요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
Status, protocol, and queue
sysfs-class-mei:17-56Generation별 firmware status register와 negotiated·driver HBM version, session별 pending TX write limit을 구분합니다.
Firmware, state, and TRC
sysfs-class-mei:58-92Platform firmware version block, 7개 device state와 Glitch Detection HW(TRC) health status를 제공합니다.
Device kind
sysfs-class-mei:94-105Generic mei와 special-purpose itouch(IPTS) device kind를 구분합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/class/mei/
2
Date: May 2014
3
KernelVersion: 3.17
4
Contact: Tomas Winkler <[email protected]>
5
Description:
6
The mei/ class sub-directory belongs to mei device class
9
What: /sys/class/mei/mei<N>/
10
Date: May 2014
11
KernelVersion: 3.17
12
Contact: Tomas Winkler <[email protected]>
13
Description:
14
The /sys/class/mei/meiN directory is created for
15
each probed mei device
17
What: /sys/class/mei/mei<N>/fw_status
18
Date: Nov 2014
19
KernelVersion: 3.19
20
Contact: Tomas Winkler <[email protected]>
21
Description: Display fw status registers content
23
The ME FW writes its status information into fw status
24
registers for BIOS and OS to monitor fw health.
26
The register contains running state, power management
27
state, error codes, and others. The way the registers
28
are decoded depends on PCH or SoC generation.
29
Also number of registers varies between 1 and 6
30
depending on generation.
32
What: /sys/class/mei/mei<N>/hbm_ver
33
Date: Aug 2016
34
KernelVersion: 4.9
35
Contact: Tomas Winkler <[email protected]>
36
Description: Display the negotiated HBM protocol version.
38
The HBM protocol version negotiated
39
between the driver and the device.
41
What: /sys/class/mei/mei<N>/hbm_ver_drv
42
Date: Aug 2016
43
KernelVersion: 4.9
44
Contact: Tomas Winkler <[email protected]>
45
Description: Display the driver HBM protocol version.
47
The HBM protocol version supported by the driver.
49
What: /sys/class/mei/mei<N>/tx_queue_limit
50
Date: Jan 2018
51
KernelVersion: 4.16
52
Contact: Tomas Winkler <[email protected]>
53
Description: Configure tx queue limit
55
Set maximal number of pending writes
56
per opened session.
58
What: /sys/class/mei/mei<N>/fw_ver
59
Date: May 2018
60
KernelVersion: 4.18
61
Contact: Tomas Winkler <[email protected]>
62
Description: Display the ME firmware version.
64
The version of the platform ME firmware is in format:
65
<platform>:<major>.<minor>.<milestone>.<build_no>.
66
There can be up to three such blocks for different
67
FW components.
69
What: /sys/class/mei/mei<N>/dev_state
70
Date: Mar 2019
71
KernelVersion: 5.1
72
Contact: Tomas Winkler <[email protected]>
73
Description: Display the ME device state.
75
The device state can have following values:
76
INITIALIZING
77
INIT_CLIENTS
78
ENABLED
79
RESETTING
80
DISABLED
81
POWER_DOWN
82
POWER_UP
84
What: /sys/class/mei/mei<N>/trc
85
Date: Nov 2019
86
KernelVersion: 5.5
87
Contact: Tomas Winkler <[email protected]>
88
Description: Display trc status register content
90
The ME FW writes Glitch Detection HW (TRC)
91
status information into trc status register
92
for BIOS and OS to monitor fw health.
94
What: /sys/class/mei/mei<N>/kind
95
Date: Jul 2020
96
KernelVersion: 5.8
97
Contact: Tomas Winkler <[email protected]>
98
Description: Display kind of the device
100
Generic devices are marked as "mei"
101
while special purpose have their own
102
names.
103
Available options:
104
- mei: generic mei device.
105
- itouch: itouch (ipts) mei device.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
MEI device class directory
1-6| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/mei/ |
| Date | 2014년 5월 |
| KernelVersion | 3.17 |
| Contact | Tomas Winkler <[email protected]> |
| Description | mei/ class 하위 directory는 MEI device class에 속합니다. |
Probed MEI device directory
9-15| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/mei/mei<N>/ |
| Date | 2014년 5월 |
| KernelVersion | 3.17 |
| Contact | Tomas Winkler <[email protected]> |
| Description | Probe된 각 MEI device마다 /sys/class/mei/meiN directory를 생성합니다. |
/sys/class/mei/→mei<N>/ instance per probed device→fw_status·HBM·queue·firmware·state·TRC·kind 속성
Class directory에서 probe된 instance와 instance별 속성으로 이어지는 구조입니다.
Firmware status registers
17-30| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/mei/mei<N>/fw_status |
| Date | 2014년 11월 |
| KernelVersion | 3.19 |
| Contact | Tomas Winkler <[email protected]> |
| Description | Firmware status register 내용을 표시합니다. ME FW는 BIOS와 OS가 firmware health를 monitor할 수 있도록 status 정보를 이 register에 씁니다. Register에는 running state, power management state, error code 등이 들어 있습니다. Register decoding 방식은 PCH 또는 SoC generation에 따라 달라지고 register 수도 generation에 따라 1개에서 6개까지 달라집니다. |
항목내용
WriterME FW
ConsumerBIOS와 OS의 firmware health monitoring
ContentRunning state·power management state·error code 등
DecodingPCH 또는 SoC generation 의존
Register 수Generation에 따라 1~6개
원문이 명시한 내용과 generation 의존성을 정리합니다.
Negotiated HBM protocol version
32-39| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/mei/mei<N>/hbm_ver |
| Date | 2016년 8월 |
| KernelVersion | 4.9 |
| Contact | Tomas Winkler <[email protected]> |
| Description | Negotiated HBM protocol version을 표시합니다. 이 값은 driver와 device 사이에서 협상된 HBM protocol version입니다. |
Driver HBM protocol version
41-47| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/mei/mei<N>/hbm_ver_drv |
| Date | 2016년 8월 |
| KernelVersion | 4.9 |
| Contact | Tomas Winkler <[email protected]> |
| Description | Driver HBM protocol version을 표시합니다. 이 값은 driver가 지원하는 HBM protocol version입니다. |
속성Version 의미
hbm_verDriver와 device가 협상한 version
hbm_ver_drvDriver가 지원하는 version
협상 결과와 driver capability를 구분합니다.
Transmit queue limit
49-56| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/mei/mei<N>/tx_queue_limit |
| Date | 2018년 1월 |
| KernelVersion | 4.16 |
| Contact | Tomas Winkler <[email protected]> |
| Description | TX queue limit을 설정합니다. Open된 session마다 pending write의 maximum 개수를 지정합니다. |
ME firmware version
58-67| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/mei/mei<N>/fw_ver |
| Date | 2018년 5월 |
| KernelVersion | 4.18 |
| Contact | Tomas Winkler <[email protected]> |
| Description | ME firmware version을 표시합니다. Platform ME firmware version은 아래 형식을 사용합니다. 서로 다른 FW component를 위해 이런 block이 최대 3개까지 있을 수 있습니다. |
<platform>:<major>.<minor>.<milestone>.<build_no>ME device state
69-82| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/mei/mei<N>/dev_state |
| Date | 2019년 3월 |
| KernelVersion | 5.1 |
| Contact | Tomas Winkler <[email protected]> |
| Description | ME device state를 표시합니다. 가능한 값은 INITIALIZING, INIT_CLIENTS, ENABLED, RESETTING, DISABLED, POWER_DOWN, POWER_UP입니다. |
Device state
INITIALIZING
INIT_CLIENTS
ENABLED
RESETTING
DISABLED
POWER_DOWN
POWER_UP
원문에 열거된 device state symbol을 그대로 보존합니다.
Glitch Detection TRC status
84-92| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/mei/mei<N>/trc |
| Date | 2019년 11월 |
| KernelVersion | 5.5 |
| Contact | Tomas Winkler <[email protected]> |
| Description | TRC status register 내용을 표시합니다. ME FW는 BIOS와 OS가 firmware health를 monitor할 수 있도록 Glitch Detection HW(TRC) status 정보를 TRC status register에 씁니다. |
MEI device kind
94-105| 항목 | 한국어 전문 번역 |
|---|---|
| What | /sys/class/mei/mei<N>/kind |
| Date | 2020년 7월 |
| KernelVersion | 5.8 |
| Contact | Tomas Winkler <[email protected]> |
| Description | Device kind를 표시합니다. Generic device는 mei로 표시하고 special-purpose device는 고유 이름을 사용합니다. 사용 가능한 option은 generic MEI device인 mei와 itouch(IPTS) MEI device인 itouch입니다. |
KindDevice
meiGeneric MEI device
itouchitouch(IPTS) MEI device
원문에 정의된 두 kind option입니다.
Class and device instances
sysfs-class-mei:1-15/sys/class/mei 아래 probe된 device마다 mei<N> instance directory를 생성합니다.