요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Common and vendor-specific identity
sysfs-devices-soc:15-86Read-only attributes는 machine·family와 대부분의 SoC에서 serial_number·soc_id·revision을 제공하며, ST-Ericsson silicon은 manufacturing process도 제공합니다.
JEP106 manufacturer and SoC identifiers
sysfs-devices-soc:29-51, 67-71SMCCC v1.2+ firmware가 있는 ARM silicon은 JEP106 identity·continuation code를 family에, vendor namespace 충돌을 피하기 위한 SOC ID를 soc_id에 encoding할 수 있습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/devices/socX
2
Date: January 2012
3
contact: Lee Jones <lee@kernel.org>
4
Description:
5
The /sys/devices/ directory contains a sub-directory for each
6
System-on-Chip (SoC) device on a running platform. Information
7
regarding each SoC can be obtained by reading sysfs files. This
8
functionality is only available if implemented by the platform.
10
The directory created for each SoC will also house information
11
about devices which are commonly contained in /sys/devices/platform.
12
It has been agreed that if an SoC device exists, its supported
13
devices would be better suited to appear as children of that SoC.
15
What: /sys/devices/socX/machine
16
Date: January 2012
17
contact: Lee Jones <lee@kernel.org>
18
Description:
19
Read-only attribute common to all SoCs. Contains the SoC machine
20
name (e.g. Ux500).
22
What: /sys/devices/socX/family
23
Date: January 2012
24
contact: Lee Jones <lee@kernel.org>
25
Description:
26
Read-only attribute common to all SoCs. Contains SoC family name
27
(e.g. DB8500).
29
On many of ARM based silicon with SMCCC v1.2+ compliant firmware
30
this will contain the JEDEC JEP106 manufacturer’s identification
31
code. The format is "jep106:XXYY" where XX is identity code and
32
YY is continuation code.
34
This manufacturer’s identification code is defined by one
35
or more eight (8) bit fields, each consisting of seven (7)
36
data bits plus one (1) odd parity bit. It is a single field,
37
limiting the possible number of vendors to 126. To expand
38
the maximum number of identification codes, a continuation
39
scheme has been defined.
41
The specified mechanism is that an identity code of 0x7F
42
represents the "continuation code" and implies the presence
43
of an additional identity code field, and this mechanism
44
may be extended to multiple continuation codes followed
45
by the manufacturer's identity code.
47
For example, ARM has identity code 0x7F 0x7F 0x7F 0x7F 0x3B,
48
which is code 0x3B on the fifth 'page'. This is shortened
49
as JEP106 identity code of 0x3B and a continuation code of
50
0x4 to represent the four continuation codes preceding the
51
identity code.
53
What: /sys/devices/socX/serial_number
54
Date: January 2019
55
contact: Bjorn Andersson <bjorn.andersson@linaro.org>
56
Description:
57
Read-only attribute supported by most SoCs. Contains the SoC's
58
serial number, if available.
60
What: /sys/devices/socX/soc_id
61
Date: January 2012
62
contact: Lee Jones <lee@kernel.org>
63
Description:
64
Read-only attribute supported by most SoCs. In the case of
65
ST-Ericsson's chips this contains the SoC serial number.
67
On many of ARM based silicon with SMCCC v1.2+ compliant firmware
68
this will contain the SOC ID appended to the family attribute
69
to ensure there is no conflict in this namespace across various
70
vendors. The format is "jep106:XXYY:ZZZZ" where XX is identity
71
code, YY is continuation code and ZZZZ is the SOC ID.
73
What: /sys/devices/socX/revision
74
Date: January 2012
75
contact: Lee Jones <lee@kernel.org>
76
Description:
77
Read-only attribute supported by most SoCs. Contains the SoC's
78
manufacturing revision number.
80
What: /sys/devices/socX/process
81
Date: January 2012
82
contact: Lee Jones <lee@kernel.org>
83
Description:
84
Read-only attribute supported ST-Ericsson's silicon. Contains the
85
the process by which the silicon chip was manufactured.
87
What: /sys/bus/soc
88
Date: January 2012
89
contact: Lee Jones <lee@kernel.org>
90
Description:
91
The /sys/bus/soc/ directory contains the usual sub-folders
92
expected under most buses. /sys/bus/soc/devices is of particular
93
interest, as it contains a symlink for each SoC device found on
94
the system. Each symlink points back into the aforementioned
95
/sys/devices/socX devices.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
System-on-Chip device directory
1-14| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/socX |
| Date | 2012년 1월 |
| Contact | Lee Jones <lee@kernel.org> |
| Description | /sys/devices/ directory에는 running platform의 각 System-on-Chip(SoC) device를 위한 subdirectory가 있습니다. Sysfs file을 읽어 각 SoC의 정보를 얻을 수 있으며, platform이 이 기능을 구현한 경우에만 사용할 수 있습니다. 각 SoC를 위해 생성된 directory에는 보통 /sys/devices/platform에 포함되는 device의 정보도 들어갑니다. SoC device가 존재한다면 그 SoC가 지원하는 device를 해당 SoC의 child로 두는 편이 더 적합하다는 데 합의되어 있습니다. |
/sys/devices/→socX SoC instance→SoC identity attributes→Supported child devices
Platform-supported devices가 SoC instance 아래 child로 배치되는 구조입니다.
SoC machine name
15-21| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/socX/machine |
| Date | 2012년 1월 |
| Contact | Lee Jones <lee@kernel.org> |
| Description | 모든 SoC에 공통인 read-only attribute입니다. SoC machine name(예: Ux500)이 들어 있습니다. |
SoC family and JEP106 manufacturer code
22-52| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/socX/family |
| Date | 2012년 1월 |
| Contact | Lee Jones <lee@kernel.org> |
| Description | 모든 SoC에 공통인 read-only attribute로 SoC family name(예: DB8500)이 들어 있습니다. SMCCC v1.2+ compliant firmware를 사용하는 많은 ARM-based silicon에서는 JEDEC JEP106 manufacturer's identification code가 들어가며 형식은 "jep106:XXYY"입니다. XX는 identity code, YY는 continuation code입니다. Manufacturer identification code는 하나 이상의 8-bit field로 정의되며 각 field는 7 data bits와 1 odd-parity bit로 이루어집니다. Single field만으로는 가능한 vendor가 126개로 제한되므로 identification code 수를 늘리기 위한 continuation scheme이 정의되었습니다. Identity code 0x7F는 "continuation code"를 나타내며 뒤에 identity-code field가 하나 더 있음을 뜻합니다. 이 방식은 여러 continuation code 뒤에 manufacturer's identity code가 오도록 확장할 수 있습니다. 예를 들어 ARM identity code는 0x7F 0x7F 0x7F 0x7F 0x3B로, 다섯 번째 page의 code 0x3B입니다. 이를 JEP106 identity code 0x3B와 앞선 continuation code 네 개를 나타내는 continuation code 0x4로 줄여 표현합니다. |
FieldMeaningARM example
XXManufacturer identity code0x3B
YYNumber of preceding 0x7F continuation codes0x4
Combinedjep106:XXYYFifth-page ARM identity
family attribute가 사용하는 compact manufacturer-code fields입니다.
SoC serial number
53-59| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/socX/serial_number |
| Date | 2019년 1월 |
| Contact | Bjorn Andersson <bjorn.andersson@linaro.org> |
| Description | 대부분의 SoC가 지원하는 read-only attribute입니다. 이용할 수 있으면 SoC serial number가 들어 있습니다. |
Vendor-qualified SoC identifier
60-72| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/socX/soc_id |
| Date | 2012년 1월 |
| Contact | Lee Jones <lee@kernel.org> |
| Description | 대부분의 SoC가 지원하는 read-only attribute입니다. ST-Ericsson chip에서는 SoC serial number가 들어 있습니다. SMCCC v1.2+ compliant firmware를 사용하는 많은 ARM-based silicon에서는 여러 vendor 사이의 namespace 충돌을 막기 위해 family attribute에 SOC ID를 붙인 값이 들어갑니다. 형식은 "jep106:XXYY:ZZZZ"이며 XX는 identity code, YY는 continuation code, ZZZZ는 SOC ID입니다. |
Format componentMeaning
jep106JEDEC JEP106 namespace
XXManufacturer identity code
YYContinuation code
ZZZZSOC ID
SMCCC firmware가 제공하는 identifier의 field 순서입니다.
SoC manufacturing revision
73-79| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/socX/revision |
| Date | 2012년 1월 |
| Contact | Lee Jones <lee@kernel.org> |
| Description | 대부분의 SoC가 지원하는 read-only attribute입니다. SoC manufacturing revision number가 들어 있습니다. |
ST-Ericsson silicon process
80-86| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/devices/socX/process |
| Date | 2012년 1월 |
| Contact | Lee Jones <lee@kernel.org> |
| Description | ST-Ericsson silicon이 지원하는 read-only attribute입니다. Silicon chip을 제조한 process가 들어 있습니다. |
SoC bus device links
87-95| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/bus/soc |
| Date | 2012년 1월 |
| Contact | Lee Jones <lee@kernel.org> |
| Description | /sys/bus/soc/ directory에는 대부분의 bus 아래에서 볼 수 있는 일반적인 subfolder가 들어 있습니다. 특히 /sys/bus/soc/devices에는 system에서 발견한 각 SoC device의 symlink가 있으며, 각 symlink는 앞에서 설명한 /sys/devices/socX device를 다시 가리킵니다. |
/sys/bus/soc/devices/→One symlink per discovered SoC→/sys/devices/socX→SoC attributes and child devices
Bus view의 symlink가 canonical SoC device instance를 가리킵니다.
SoC device hierarchy
sysfs-devices-soc:1-14, 87-95Platform이 구현한 각 SoC는 /sys/devices/socX로 나타나고 supported devices를 child로 둘 수 있으며, /sys/bus/soc/devices의 symlink가 각 instance를 가리킵니다.