← Documents Documentation/ABI/testing/sysfs-class-mei GitHub 원문 ↗

Linux 6.18.37 · ABI / testing

MEI device class sysfs ABI

MEI class instance의 firmware status·HBM version·TX queue·firmware version·device state·TRC·kind 속성을 설명합니다.

Source pathDocumentation/ABI/testing/sysfs-class-mei
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

Class and device instances

sysfs-class-mei:1-15

/sys/class/mei 아래 probe된 device마다 mei<N> instance directory를 생성합니다.

Status, protocol, and queue

sysfs-class-mei:17-56

Generation별 firmware status register와 negotiated·driver HBM version, session별 pending TX write limit을 구분합니다.

Firmware, state, and TRC

sysfs-class-mei:58-92

Platform firmware version block, 7개 device state와 Glitch Detection HW(TRC) health status를 제공합니다.

Device kind

sysfs-class-mei:94-105

Generic 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 <tomas.winkler@intel.com>
5 Description:
6 The mei/ class sub-directory belongs to mei device class
7
8
9 What: /sys/class/mei/mei<N>/
10 Date: May 2014
11 KernelVersion: 3.17
12 Contact: Tomas Winkler <tomas.winkler@intel.com>
13 Description:
14 The /sys/class/mei/meiN directory is created for
15 each probed mei device
16
17 What: /sys/class/mei/mei<N>/fw_status
18 Date: Nov 2014
19 KernelVersion: 3.19
20 Contact: Tomas Winkler <tomas.winkler@intel.com>
21 Description: Display fw status registers content
22
23 The ME FW writes its status information into fw status
24 registers for BIOS and OS to monitor fw health.
25
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.
31
32 What: /sys/class/mei/mei<N>/hbm_ver
33 Date: Aug 2016
34 KernelVersion: 4.9
35 Contact: Tomas Winkler <tomas.winkler@intel.com>
36 Description: Display the negotiated HBM protocol version.
37
38 The HBM protocol version negotiated
39 between the driver and the device.
40
41 What: /sys/class/mei/mei<N>/hbm_ver_drv
42 Date: Aug 2016
43 KernelVersion: 4.9
44 Contact: Tomas Winkler <tomas.winkler@intel.com>
45 Description: Display the driver HBM protocol version.
46
47 The HBM protocol version supported by the driver.
48
49 What: /sys/class/mei/mei<N>/tx_queue_limit
50 Date: Jan 2018
51 KernelVersion: 4.16
52 Contact: Tomas Winkler <tomas.winkler@intel.com>
53 Description: Configure tx queue limit
54
55 Set maximal number of pending writes
56 per opened session.
57
58 What: /sys/class/mei/mei<N>/fw_ver
59 Date: May 2018
60 KernelVersion: 4.18
61 Contact: Tomas Winkler <tomas.winkler@intel.com>
62 Description: Display the ME firmware version.
63
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.
68
69 What: /sys/class/mei/mei<N>/dev_state
70 Date: Mar 2019
71 KernelVersion: 5.1
72 Contact: Tomas Winkler <tomas.winkler@intel.com>
73 Description: Display the ME device state.
74
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
83
84 What: /sys/class/mei/mei<N>/trc
85 Date: Nov 2019
86 KernelVersion: 5.5
87 Contact: Tomas Winkler <tomas.winkler@intel.com>
88 Description: Display trc status register content
89
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.
93
94 What: /sys/class/mei/mei<N>/kind
95 Date: Jul 2020
96 KernelVersion: 5.8
97 Contact: Tomas Winkler <tomas.winkler@intel.com>
98 Description: Display kind of the device
99
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.
106

3. 한국어 전문 번역

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

MEI device class directory

1-6
항목한국어 전문 번역
What/sys/class/mei/
Date2014년 5월
KernelVersion3.17
ContactTomas Winkler <tomas.winkler@intel.com>
Descriptionmei/ class 하위 directory는 MEI device class에 속합니다.

Probed MEI device directory

9-15
항목한국어 전문 번역
What/sys/class/mei/mei<N>/
Date2014년 5월
KernelVersion3.17
ContactTomas Winkler <tomas.winkler@intel.com>
DescriptionProbe된 각 MEI device마다 /sys/class/mei/meiN directory를 생성합니다.
MEI sysfs hierarchy
/sys/class/mei/mei<N>/ instance per probed devicefw_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
Date2014년 11월
KernelVersion3.19
ContactTomas Winkler <tomas.winkler@intel.com>
DescriptionFirmware 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개까지 달라집니다.
Firmware status register 특성
항목내용
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
Date2016년 8월
KernelVersion4.9
ContactTomas Winkler <tomas.winkler@intel.com>
DescriptionNegotiated HBM protocol version을 표시합니다. 이 값은 driver와 device 사이에서 협상된 HBM protocol version입니다.

Driver HBM protocol version

41-47
항목한국어 전문 번역
What/sys/class/mei/mei<N>/hbm_ver_drv
Date2016년 8월
KernelVersion4.9
ContactTomas Winkler <tomas.winkler@intel.com>
DescriptionDriver HBM protocol version을 표시합니다. 이 값은 driver가 지원하는 HBM protocol version입니다.
HBM 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
Date2018년 1월
KernelVersion4.16
ContactTomas Winkler <tomas.winkler@intel.com>
DescriptionTX queue limit을 설정합니다. Open된 session마다 pending write의 maximum 개수를 지정합니다.

ME firmware version

58-67
항목한국어 전문 번역
What/sys/class/mei/mei<N>/fw_ver
Date2018년 5월
KernelVersion4.18
ContactTomas Winkler <tomas.winkler@intel.com>
DescriptionME 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
Date2019년 3월
KernelVersion5.1
ContactTomas Winkler <tomas.winkler@intel.com>
DescriptionME device state를 표시합니다. 가능한 값은 INITIALIZING, INIT_CLIENTS, ENABLED, RESETTING, DISABLED, POWER_DOWN, POWER_UP입니다.
ME device state value
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
Date2019년 11월
KernelVersion5.5
ContactTomas Winkler <tomas.winkler@intel.com>
DescriptionTRC 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
Date2020년 7월
KernelVersion5.8
ContactTomas Winkler <tomas.winkler@intel.com>
DescriptionDevice kind를 표시합니다. Generic device는 mei로 표시하고 special-purpose device는 고유 이름을 사용합니다. 사용 가능한 option은 generic MEI device인 mei와 itouch(IPTS) MEI device인 itouch입니다.
MEI device kind
KindDevice
meiGeneric MEI device
itouchitouch(IPTS) MEI device

원문에 정의된 두 kind option입니다.