Allwinner A13 High-Speed Timer

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

1. 요약·해설

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

요약과 해설

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

11 - Maxime Ripard <[email protected]>

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

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

...