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: (R) 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: (R) 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: (R) 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: (R) 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: (R) 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: (R) 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: (R) 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: (R) 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: (R) 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: (R) 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: (W) 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: (R) 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: (R) 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>/mgmt/trcoslsr 333Date: April 2015 334KernelVersion: 4.01 335Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 336Description: (R) Print the content of the OS Lock Status Register (0x304). 337 The value it taken directly from the HW. 338 339What: /sys/bus/coresight/devices/etm<N>/mgmt/trcpdcr 340Date: April 2015 341KernelVersion: 4.01 342Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 343Description: (R) Print the content of the Power Down Control Register 344 (0x310). The value is taken directly from the HW. 345 346What: /sys/bus/coresight/devices/etm<N>/mgmt/trcpdsr 347Date: April 2015 348KernelVersion: 4.01 349Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 350Description: (R) Print the content of the Power Down Status Register 351 (0x314). The value is taken directly from the HW. 352 353What: /sys/bus/coresight/devices/etm<N>/mgmt/trclsr 354Date: April 2015 355KernelVersion: 4.01 356Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 357Description: (R) Print the content of the SW Lock Status Register 358 (0xFB4). The value is taken directly from the HW. 359 360What: /sys/bus/coresight/devices/etm<N>/mgmt/trcauthstatus 361Date: April 2015 362KernelVersion: 4.01 363Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 364Description: (R) Print the content of the Authentication Status Register 365 (0xFB8). The value is taken directly from the HW. 366 367What: /sys/bus/coresight/devices/etm<N>/mgmt/trcdevid 368Date: April 2015 369KernelVersion: 4.01 370Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 371Description: (R) Print the content of the Device ID Register 372 (0xFC8). The value is taken directly from the HW. 373 374What: /sys/bus/coresight/devices/etm<N>/mgmt/trcdevtype 375Date: April 2015 376KernelVersion: 4.01 377Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 378Description: (R) Print the content of the Device Type Register 379 (0xFCC). The value is taken directly from the HW. 380 381What: /sys/bus/coresight/devices/etm<N>/mgmt/trcpidr0 382Date: April 2015 383KernelVersion: 4.01 384Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 385Description: (R) Print the content of the Peripheral ID0 Register 386 (0xFE0). The value is taken directly from the HW. 387 388What: /sys/bus/coresight/devices/etm<N>/mgmt/trcpidr1 389Date: April 2015 390KernelVersion: 4.01 391Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 392Description: (R) Print the content of the Peripheral ID1 Register 393 (0xFE4). The value is taken directly from the HW. 394 395What: /sys/bus/coresight/devices/etm<N>/mgmt/trcpidr2 396Date: April 2015 397KernelVersion: 4.01 398Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 399Description: (R) Print the content of the Peripheral ID2 Register 400 (0xFE8). The value is taken directly from the HW. 401 402What: /sys/bus/coresight/devices/etm<N>/mgmt/trcpidr3 403Date: April 2015 404KernelVersion: 4.01 405Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 406Description: (R) Print the content of the Peripheral ID3 Register 407 (0xFEC). The value is taken directly from the HW. 408 409What: /sys/bus/coresight/devices/etm<N>/mgmt/trcconfig 410Date: February 2016 411KernelVersion: 4.07 412Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 413Description: (R) Print the content of the trace configuration register 414 (0x010) as currently set by SW. 415 416What: /sys/bus/coresight/devices/etm<N>/mgmt/trctraceid 417Date: February 2016 418KernelVersion: 4.07 419Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 420Description: (R) Print the content of the trace ID register (0x040). 421 422What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr0 423Date: April 2015 424KernelVersion: 4.01 425Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 426Description: (R) Returns the tracing capabilities of the trace unit (0x1E0). 427 The value is taken directly from the HW. 428 429What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr1 430Date: April 2015 431KernelVersion: 4.01 432Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 433Description: (R) Returns the tracing capabilities of the trace unit (0x1E4). 434 The value is taken directly from the HW. 435 436What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr2 437Date: April 2015 438KernelVersion: 4.01 439Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 440Description: (R) Returns the maximum size of the data value, data address, 441 VMID, context ID and instuction address in the trace unit 442 (0x1E8). The value is taken directly from the HW. 443 444What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr3 445Date: April 2015 446KernelVersion: 4.01 447Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 448Description: (R) Returns the value associated with various resources 449 available to the trace unit. See the Trace Macrocell 450 architecture specification for more details (0x1E8). 451 The value is taken directly from the HW. 452 453What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr4 454Date: April 2015 455KernelVersion: 4.01 456Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 457Description: (R) Returns how many resources the trace unit supports (0x1F0). 458 The value is taken directly from the HW. 459 460What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr5 461Date: April 2015 462KernelVersion: 4.01 463Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 464Description: (R) Returns how many resources the trace unit supports (0x1F4). 465 The value is taken directly from the HW. 466 467What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr8 468Date: April 2015 469KernelVersion: 4.01 470Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 471Description: (R) Returns the maximum speculation depth of the instruction 472 trace stream. (0x180). The value is taken directly from the HW. 473 474What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr9 475Date: April 2015 476KernelVersion: 4.01 477Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 478Description: (R) Returns the number of P0 right-hand keys that the trace unit 479 can use (0x184). The value is taken directly from the HW. 480 481What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr10 482Date: April 2015 483KernelVersion: 4.01 484Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 485Description: (R) Returns the number of P1 right-hand keys that the trace unit 486 can use (0x188). The value is taken directly from the HW. 487 488What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr11 489Date: April 2015 490KernelVersion: 4.01 491Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 492Description: (R) Returns the number of special P1 right-hand keys that the 493 trace unit can use (0x18C). The value is taken directly from 494 the HW. 495 496What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr12 497Date: April 2015 498KernelVersion: 4.01 499Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 500Description: (R) Returns the number of conditional P1 right-hand keys that 501 the trace unit can use (0x190). The value is taken directly 502 from the HW. 503 504What: /sys/bus/coresight/devices/etm<N>/trcidr/trcidr13 505Date: April 2015 506KernelVersion: 4.01 507Contact: Mathieu Poirier <mathieu.poirier@linaro.org> 508Description: (R) Returns the number of special conditional P1 right-hand keys 509 that the trace unit can use (0x194). The value is taken 510 directly from the HW. 511