xref: /OK3568_Linux_fs/kernel/Documentation/ABI/testing/sysfs-device-mali-coresight-source (revision 4882a59341e53eb6f0b4789bf948001014eff981)
1*4882a593Smuzhiyun/*
2*4882a593Smuzhiyun *
3*4882a593Smuzhiyun * (C) COPYRIGHT 2022 ARM Limited. All rights reserved.
4*4882a593Smuzhiyun *
5*4882a593Smuzhiyun * This program is free software and is provided to you under the terms of the
6*4882a593Smuzhiyun * GNU General Public License version 2 as published by the Free Software
7*4882a593Smuzhiyun * Foundation) and any use by you of this program is subject to the terms
8*4882a593Smuzhiyun * of such GNU licence.
9*4882a593Smuzhiyun *
10*4882a593Smuzhiyun * A copy of the licence is included with the program) and can also be obtained
11*4882a593Smuzhiyun * from Free Software Foundation) Inc.) 51 Franklin Street) Fifth Floor)
12*4882a593Smuzhiyun * Boston) MA  02110-1301) USA.
13*4882a593Smuzhiyun *
14*4882a593Smuzhiyun */
15*4882a593Smuzhiyun
16*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-etm/enable_source
17*4882a593SmuzhiyunDescription:
18*4882a593Smuzhiyun        Attribute used to enable Coresight Source ETM.
19*4882a593Smuzhiyun
20*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-etm/is_enabled
21*4882a593SmuzhiyunDescription:
22*4882a593Smuzhiyun        Attribute used to check if Coresight Source ITM is enabled.
23*4882a593Smuzhiyun
24*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-etm/trcconfigr
25*4882a593SmuzhiyunDescription:
26*4882a593Smuzhiyun        Coresight Source ETM trace configuration to enable global
27*4882a593Smuzhiyun        timestamping, and data value tracing.
28*4882a593Smuzhiyun
29*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-etm/trctraceidr
30*4882a593SmuzhiyunDescription:
31*4882a593Smuzhiyun        Coresight Source ETM trace ID.
32*4882a593Smuzhiyun
33*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-etm/trcvdarcctlr
34*4882a593SmuzhiyunDescription:
35*4882a593Smuzhiyun        Coresight Source ETM viewData include/exclude address
36*4882a593Smuzhiyun        range comparators.
37*4882a593Smuzhiyun
38*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-etm/trcviiectlr
39*4882a593SmuzhiyunDescription:
40*4882a593Smuzhiyun        Coresight Source ETM viewInst include and exclude control.
41*4882a593Smuzhiyun
42*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-etm/trcstallctlr
43*4882a593SmuzhiyunDescription:
44*4882a593Smuzhiyun        Coresight Source ETM stall control register.
45*4882a593Smuzhiyun
46*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-itm/enable_source
47*4882a593SmuzhiyunDescription:
48*4882a593Smuzhiyun        Attribute used to enable Coresight Source ITM.
49*4882a593Smuzhiyun
50*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-itm/is_enabled
51*4882a593SmuzhiyunDescription:
52*4882a593Smuzhiyun        Attribute used to check if Coresight Source ITM is enabled.
53*4882a593Smuzhiyun
54*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-itm/dwt_ctrl
55*4882a593SmuzhiyunDescription:
56*4882a593Smuzhiyun        Coresight Source DWT configuration:
57*4882a593Smuzhiyun            [0] = 1, enable cycle counter
58*4882a593Smuzhiyun            [4:1] = 4, set PC sample rate pf 256 cycles
59*4882a593Smuzhiyun            [8:5] = 1, set initial post count value
60*4882a593Smuzhiyun            [9] = 1, select position of post count tap on the cycle counter
61*4882a593Smuzhiyun            [10:11] = 1, enable sync packets
62*4882a593Smuzhiyun            [12] = 1, enable periodic PC sample packets
63*4882a593Smuzhiyun
64*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-itm/itm_tcr
65*4882a593SmuzhiyunDescription:
66*4882a593Smuzhiyun        Coresight Source ITM configuration:
67*4882a593Smuzhiyun            [0] = 1, Enable ITM
68*4882a593Smuzhiyun            [1] = 1, Enable Time stamp generation
69*4882a593Smuzhiyun            [2] = 1, Enable sync packet transmission
70*4882a593Smuzhiyun            [3] = 1, Enable HW event forwarding
71*4882a593Smuzhiyun            [11:10] = 1, Generate TS request approx every 128 cycles
72*4882a593Smuzhiyun            [22:16] = 1, Trace bus ID
73*4882a593Smuzhiyun
74*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-ela/enable_source
75*4882a593SmuzhiyunDescription:
76*4882a593Smuzhiyun        Attribute used to enable Coresight Source ELA.
77*4882a593Smuzhiyun
78*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-ela/is_enabled
79*4882a593SmuzhiyunDescription:
80*4882a593Smuzhiyun        Attribute used to check if Coresight Source ELA is enabled.
81*4882a593Smuzhiyun
82*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-ela/select
83*4882a593SmuzhiyunDescription:
84*4882a593Smuzhiyun        Coresight Source ELA select trace mode:
85*4882a593Smuzhiyun            [0], NONE
86*4882a593Smuzhiyun            [1], JCN
87*4882a593Smuzhiyun            [2], CEU_EXEC
88*4882a593Smuzhiyun            [3], CEU_CMDS
89*4882a593Smuzhiyun            [4], MCU_AHBP
90*4882a593Smuzhiyun            [5], HOST_AXI
91*4882a593Smuzhiyun            [6], NR_TRACEMODE
92*4882a593Smuzhiyun
93*4882a593Smuzhiyun        Refer to specification for more details.
94*4882a593Smuzhiyun
95*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-ela/sigmask0
96*4882a593SmuzhiyunDescription:
97*4882a593Smuzhiyun        Coresight Source ELA SIGMASK0 register set/get.
98*4882a593Smuzhiyun        Refer to specification for more details.
99*4882a593Smuzhiyun
100*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-ela/sigmask4
101*4882a593SmuzhiyunDescription:
102*4882a593Smuzhiyun        Coresight Source ELA SIGMASK4 register set/get.
103*4882a593Smuzhiyun        Refer to specification for more details.
104*4882a593Smuzhiyun
105*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-ela/sigcomp0
106*4882a593SmuzhiyunDescription:
107*4882a593Smuzhiyun        Coresight Source ELA SIGCOMP0 register set/get.
108*4882a593Smuzhiyun        Refer to specification for more details.
109*4882a593Smuzhiyun
110*4882a593SmuzhiyunWhat:		/sys/bus/coresight/devices/mali-source-ela/sigcomp4
111*4882a593SmuzhiyunDescription:
112*4882a593Smuzhiyun        Coresight Source ELA SIGCOMP4 register set/get.
113*4882a593Smuzhiyun        Refer to specification for more details.
114