summaryrefslogtreecommitdiffstats
path: root/Documentation/ABI/testing/sysfs-bus-coresight-devices-tpdm
blob: bf710ea6e0efc5fa0081cddcca1974b383fc1117 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
What:		/sys/bus/coresight/devices/<tpdm-name>/integration_test
Date:		January 2023
KernelVersion	6.2
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(Write) Run integration test for tpdm. Integration test
		will generate test data for tpdm. It can help to make
		sure that the trace path is enabled and the link configurations
		are fine.

		Accepts only one of the 2 values -  1 or 2.
		1 : Generate 64 bits data
		2 : Generate 32 bits data

What:		/sys/bus/coresight/devices/<tpdm-name>/reset_dataset
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(Write) Reset the dataset of the tpdm.

		Accepts only one value -  1.
		1 : Reset the dataset of the tpdm

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_trig_type
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the trigger type of the DSB for tpdm.

		Accepts only one of the 2 values -  0 or 1.
		0 : Set the DSB trigger type to false
		1 : Set the DSB trigger type to true

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_trig_ts
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the trigger timestamp of the DSB for tpdm.

		Accepts only one of the 2 values -  0 or 1.
		0 : Set the DSB trigger type to false
		1 : Set the DSB trigger type to true

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_mode
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the programming mode of the DSB for tpdm.

		Accepts the value needs to be greater than 0. What data
		bits do is listed below.
		Bit[0:1] : Test mode control bit for choosing the inputs.
		Bit[3] : Set to 0 for low performance mode. Set to 1 for high
		performance mode.
		Bit[4:8] : Select byte lane for high performance mode.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/ctrl_idx
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the index number of the edge detection for the DSB
		subunit TPDM. Since there are at most 256 edge detections, this
		value ranges from 0 to 255.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/ctrl_val
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		Write a data to control the edge detection corresponding to
		the index number. Before writing data to this sysfs file,
		"ctrl_idx" should be written first to configure the index
		number of the edge detection which needs to be controlled.

		Accepts only one of the following values.
		0 - Rising edge detection
		1 - Falling edge detection
		2 - Rising and falling edge detection (toggle detection)


What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/ctrl_mask
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		Write a data to mask the edge detection corresponding to the index
		number. Before writing data to this sysfs file, "ctrl_idx" should
		be written first to configure the index number of the edge detection
		which needs to be masked.

		Accepts only one of the 2 values -  0 or 1.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/edcr[0:15]
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		Read a set of the edge control value of the DSB in TPDM.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_edge/edcmr[0:7]
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		Read a set of the edge control mask of the DSB in TPDM.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_trig_patt/xpr[0:7]
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the value of the trigger pattern for the DSB
		subunit TPDM.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_trig_patt/xpmr[0:7]
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the mask of the trigger pattern for the DSB
		subunit TPDM.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_patt/tpr[0:7]
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the value of the pattern for the DSB subunit TPDM.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_patt/tpmr[0:7]
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the mask of the pattern for the DSB subunit TPDM.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_patt/enable_ts
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(Write) Set the pattern timestamp of DSB tpdm. Read
		the pattern timestamp of DSB tpdm.

		Accepts only one of the 2 values -  0 or 1.
		0 : Disable DSB pattern timestamp.
		1 : Enable DSB pattern timestamp.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_patt/set_type
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(Write) Set the pattern type of DSB tpdm. Read
		the pattern type of DSB tpdm.

		Accepts only one of the 2 values -  0 or 1.
		0 : Set the DSB pattern type to value.
		1 : Set the DSB pattern type to toggle.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_msr/msr[0:31]
Date:		March 2023
KernelVersion	6.7
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the MSR(mux select register) for the DSB subunit
		TPDM.

What:		/sys/bus/coresight/devices/<tpdm-name>/cmb_mode
Date:		January 2024
KernelVersion	6.9
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:	(Write) Set the data collection mode of CMB tpdm. Continuous
		change creates CMB data set elements on every CMBCLK edge.
		Trace-on-change creates CMB data set elements only when a new
		data set element differs in value from the previous element
		in a CMB data set.

		Accepts only one of the 2 values -  0 or 1.
		0 : Continuous CMB collection mode.
		1 : Trace-on-change CMB collection mode.

What:		/sys/bus/coresight/devices/<tpdm-name>/cmb_trig_patt/xpr[0:1]
Date:		January 2024
KernelVersion	6.9
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the value of the trigger pattern for the CMB
		subunit TPDM.

What:		/sys/bus/coresight/devices/<tpdm-name>/cmb_trig_patt/xpmr[0:1]
Date:		January 2024
KernelVersion	6.9
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the mask of the trigger pattern for the CMB
		subunit TPDM.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_patt/tpr[0:1]
Date:		January 2024
KernelVersion	6.9
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the value of the pattern for the CMB subunit TPDM.

What:		/sys/bus/coresight/devices/<tpdm-name>/dsb_patt/tpmr[0:1]
Date:		January 2024
KernelVersion	6.9
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the mask of the pattern for the CMB subunit TPDM.

What:		/sys/bus/coresight/devices/<tpdm-name>/cmb_patt/enable_ts
Date:		January 2024
KernelVersion	6.9
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(Write) Set the pattern timestamp of CMB tpdm. Read
		the pattern timestamp of CMB tpdm.

		Accepts only one of the 2 values -  0 or 1.
		0 : Disable CMB pattern timestamp.
		1 : Enable CMB pattern timestamp.

What:		/sys/bus/coresight/devices/<tpdm-name>/cmb_trig_ts
Date:		January 2024
KernelVersion	6.9
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the trigger timestamp of the CMB for tpdm.

		Accepts only one of the 2 values -  0 or 1.
		0 : Set the CMB trigger type to false
		1 : Set the CMB trigger type to true

What:		/sys/bus/coresight/devices/<tpdm-name>/cmb_ts_all
Date:		January 2024
KernelVersion	6.9
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Read or write the status of timestamp upon all interface.
		Only value 0 and 1  can be written to this node. Set this node to 1 to request
		timestamp to all trace packet.
		Accepts only one of the 2 values -  0 or 1.
		0 : Disable the timestamp of all trace packets.
		1 : Enable the timestamp of all trace packets.

What:		/sys/bus/coresight/devices/<tpdm-name>/cmb_msr/msr[0:31]
Date:		January 2024
KernelVersion	6.9
Contact:	Jinlong Mao (QUIC) <quic_jinlmao@quicinc.com>, Tao Zhang (QUIC) <quic_taozha@quicinc.com>
Description:
		(RW) Set/Get the MSR(mux select register) for the CMB subunit
		TPDM.