← Documents Documentation/ABI/testing/sysfs-bus-coresight-devices-cti GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

CoreSight CTI device sysfs ABI

CoreSight Cross Trigger Interface의 enable·power·CTM identity, connected trigger metadata, CTI registers, CTM channel attachment·gate·pulse·filter·inspection과 hardware context label을 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-bus-coresight-devices-cti
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

CTI control, power와 CTM identity

sysfs-bus-coresight-devices-cti:1-23

enable은 CTI hardware를 제어하고 powered·ctmid·nr_trigger_cons는 power state, associated CTM ID와 connected-trigger device 수를 제공합니다.

Connected trigger signals와 types

sysfs-bus-coresight-devices-cti:25-55

triggers<N>은 connected device name과 CTI input·output trigger signal numbers 및 functional types를 읽게 합니다.

Input/output mapping과 control registers

sysfs-bus-coresight-devices-cti:57-85

inout_sel이 CTIINEN·CTIOUTEN index를 선택하고 inen·outen·gate·asicctl이 corresponding registers를 read/write합니다.

Application channel control과 status registers

sysfs-bus-coresight-devices-cti:87-135

INTACK, APPSET·APPCLEAR·APPPULSE가 interrupt acknowledge와 channel activation을 제어하고 channel·trigger input/output status files가 current signals를 보고합니다.

Trigger attachment와 channel gates

sysfs-bus-coresight-devices-cti:137-172

Input·output triggers를 CTM channels에 attach/detach하고 channel별 CTIGATE를 enable·disable합니다.

Channel activation, filtering과 allocation state

sysfs-bus-coresight-devices-cti:174-214

Channel set·clear·single-cycle pulse, trigger output filtering, attached-trigger 기준 in-use/free channel lists를 제공합니다.

Selected-channel inspection, reset과 device label

sysfs-bus-coresight-devices-cti:216-247

chan_xtrigs_*는 selected channel의 input/output triggers를 조사하고 programming을 reset하며 label은 device hardware context information을 보여 줍니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 What: /sys/bus/coresight/devices/<cti-name>/enable
2 Date: March 2020
3 KernelVersion: 5.7
4 Contact: Mike Leach or Mathieu Poirier
5 Description: (RW) Enable/Disable the CTI hardware.
6
7 What: /sys/bus/coresight/devices/<cti-name>/powered
8 Date: March 2020
9 KernelVersion: 5.7
10 Contact: Mike Leach or Mathieu Poirier
11 Description: (Read) Indicate if the CTI hardware is powered.
12
13 What: /sys/bus/coresight/devices/<cti-name>/ctmid
14 Date: March 2020
15 KernelVersion: 5.7
16 Contact: Mike Leach or Mathieu Poirier
17 Description: (Read) Display the associated CTM ID
18
19 What: /sys/bus/coresight/devices/<cti-name>/nr_trigger_cons
20 Date: March 2020
21 KernelVersion: 5.7
22 Contact: Mike Leach or Mathieu Poirier
23 Description: (Read) Number of devices connected to triggers on this CTI
24
25 What: /sys/bus/coresight/devices/<cti-name>/triggers<N>/name
26 Date: March 2020
27 KernelVersion: 5.7
28 Contact: Mike Leach or Mathieu Poirier
29 Description: (Read) Name of connected device <N>
30
31 What: /sys/bus/coresight/devices/<cti-name>/triggers<N>/in_signals
32 Date: March 2020
33 KernelVersion: 5.7
34 Contact: Mike Leach or Mathieu Poirier
35 Description: (Read) Input trigger signals from connected device <N>
36
37 What: /sys/bus/coresight/devices/<cti-name>/triggers<N>/in_types
38 Date: March 2020
39 KernelVersion: 5.7
40 Contact: Mike Leach or Mathieu Poirier
41 Description: (Read) Functional types for the input trigger signals
42 from connected device <N>
43
44 What: /sys/bus/coresight/devices/<cti-name>/triggers<N>/out_signals
45 Date: March 2020
46 KernelVersion: 5.7
47 Contact: Mike Leach or Mathieu Poirier
48 Description: (Read) Output trigger signals to connected device <N>
49
50 What: /sys/bus/coresight/devices/<cti-name>/triggers<N>/out_types
51 Date: March 2020
52 KernelVersion: 5.7
53 Contact: Mike Leach or Mathieu Poirier
54 Description: (Read) Functional types for the output trigger signals
55 to connected device <N>
56
57 What: /sys/bus/coresight/devices/<cti-name>/regs/inout_sel
58 Date: March 2020
59 KernelVersion: 5.7
60 Contact: Mike Leach or Mathieu Poirier
61 Description: (RW) Select the index for inen and outen registers.
62
63 What: /sys/bus/coresight/devices/<cti-name>/regs/inen
64 Date: March 2020
65 KernelVersion: 5.7
66 Contact: Mike Leach or Mathieu Poirier
67 Description: (RW) Read or write the CTIINEN register selected by inout_sel.
68
69 What: /sys/bus/coresight/devices/<cti-name>/regs/outen
70 Date: March 2020
71 KernelVersion: 5.7
72 Contact: Mike Leach or Mathieu Poirier
73 Description: (RW) Read or write the CTIOUTEN register selected by inout_sel.
74
75 What: /sys/bus/coresight/devices/<cti-name>/regs/gate
76 Date: March 2020
77 KernelVersion: 5.7
78 Contact: Mike Leach or Mathieu Poirier
79 Description: (RW) Read or write CTIGATE register.
80
81 What: /sys/bus/coresight/devices/<cti-name>/regs/asicctl
82 Date: March 2020
83 KernelVersion: 5.7
84 Contact: Mike Leach or Mathieu Poirier
85 Description: (RW) Read or write ASICCTL register.
86
87 What: /sys/bus/coresight/devices/<cti-name>/regs/intack
88 Date: March 2020
89 KernelVersion: 5.7
90 Contact: Mike Leach or Mathieu Poirier
91 Description: (Write) Write the INTACK register.
92
93 What: /sys/bus/coresight/devices/<cti-name>/regs/appset
94 Date: March 2020
95 KernelVersion: 5.7
96 Contact: Mike Leach or Mathieu Poirier
97 Description: (RW) Set CTIAPPSET register to activate channel. Read back to
98 determine current value of register.
99
100 What: /sys/bus/coresight/devices/<cti-name>/regs/appclear
101 Date: March 2020
102 KernelVersion: 5.7
103 Contact: Mike Leach or Mathieu Poirier
104 Description: (Write) Write APPCLEAR register to deactivate channel.
105
106 What: /sys/bus/coresight/devices/<cti-name>/regs/apppulse
107 Date: March 2020
108 KernelVersion: 5.7
109 Contact: Mike Leach or Mathieu Poirier
110 Description: (Write) Write APPPULSE to pulse a channel active for one clock
111 cycle.
112
113 What: /sys/bus/coresight/devices/<cti-name>/regs/chinstatus
114 Date: March 2020
115 KernelVersion: 5.7
116 Contact: Mike Leach or Mathieu Poirier
117 Description: (Read) Read current status of channel inputs.
118
119 What: /sys/bus/coresight/devices/<cti-name>/regs/choutstatus
120 Date: March 2020
121 KernelVersion: 5.7
122 Contact: Mike Leach or Mathieu Poirier
123 Description: (Read) read current status of channel outputs.
124
125 What: /sys/bus/coresight/devices/<cti-name>/regs/triginstatus
126 Date: March 2020
127 KernelVersion: 5.7
128 Contact: Mike Leach or Mathieu Poirier
129 Description: (Read) read current status of input trigger signals
130
131 What: /sys/bus/coresight/devices/<cti-name>/regs/trigoutstatus
132 Date: March 2020
133 KernelVersion: 5.7
134 Contact: Mike Leach or Mathieu Poirier
135 Description: (Read) read current status of output trigger signals.
136
137 What: /sys/bus/coresight/devices/<cti-name>/channels/trigin_attach
138 Date: March 2020
139 KernelVersion: 5.7
140 Contact: Mike Leach or Mathieu Poirier
141 Description: (Write) Attach a CTI input trigger to a CTM channel.
142
143 What: /sys/bus/coresight/devices/<cti-name>/channels/trigin_detach
144 Date: March 2020
145 KernelVersion: 5.7
146 Contact: Mike Leach or Mathieu Poirier
147 Description: (Write) Detach a CTI input trigger from a CTM channel.
148
149 What: /sys/bus/coresight/devices/<cti-name>/channels/trigout_attach
150 Date: March 2020
151 KernelVersion: 5.7
152 Contact: Mike Leach or Mathieu Poirier
153 Description: (Write) Attach a CTI output trigger to a CTM channel.
154
155 What: /sys/bus/coresight/devices/<cti-name>/channels/trigout_detach
156 Date: March 2020
157 KernelVersion: 5.7
158 Contact: Mike Leach or Mathieu Poirier
159 Description: (Write) Detach a CTI output trigger from a CTM channel.
160
161 What: /sys/bus/coresight/devices/<cti-name>/channels/chan_gate_enable
162 Date: March 2020
163 KernelVersion: 5.7
164 Contact: Mike Leach or Mathieu Poirier
165 Description: (RW) Enable CTIGATE for single channel (Write) or list enabled
166 channels through the gate (R).
167
168 What: /sys/bus/coresight/devices/<cti-name>/channels/chan_gate_disable
169 Date: March 2020
170 KernelVersion: 5.7
171 Contact: Mike Leach or Mathieu Poirier
172 Description: (Write) Disable CTIGATE for single channel.
173
174 What: /sys/bus/coresight/devices/<cti-name>/channels/chan_set
175 Date: March 2020
176 KernelVersion: 5.7
177 Contact: Mike Leach or Mathieu Poirier
178 Description: (Write) Activate a single channel.
179
180 What: /sys/bus/coresight/devices/<cti-name>/channels/chan_clear
181 Date: March 2020
182 KernelVersion: 5.7
183 Contact: Mike Leach or Mathieu Poirier
184 Description: (Write) Deactivate a single channel.
185
186 What: /sys/bus/coresight/devices/<cti-name>/channels/chan_pulse
187 Date: March 2020
188 KernelVersion: 5.7
189 Contact: Mike Leach or Mathieu Poirier
190 Description: (Write) Pulse a single channel - activate for a single clock cycle.
191
192 What: /sys/bus/coresight/devices/<cti-name>/channels/trigout_filtered
193 Date: March 2020
194 KernelVersion: 5.7
195 Contact: Mike Leach or Mathieu Poirier
196 Description: (Read) List of output triggers filtered across all connections.
197
198 What: /sys/bus/coresight/devices/<cti-name>/channels/trig_filter_enable
199 Date: March 2020
200 KernelVersion: 5.7
201 Contact: Mike Leach or Mathieu Poirier
202 Description: (RW) Enable or disable trigger output signal filtering.
203
204 What: /sys/bus/coresight/devices/<cti-name>/channels/chan_inuse
205 Date: March 2020
206 KernelVersion: 5.7
207 Contact: Mike Leach or Mathieu Poirier
208 Description: (Read) show channels with at least one attached trigger signal.
209
210 What: /sys/bus/coresight/devices/<cti-name>/channels/chan_free
211 Date: March 2020
212 KernelVersion: 5.7
213 Contact: Mike Leach or Mathieu Poirier
214 Description: (Read) show channels with no attached trigger signals.
215
216 What: /sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_sel
217 Date: March 2020
218 KernelVersion: 5.7
219 Contact: Mike Leach or Mathieu Poirier
220 Description: (RW) Write channel number to select a channel to view, read to
221 see selected channel number.
222
223 What: /sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_in
224 Date: March 2020
225 KernelVersion: 5.7
226 Contact: Mike Leach or Mathieu Poirier
227 Description: (Read) Read to see input triggers connected to selected view
228 channel.
229
230 What: /sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_out
231 Date: March 2020
232 KernelVersion: 5.7
233 Contact: Mike Leach or Mathieu Poirier
234 Description: (Read) Read to see output triggers connected to selected view
235 channel.
236
237 What: /sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_reset
238 Date: March 2020
239 KernelVersion: 5.7
240 Contact: Mike Leach or Mathieu Poirier
241 Description: (Write) Clear all channel / trigger programming.
242
243 What: /sys/bus/coresight/devices/<cti-name>/label
244 Date: Aug 2025
245 KernelVersion 6.18
246 Contact: Mao Jinlong <quic_jinlmao@quicinc.com>
247 Description: (Read) Show hardware context information of device.
248

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

CTI hardware control과 identity

1-23
공통 항목내용
Date2020년 3월
KernelVersion5.7
ContactMike Leach 또는 Mathieu Poirier
적용 범위별도 metadata가 명시된 label을 제외한 lines 1-241의 모든 CTI attributes
WhatAccess전문 번역
/sys/bus/coresight/devices/<cti-name>/enableRWCTI hardware를 enable 또는 disable합니다.
/sys/bus/coresight/devices/<cti-name>/poweredReadCTI hardware에 power가 공급되는지 나타냅니다.
/sys/bus/coresight/devices/<cti-name>/ctmidRead연결된 CTM ID를 표시합니다.
/sys/bus/coresight/devices/<cti-name>/nr_trigger_consRead이 CTI의 triggers에 연결된 device 수입니다.

Connected devices와 trigger metadata

25-55
WhatAccess전문 번역
/sys/bus/coresight/devices/<cti-name>/triggers<N>/nameReadConnected device <N>의 name입니다.
/sys/bus/coresight/devices/<cti-name>/triggers<N>/in_signalsReadConnected device <N>에서 들어오는 input trigger signals입니다.
/sys/bus/coresight/devices/<cti-name>/triggers<N>/in_typesReadConnected device <N>에서 들어오는 input trigger signals의 functional types입니다.
/sys/bus/coresight/devices/<cti-name>/triggers<N>/out_signalsReadConnected device <N>으로 나가는 output trigger signals입니다.
/sys/bus/coresight/devices/<cti-name>/triggers<N>/out_typesReadConnected device <N>으로 나가는 output trigger signals의 functional types입니다.
CoreSight CTI trigger routing
Connected device N input triggerCTI triginCTM channelCTI trigoutConnected device M output trigger
triggers<N>/in_signals and in_typesInput connection metadata
triggers<N>/out_signals and out_typesOutput connection metadata

Connected device의 input trigger가 CTM channel에 mapping되고 CTI output trigger로 다른 device에 전달되는 기본 구조다.

CTI mapping, gate와 ASIC registers

57-85
WhatAccess전문 번역
/sys/bus/coresight/devices/<cti-name>/regs/inout_selRWinen과 outen registers에 사용할 index를 선택합니다.
/sys/bus/coresight/devices/<cti-name>/regs/inenRWinout_sel이 선택한 CTIINEN register를 읽거나 씁니다.
/sys/bus/coresight/devices/<cti-name>/regs/outenRWinout_sel이 선택한 CTIOUTEN register를 읽거나 씁니다.
/sys/bus/coresight/devices/<cti-name>/regs/gateRWCTIGATE register를 읽거나 씁니다.
/sys/bus/coresight/devices/<cti-name>/regs/asicctlRWASICCTL register를 읽거나 씁니다.
Indexed CTIINEN and CTIOUTEN access
Write index to inout_selRead or write inenSelected CTIINEN register
Write index to inout_selRead or write outenSelected CTIOUTEN register
gateCTIGATE register
asicctlASICCTL register

inout_sel로 register index를 고른 뒤 같은 inen·outen files를 통해 selected mapping register에 접근한다.

Application channel control과 signal status

87-135
WhatAccess전문 번역
/sys/bus/coresight/devices/<cti-name>/regs/intackWriteINTACK register에 씁니다.
/sys/bus/coresight/devices/<cti-name>/regs/appsetRWCTIAPPSET register를 set하여 channel을 activate합니다. Read-back으로 current register value를 확인합니다.
/sys/bus/coresight/devices/<cti-name>/regs/appclearWriteAPPCLEAR register에 써서 channel을 deactivate합니다.
/sys/bus/coresight/devices/<cti-name>/regs/apppulseWriteAPPPULSE에 써서 channel을 한 clock cycle 동안 active로 pulse합니다.
/sys/bus/coresight/devices/<cti-name>/regs/chinstatusReadChannel inputs의 current status를 읽습니다.
/sys/bus/coresight/devices/<cti-name>/regs/choutstatusReadChannel outputs의 current status를 읽습니다.
/sys/bus/coresight/devices/<cti-name>/regs/triginstatusReadInput trigger signals의 current status를 읽습니다.
/sys/bus/coresight/devices/<cti-name>/regs/trigoutstatusReadOutput trigger signals의 current status를 읽습니다.
OperationRegisterChannel effect
SetCTIAPPSETChannel activate
ClearAPPCLEARChannel deactivate
PulseAPPPULSE한 clock cycle 동안 activate

CTM channel trigger attachment와 gating

137-172
WhatAccess전문 번역
/sys/bus/coresight/devices/<cti-name>/channels/trigin_attachWriteCTI input trigger를 CTM channel에 attach합니다.
/sys/bus/coresight/devices/<cti-name>/channels/trigin_detachWriteCTI input trigger를 CTM channel에서 detach합니다.
/sys/bus/coresight/devices/<cti-name>/channels/trigout_attachWriteCTI output trigger를 CTM channel에 attach합니다.
/sys/bus/coresight/devices/<cti-name>/channels/trigout_detachWriteCTI output trigger를 CTM channel에서 detach합니다.
/sys/bus/coresight/devices/<cti-name>/channels/chan_gate_enableRWWrite 시 single channel에 CTIGATE를 enable하고, read 시 gate를 통해 enable된 channels를 나열합니다.
/sys/bus/coresight/devices/<cti-name>/channels/chan_gate_disableWriteSingle channel의 CTIGATE를 disable합니다.

Channel control, output filtering과 allocation

174-214
WhatAccess전문 번역
/sys/bus/coresight/devices/<cti-name>/channels/chan_setWriteSingle channel을 activate합니다.
/sys/bus/coresight/devices/<cti-name>/channels/chan_clearWriteSingle channel을 deactivate합니다.
/sys/bus/coresight/devices/<cti-name>/channels/chan_pulseWriteSingle channel을 pulse하여 한 clock cycle 동안 activate합니다.
/sys/bus/coresight/devices/<cti-name>/channels/trigout_filteredRead모든 connection에 걸쳐 filtered된 output triggers 목록입니다.
/sys/bus/coresight/devices/<cti-name>/channels/trig_filter_enableRWTrigger output signal filtering을 enable 또는 disable합니다.
/sys/bus/coresight/devices/<cti-name>/channels/chan_inuseReadAttached trigger signal이 하나 이상 있는 channels를 보여 줍니다.
/sys/bus/coresight/devices/<cti-name>/channels/chan_freeReadAttached trigger signal이 없는 channels를 보여 줍니다.

Channel trigger inspection, reset과 context label

216-247
WhatAccess전문 번역
/sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_selRW살펴볼 channel을 선택하려면 channel number를 씁니다. Read하면 selected channel number를 확인할 수 있습니다.
/sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_inReadSelected view channel에 연결된 input triggers를 확인합니다.
/sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_outReadSelected view channel에 연결된 output triggers를 확인합니다.
/sys/bus/coresight/devices/<cti-name>/channels/chan_xtrigs_resetWrite모든 channel/trigger programming을 clear합니다.
항목전문 번역
What/sys/bus/coresight/devices/<cti-name>/label
Date2025년 8월
KernelVersion6.18
ContactMao Jinlong <quic_jinlmao@quicinc.com>
Description(Read) Device의 hardware context information을 보여 줍니다.
Selected CTI channel inspection
Write channel numberchan_xtrigs_selRead chan_xtrigs_inSelected input triggers
Write channel numberchan_xtrigs_selRead chan_xtrigs_outSelected output triggers
Write chan_xtrigs_resetClear all channel and trigger programming
Read labelDevice hardware context information

Channel number를 selector에 쓴 뒤 connected input/output triggers를 별도 files로 읽고 필요하면 programming 전체를 reset한다.