LTC2952 PowerPath Controller | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

ltc2952-poweroff.txt:1-33

Trigger 이후 watchdog 처리와 kill signal, 기본 2500ms delay를 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Binding for the LTC2952 PowerPath controller

3 This chip is used to externally trigger a system shut down. Once the trigger has

4 been sent, the chip's watchdog has to be reset to gracefully shut down.

5 A full powerdown can be triggered via the kill signal.

7 Required properties:

9 - compatible: Must contain: "lltc,ltc2952"

10 - watchdog-gpios: phandle + gpio-specifier for the GPIO connected to the

11 chip's watchdog line

12 - kill-gpios: phandle + gpio-specifier for the GPIO connected to the

13 chip's kill line

15 Optional properties:

16 - trigger-gpios: phandle + gpio-specifier for the GPIO connected to the

17 chip's trigger line. If this property is not set, the

18 trigger function is ignored and the chip is kept alive

19 until an explicit kill signal is received

20 - trigger-delay-ms The number of milliseconds to wait after trigger line

21 assertion before executing shut down procedure.

22 The default is 2500ms.

24 Example:

26 ltc2952 {

27 compatible = "lltc,ltc2952";

29 trigger-gpios = <&gpio0 1 GPIO_ACTIVE_LOW>;

30 trigger-delay-ms = <2000>;

31 watchdog-gpios = <&gpio1 2 GPIO_ACTIVE_HIGH>;

32 kill-gpios = <&gpio0 2 GPIO_ACTIVE_LOW>;

33 };

3. 한국어 전문 번역

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

LTC2952 PowerPath 종료 절차

1-6

LTC2952는 외부에서 system shutdown을 trigger하는 chip입니다. Trigger가 전달된 뒤 graceful shutdown을 위해 chip의 watchdog을 reset해야 하며, kill signal을 사용하면 완전한 powerdown을 일으킬 수 있습니다.

GPIO와 trigger delay

7-23

필수 `compatible`은 `lltc,ltc2952`입니다. `watchdog-gpios`는 chip watchdog line에 연결된 GPIO의 phandle과 gpio-specifier이고 `kill-gpios`는 kill line에 연결된 GPIO의 phandle과 specifier입니다.

선택적 `trigger-gpios`는 trigger line GPIO를 지정합니다. 이 property가 없으면 trigger 기능을 무시하고 explicit kill signal을 받을 때까지 chip을 계속 살려 둡니다.

`trigger-delay-ms`는 trigger line assertion 후 shutdown procedure를 실행하기 전에 기다릴 millisecond 수이며 기본값은 2500ms입니다.

Active-low trigger·kill 예제

24-33

예제는 active-low trigger와 kill, active-high watchdog을 연결하고 trigger delay를 2000ms로 설정합니다.

ltc2952 {
        compatible = "lltc,ltc2952";

        trigger-gpios = <&gpio0 1 GPIO_ACTIVE_LOW>;
        trigger-delay-ms = <2000>;
        watchdog-gpios = <&gpio1 2 GPIO_ACTIVE_HIGH>;
        kill-gpios = <&gpio0 2 GPIO_ACTIVE_LOW>;
};