1What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/enable_source 2Date: November 2014 3KernelVersion: 3.19 4Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 5Description: (RW) Enable/disable tracing on this specific trace entiry. 6 Enabling a source implies the source has been configured 7 properly and a sink has been identidifed for it. The path 8 of coresight components linking the source to the sink is 9 configured and managed automatically by the coresight framework. 10 11What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/addr_idx 12Date: November 2014 13KernelVersion: 3.19 14Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 15Description: Select which address comparator or pair (of comparators) to 16 work with. 17 18What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/addr_acctype 19Date: November 2014 20KernelVersion: 3.19 21Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 22Description: (RW) Used in conjunction with @addr_idx. Specifies 23 characteristics about the address comparator being configure, 24 for example the access type, the kind of instruction to trace, 25 processor context ID to trigger on, etc. Individual fields in 26 the access type register may vary on the version of the trace 27 entity. 28 29What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/addr_range 30Date: November 2014 31KernelVersion: 3.19 32Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 33Description: (RW) Used in conjunction with @addr_idx. Specifies the range of 34 addresses to trigger on. Inclusion or exclusion is specified 35 in the corresponding access type register. 36 37What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/addr_single 38Date: November 2014 39KernelVersion: 3.19 40Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 41Description: (RW) Used in conjunction with @addr_idx. Specifies the single 42 address to trigger on, highly influenced by the configuration 43 options of the corresponding access type register. 44 45What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/addr_start 46Date: November 2014 47KernelVersion: 3.19 48Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 49Description: (RW) Used in conjunction with @addr_idx. Specifies the single 50 address to start tracing on, highly influenced by the 51 configuration options of the corresponding access type register. 52 53What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/addr_stop 54Date: November 2014 55KernelVersion: 3.19 56Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 57Description: (RW) Used in conjunction with @addr_idx. Specifies the single 58 address to stop tracing on, highly influenced by the 59 configuration options of the corresponding access type register. 60 61What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/cntr_idx 62Date: November 2014 63KernelVersion: 3.19 64Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 65Description: (RW) Specifies the counter to work on. 66 67What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/cntr_event 68Date: November 2014 69KernelVersion: 3.19 70Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 71Description: (RW) Used in conjunction with cntr_idx, give access to the 72 counter event register. 73 74What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/cntr_val 75Date: November 2014 76KernelVersion: 3.19 77Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 78Description: (RW) Used in conjunction with cntr_idx, give access to the 79 counter value register. 80 81What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/cntr_rld_val 82Date: November 2014 83KernelVersion: 3.19 84Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 85Description: (RW) Used in conjunction with cntr_idx, give access to the 86 counter reload value register. 87 88What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/cntr_rld_event 89Date: November 2014 90KernelVersion: 3.19 91Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 92Description: (RW) Used in conjunction with cntr_idx, give access to the 93 counter reload event register. 94 95What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/ctxid_idx 96Date: November 2014 97KernelVersion: 3.19 98Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 99Description: (RW) Specifies the index of the context ID register to be 100 selected. 101 102What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/ctxid_mask 103Date: November 2014 104KernelVersion: 3.19 105Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 106Description: (RW) Mask to apply to all the context ID comparator. 107 108What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/ctxid_pid 109Date: November 2014 110KernelVersion: 3.19 111Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 112Description: (RW) Used with the ctxid_idx, specify with context ID to trigger 113 on. 114 115What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/enable_event 116Date: November 2014 117KernelVersion: 3.19 118Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 119Description: (RW) Defines which event triggers a trace. 120 121What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/etmsr 122Date: November 2014 123KernelVersion: 3.19 124Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 125Description: (RW) Gives access to the ETM status register, which holds 126 programming information and status on certains events. 127 128What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/fifofull_level 129Date: November 2014 130KernelVersion: 3.19 131Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 132Description: (RW) Number of byte left in the fifo before considering it full. 133 Depending on the tracer's version, can also hold threshold for 134 data suppression. 135 136What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mode 137Date: November 2014 138KernelVersion: 3.19 139Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 140Description: (RW) Interface with the driver's 'mode' field, controlling 141 various aspect of the trace entity such as time stamping, 142 context ID size and cycle accurate tracing. Driver specific 143 and bound to change depending on the driver. 144 145What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/nr_addr_cmp 146Date: November 2014 147KernelVersion: 3.19 148Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 149Description: (Read) Provides the number of address comparators pairs accessible 150 on a trace unit, as specified by bit 3:0 of register ETMCCR. 151 152What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/nr_cntr 153Date: November 2014 154KernelVersion: 3.19 155Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 156Description: (Read) Provides the number of counters accessible on a trace unit, 157 as specified by bit 15:13 of register ETMCCR. 158 159What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/nr_ctxid_cmp 160Date: November 2014 161KernelVersion: 3.19 162Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 163Description: (Read) Provides the number of context ID comparator available on a 164 trace unit, as specified by bit 25:24 of register ETMCCR. 165 166What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/reset 167Date: November 2014 168KernelVersion: 3.19 169Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 170Description: (Write) Cancels all configuration on a trace unit and set it back 171 to its boot configuration. 172 173What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/seq_12_event 174Date: November 2014 175KernelVersion: 3.19 176Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 177Description: (RW) Defines the event that causes the sequencer to transition 178 from state 1 to state 2. 179 180What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/seq_13_event 181Date: November 2014 182KernelVersion: 3.19 183Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 184Description: (RW) Defines the event that causes the sequencer to transition 185 from state 1 to state 3. 186 187What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/seq_21_event 188Date: November 2014 189KernelVersion: 3.19 190Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 191Description: (RW) Defines the event that causes the sequencer to transition 192 from state 2 to state 1. 193 194What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/seq_23_event 195Date: November 2014 196KernelVersion: 3.19 197Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 198Description: (RW) Defines the event that causes the sequencer to transition 199 from state 2 to state 3. 200 201What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/seq_31_event 202Date: November 2014 203KernelVersion: 3.19 204Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 205Description: (RW) Defines the event that causes the sequencer to transition 206 from state 3 to state 1. 207 208What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/seq_32_event 209Date: November 2014 210KernelVersion: 3.19 211Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 212Description: (RW) Defines the event that causes the sequencer to transition 213 from state 3 to state 2. 214 215What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/curr_seq_state 216Date: November 2014 217KernelVersion: 3.19 218Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 219Description: (Read) Holds the current state of the sequencer. 220 221What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/sync_freq 222Date: November 2014 223KernelVersion: 3.19 224Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 225Description: (RW) Holds the trace synchronization frequency value - must be 226 programmed with the various implementation behavior in mind. 227 228What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/timestamp_event 229Date: November 2014 230KernelVersion: 3.19 231Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 232Description: (RW) Defines an event that requests the insertion of a timestamp 233 into the trace stream. 234 235What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/traceid 236Date: November 2014 237KernelVersion: 3.19 238Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 239Description: (RO) Holds the trace ID that will appear in the trace stream 240 coming from this trace entity. 241 242What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/trigger_event 243Date: November 2014 244KernelVersion: 3.19 245Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 246Description: (RW) Define the event that controls the trigger. 247 248What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/cpu 249Date: October 2015 250KernelVersion: 4.4 251Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 252Description: (RO) Holds the cpu number this tracer is affined to. 253 254What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/label 255Date: Aug 2025 256KernelVersion 6.18 257Contact: Mao Jinlong <quic_jinlmao@quicinc.com> 258Description: (Read) Show hardware context information of device. 259 260What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmccr 261Date: September 2015 262KernelVersion: 4.4 263Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 264Description: (RO) Print the content of the ETM Configuration Code register 265 (0x004). The value is read directly from the HW. 266 267What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmccer 268Date: September 2015 269KernelVersion: 4.4 270Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 271Description: (RO) Print the content of the ETM Configuration Code Extension 272 register (0x1e8). The value is read directly from the HW. 273 274What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmscr 275Date: September 2015 276KernelVersion: 4.4 277Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 278Description: (RO) Print the content of the ETM System Configuration 279 register (0x014). The value is read directly from the HW. 280 281What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmidr 282Date: September 2015 283KernelVersion: 4.4 284Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 285Description: (RO) Print the content of the ETM ID register (0x1e4). The 286 value is read directly from the HW. 287 288What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmcr 289Date: September 2015 290KernelVersion: 4.4 291Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 292Description: (RO) Print the content of the ETM Main Control register (0x000). 293 The value is read directly from the HW. 294 295What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmtraceidr 296Date: September 2015 297KernelVersion: 4.4 298Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 299Description: (RO) Print the content of the ETM Trace ID register (0x200). 300 The value is read directly from the HW. 301 302What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmteevr 303Date: September 2015 304KernelVersion: 4.4 305Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 306Description: (RO) Print the content of the ETM Trace Enable Event register 307 (0x020). The value is read directly from the HW. 308 309What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmtsscr 310Date: September 2015 311KernelVersion: 4.4 312Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 313Description: (RO) Print the content of the ETM Trace Start/Stop Control 314 register (0x018). The value is read directly from the HW. 315 316What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmtecr1 317Date: September 2015 318KernelVersion: 4.4 319Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 320Description: (RO) Print the content of the ETM Enable Control #1 321 register (0x024). The value is read directly from the HW. 322 323What: /sys/bus/coresight/devices/<memory_map>.[etm|ptm]/mgmt/etmtecr2 324Date: September 2015 325KernelVersion: 4.4 326Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 327Description: (RO) Print the content of the ETM Enable Control #2 328 register (0x01c). The value is read directly from the HW. 329