Nuvoton NPCM Watchdog | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

nuvoton,npcm750-wdt.yaml:1-60

NPCM·WPCM 워치독의 10ms pre-timeout interrupt와 clock 속성을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, reset, timeout, 예제와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

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

2 %YAML 1.2

3 ---

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

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

7 title: Nuvoton NPCM Watchdog

9 maintainers:

10 - Joel Stanley <joel@jms.id.au>

12 description:

13 Nuvoton NPCM timer module provides five 24-bit timer counters, and a watchdog.

14 The watchdog supports a pre-timeout interrupt that fires 10ms before the

15 expiry.

17 allOf:

18 - $ref: watchdog.yaml#

20 properties:

21 compatible:

22 oneOf:

23 - enum:

24 - nuvoton,npcm750-wdt

25 - nuvoton,wpcm450-wdt

26 - items:

27 - enum:

28 - nuvoton,npcm845-wdt

29 - const: nuvoton,npcm750-wdt

31 reg:

32 maxItems: 1

34 interrupts:

35 maxItems: 1

37 clocks:

38 maxItems: 1

40 clock-frequency:

41 description: Frequency in Hz of the clock that drives the NPCM timer.

43 required:

44 - compatible

45 - reg

46 - interrupts

48 unevaluatedProperties: false

50 examples:

51 - |

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

53 #include <dt-bindings/clock/nuvoton,npcm7xx-clock.h>

55 watchdog@f000801c {

56 compatible = "nuvoton,npcm750-wdt";

57 interrupts = <GIC_SPI 47 IRQ_TYPE_LEVEL_HIGH>;

58 reg = <0xf000801c 0x4>;

59 clocks = <&clk NPCM7XX_CLK_TIMER>;

60 };

3. 한국어 전문 번역

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

Nuvoton NPCM timer와 워치독

1-19

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 스키마는 Nuvoton NPCM Watchdog을 정의합니다. NPCM timer module은 다섯 개의 24-bit timer counter와 워치독 하나를 제공하며, 워치독은 만료 10ms 전에 발생하는 pre-timeout interrupt를 지원합니다.

공통 `watchdog.yaml`을 상속하며 관리자는 Joel Stanley입니다.

NPCM·WPCM 호환 문자열과 클록

20-42

`compatible`은 `nuvoton,npcm750-wdt` 또는 `nuvoton,wpcm450-wdt`를 직접 사용합니다. NPCM845는 `nuvoton,npcm845-wdt` 뒤에 `nuvoton,npcm750-wdt`를 fallback으로 나열합니다.

`reg`, `interrupts`, `clocks`는 각각 항목 하나만 받습니다. `clock-frequency`는 NPCM timer를 구동하는 클록 주파수를 Hz 단위로 지정합니다.

properties:
  compatible:
    oneOf:
      - enum:
          - nuvoton,npcm750-wdt
          - nuvoton,wpcm450-wdt
      - items:
          - enum:
              - nuvoton,npcm845-wdt
          - const: nuvoton,npcm750-wdt

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-frequency:
    description: Frequency in Hz of the clock that drives the NPCM timer.

필수 속성

43-49

`compatible`, `reg`, `interrupts`가 필수입니다. 공통 스키마에서 평가되지 않은 속성은 허용하지 않습니다.

required:
  - compatible
  - reg
  - interrupts

unevaluatedProperties: false

NPCM750 예제

50-60

예제는 주소 `0xf000801c`, 길이 `0x4`인 NPCM750 워치독에 level-high GIC SPI 47과 `NPCM7XX_CLK_TIMER` 클록을 연결합니다.

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

    watchdog@f000801c {
        compatible = "nuvoton,npcm750-wdt";
        interrupts = <GIC_SPI 47 IRQ_TYPE_LEVEL_HIGH>;
        reg = <0xf000801c 0x4>;
        clocks = <&clk NPCM7XX_CLK_TIMER>;
    };