Marvell Orion Watchdog Timer | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

marvel.txt:1-45

Orion·Armada 워치독의 RSTOUT register, 기종별 clock과 선택 속성을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, GPIO, 예제와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 * Marvell Orion Watchdog Time

3 Required Properties:

5 - Compatibility : "marvell,orion-wdt"

6 "marvell,armada-370-wdt"

7 "marvell,armada-xp-wdt"

8 "marvell,armada-375-wdt"

9 "marvell,armada-380-wdt"

11 - reg : Should contain two entries: first one with the

12 timer control address, second one with the

13 rstout enable address.

15 For "marvell,armada-375-wdt" and "marvell,armada-380-wdt":

17 - reg : A third entry is mandatory and should contain the

18 shared mask/unmask RSTOUT address.

20 Clocks required for compatibles = "marvell,orion-wdt",

21 "marvell,armada-370-wdt":

22 - clocks : Must contain a single entry describing the clock input

24 Clocks required for compatibles = "marvell,armada-xp-wdt"

25 "marvell,armada-375-wdt"

26 "marvell,armada-380-wdt":

27 - clocks : Must contain an entry for each entry in clock-names.

28 - clock-names : Must include the following entries:

29 "nbclk" (L2/coherency fabric clock),

30 "fixed" (Reference 25 MHz fixed-clock).

32 Optional properties:

34 - interrupts : Contains the IRQ for watchdog expiration

35 - timeout-sec : Contains the watchdog timeout in seconds

37 Example:

39 wdt@20300 {

40 compatible = "marvell,orion-wdt";

41 reg = <0x20300 0x28>, <0x20108 0x4>;

42 interrupts = <3>;

43 timeout-sec = <10>;

44 clocks = <&gate_clk 7>;

45 };

3. 한국어 전문 번역

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

Marvell Orion 워치독

1-2

이 구형 TXT binding은 Marvell Orion과 Armada 계열 워치독 타이머를 설명합니다.

호환 기종과 RSTOUT register

3-19

`compatible`은 `marvell,orion-wdt`, `marvell,armada-370-wdt`, `marvell,armada-xp-wdt`, `marvell,armada-375-wdt`, `marvell,armada-380-wdt` 중 하나입니다.

`reg`에는 첫째 timer control 주소와 둘째 RSTOUT enable 주소를 제공합니다. Armada 375와 380은 shared mask/unmask RSTOUT 주소를 담는 셋째 항목도 반드시 필요합니다.

Required Properties:

- Compatibility : "marvell,orion-wdt"
                  "marvell,armada-370-wdt"
                  "marvell,armada-xp-wdt"
                  "marvell,armada-375-wdt"
                  "marvell,armada-380-wdt"

- reg                : Should contain two entries: first one with the
                  timer control address, second one with the
                  rstout enable address.

For "marvell,armada-375-wdt" and "marvell,armada-380-wdt":

- reg                : A third entry is mandatory and should contain the
                  shared mask/unmask RSTOUT address.

기종별 클록과 선택 속성

20-36

Orion과 Armada 370의 `clocks`에는 단일 clock input을 제공합니다. Armada XP, 375, 380은 `clock-names`의 각 이름에 대응하는 클록을 제공해야 하며, 이름에는 L2/coherency fabric clock인 `nbclk`와 25MHz fixed reference clock인 `fixed`가 포함되어야 합니다.

선택 속성 `interrupts`는 watchdog expiration IRQ를, `timeout-sec`는 초 단위 timeout을 담습니다.

Clocks required for compatibles = "marvell,orion-wdt",
                                  "marvell,armada-370-wdt":
- clocks : Must contain a single entry describing the clock input

Clocks required for compatibles = "marvell,armada-xp-wdt"
                                  "marvell,armada-375-wdt"
                                  "marvell,armada-380-wdt":
- clocks : Must contain an entry for each entry in clock-names.
- clock-names : Must include the following entries:
  "nbclk" (L2/coherency fabric clock),
  "fixed" (Reference 25 MHz fixed-clock).

Optional properties:

- interrupts        : Contains the IRQ for watchdog expiration
- timeout-sec        : Contains the watchdog timeout in seconds

Orion 워치독 예제

37-45

예제는 Orion 워치독에 timer control과 RSTOUT enable register를 제공하고 interrupt 3, timeout 10초, gate clock 7을 연결합니다.

Example:

        wdt@20300 {
                compatible = "marvell,orion-wdt";
                reg = <0x20300 0x28>, <0x20108 0x4>;
                interrupts = <3>;
                timeout-sec = <10>;
                clocks = <&gate_clk 7>;
        };