TI OMAP RTC | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

rtc-omap.txt:1-53

RTC 기능과 전원·clock·interrupt 연결을 먼저 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 TI Real Time Clock

3 Required properties:

4 - compatible:

5 - "ti,da830-rtc" - for RTC IP used similar to that on DA8xx SoC family.

6 - "ti,am3352-rtc" - for RTC IP used similar to that on AM335x SoC family.

7 This RTC IP has special WAKE-EN Register to enable

8 Wakeup generation for event Alarm. It can also be

9 used to control an external PMIC via the

10 pmic_power_en pin.

11 - "ti,am4372-rtc" - for RTC IP used similar to that on AM437X SoC family.

12 - reg: Address range of rtc register set

13 - interrupts: rtc timer, alarm interrupts in order

15 Optional properties:

16 - system-power-controller: whether the rtc is controlling the system power

17 through pmic_power_en

18 - clocks: Any internal or external clocks feeding in to rtc

19 - clock-names: Corresponding names of the clocks

20 - pinctrl-0: a phandle pointing to the pin settings for the device

21 - pinctrl-names: should be "default"

23 Optional subnodes:

24 - generic pinctrl node

26 Required pinctrl subnodes properties:

27 - pins - Names of ext_wakeup pins to configure

29 Optional pinctrl subnodes properties:

30 - input-enable - Enables ext_wakeup

31 - ti,active-high - Set input active high (by default active low)

33 Example:

35 rtc@1c23000 {

36 compatible = "ti,da830-rtc";

37 reg = <0x23000 0x1000>;

38 interrupts = <19

39 19>;

40 interrupt-parent = <&intc>;

41 system-power-controller;

42 clocks = <&clk_32k_rtc>, <&clk_32768_ck>;

43 clock-names = "ext-clk", "int-clk";

45 pinctrl-0 = <&ext_wakeup>;

46 pinctrl-names = "default";

48 ext_wakeup: ext-wakeup {

49 pins = "ext_wakeup0";

50 input-enable;

51 ti,active-high;

52 };

53 };

3. 한국어 전문 번역

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

TI RTC 필수 속성

1-14

`compatible`은 DA8xx 계열과 유사한 `ti,da830-rtc`, AM335x 계열과 유사한 `ti,am3352-rtc`, AM437x 계열과 유사한 `ti,am4372-rtc` 가운데 하나입니다.

AM335x 계열 RTC IP에는 alarm event의 wakeup 생성을 활성화하는 특별한 `WAKE-EN` register가 있으며 `pmic_power_en` pin을 통해 외부 PMIC를 제어할 수도 있습니다.

`reg`는 RTC register set의 주소 범위이고 `interrupts`에는 RTC timer와 alarm interrupt를 그 순서로 지정합니다.

선택 속성과 하위 노드

15-24

`system-power-controller`는 RTC가 `pmic_power_en`을 통해 시스템 전원을 제어하는지 나타냅니다. `clocks`는 RTC에 공급되는 내부·외부 clock이고 `clock-names`는 대응 이름입니다.

`pinctrl-0`은 장치 pin 설정의 phandle이며 `pinctrl-names`는 `default`여야 합니다. 선택적으로 일반 pinctrl 하위 노드를 둘 수 있습니다.

pinctrl 하위 노드

25-31

필수 `pins`는 구성할 `ext_wakeup` pin 이름입니다. 선택 `input-enable`은 외부 wakeup을 활성화하고 `ti,active-high`는 입력을 active high로 설정합니다. 기본값은 active low입니다.

TI RTC 예제

32-53

예제는 두 RTC interrupt, 시스템 전원 제어, `ext-clk`·`int-clk`, `ext_wakeup0`의 active-high wakeup 입력을 구성합니다.

rtc@1c23000 {
        compatible = "ti,da830-rtc";
        reg = <0x23000 0x1000>;
        interrupts = <19
                      19>;
        interrupt-parent = <&intc>;
        system-power-controller;
        clocks = <&clk_32k_rtc>, <&clk_32768_ck>;
        clock-names = "ext-clk", "int-clk";

        pinctrl-0 = <&ext_wakeup>;
        pinctrl-names = "default";

        ext_wakeup: ext-wakeup {
                pins = "ext_wakeup0";
                input-enable;
                ti,active-high;
        };
};