요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
SoC reset과 EDL
sysfs-bus-mhi:23-44응답 불능 복구에는 전체 재초기화가 필요한 SoC reset을, QDL firmware update에는 EDL mode 진입을 사용합니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
1
What: /sys/bus/mhi/devices/.../serialnumber
2
Date: Sept 2020
3
KernelVersion: 5.10
4
Contact: mhi@lists.linux.dev
5
Description: The file holds the serial number of the client device obtained
6
using a BHI (Boot Host Interface) register read after at least
7
one attempt to power up the device has been done. If read
8
without having the device power on at least once, the file will
9
read all 0's.
10
Users: Any userspace application or clients interested in device info.
12
What: /sys/bus/mhi/devices/.../oem_pk_hash
13
Date: Sept 2020
14
KernelVersion: 5.10
15
Contact: mhi@lists.linux.dev
16
Description: The file holds the OEM PK Hash value of the endpoint device
17
obtained using a BHI (Boot Host Interface) register read after
18
at least one attempt to power up the device has been done. If
19
read without having the device power on at least once, the file
20
will read all 0's.
21
Users: Any userspace application or clients interested in device info.
23
What: /sys/bus/mhi/devices/.../soc_reset
24
Date: April 2022
25
KernelVersion: 5.19
26
Contact: mhi@lists.linux.dev
27
Description: Initiates a SoC reset on the MHI controller. A SoC reset is
28
a reset of last resort, and will require a complete re-init.
29
This can be useful as a method of recovery if the device is
30
non-responsive, or as a means of loading new firmware as a
31
system administration task.
33
What: /sys/bus/mhi/devices/.../trigger_edl
34
Date: April 2024
35
KernelVersion: 6.10
36
Contact: mhi@lists.linux.dev
37
Description: Writing a non-zero value to this file will force devices to
38
enter EDL (Emergency Download) mode. This entry only exists for
39
devices capable of entering the EDL mode using the standard EDL
40
triggering mechanism defined in the MHI spec v1.2. Once in EDL
41
mode, the flash programmer image can be downloaded to the
42
device to enter the flash programmer execution environment.
43
This can be useful if user wants to use QDL (Qualcomm Download,
44
which is used to download firmware over EDL) to update firmware.
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
MHI identity attribute
1-21두 attribute는 2020년 9월 kernel 5.10에 도입됐고 contact는 mhi@lists.linux.dev다. Device 정보에 관심 있는 user space application과 client가 사용한다.
| 경로 | 의미 |
|---|---|
| /sys/bus/mhi/devices/.../serialnumber | Client device를 적어도 한 번 power-up하려고 시도한 뒤 BHI(Boot Host Interface) register read로 얻은 serial number다. 한 번도 power on하지 않고 읽으면 모두 0이다. |
| /sys/bus/mhi/devices/.../oem_pk_hash | Endpoint device를 적어도 한 번 power-up하려고 시도한 뒤 BHI register read로 얻은 OEM PK Hash다. 한 번도 power on하지 않고 읽으면 모두 0이다. |
SoC reset과 Emergency Download
23-44| 경로 | 도입 | 동작 |
|---|---|---|
| /sys/bus/mhi/devices/.../soc_reset | 2022년 4월 · kernel 5.19 | MHI controller에서 SoC reset을 시작한다. 최후 수단의 reset이며 완전한 재초기화가 필요하다. 응답하지 않는 device 복구나 system 관리 작업으로 새 firmware를 load하는 데 쓸 수 있다. |
| /sys/bus/mhi/devices/.../trigger_edl | 2024년 4월 · kernel 6.10 | 0이 아닌 값을 쓰면 device를 EDL(Emergency Download) mode로 강제 진입시킨다. MHI specification v1.2의 표준 EDL trigger mechanism을 지원하는 device에만 존재한다. |
EDL mode에 들어가면 flash programmer image를 device에 내려받아 flash programmer execution environment로 진입할 수 있다. EDL을 통해 firmware를 내려받는 QDL(Qualcomm Download)로 firmware를 갱신할 때 유용하다. Contact는 mhi@lists.linux.dev다.
Device identity
sysfs-bus-mhi:1-21최소 한 번 power-up을 시도한 뒤 serialnumber와 oem_pk_hash를 BHI register에서 읽습니다.