1What: /sys/bus/coresight/devices/etm<N>/enable_source 2Date: April 2015 3KernelVersion: 4.01 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/etm<N>/cpu 12Date: April 2015 13KernelVersion: 4.01 14Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 15Description: (Read) The CPU this tracing entity is associated with. 16 17What: /sys/bus/coresight/devices/etm<N>/nr_pe_cmp 18Date: April 2015 19KernelVersion: 4.01 20Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 21Description: (Read) Indicates the number of PE comparator inputs that are 22 available for tracing. 23 24What: /sys/bus/coresight/devices/etm<N>/nr_addr_cmp 25Date: April 2015 26KernelVersion: 4.01 27Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 28Description: (Read) Indicates the number of address comparator pairs that are 29 available for tracing. 30 31What: /sys/bus/coresight/devices/etm<N>/nr_cntr 32Date: April 2015 33KernelVersion: 4.01 34Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 35Description: (Read) Indicates the number of counters that are available for 36 tracing. 37 38What: /sys/bus/coresight/devices/etm<N>/nr_ext_inp 39Date: April 2015 40KernelVersion: 4.01 41Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 42Description: (Read) Indicates how many external inputs are implemented. 43 44What: /sys/bus/coresight/devices/etm<N>/numcidc 45Date: April 2015 46KernelVersion: 4.01 47Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 48Description: (Read) Indicates the number of Context ID comparators that are 49 available for tracing. 50 51What: /sys/bus/coresight/devices/etm<N>/numvmidc 52Date: April 2015 53KernelVersion: 4.01 54Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 55Description: (Read) Indicates the number of VMID comparators that are available 56 for tracing. 57 58What: /sys/bus/coresight/devices/etm<N>/nrseqstate 59Date: April 2015 60KernelVersion: 4.01 61Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 62Description: (Read) Indicates the number of sequencer states that are 63 implemented. 64 65What: /sys/bus/coresight/devices/etm<N>/nr_resource 66Date: April 2015 67KernelVersion: 4.01 68Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 69Description: (Read) Indicates the number of resource selection pairs that are 70 available for tracing. 71 72What: /sys/bus/coresight/devices/etm<N>/nr_ss_cmp 73Date: April 2015 74KernelVersion: 4.01 75Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 76Description: (Read) Indicates the number of single-shot comparator controls that 77 are available for tracing. 78 79What: /sys/bus/coresight/devices/etm<N>/reset 80Date: April 2015 81KernelVersion: 4.01 82Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 83Description: (Write) Cancels all configuration on a trace unit and set it back 84 to its boot configuration. 85 86What: /sys/bus/coresight/devices/etm<N>/mode 87Date: April 2015 88KernelVersion: 4.01 89Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 90Description: (RW) Controls various modes supported by this ETM, for example 91 P0 instruction tracing, branch broadcast, cycle counting and 92 context ID tracing. 93 94What: /sys/bus/coresight/devices/etm<N>/pe 95Date: April 2015 96KernelVersion: 4.01 97Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 98Description: (RW) Controls which PE to trace. 99 100What: /sys/bus/coresight/devices/etm<N>/event 101Date: April 2015 102KernelVersion: 4.01 103Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 104Description: (RW) Controls the tracing of arbitrary events from bank 0 to 3. 105 106What: /sys/bus/coresight/devices/etm<N>/event_instren 107Date: April 2015 108KernelVersion: 4.01 109Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 110Description: (RW) Controls the behavior of the events in bank 0 to 3. 111 112What: /sys/bus/coresight/devices/etm<N>/event_ts 113Date: April 2015 114KernelVersion: 4.01 115Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 116Description: (RW) Controls the insertion of global timestamps in the trace 117 streams. 118 119What: /sys/bus/coresight/devices/etm<N>/syncfreq 120Date: April 2015 121KernelVersion: 4.01 122Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 123Description: (RW) Controls how often trace synchronization requests occur. 124 125What: /sys/bus/coresight/devices/etm<N>/cyc_threshold 126Date: April 2015 127KernelVersion: 4.01 128Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 129Description: (RW) Sets the threshold value for cycle counting. 130 131What: /sys/bus/coresight/devices/etm<N>/bb_ctrl 132Date: April 2015 133KernelVersion: 4.01 134Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 135Description: (RW) Controls which regions in the memory map are enabled to 136 use branch broadcasting. 137 138What: /sys/bus/coresight/devices/etm<N>/event_vinst 139Date: April 2015 140KernelVersion: 4.01 141Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 142Description: (RW) Controls instruction trace filtering. 143 144What: /sys/bus/coresight/devices/etm<N>/s_exlevel_vinst 145Date: April 2015 146KernelVersion: 4.01 147Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 148Description: (RW) In Secure state, each bit controls whether instruction 149 tracing is enabled for the corresponding exception level. 150 151What: /sys/bus/coresight/devices/etm<N>/ns_exlevel_vinst 152Date: April 2015 153KernelVersion: 4.01 154Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 155Description: (RW) In non-secure state, each bit controls whether instruction 156 tracing is enabled for the corresponding exception level. 157 158What: /sys/bus/coresight/devices/etm<N>/addr_idx 159Date: April 2015 160KernelVersion: 4.01 161Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 162Description: (RW) Select which address comparator or pair (of comparators) to 163 work with. 164 165What: /sys/bus/coresight/devices/etm<N>/addr_instdatatype 166Date: April 2015 167KernelVersion: 4.01 168Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 169Description: (RW) Controls what type of comparison the trace unit performs. 170 171What: /sys/bus/coresight/devices/etm<N>/addr_single 172Date: April 2015 173KernelVersion: 4.01 174Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 175Description: (RW) Used to setup single address comparator values. 176 177What: /sys/bus/coresight/devices/etm<N>/addr_range 178Date: April 2015 179KernelVersion: 4.01 180Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 181Description: (RW) Used to setup address range comparator values. 182 183What: /sys/bus/coresight/devices/etm<N>/seq_idx 184Date: April 2015 185KernelVersion: 4.01 186Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 187Description: (RW) Select which sequensor. 188 189What: /sys/bus/coresight/devices/etm<N>/seq_state 190Date: April 2015 191KernelVersion: 4.01 192Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 193Description: (RW) Use this to set, or read, the sequencer state. 194 195What: /sys/bus/coresight/devices/etm<N>/seq_event 196Date: April 2015 197KernelVersion: 4.01 198Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 199Description: (RW) Moves the sequencer state to a specific state. 200 201What: /sys/bus/coresight/devices/etm<N>/seq_reset_event 202Date: April 2015 203KernelVersion: 4.01 204Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 205Description: (RW) Moves the sequencer to state 0 when a programmed event 206 occurs. 207 208What: /sys/bus/coresight/devices/etm<N>/cntr_idx 209Date: April 2015 210KernelVersion: 4.01 211Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 212Description: (RW) Select which counter unit to work with. 213 214What: /sys/bus/coresight/devices/etm<N>/cntrldvr 215Date: April 2015 216KernelVersion: 4.01 217Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 218Description: (RW) This sets or returns the reload count value of the 219 specific counter. 220 221What: /sys/bus/coresight/devices/etm<N>/cntr_val 222Date: April 2015 223KernelVersion: 4.01 224Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 225Description: (RW) This sets or returns the current count value of the 226 specific counter. 227 228What: /sys/bus/coresight/devices/etm<N>/cntr_ctrl 229Date: April 2015 230KernelVersion: 4.01 231Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 232Description: (RW) Controls the operation of the selected counter. 233 234What: /sys/bus/coresight/devices/etm<N>/res_idx 235Date: April 2015 236KernelVersion: 4.01 237Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 238Description: (RW) Select which resource selection unit to work with. 239 240What: /sys/bus/coresight/devices/etm<N>/res_ctrl 241Date: April 2015 242KernelVersion: 4.01 243Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 244Description: (RW) Controls the selection of the resources in the trace unit. 245 246What: /sys/bus/coresight/devices/etm<N>/ctxid_idx 247Date: April 2015 248KernelVersion: 4.01 249Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 250Description: (RW) Select which context ID comparator to work with. 251 252What: /sys/bus/coresight/devices/etm<N>/ctxid_pid 253Date: April 2015 254KernelVersion: 4.01 255Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 256Description: (RW) Get/Set the context ID comparator value to trigger on. 257 258What: /sys/bus/coresight/devices/etm<N>/ctxid_masks 259Date: April 2015 260KernelVersion: 4.01 261Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 262Description: (RW) Mask for all 8 context ID comparator value 263 registers (if implemented). 264 265What: /sys/bus/coresight/devices/etm<N>/vmid_idx 266Date: April 2015 267KernelVersion: 4.01 268Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 269Description: (RW) Select which virtual machine ID comparator to work with. 270 271What: /sys/bus/coresight/devices/etm<N>/vmid_val 272Date: April 2015 273KernelVersion: 4.01 274Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 275Description: (RW) Get/Set the virtual machine ID comparator value to 276 trigger on. 277 278What: /sys/bus/coresight/devices/etm<N>/vmid_masks 279Date: April 2015 280KernelVersion: 4.01 281Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 282Description: (RW) Mask for all 8 virtual machine ID comparator value 283 registers (if implemented). 284 285What: /sys/bus/coresight/devices/etm<N>/addr_exlevel_s_ns 286Date: December 2019 287KernelVersion: 5.5 288Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 289Description: (RW) Set the Exception Level matching bits for secure and 290 non-secure exception levels. 291 292What: /sys/bus/coresight/devices/etm<N>/vinst_pe_cmp_start_stop 293Date: December 2019 294KernelVersion: 5.5 295Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 296Description: (RW) Access the start stop control register for PE input 297 comparators. 298 299What: /sys/bus/coresight/devices/etm<N>/addr_cmp_view 300Date: December 2019 301KernelVersion: 5.5 302Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 303Description: (Read) Print the current settings for the selected address 304 comparator. 305 306What: /sys/bus/coresight/devices/etm<N>/sshot_idx 307Date: December 2019 308KernelVersion: 5.5 309Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 310Description: (RW) Select the single shot control register to access. 311 312What: /sys/bus/coresight/devices/etm<N>/sshot_ctrl 313Date: December 2019 314KernelVersion: 5.5 315Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 316Description: (RW) Access the selected single shot control register. 317 318What: /sys/bus/coresight/devices/etm<N>/sshot_status 319Date: December 2019 320KernelVersion: 5.5 321Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 322Description: (Read) Print the current value of the selected single shot 323 status register. 324 325What: /sys/bus/coresight/devices/etm<N>/sshot_pe_ctrl 326Date: December 2019 327KernelVersion: 5.5 328Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 329Description: (RW) Access the selected single show PE comparator control 330 register. 331 332What: /sys/bus/coresight/devices/etm<N>/label 333Date: Aug 2025 334KernelVersion 6.18 335Contact: Mao Jinlong <quic_jinlmao@quicinc.com> 336Description: (Read) Show hardware context information of device. 337 338What: /sys/bus/coresight/devices/etm<N>/mgmt/trcoslsr 339Date: April 2015 340KernelVersion: 4.01 341Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 342Description: (Read) Print the content of the OS Lock Status Register (0x304). 343 The value it taken directly from the HW. 344 345What: /sys/bus/coresight/devices/etm<N>/mgmt/trcpdcr 346Date: April 2015 347KernelVersion: 4.01 348Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 349Description: (Read) Print the content of the Power Down Control Register 350 (0x310). The value is taken directly from the HW. 351 352What: /sys/bus/coresight/devices/etm<N>/mgmt/trcpdsr 353Date: April 2015 354KernelVersion: 4.01 355Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 356Description: (Read) Print the content of the Power Down Status Register 357 (0x314). The value is taken directly from the HW. 358 359What: /sys/bus/coresight/devices/etm<N>/mgmt/trclsr 360Date: April 2015 361KernelVersion: 4.01 362Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 363Description: (Read) Print the content of the SW Lock Status Register 364 (0xFB4). The value is taken directly from the HW. 365 366What: /sys/bus/coresight/devices/etm<N>/mgmt/trcauthstatus 367Date: April 2015 368KernelVersion: 4.01 369Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 370Description: (Read) Print the content of the Authentication Status Register 371 (0xFB8). The value is taken directly from the HW. 372 373What: /sys/bus/coresight/devices/etm<N>/mgmt/trcdevid 374Date: April 2015 375KernelVersion: 4.01 376Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 377Description: (Read) Print the content of the Device ID Register 378 (0xFC8). The value is taken directly from the HW. 379 380What: /sys/bus/coresight/devices/etm<N>/mgmt/trcdevarch 381Date: January 2021 382KernelVersion: 5.12 383Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 384Description: (Read) Print the content of the Device Architecture Register 385 (offset 0xFBC). The value is taken directly read 386 from the HW. 387 388What: /sys/bus/coresight/devices/etm<N>/mgmt/trcdevtype 389Date: April 2015 390KernelVersion: 4.01 391Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 392Description: (Read) Print the content of the Device Type Register 393 (0xFCC). The value is taken directly from the HW. 394 395What: /sys/bus/coresight/devices/etm<N>/mgmt/trcpidr0 396Date: April 2015 397KernelVersion: 4.01 398Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 399Description: (Read) Print the content of the Peripheral ID0 Register 400 (0xFE0). The value is taken directly from the HW. 401 402What: /sys/bus/coresight/devices/etm<N>/mgmt/trcpidr1 403Date: April 2015 404KernelVersion: 4.01 405Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 406Description: (Read) Print the content of the Peripheral ID1 Register 407 (0xFE4). The value is taken directly from the HW. 408 409What: /sys/bus/coresight/devices/etm<N>/mgmt/trcpidr2 410Date: April 2015 411KernelVersion: 4.01 412Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 413Description: (Read) Print the content of the Peripheral ID2 Register 414 (0xFE8). The value is taken directly from the HW. 415 416What: /sys/bus/coresight/devices/etm<N>/mgmt/trcpidr3 417Date: April 2015 418KernelVersion: 4.01 419Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 420Description: (Read) Print the content of the Peripheral ID3 Register 421 (0xFEC). The value is taken directly from the HW. 422 423What: /sys/bus/coresight/devices/etm<N>/mgmt/trcconfig 424Date: February 2016 425KernelVersion: 4.07 426Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 427Description: (Read) Print the content of the trace configuration register 428 (0x010) as currently set by SW. 429 430What: /sys/bus/coresight/devices/etm<N>/mgmt/trctraceid 431Date: February 2016 432KernelVersion: 4.07 433Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 434Description: (Read) Print the content of the trace ID register (0x040). 435 436What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr0 437Date: April 2015 438KernelVersion: 4.01 439Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 440Description: (Read) Returns the tracing capabilities of the trace unit (0x1E0). 441 The value is taken directly from the HW. 442 443What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr1 444Date: April 2015 445KernelVersion: 4.01 446Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 447Description: (Read) Returns the tracing capabilities of the trace unit (0x1E4). 448 The value is taken directly from the HW. 449 450What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr2 451Date: April 2015 452KernelVersion: 4.01 453Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 454Description: (Read) Returns the maximum size of the data value, data address, 455 VMID, context ID and instruction address in the trace unit 456 (0x1E8). The value is taken directly from the HW. 457 458What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr3 459Date: April 2015 460KernelVersion: 4.01 461Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 462Description: (Read) Returns the value associated with various resources 463 available to the trace unit. See the Trace Macrocell 464 architecture specification for more details (0x1E8). 465 The value is taken directly from the HW. 466 467What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr4 468Date: April 2015 469KernelVersion: 4.01 470Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 471Description: (Read) Returns how many resources the trace unit supports (0x1F0). 472 The value is taken directly from the HW. 473 474What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr5 475Date: April 2015 476KernelVersion: 4.01 477Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 478Description: (Read) Returns how many resources the trace unit supports (0x1F4). 479 The value is taken directly from the HW. 480 481What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr8 482Date: April 2015 483KernelVersion: 4.01 484Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 485Description: (Read) Returns the maximum speculation depth of the instruction 486 trace stream. (0x180). The value is taken directly from the HW. 487 488What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr9 489Date: April 2015 490KernelVersion: 4.01 491Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 492Description: (Read) Returns the number of P0 right-hand keys that the trace unit 493 can use (0x184). The value is taken directly from the HW. 494 495What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr10 496Date: April 2015 497KernelVersion: 4.01 498Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 499Description: (Read) Returns the number of P1 right-hand keys that the trace unit 500 can use (0x188). The value is taken directly from the HW. 501 502What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr11 503Date: April 2015 504KernelVersion: 4.01 505Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 506Description: (Read) Returns the number of special P1 right-hand keys that the 507 trace unit can use (0x18C). The value is taken directly from 508 the HW. 509 510What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr12 511Date: April 2015 512KernelVersion: 4.01 513Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 514Description: (Read) Returns the number of conditional P1 right-hand keys that 515 the trace unit can use (0x190). The value is taken directly 516 from the HW. 517 518What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr13 519Date: April 2015 520KernelVersion: 4.01 521Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 522Description: (Read) Returns the number of special conditional P1 right-hand keys 523 that the trace unit can use (0x194). The value is taken 524 directly from the HW. 525 526What: /sys/bus/coresight/devices/etm<N>/ts_source 527Date: October 2022 528KernelVersion: 6.1 529Contact: Mathieu Poirier <mathieu.poirier@linaro.org> or Suzuki K Poulose <suzuki.poulose@arm.com> 530Description: (Read) When FEAT_TRF is implemented, value of TRFCR_ELx.TS used for 531 trace session. Otherwise -1 indicates an unknown time source. Check 532 trcidr0.tssize to see if a global timestamp is available. 533