Cadence Watchdog Timer Controller | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

cdns,wdt-r1p2.yaml:1-62

Cadence 24비트 counter, timeout 범위와 reset-on-timeout 동작을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, reset, 예제와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

2 %YAML 1.2

3 ---

4 $id: http://devicetree.org/schemas/watchdog/cdns,wdt-r1p2.yaml#

5 $schema: http://devicetree.org/meta-schemas/core.yaml#

7 title: Cadence watchdog timer controller

9 maintainers:

10 - Neeli Srinivas <srinivas.neeli@amd.com>

12 description:

13 The cadence watchdog timer is used to detect and recover from

14 system malfunctions. This watchdog contains 24 bit counter and

15 a programmable reset period. The timeout period varies from 1 ms

16 to 30 seconds while using a 100Mhz clock.

18 allOf:

19 - $ref: watchdog.yaml#

21 properties:

22 compatible:

23 enum:

24 - cdns,wdt-r1p2

26 reg:

27 maxItems: 1

29 clocks:

30 maxItems: 1

32 interrupts:

33 maxItems: 1

35 reset-on-timeout:

36 type: boolean

37 description: |

38 If this property exists, then a reset is done when watchdog

39 times out.

41 required:

42 - compatible

43 - reg

44 - clocks

45 - interrupts

47 unevaluatedProperties: false

49 examples:

50 - |

51 #include <dt-bindings/interrupt-controller/arm-gic.h>

53 watchdog@f8005000 {

54 compatible = "cdns,wdt-r1p2";

55 reg = <0xf8005000 0x1000>;

56 clocks = <&clkc 45>;

57 interrupt-parent = <&intc>;

58 interrupts = <GIC_SPI 9 IRQ_TYPE_EDGE_RISING>;

59 reset-on-timeout;

60 timeout-sec = <10>;

61 };

62 ...

3. 한국어 전문 번역

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

Cadence 워치독 컨트롤러

1-11

GPL-2.0 또는 BSD-2-Clause로 배포되는 이 스키마는 Cadence watchdog timer controller를 정의합니다. 관리자는 Neeli Srinivas입니다.

24비트 counter와 timeout 범위

12-17

Cadence 워치독은 시스템 오작동을 감지하고 복구하는 데 사용합니다. 24비트 counter와 programmable reset period를 갖추며, 100MHz 클록을 사용할 때 timeout 범위는 1ms부터 30초까지입니다.

클록·interrupt와 reset-on-timeout

18-48

공통 `watchdog.yaml`을 상속하고 `compatible`은 `cdns,wdt-r1p2`입니다. `reg`, `clocks`, `interrupts`는 각각 최대 하나입니다.

boolean 속성 `reset-on-timeout`이 있으면 watchdog timeout 발생 시 reset을 수행합니다. `compatible`, `reg`, `clocks`, `interrupts`가 모두 필수이며 평가되지 않은 추가 속성은 허용하지 않습니다.

allOf:
  - $ref: watchdog.yaml#

properties:
  compatible:
    enum:
      - cdns,wdt-r1p2

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  interrupts:
    maxItems: 1

  reset-on-timeout:
    type: boolean
    description: |
      If this property exists, then a reset is done when watchdog
      times out.

required:
  - compatible
  - reg
  - clocks
  - interrupts

unevaluatedProperties: false

Cadence GIC SPI 예제

49-62

예제는 주소 `0xf8005000`의 Cadence 워치독에 clock controller의 45번 클록과 edge-rising GIC SPI interrupt 9를 연결합니다. timeout 10초와 `reset-on-timeout`을 활성화합니다.

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>

    watchdog@f8005000 {
        compatible = "cdns,wdt-r1p2";
        reg = <0xf8005000 0x1000>;
        clocks = <&clkc 45>;
        interrupt-parent = <&intc>;
        interrupts = <GIC_SPI 9 IRQ_TYPE_EDGE_RISING>;
        reset-on-timeout;
        timeout-sec = <10>;
    };
...