TI Palmas Power Button | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

ti,palmas-pwrbutton.txt:1-35

자동 power-off와 press 등록 시간을 설명합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Texas Instruments Palmas family power button module

3 This module is part of the Palmas family of PMICs. For more details

4 about the whole chip see:

5 Documentation/devicetree/bindings/mfd/palmas.txt.

7 This module provides a simple power button event via an Interrupt.

9 Required properties:

10 - compatible: should be one of the following

11 - "ti,palmas-pwrbutton": For Palmas compatible power on button

12 - interrupts: Interrupt number of power button submodule on device.

14 Optional Properties:

16 - ti,palmas-long-press-seconds: Duration in seconds which the power

17 button should be kept pressed for Palmas to power off automatically.

18 NOTE: This depends on OTP support and POWERHOLD signal configuration

19 on platform. Valid values are 6, 8, 10 and 12.

20 - ti,palmas-pwron-debounce-milli-seconds: Duration in milliseconds

21 which the power button should be kept pressed for Palmas to register

22 a press for debouncing purposes. NOTE: This depends on specific

23 Palmas variation capability. Valid values are 15, 100, 500 and 1000.

25 Example:

27 &palmas {

28 palmas_pwr_button: pwrbutton {

29 compatible = "ti,palmas-pwrbutton";

30 interrupt-parent = <&tps659038>;

31 interrupts = <1 IRQ_TYPE_EDGE_FALLING>;

32 ti,palmas-long-press-seconds = <12>;

33 ti,palmas-pwron-debounce-milli-seconds = <15>;

34 };

35 };

3. 한국어 전문 번역

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

Palmas power-button timing

1-24

이 module은 TI Palmas PMIC family의 일부이며 전체 chip은 `Documentation/devicetree/bindings/mfd/palmas.txt`를 참조합니다. Interrupt를 통해 단순 power-button event를 제공합니다. 필수 `compatible`은 Palmas-compatible power-on button용 `ti,palmas-pwrbutton`, `interrupts`는 device의 power-button submodule interrupt number입니다.

선택 `ti,palmas-long-press-seconds`는 Palmas가 자동 power-off하기까지 button을 누를 second 단위 시간입니다. Platform의 OTP support와 POWERHOLD signal configuration에 의존하며 valid 값은 6, 8, 10, 12입니다.

`ti,palmas-pwron-debounce-milli-seconds`는 debounce 목적으로 press를 등록하기까지 button을 누를 millisecond 단위 시간입니다. Palmas variant capability에 따라 지원 여부가 달라지며 valid 값은 15, 100, 500, 1000입니다.

Palmas button timing values

PropertyValid valuesDependency

long-press-seconds6, 8, 10, 12 sOTP + POWERHOLD

pwron-debounce-milli-seconds15, 100, 500, 1000 msPMIC variant

Long-press power-off와 press debounce가 지원하는 값입니다.

12-second Palmas 예제

25-35

예제는 TPS659038 parent의 falling-edge IRQ 1을 사용하고 long press를 12 seconds, press debounce를 15 milliseconds로 설정합니다.

&palmas {
        palmas_pwr_button: pwrbutton {
                compatible = "ti,palmas-pwrbutton";
                interrupt-parent = <&tps659038>;
                interrupts = <1 IRQ_TYPE_EDGE_FALLING>;
                ti,palmas-long-press-seconds = <12>;
                ti,palmas-pwron-debounce-milli-seconds = <15>;
        };
};