Amlogic Meson6 Timer Controller

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

1. 요약·해설

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

요약과 해설

amlogic,meson6-timer.yaml:1-54

Meson6 timer controller의 네 event interrupt와 두 clock을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며 compatible, clock, interrupt, 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/amlogic,meson6-timer.yaml#

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

7 title: Amlogic Meson6 SoCs Timer Controller

9 maintainers:

10 - Neil Armstrong <[email protected]>

11 - Martin Blumenstingl <[email protected]>

13 properties:

14 compatible:

15 const: amlogic,meson6-timer

17 reg:

18 maxItems: 1

20 interrupts:

21 maxItems: 4

22 description: per-timer event interrupts

24 clocks:

25 maxItems: 2

27 clock-names:

28 items:

29 - const: xtal

30 - const: pclk

32 required:

33 - compatible

34 - reg

35 - interrupts

36 - clocks

37 - clock-names

39 additionalProperties: false

41 examples:

42 - |

43 #include <dt-bindings/interrupt-controller/irq.h>

44 #include <dt-bindings/interrupt-controller/arm-gic.h>

45 timer@c1109940 {

46 compatible = "amlogic,meson6-timer";

47 reg = <0xc1109940 0x14>;

48 interrupts = <GIC_SPI 10 IRQ_TYPE_EDGE_RISING>,

49 <GIC_SPI 11 IRQ_TYPE_EDGE_RISING>,

50 <GIC_SPI 6 IRQ_TYPE_EDGE_RISING>,

51 <GIC_SPI 29 IRQ_TYPE_EDGE_RISING>;

52 clocks = <&xtal>, <&clk81>;

53 clock-names = "xtal", "pclk";

54 };

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

1-12

GPL-2.0-only 또는 BSD-2-Clause 라이선스의 이 스키마는 Amlogic Meson6 SoC Timer Controller를 정의합니다. Maintainer는 Neil Armstrong과 Martin Blumenstingl입니다.

Timer별 event IRQ와 두 clock

13-40

`compatible`은 `amlogic,meson6-timer`이고 `reg`는 최대 한 항목입니다. `interrupts`는 timer별 event interrupt를 최대 4개까지 담습니다. `clocks`는 최대 두 항목이며 `clock-names` 순서는 `xtal`, `pclk`입니다. `compatible`, `reg`, `interrupts`, `clocks`, `clock-names`가 모두 필수이고 추가 속성은 허용되지 않습니다.

properties:
  compatible:
    const: amlogic,meson6-timer

  reg:
    maxItems: 1

  interrupts:
    maxItems: 4
    description: per-timer event interrupts

  clocks:
    maxItems: 2

  clock-names:
    items:
      - const: xtal
      - const: pclk

required:
  - compatible
  - reg
  - interrupts
  - clocks
  - clock-names

additionalProperties: false

Meson6 네 event interrupt 예제

41-54

예제는 `timer@c1109940`에 0x14-byte register 영역을 두고 GIC SPI 10, GIC SPI 11, GIC SPI 6, GIC SPI 29를 rising-edge interrupt로 연결합니다. `xtal`과 `clk81` clock은 각각 `xtal`, `pclk` 이름에 대응합니다.

- |
  #include <dt-bindings/interrupt-controller/irq.h>
  #include <dt-bindings/interrupt-controller/arm-gic.h>
  timer@c1109940 {
      compatible = "amlogic,meson6-timer";
      reg = <0xc1109940 0x14>;
      interrupts = <GIC_SPI 10 IRQ_TYPE_EDGE_RISING>,
                   <GIC_SPI 11 IRQ_TYPE_EDGE_RISING>,
                   <GIC_SPI 6 IRQ_TYPE_EDGE_RISING>,
                   <GIC_SPI 29 IRQ_TYPE_EDGE_RISING>;
      clocks = <&xtal>, <&clk81>;
      clock-names = "xtal", "pclk";
  };