Synopsys DesignWare APB Timer

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

1. 요약·해설

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

요약과 해설

snps,dw-apb-timer.yaml:1-84

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

2. 영어 원문 전체

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

원문 전체 펼치기

1 # SPDX-License-Identifier: GPL-2.0-only

2 %YAML 1.2

3 ---

4 $id: http://devicetree.org/schemas/timer/snps,dw-apb-timer.yaml#

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

7 title: Synopsys DesignWare APB Timer

9 maintainers:

10 - Daniel Lezcano <[email protected]>

12 properties:

13 compatible:

14 oneOf:

15 - const: snps,dw-apb-timer

16 - enum:

17 - snps,dw-apb-timer-sp

18 - snps,dw-apb-timer-osc

19 deprecated: true

21 reg:

22 maxItems: 1

24 interrupts:

25 maxItems: 1

27 resets:

28 maxItems: 1

30 clocks:

31 minItems: 1

32 items:

33 - description: Timer ticks reference clock source

34 - description: APB interface clock source

36 clock-names:

37 minItems: 1

38 items:

39 - const: timer

40 - const: pclk

42 clock-frequency: true

44 additionalProperties: false

46 required:

47 - compatible

48 - reg

49 - interrupts

51 oneOf:

52 - required:

53 - clocks

54 - clock-names

55 - required:

56 - clock-frequency

57 - required:

58 - clock-freq

60 examples:

61 - |

62 timer@ffe00000 {

63 compatible = "snps,dw-apb-timer";

64 interrupts = <0 170 4>;

65 reg = <0xffe00000 0x1000>;

66 clocks = <&timer_clk>, <&timer_pclk>;

67 clock-names = "timer", "pclk";

68 };

69 - |

70 timer@ffe00000 {

71 compatible = "snps,dw-apb-timer";

72 interrupts = <0 170 4>;

73 reg = <0xffe00000 0x1000>;

74 clocks = <&timer_clk>;

75 clock-names = "timer";

76 };

77 - |

78 timer@ffe00000 {

79 compatible = "snps,dw-apb-timer";

80 interrupts = <0 170 4>;

81 reg = <0xffe00000 0x1000>;

82 clock-frequency = <25000000>;

83 };

84 ...

3. 한국어 전문 번역

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

1-20

GPL-2.0-only 라이선스의 이 스키마는 Synopsys DesignWare APB Timer를 정의합니다. `compatible`은 `snps,dw-apb-timer`를 사용합니다. 이전의 `snps,dw-apb-timer-sp`와 `snps,dw-apb-timer-osc` 값은 deprecated입니다. Maintainer는 Daniel Lezcano입니다.

properties:
  compatible:
    oneOf:
      - const: snps,dw-apb-timer
      - enum:
          - snps,dw-apb-timer-sp
          - snps,dw-apb-timer-osc
        deprecated: true

Register·interrupt·reset과 두 clock

21-44

`reg`, `interrupts`, `resets`는 각각 최대 한 항목입니다. `clocks`는 최소 한 항목이며 첫째는 timer tick reference clock source, 둘째는 APB interface clock source입니다. 대응하는 `clock-names`의 순서는 `timer`, `pclk`입니다. 별도의 fixed frequency를 사용할 때는 `clock-frequency` 속성을 쓸 수 있습니다. 정의되지 않은 추가 속성은 허용하지 않습니다.

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  resets:
    maxItems: 1

  clocks:
    minItems: 1
    items:
      - description: Timer ticks reference clock source
      - description: APB interface clock source

  clock-names:
    minItems: 1
    items:
      - const: timer
      - const: pclk

  clock-frequency: true

additionalProperties: false

Clock 지정 방식의 세 가지 선택지

45-59

`compatible`, `reg`, `interrupts`가 공통 필수 속성입니다. Clock 정보는 세 방식 중 정확히 하나의 조건을 만족해야 합니다. 첫째는 `clocks`와 `clock-names`를 함께 제공하는 방식, 둘째는 `clock-frequency`를 제공하는 방식, 셋째는 legacy `clock-freq`를 제공하는 방식입니다.

required:
  - compatible
  - reg
  - interrupts

oneOf:
  - required:
      - clocks
      - clock-names
  - required:
      - clock-frequency
  - required:
      - clock-freq

Dual clock·single clock·fixed frequency

60-84

세 예제는 모두 `timer@ffe00000`, `snps,dw-apb-timer`, interrupt `<0 170 4>`, 0x1000-byte register 영역을 사용합니다. 첫째는 `timer_clk`와 `timer_pclk`를 각각 `timer`, `pclk`로 연결합니다. 둘째는 `timer_clk` 하나만 `timer`로 연결합니다. 셋째는 clock phandle 대신 `clock-frequency = <25000000>`으로 25 MHz를 지정합니다.

examples:
  - |
    timer@ffe00000 {
      compatible = "snps,dw-apb-timer";
      interrupts = <0 170 4>;
      reg = <0xffe00000 0x1000>;
      clocks = <&timer_clk>, <&timer_pclk>;
      clock-names = "timer", "pclk";
    };
  - |
    timer@ffe00000 {
      compatible = "snps,dw-apb-timer";
      interrupts = <0 170 4>;
      reg = <0xffe00000 0x1000>;
      clocks = <&timer_clk>;
      clock-names = "timer";
    };
  - |
    timer@ffe00000 {
      compatible = "snps,dw-apb-timer";
      interrupts = <0 170 4>;
      reg = <0xffe00000 0x1000>;
      clock-frequency = <25000000>;
    };
...