Pistachio General-purpose Timer

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

1. 요약·해설

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

요약과 해설

img,pistachio-gptimer.yaml:1-69

Pistachio timer의 네 IRQ, 세 clock과 peripheral syscon을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며 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/img,pistachio-gptimer.yaml#

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

7 title: Pistachio general-purpose timer

9 maintainers:

10 - Ezequiel Garcia <[email protected]>

12 properties:

13 compatible:

14 const: img,pistachio-gptimer

16 reg:

17 maxItems: 1

19 interrupts:

20 items:

21 - description: Timer0 interrupt

22 - description: Timer1 interrupt

23 - description: Timer2 interrupt

24 - description: Timer3 interrupt

26 clocks:

27 items:

28 - description: Fast counter clock

29 - description: Slow counter clock

30 - description: Interface clock

32 clock-names:

33 items:

34 - const: fast

35 - const: slow

36 - const: sys

38 img,cr-periph:

39 description: Peripheral control syscon phandle

40 $ref: /schemas/types.yaml#/definitions/phandle

42 required:

43 - compatible

44 - reg

45 - interrupts

46 - clocks

47 - clock-names

48 - img,cr-periph

50 additionalProperties: false

52 examples:

53 - |

54 #include <dt-bindings/interrupt-controller/mips-gic.h>

55 #include <dt-bindings/clock/pistachio-clk.h>

57 timer@18102000 {

58 compatible = "img,pistachio-gptimer";

59 reg = <0x18102000 0x100>;

60 interrupts = <GIC_SHARED 60 IRQ_TYPE_LEVEL_HIGH>,

61 <GIC_SHARED 61 IRQ_TYPE_LEVEL_HIGH>,

62 <GIC_SHARED 62 IRQ_TYPE_LEVEL_HIGH>,

63 <GIC_SHARED 63 IRQ_TYPE_LEVEL_HIGH>;

64 clocks = <&clk_periph PERIPH_CLK_COUNTER_FAST>,

65 <&clk_periph PERIPH_CLK_COUNTER_SLOW>,

66 <&cr_periph SYS_CLK_TIMER>;

67 clock-names = "fast", "slow", "sys";

68 img,cr-periph = <&cr_periph>;

69 };

3. 한국어 전문 번역

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

1-11

GPL-2.0-only 또는 BSD-2-Clause 라이선스의 이 스키마는 Imagination Technologies Pistachio general-purpose timer를 정의합니다. Maintainer는 Ezequiel Garcia입니다.

네 timer IRQ와 세 clock

12-51

`compatible`은 `img,pistachio-gptimer`이고 `reg`는 최대 한 항목입니다. `interrupts`는 timer0·timer1·timer2·timer3 interrupt 네 개를 순서대로 담습니다. `clocks`는 fast counter, slow counter, interface clock 세 개이며 대응하는 `clock-names`는 `fast`, `slow`, `sys`입니다. `img,cr-periph`는 peripheral control syscon phandle입니다. 이 여섯 속성이 모두 필수이며 추가 속성은 허용되지 않습니다.

properties:
  compatible:
    const: img,pistachio-gptimer

  reg:
    maxItems: 1

  interrupts:
    items:
      - description: Timer0 interrupt
      - description: Timer1 interrupt
      - description: Timer2 interrupt
      - description: Timer3 interrupt

  clocks:
    items:
      - description: Fast counter clock
      - description: Slow counter clock
      - description: Interface clock

  clock-names:
    items:
      - const: fast
      - const: slow
      - const: sys

  img,cr-periph:
    description: Peripheral control syscon phandle
    $ref: /schemas/types.yaml#/definitions/phandle

required:
  - compatible
  - reg
  - interrupts
  - clocks
  - clock-names
  - img,cr-periph

additionalProperties: false

Pistachio GIC·clock 예제

52-69

예제는 `timer@18102000`에 0x100-byte register 영역을 두고 GIC shared interrupt 60·61·62·63을 level-high로 지정합니다. `PERIPH_CLK_COUNTER_FAST`, `PERIPH_CLK_COUNTER_SLOW`, `SYS_CLK_TIMER`를 각각 `fast`, `slow`, `sys`에 연결하고 `cr_periph`를 peripheral control syscon으로 참조합니다.

examples:
  - |
    #include <dt-bindings/interrupt-controller/mips-gic.h>
    #include <dt-bindings/clock/pistachio-clk.h>

    timer@18102000 {
        compatible = "img,pistachio-gptimer";
        reg = <0x18102000 0x100>;
        interrupts = <GIC_SHARED 60 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SHARED 61 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SHARED 62 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SHARED 63 IRQ_TYPE_LEVEL_HIGH>;
        clocks = <&clk_periph PERIPH_CLK_COUNTER_FAST>,
                 <&clk_periph PERIPH_CLK_COUNTER_SLOW>,
                 <&cr_periph SYS_CLK_TIMER>;
        clock-names = "fast", "slow", "sys";
        img,cr-periph = <&cr_periph>;
    };