Nuvoton NPCM7xx Timer | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

nuvoton,npcm7xx-timer.yaml:1-54

WPCM450·NPCM750·NPCM845 timer의 interrupt와 clock 배열을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며 compatible, interrupt, clock, register, phandle, 수치와 줄 좌표를 원형대로 보존합니다.

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/timer/nuvoton,npcm7xx-timer.yaml#

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

7 title: Nuvoton NPCM7xx timer

9 maintainers:

10 - Jonathan Neuschäfer <j.neuschaefer@gmx.net>

11 - Tomer Maimon <tmaimon77@gmail.com>

13 properties:

14 compatible:

15 enum:

16 - nuvoton,wpcm450-timer # for Hermon WPCM450

17 - nuvoton,npcm750-timer # for Poleg NPCM750

18 - nuvoton,npcm845-timer # for Arbel NPCM845

20 reg:

21 maxItems: 1

23 interrupts:

24 items:

25 - description: The timer interrupt of timer 0

27 clocks:

28 items:

29 - description: The reference clock for timer 0

30 - description: The reference clock for timer 1

31 - description: The reference clock for timer 2

32 - description: The reference clock for timer 3

33 - description: The reference clock for timer 4

34 minItems: 1

36 required:

37 - compatible

38 - reg

39 - interrupts

40 - clocks

42 additionalProperties: false

44 examples:

45 - |

46 #include <dt-bindings/interrupt-controller/irq.h>

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

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

49 timer@f0008000 {

50 compatible = "nuvoton,npcm750-timer";

51 interrupts = <GIC_SPI 32 IRQ_TYPE_LEVEL_HIGH>;

52 reg = <0xf0008000 0x50>;

53 clocks = <&clk NPCM7XX_CLK_TIMER>;

54 };

3. 한국어 전문 번역

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

Nuvoton NPCM timer

1-12

GPL-2.0-only 또는 BSD-2-Clause 라이선스의 이 스키마는 Nuvoton NPCM7xx 계열 timer를 정의합니다. Maintainer는 Jonathan Neuschäfer와 Tomer Maimon입니다.

WPCM450·NPCM750·NPCM845와 다섯 clock

13-43

`compatible`은 Hermon WPCM450의 `nuvoton,wpcm450-timer`, Poleg NPCM750의 `nuvoton,npcm750-timer`, Arbel NPCM845의 `nuvoton,npcm845-timer` 중 하나입니다. `reg`는 최대 한 항목이고 `interrupts`는 timer 0 interrupt 하나입니다. `clocks`는 timer 0부터 timer 4까지 reference clock을 순서대로 담으며 최소 하나, 최대 다섯 개입니다. `compatible`, `reg`, `interrupts`, `clocks`가 필수이고 추가 속성은 허용되지 않습니다.

properties:
  compatible:
    enum:
      - nuvoton,wpcm450-timer  # for Hermon WPCM450
      - nuvoton,npcm750-timer  # for Poleg NPCM750
      - nuvoton,npcm845-timer  # for Arbel NPCM845

  reg:
    maxItems: 1

  interrupts:
    items:
      - description: The timer interrupt of timer 0

  clocks:
    items:
      - description: The reference clock for timer 0
      - description: The reference clock for timer 1
      - description: The reference clock for timer 2
      - description: The reference clock for timer 3
      - description: The reference clock for timer 4
    minItems: 1

required:
  - compatible
  - reg
  - interrupts
  - clocks

additionalProperties: false

NPCM750 timer 0 예제

44-54

예제는 `timer@f0008000`에 NPCM750 compatible, GIC SPI 32 level-high interrupt, 0x50-byte register 영역, `NPCM7XX_CLK_TIMER` reference clock을 지정합니다.

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    #include <dt-bindings/clock/nuvoton,npcm7xx-clock.h>
    timer@f0008000 {
        compatible = "nuvoton,npcm750-timer";
        interrupts = <GIC_SPI 32 IRQ_TYPE_LEVEL_HIGH>;
        reg = <0xf0008000 0x50>;
        clocks = <&clk NPCM7XX_CLK_TIMER>;
    };