1Intel hybrid support
2--------------------
3Support for Intel hybrid events within perf tools.
4
5For some Intel platforms, such as AlderLake, which is hybrid platform and
6it consists of atom cpu and core cpu. Each cpu has dedicated event list.
7Part of events are available on core cpu, part of events are available
8on atom cpu and even part of events are available on both.
9
10Kernel exports two new cpu pmus via sysfs:
11/sys/devices/cpu_core
12/sys/devices/cpu_atom
13
14The 'cpus' files are created under the directories. For example,
15
16cat /sys/devices/cpu_core/cpus
170-15
18
19cat /sys/devices/cpu_atom/cpus
2016-23
21
22It indicates cpu0-cpu15 are core cpus and cpu16-cpu23 are atom cpus.
23
24Quickstart
25
26List hybrid event
27-----------------
28
29As before, use perf-list to list the symbolic event.
30
31perf list
32
33inst_retired.any
34	[Fixed Counter: Counts the number of instructions retired. Unit: cpu_atom]
35inst_retired.any
36	[Number of instructions retired. Fixed Counter - architectural event. Unit: cpu_core]
37
38The 'Unit: xxx' is added to brief description to indicate which pmu
39the event is belong to. Same event name but with different pmu can
40be supported.
41
42Enable hybrid event with a specific pmu
43---------------------------------------
44
45To enable a core only event or atom only event, following syntax is supported:
46
47	cpu_core/<event name>/
48or
49	cpu_atom/<event name>/
50
51For example, count the 'cycles' event on core cpus.
52
53	perf stat -e cpu_core/cycles/
54
55Create two events for one hardware event automatically
56------------------------------------------------------
57
58When creating one event and the event is available on both atom and core,
59two events are created automatically. One is for atom, the other is for
60core. Most of hardware events and cache events are available on both
61cpu_core and cpu_atom.
62
63For hardware events, they have pre-defined configs (e.g. 0 for cycles).
64But on hybrid platform, kernel needs to know where the event comes from
65(from atom or from core). The original perf event type PERF_TYPE_HARDWARE
66can't carry pmu information. So now this type is extended to be PMU aware
67type. The PMU type ID is stored at attr.config[63:32].
68
69PMU type ID is retrieved from sysfs.
70/sys/devices/cpu_atom/type
71/sys/devices/cpu_core/type
72
73The new attr.config layout for PERF_TYPE_HARDWARE:
74
75PERF_TYPE_HARDWARE:                 0xEEEEEEEE000000AA
76                                    AA: hardware event ID
77                                    EEEEEEEE: PMU type ID
78
79Cache event is similar. The type PERF_TYPE_HW_CACHE is extended to be
80PMU aware type. The PMU type ID is stored at attr.config[63:32].
81
82The new attr.config layout for PERF_TYPE_HW_CACHE:
83
84PERF_TYPE_HW_CACHE:                 0xEEEEEEEE00DDCCBB
85                                    BB: hardware cache ID
86                                    CC: hardware cache op ID
87                                    DD: hardware cache op result ID
88                                    EEEEEEEE: PMU type ID
89
90When enabling a hardware event without specified pmu, such as,
91perf stat -e cycles -a (use system-wide in this example), two events
92are created automatically.
93
94  ------------------------------------------------------------
95  perf_event_attr:
96    size                             120
97    config                           0x400000000
98    sample_type                      IDENTIFIER
99    read_format                      TOTAL_TIME_ENABLED|TOTAL_TIME_RUNNING
100    disabled                         1
101    inherit                          1
102    exclude_guest                    1
103  ------------------------------------------------------------
104
105and
106
107  ------------------------------------------------------------
108  perf_event_attr:
109    size                             120
110    config                           0x800000000
111    sample_type                      IDENTIFIER
112    read_format                      TOTAL_TIME_ENABLED|TOTAL_TIME_RUNNING
113    disabled                         1
114    inherit                          1
115    exclude_guest                    1
116  ------------------------------------------------------------
117
118type 0 is PERF_TYPE_HARDWARE.
1190x4 in 0x400000000 indicates it's cpu_core pmu.
1200x8 in 0x800000000 indicates it's cpu_atom pmu (atom pmu type id is random).
121
122The kernel creates 'cycles' (0x400000000) on cpu0-cpu15 (core cpus),
123and create 'cycles' (0x800000000) on cpu16-cpu23 (atom cpus).
124
125For perf-stat result, it displays two events:
126
127 Performance counter stats for 'system wide':
128
129           6,744,979      cpu_core/cycles/
130           1,965,552      cpu_atom/cycles/
131
132The first 'cycles' is core event, the second 'cycles' is atom event.
133
134Thread mode example:
135--------------------
136
137perf-stat reports the scaled counts for hybrid event and with a percentage
138displayed. The percentage is the event's running time/enabling time.
139
140One example, 'triad_loop' runs on cpu16 (atom core), while we can see the
141scaled value for core cycles is 160,444,092 and the percentage is 0.47%.
142
143perf stat -e cycles \-- taskset -c 16 ./triad_loop
144
145As previous, two events are created.
146
147------------------------------------------------------------
148perf_event_attr:
149  size                             120
150  config                           0x400000000
151  sample_type                      IDENTIFIER
152  read_format                      TOTAL_TIME_ENABLED|TOTAL_TIME_RUNNING
153  disabled                         1
154  inherit                          1
155  enable_on_exec                   1
156  exclude_guest                    1
157------------------------------------------------------------
158
159and
160
161------------------------------------------------------------
162perf_event_attr:
163  size                             120
164  config                           0x800000000
165  sample_type                      IDENTIFIER
166  read_format                      TOTAL_TIME_ENABLED|TOTAL_TIME_RUNNING
167  disabled                         1
168  inherit                          1
169  enable_on_exec                   1
170  exclude_guest                    1
171------------------------------------------------------------
172
173 Performance counter stats for 'taskset -c 16 ./triad_loop':
174
175       233,066,666      cpu_core/cycles/                                              (0.43%)
176       604,097,080      cpu_atom/cycles/                                              (99.57%)
177
178perf-record:
179------------
180
181If there is no '-e' specified in perf record, on hybrid platform,
182it creates two default 'cycles' and adds them to event list. One
183is for core, the other is for atom.
184
185perf-stat:
186----------
187
188If there is no '-e' specified in perf stat, on hybrid platform,
189besides of software events, following events are created and
190added to event list in order.
191
192cpu_core/cycles/,
193cpu_atom/cycles/,
194cpu_core/instructions/,
195cpu_atom/instructions/,
196cpu_core/branches/,
197cpu_atom/branches/,
198cpu_core/branch-misses/,
199cpu_atom/branch-misses/
200
201Of course, both perf-stat and perf-record support to enable
202hybrid event with a specific pmu.
203
204e.g.
205perf stat -e cpu_core/cycles/
206perf stat -e cpu_atom/cycles/
207perf stat -e cpu_core/r1a/
208perf stat -e cpu_atom/L1-icache-loads/
209perf stat -e cpu_core/cycles/,cpu_atom/instructions/
210perf stat -e '{cpu_core/cycles/,cpu_core/instructions/}'
211
212But '{cpu_core/cycles/,cpu_atom/instructions/}' will return
213warning and disable grouping, because the pmus in group are
214not matched (cpu_core vs. cpu_atom).
215