← Documents Documentation/ABI/testing/debugfs-scmi GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

SCMI instance와 transport debugfs ABI

SCMI instance의 DT 기반 이름과 atomic latency threshold, transport type·atomic capability·reply timeout·message size·TX/RX concurrency limits를 노출하는 debugfs ABI를 설명합니다.

Source pathDocumentation/ABI/testing/debugfs-scmi
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

SCMI instance identity와 atomic threshold

debugfs-scmi:1-20

instance_name은 SCMI instance가 속한 최상위 DT SCMI node의 full name이며, atomic_threshold_us보다 실행 latency가 큰 command는 요청되더라도 atomic mode 대상으로 보지 않습니다.

Transport type과 operation limits

debugfs-scmi:22-70

transport subtree는 type, atomic 지원 여부, synchronous reply timeout, 최대 message size, TX·RX channel의 최대 concurrent in-flight message 수를 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 What: /sys/kernel/debug/scmi/<n>/instance_name
2 Date: March 2023
3 KernelVersion: 6.3
5 Description: The name of the underlying SCMI instance <n> described by
6 all the debugfs accessors rooted at /sys/kernel/debug/scmi/<n>,
7 expressed as the full name of the top DT SCMI node under which
8 this SCMI instance is rooted.
9 Users: Debugging, any userspace test suite
10
11 What: /sys/kernel/debug/scmi/<n>/atomic_threshold_us
12 Date: March 2023
13 KernelVersion: 6.3
15 Description: An optional time value, expressed in microseconds, representing,
16 on this SCMI instance <n>, the threshold above which any SCMI
17 command, advertised to have an higher-than-threshold execution
18 latency, should not be considered for atomic mode of operation,
19 even if requested.
20 Users: Debugging, any userspace test suite
21
22 What: /sys/kernel/debug/scmi/<n>/transport/type
23 Date: March 2023
24 KernelVersion: 6.3
26 Description: A string representing the type of transport configured for this
27 SCMI instance <n>.
28 Users: Debugging, any userspace test suite
29
30 What: /sys/kernel/debug/scmi/<n>/transport/is_atomic
31 Date: March 2023
32 KernelVersion: 6.3
34 Description: A boolean stating if the transport configured on the underlying
35 SCMI instance <n> is capable of atomic mode of operation.
36 Users: Debugging, any userspace test suite
37
38 What: /sys/kernel/debug/scmi/<n>/transport/max_rx_timeout_ms
39 Date: March 2023
40 KernelVersion: 6.3
42 Description: Timeout in milliseconds allowed for SCMI synchronous replies
43 for the currently configured SCMI transport for instance <n>.
44 Users: Debugging, any userspace test suite
45
46 What: /sys/kernel/debug/scmi/<n>/transport/max_msg_size
47 Date: March 2023
48 KernelVersion: 6.3
50 Description: Max message size of allowed SCMI messages for the currently
51 configured SCMI transport for instance <n>.
52 Users: Debugging, any userspace test suite
53
54 What: /sys/kernel/debug/scmi/<n>/transport/tx_max_msg
55 Date: March 2023
56 KernelVersion: 6.3
58 Description: Max number of concurrently allowed in-flight SCMI messages for
59 the currently configured SCMI transport for instance <n> on the
60 TX channels.
61 Users: Debugging, any userspace test suite
62
63 What: /sys/kernel/debug/scmi/<n>/transport/rx_max_msg
64 Date: March 2023
65 KernelVersion: 6.3
67 Description: Max number of concurrently allowed in-flight SCMI messages for
68 the currently configured SCMI transport for instance <n> on the
69 RX channels.
70 Users: Debugging, any userspace test suite
71

3. 한국어 전문 번역

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

SCMI instance 이름과 atomic threshold

1-20
What전문 번역
/sys/kernel/debug/scmi/<n>/instance_name/sys/kernel/debug/scmi/<n> 아래에 뿌리를 둔 모든 debugfs accessor가 설명하는 기반 SCMI instance <n>의 이름입니다. 이 SCMI instance가 속한 최상위 DT SCMI node의 full name으로 표현합니다.
/sys/kernel/debug/scmi/<n>/atomic_threshold_usMicroseconds 단위의 선택적 시간 값입니다. 이 SCMI instance <n>에서 advertise된 execution latency가 이 threshold보다 큰 SCMI command는 요청되더라도 atomic operation mode 대상으로 간주하지 않아야 합니다.
공통 항목내용
Date2023년 3월
KernelVersion6.3
Contact[email protected]
UsersDebugging, 모든 userspace test suite

SCMI transport 구성과 한계

22-70
What전문 번역
/sys/kernel/debug/scmi/<n>/transport/type이 SCMI instance <n>에 구성된 transport type을 나타내는 문자열입니다.
/sys/kernel/debug/scmi/<n>/transport/is_atomic기반 SCMI instance <n>에 구성된 transport가 atomic operation mode를 수행할 수 있는지 나타내는 boolean입니다.
/sys/kernel/debug/scmi/<n>/transport/max_rx_timeout_msInstance <n>에 현재 구성된 SCMI transport에서 synchronous reply에 허용되는 milliseconds 단위 timeout입니다.
/sys/kernel/debug/scmi/<n>/transport/max_msg_size현재 구성된 SCMI transport가 허용하는 SCMI message의 최대 크기입니다.
/sys/kernel/debug/scmi/<n>/transport/tx_max_msg현재 구성된 SCMI transport에서 instance <n>의 TX channel에 동시에 허용되는 in-flight SCMI message의 최대 수입니다.
/sys/kernel/debug/scmi/<n>/transport/rx_max_msg현재 구성된 SCMI transport에서 instance <n>의 RX channel에 동시에 허용되는 in-flight SCMI message의 최대 수입니다.
공통 항목내용
Date2023년 3월
KernelVersion6.3
Contact[email protected]
UsersDebugging, 모든 userspace test suite
SCMI atomic 판단과 transport 한계
SCMI command advertised latencyCompare with atomic_threshold_usAt or below threshold and transport is_atomicAtomic mode candidate
Latency above thresholdAtomic mode excluded even when requested
Configured transport typemax_msg_sizetx_max_msg and rx_max_msgmax_rx_timeout_ms

Instance의 atomic threshold와 transport capability를 함께 확인하고 message size·concurrency·timeout 범위 안에서 통신한다.