Realtek Otto Timer/Counter

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

1. 요약·해설

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

요약과 해설

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

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

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