Allwinner A13 High-Speed Timer

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

1. 요약·해설

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

요약과 해설

allwinner,sun5i-a13-hstimer.yaml:1-77

A13·A20·A31 high-speed timer의 interrupt와 reset 구성을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며 compatible, clock, interrupt, register, phandle, 수치와 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 # SPDX-License-Identifier: GPL-2.0

2 %YAML 1.2

3 ---

4 $id: http://devicetree.org/schemas/timer/allwinner,sun5i-a13-hstimer.yaml#

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

7 title: Allwinner A13 High-Speed Timer

9 maintainers:

10 - Chen-Yu Tsai <wens@csie.org>

11 - Maxime Ripard <mripard@kernel.org>

13 properties:

14 compatible:

15 oneOf:

16 - const: allwinner,sun5i-a13-hstimer

17 - const: allwinner,sun7i-a20-hstimer

18 - items:

19 - const: allwinner,sun6i-a31-hstimer

20 - const: allwinner,sun7i-a20-hstimer

22 reg:

23 maxItems: 1

25 interrupts:

26 minItems: 2

27 items:

28 - description: Timer 0 Interrupt

29 - description: Timer 1 Interrupt

30 - description: Timer 2 Interrupt

31 - description: Timer 3 Interrupt

33 clocks:

34 maxItems: 1

36 resets:

37 maxItems: 1

39 required:

40 - compatible

41 - reg

42 - interrupts

43 - clocks

45 if:

46 properties:

47 compatible:

48 const: allwinner,sun5i-a13-hstimer

50 then:

51 properties:

52 interrupts:

53 minItems: 2

54 maxItems: 2

56 else:

57 properties:

58 interrupts:

59 minItems: 4

60 maxItems: 4

62 additionalProperties: false

64 examples:

65 - |

66 timer@1c60000 {

67 compatible = "allwinner,sun7i-a20-hstimer";

68 reg = <0x01c60000 0x1000>;

69 interrupts = <0 51 1>,

70 <0 52 1>,

71 <0 53 1>,

72 <0 54 1>;

73 clocks = <&ahb1_gates 19>;

74 resets = <&ahb1rst 19>;

75 };

77 ...

3. 한국어 전문 번역

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

1-12

GPL-2.0 라이선스의 이 스키마는 Allwinner A13 High-Speed Timer 계열을 정의합니다. Maintainer는 Chen-Yu Tsai와 Maxime Ripard입니다.

High-speed timer 자원

13-44

지원 조합은 A13 단독, A20 단독, 또는 `allwinner,sun6i-a31-hstimer` 뒤에 `allwinner,sun7i-a20-hstimer` fallback을 둔 형태입니다. `reg`, `clocks`, `resets`는 각각 최대 한 항목입니다. Interrupt는 최소 2개이며 항목 순서대로 Timer 0, Timer 1, Timer 2, Timer 3 interrupt를 뜻합니다. `compatible`, `reg`, `interrupts`, `clocks`가 필수이고 `resets`는 선택 사항입니다.

properties:
  compatible:
    oneOf:
      - const: allwinner,sun5i-a13-hstimer
      - const: allwinner,sun7i-a20-hstimer
      - items:
          - const: allwinner,sun6i-a31-hstimer
          - const: allwinner,sun7i-a20-hstimer

  reg:
    maxItems: 1

  interrupts:
    minItems: 2
    items:
      - description: Timer 0 Interrupt
      - description: Timer 1 Interrupt
      - description: Timer 2 Interrupt
      - description: Timer 3 Interrupt

  clocks:
    maxItems: 1

  resets:
    maxItems: 1

required:
  - compatible
  - reg
  - interrupts
  - clocks

A13과 다른 SoC의 interrupt 수

45-63

Compatible이 `allwinner,sun5i-a13-hstimer`이면 interrupt는 정확히 2개입니다. 그 밖의 A20 또는 A31 조합은 정확히 4개를 요구합니다. 정의되지 않은 추가 속성은 허용되지 않습니다.

if:
  properties:
    compatible:
      const: allwinner,sun5i-a13-hstimer

then:
  properties:
    interrupts:
      minItems: 2
      maxItems: 2

else:
  properties:
    interrupts:
      minItems: 4
      maxItems: 4

additionalProperties: false

A20 네 interrupt 예제

64-77

A20 예제는 `timer@1c60000`에 0x1000-byte register 영역을 두고 interrupt 51부터 54까지 네 개를 지정합니다. `ahb1_gates`와 `ahb1rst`의 index 19를 각각 clock과 reset으로 연결합니다.

  - |
    timer@1c60000 {
        compatible = "allwinner,sun7i-a20-hstimer";
        reg = <0x01c60000 0x1000>;
        interrupts = <0 51 1>,
                     <0 52 1>,
                     <0 53 1>,
                     <0 54 1>;
        clocks = <&ahb1_gates 19>;
        resets = <&ahb1rst 19>;
    };

...