Documentation/devicetree/bindings/power/power-controller.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

Generic System Power Controller

Device가 system power-off를 제공함을 표시하는 표준 binding입니다.

Source pathDocumentation/devicetree/bindings/power/power-controller.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

power-controller.txt:1-17

`system-power-controller`와 kernel helper를 ACT8846 예제로 설명합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 * Generic system power control capability
2
3 Power-management integrated circuits or miscellaneous hardware components are
4 sometimes able to control the system power. The device driver associated with these
5 components might need to define this capability, which tells the kernel that
6 it can be used to switch off the system. The corresponding device must have the
7 standard property "system-power-controller" in its device node. This property
8 marks the device as able to control the system power. In order to test if this
9 property is found programmatically, use the helper function
10 "of_device_is_system_power_controller" from of.h .
11
12 Example:
13
14 act8846: act8846@5 {
15 compatible = "active-semi,act8846";
16 system-power-controller;
17 }
18

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

Generic system power control capability

1-11

Power-management IC나 기타 hardware component가 system power를 제어할 수 있습니다. 그 component의 device driver는 kernel에 자신이 system을 끌 수 있음을 알리기 위해 이 capability를 정의해야 할 수 있습니다.

대응하는 device node에는 표준 boolean property `system-power-controller`가 있어야 합니다. 이 property는 해당 device가 system power를 제어할 수 있음을 표시합니다.

Program에서 이 property의 존재를 검사하려면 `of.h`의 helper function `of_device_is_system_power_controller`를 사용합니다.

ACT8846 예제

12-17

ACT8846 PMIC node에 `system-power-controller`를 지정해 system power-off provider로 표시합니다.

act8846: act8846@5 {
         compatible = "active-semi,act8846";
         system-power-controller;
}