요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
HW-event bank와 enable register
sysfs-bus-coresight-devices-stm:11-24hwevent_select는 STMHEBSR의 HW-event block을 선택하고 hwevent_enable은 선택된 bank의 event enable register를 제어하여 최대 256개 channel을 구성합니다.
Stimulus-port bank와 enable register
sysfs-bus-coresight-devices-stm:26-39port_select는 STMSPER의 stimulus-port bits가 적용될 bank를 선택하고 port_enable은 해당 stimulus ports를 enable합니다.
Status와 trace ID
sysfs-bus-coresight-devices-stm:41-53status는 driver-specific control/status registers를 나열하고 traceid는 STM trace stream에 나타날 trace ID를 보관합니다.
Hardware context label
sysfs-bus-coresight-devices-stm:55-59label은 STM device의 hardware context information을 보여 줍니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/coresight/devices/<memory_map>.stm/enable_source
2
Date: April 2016
3
KernelVersion: 4.7
4
Contact: Mathieu Poirier <mathieu.poirier@linaro.org>
5
Description: (RW) Enable/disable tracing on this specific trace macrocell.
6
Enabling the trace macrocell implies it has been configured
7
properly and a sink has been identified for it. The path
8
of coresight components linking the source to the sink is
9
configured and managed automatically by the coresight framework.
11
What: /sys/bus/coresight/devices/<memory_map>.stm/hwevent_enable
12
Date: April 2016
13
KernelVersion: 4.7
14
Contact: Mathieu Poirier <mathieu.poirier@linaro.org>
15
Description: (RW) Provides access to the HW event enable register, used in
16
conjunction with HW event bank select register.
18
What: /sys/bus/coresight/devices/<memory_map>.stm/hwevent_select
19
Date: April 2016
20
KernelVersion: 4.7
21
Contact: Mathieu Poirier <mathieu.poirier@linaro.org>
22
Description: (RW) Gives access to the HW event block select register
23
(STMHEBSR) in order to configure up to 256 channels. Used in
24
conjunction with "hwevent_enable" register as described above.
26
What: /sys/bus/coresight/devices/<memory_map>.stm/port_enable
27
Date: April 2016
28
KernelVersion: 4.7
29
Contact: Mathieu Poirier <mathieu.poirier@linaro.org>
30
Description: (RW) Provides access to the stimulus port enable register
31
(STMSPER). Used in conjunction with "port_select" described
32
below.
34
What: /sys/bus/coresight/devices/<memory_map>.stm/port_select
35
Date: April 2016
36
KernelVersion: 4.7
37
Contact: Mathieu Poirier <mathieu.poirier@linaro.org>
38
Description: (RW) Used to determine which bank of stimulus port bit in
39
register STMSPER (see above) apply to.
41
What: /sys/bus/coresight/devices/<memory_map>.stm/status
42
Date: April 2016
43
KernelVersion: 4.7
44
Contact: Mathieu Poirier <mathieu.poirier@linaro.org>
45
Description: (Read) List various control and status registers. The specific
46
layout and content is driver specific.
48
What: /sys/bus/coresight/devices/<memory_map>.stm/traceid
49
Date: April 2016
50
KernelVersion: 4.7
51
Contact: Mathieu Poirier <mathieu.poirier@linaro.org>
52
Description: (RW) Holds the trace ID that will appear in the trace stream
53
coming from this trace entity.
55
What: /sys/bus/coresight/devices/<memory_map>.stm/label
56
Date: Aug 2025
57
KernelVersion 6.18
58
Contact: Mao Jinlong <quic_jinlmao@quicinc.com>
59
Description: (Read) Show hardware context information of device.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
STM trace source control
1-9| 항목 | 전문 번역 |
|---|---|
| What | /sys/bus/coresight/devices/<memory_map>.stm/enable_source |
| Date | 2016년 4월 |
| KernelVersion | 4.7 |
| Contact | Mathieu Poirier <mathieu.poirier@linaro.org> |
| Description | (RW) 이 특정 trace macrocell에서 tracing을 enable/disable합니다. Trace macrocell을 enable한다는 것은 올바르게 구성되었고 사용할 sink가 식별되었음을 전제로 합니다. Source와 sink를 연결하는 CoreSight components의 path는 CoreSight framework가 자동으로 구성하고 관리합니다. |
STM hardware-event channels
11-24| Attribute | 공통 metadata | 전문 번역 |
|---|---|---|
| hwevent_enable | 2016년 4월 / Linux 4.7 / Mathieu Poirier <mathieu.poirier@linaro.org> | (RW) HW event enable register에 대한 access를 제공합니다. HW event bank select register와 함께 사용합니다. |
| hwevent_select | 2016년 4월 / Linux 4.7 / Mathieu Poirier <mathieu.poirier@linaro.org> | (RW) 최대 256개 channel을 구성할 수 있도록 HW event block select register(STMHEBSR)에 대한 access를 제공합니다. 위에서 설명한 hwevent_enable register와 함께 사용합니다. |
두 attribute의 전체 path는 각각 /sys/bus/coresight/devices/<memory_map>.stm/hwevent_enable 및 /sys/bus/coresight/devices/<memory_map>.stm/hwevent_select입니다.
STM stimulus-port selection
26-39| Attribute | 공통 metadata | 전문 번역 |
|---|---|---|
| port_enable | 2016년 4월 / Linux 4.7 / Mathieu Poirier <mathieu.poirier@linaro.org> | (RW) Stimulus port enable register(STMSPER)에 대한 access를 제공합니다. 아래에서 설명하는 port_select와 함께 사용합니다. |
| port_select | 2016년 4월 / Linux 4.7 / Mathieu Poirier <mathieu.poirier@linaro.org> | (RW) 위 STMSPER register의 stimulus port bit가 적용될 bank를 결정하는 데 사용합니다. |
두 attribute의 전체 path는 각각 /sys/bus/coresight/devices/<memory_map>.stm/port_enable 및 /sys/bus/coresight/devices/<memory_map>.stm/port_select입니다.
HW-event channel bank→hwevent_select (STMHEBSR)→hwevent_enable→Up to 256 HW-event channels
Stimulus-port bank→port_select→port_enable (STMSPER)→Enabled stimulus ports
HW-event와 stimulus-port 설정은 먼저 대상 bank를 선택한 뒤 해당 enable register의 bits를 적용합니다.
STM status와 trace identity
41-53| Attribute | 공통 metadata | 전문 번역 |
|---|---|---|
| status | 2016년 4월 / Linux 4.7 / Mathieu Poirier <mathieu.poirier@linaro.org> | (Read) 여러 control 및 status registers를 나열합니다. 구체적인 layout과 content는 driver-specific입니다. |
| traceid | 2016년 4월 / Linux 4.7 / Mathieu Poirier <mathieu.poirier@linaro.org> | (RW) 이 trace entity에서 나오는 trace stream에 나타날 trace ID를 보관합니다. |
두 attribute의 전체 path는 각각 /sys/bus/coresight/devices/<memory_map>.stm/status 및 /sys/bus/coresight/devices/<memory_map>.stm/traceid입니다.
STM hardware context
55-59| 항목 | 전문 번역 |
|---|---|
| What | /sys/bus/coresight/devices/<memory_map>.stm/label |
| Date | 2025년 8월 |
| KernelVersion | 6.18 |
| Contact | Mao Jinlong <quic_jinlmao@quicinc.com> |
| Description | (Read) Device의 hardware context information을 보여 줍니다. |
Trace source enable과 CoreSight path
sysfs-bus-coresight-devices-stm:1-9enable_source는 STM tracing을 enable/disable하며, enable 시 CoreSight framework가 미리 식별된 sink까지의 component path를 자동으로 구성하고 관리합니다.