Renesas Multi-Function Timer Pulse Unit 2

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

1. 요약·해설

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

요약과 해설

renesas,mtu2.yaml:1-76

Renesas MTU2의 다섯 channel과 interrupt 이름을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며 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/renesas,mtu2.yaml#

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

7 title: Renesas Multi-Function Timer Pulse Unit 2 (MTU2)

9 maintainers:

10 - Geert Uytterhoeven <[email protected]>

11 - Laurent Pinchart <[email protected]>

13 description:

14 The MTU2 is a multi-purpose, multi-channel timer/counter with configurable clock inputs

15 and programmable compare match.

17 Channels share hardware resources but their counter and compare match value are

18 independent. The MTU2 hardware supports five channels indexed from 0 to 4.

20 properties:

21 compatible:

22 items:

23 - enum:

24 - renesas,mtu2-r7s72100 # RZ/A1H

25 - const: renesas,mtu2

27 reg:

28 maxItems: 1

30 interrupts:

31 minItems: 1

32 maxItems: 5

33 description: One entry for each enabled channel.

35 interrupt-names:

36 minItems: 1

37 items:

38 - const: tgi0a

39 - const: tgi1a

40 - const: tgi2a

41 - const: tgi3a

42 - const: tgi4a

44 clocks:

45 maxItems: 1

47 clock-names:

48 const: fck

50 power-domains:

51 maxItems: 1

53 required:

54 - compatible

55 - reg

56 - interrupts

57 - interrupt-names

58 - clocks

59 - clock-names

60 - power-domains

62 additionalProperties: false

64 examples:

65 - |

66 #include <dt-bindings/clock/r7s72100-clock.h>

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

68 mtu2: timer@fcff0000 {

69 compatible = "renesas,mtu2-r7s72100", "renesas,mtu2";

70 reg = <0xfcff0000 0x400>;

71 interrupts = <GIC_SPI 107 IRQ_TYPE_LEVEL_HIGH>;

72 interrupt-names = "tgi0a";

73 clocks = <&mstp3_clks R7S72100_CLK_MTU2>;

74 clock-names = "fck";

75 power-domains = <&cpg_clocks>;

76 };

3. 한국어 전문 번역

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

1-19

GPL-2.0-only 또는 BSD-2-Clause 라이선스의 이 스키마는 Renesas Multi-Function Timer Pulse Unit 2(MTU2)를 정의합니다. MTU2는 clock input을 설정하고 compare match를 programming할 수 있는 multi-purpose, multi-channel timer/counter입니다. Channel은 hardware resource를 공유하지만 counter와 compare match 값은 독립적이며, hardware는 index 0~4의 다섯 channel을 지원합니다. Maintainer는 Geert Uytterhoeven와 Laurent Pinchart입니다.

다섯 channel과 interrupt 이름

20-63

RZ/A1H는 `renesas,mtu2-r7s72100` 뒤에 generic `renesas,mtu2` fallback을 둡니다. `reg`, `clocks`, `power-domains`는 각각 최대 한 항목입니다. 활성화한 channel마다 interrupt 하나를 두어 1~5개를 사용하며 이름은 channel 순서대로 `tgi0a`, `tgi1a`, `tgi2a`, `tgi3a`, `tgi4a`입니다. Clock 이름은 `fck`입니다. 모든 열거 속성이 필수이고 추가 속성은 허용되지 않습니다.

properties:
  compatible:
    items:
      - enum:
          - renesas,mtu2-r7s72100 # RZ/A1H
      - const: renesas,mtu2

  reg:
    maxItems: 1

  interrupts:
    minItems: 1
    maxItems: 5
    description: One entry for each enabled channel.

  interrupt-names:
    minItems: 1
    items:
      - const: tgi0a
      - const: tgi1a
      - const: tgi2a
      - const: tgi3a
      - const: tgi4a

  clocks:
    maxItems: 1

  clock-names:
    const: fck

  power-domains:
    maxItems: 1

required:
  - compatible
  - reg
  - interrupts
  - interrupt-names
  - clocks
  - clock-names
  - power-domains

additionalProperties: false

RZ/A1H MTU2 예제

64-76

예제는 `timer@fcff0000`에 0x400-byte register 영역을 두고 channel 0의 GIC SPI 107 level-high interrupt를 `tgi0a`로 지정합니다. `mstp3_clks`의 `R7S72100_CLK_MTU2`를 `fck`으로 연결하고 `cpg_clocks` power domain을 사용합니다.

examples:
  - |
    #include <dt-bindings/clock/r7s72100-clock.h>
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    mtu2: timer@fcff0000 {
        compatible = "renesas,mtu2-r7s72100", "renesas,mtu2";
        reg = <0xfcff0000 0x400>;
        interrupts = <GIC_SPI 107 IRQ_TYPE_LEVEL_HIGH>;
        interrupt-names = "tgi0a";
        clocks = <&mstp3_clks R7S72100_CLK_MTU2>;
        clock-names = "fck";
        power-domains = <&cpg_clocks>;
    };