Nuvoton NPCM7xx Timer | Linux 6.18.37

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

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 <[email protected]>

11 - Tomer Maimon <[email protected]>

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. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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>;
    };