Realtek Otto Timer/Counter

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

1. 요약·해설

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

요약과 해설

realtek,otto-timer.yaml:1-63

Realtek Otto timer0~timer4의 register·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/realtek,otto-timer.yaml#

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

7 title: Realtek Otto SoCs Timer/Counter

9 description:

10 Realtek SoCs support a number of timers/counters. These are used

11 as a per CPU clock event generator and an overall CPU clocksource.

13 maintainers:

14 - Chris Packham <chris.packham@alliedtelesis.co.nz>

16 properties:

17 $nodename:

18 pattern: "^timer@[0-9a-f]+$"

20 compatible:

21 items:

22 - enum:

23 - realtek,rtl9302-timer

24 - const: realtek,otto-timer

26 reg:

27 items:

28 - description: timer0 registers

29 - description: timer1 registers

30 - description: timer2 registers

31 - description: timer3 registers

32 - description: timer4 registers

34 clocks:

35 maxItems: 1

37 interrupts:

38 items:

39 - description: timer0 interrupt

40 - description: timer1 interrupt

41 - description: timer2 interrupt

42 - description: timer3 interrupt

43 - description: timer4 interrupt

45 required:

46 - compatible

47 - reg

48 - clocks

49 - interrupts

51 additionalProperties: false

53 examples:

54 - |

55 timer@3200 {

56 compatible = "realtek,rtl9302-timer", "realtek,otto-timer";

57 reg = <0x3200 0x10>, <0x3210 0x10>, <0x3220 0x10>,

58 <0x3230 0x10>, <0x3240 0x10>;

60 interrupt-parent = <&intc>;

61 interrupts = <7>, <8>, <9>, <10>, <11>;

62 clocks = <&lx_clk>;

63 };

3. 한국어 전문 번역

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

1-15

GPL-2.0-only 또는 BSD-2-Clause 라이선스의 이 스키마는 Realtek Otto SoC의 timer/counter를 정의합니다. 여러 timer/counter는 per-CPU clock event generator와 전체 CPU가 공유하는 clocksource로 사용됩니다. Maintainer는 Chris Packham입니다.

다섯 timer register와 interrupt

16-52

Node 이름은 `timer@<hex-address>` 형식입니다. `compatible`은 `realtek,rtl9302-timer` 뒤에 `realtek,otto-timer` fallback을 둡니다. `reg`는 timer0~timer4 register 영역 다섯 개, `interrupts`는 timer0~timer4 interrupt 다섯 개를 같은 순서로 담고 `clocks`는 최대 한 항목입니다. `compatible`, `reg`, `clocks`, `interrupts`가 필수이고 추가 속성은 허용되지 않습니다.

properties:
  $nodename:
    pattern: "^timer@[0-9a-f]+$"

  compatible:
    items:
      - enum:
          - realtek,rtl9302-timer
      - const: realtek,otto-timer

  reg:
    items:
      - description: timer0 registers
      - description: timer1 registers
      - description: timer2 registers
      - description: timer3 registers
      - description: timer4 registers

  clocks:
    maxItems: 1

  interrupts:
    items:
      - description: timer0 interrupt
      - description: timer1 interrupt
      - description: timer2 interrupt
      - description: timer3 interrupt
      - description: timer4 interrupt

required:
  - compatible
  - reg
  - clocks
  - interrupts

additionalProperties: false

RTL9302 다섯 timer 예제

53-63

예제는 `timer@3200`에서 0x3200~0x3240의 다섯 0x10-byte register 영역을 지정합니다. `intc`를 interrupt parent로 사용해 interrupt 7~11을 연결하고 `lx_clk` clock을 사용합니다.

examples:
  - |
    timer@3200 {
      compatible = "realtek,rtl9302-timer", "realtek,otto-timer";
      reg = <0x3200 0x10>, <0x3210 0x10>, <0x3220 0x10>,
            <0x3230 0x10>, <0x3240 0x10>;

      interrupt-parent = <&intc>;
      interrupts = <7>, <8>, <9>, <10>, <11>;
      clocks = <&lx_clk>;
    };