Generic System Power Controller | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

power-controller.txt:1-17

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

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기

1 * Generic system power control capability

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 .

12 Example:

14 act8846: act8846@5 {

15 compatible = "active-semi,act8846";

16 system-power-controller;

17 }

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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;
}