NXP System Counter Module | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

nxp,sysctr-timer.yaml:1-65

NXP system counter의 shared time base와 divider 옵션을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며 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/nxp,sysctr-timer.yaml#

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

7 title: NXP System Counter Module(sys_ctr)

9 maintainers:

10 - Bai Ping <[email protected]>

12 description: |

13 The system counter(sys_ctr) is a programmable system counter

14 which provides a shared time base to Cortex A15, A7, A53, A73,

15 etc. it is intended for use in applications where the counter

16 is always powered and support multiple, unrelated clocks. The

17 compare frame inside can be used for timer purpose.

19 properties:

20 compatible:

21 oneOf:

22 - enum:

23 - nxp,imx95-sysctr-timer

24 - nxp,sysctr-timer

25 - items:

26 - enum:

27 - nxp,imx94-sysctr-timer

28 - const: nxp,imx95-sysctr-timer

30 reg:

31 maxItems: 1

33 interrupts:

34 maxItems: 1

36 clocks:

37 maxItems: 1

39 clock-names:

40 const: per

42 nxp,no-divider:

43 description: if present, means there is no internal base clk divider.

44 type: boolean

46 required:

47 - compatible

48 - reg

49 - interrupts

50 - clocks

51 - clock-names

53 additionalProperties: false

55 examples:

56 - |

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

59 timer@306a0000 {

60 compatible = "nxp,sysctr-timer";

61 reg = <0x306a0000 0x20000>;

62 clocks = <&clk_8m>;

63 clock-names = "per";

64 interrupts = <GIC_SPI 47 IRQ_TYPE_LEVEL_HIGH>;

65 };

3. 한국어 전문 번역

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

NXP system counter

1-18

GPL-2.0-only 또는 BSD-2-Clause 라이선스의 이 스키마는 Cortex-A15·A7·A53·A73 등에 shared time base를 제공하는 programmable NXP system counter(`sys_ctr`)를 정의합니다. 항상 전원이 공급되고 서로 무관한 여러 clock을 지원하는 application을 위한 장치이며 내부 compare frame을 timer로 사용할 수 있습니다. Maintainer는 Bai Ping입니다.

i.MX94 fallback과 divider 선택

19-54

`nxp,imx95-sysctr-timer`와 generic `nxp,sysctr-timer`는 단독 사용할 수 있습니다. i.MX94는 `nxp,imx94-sysctr-timer` 뒤에 i.MX95 fallback을 둡니다. `reg`, `interrupts`, `clocks`는 각각 최대 한 항목이고 clock 이름은 `per`입니다. Boolean `nxp,no-divider`가 있으면 internal base clock divider가 없음을 뜻합니다. `compatible`, `reg`, `interrupts`, `clocks`, `clock-names`가 필수이며 추가 속성은 허용되지 않습니다.

properties:
  compatible:
    oneOf:
      - enum:
          - nxp,imx95-sysctr-timer
          - nxp,sysctr-timer
      - items:
          - enum:
              - nxp,imx94-sysctr-timer
          - const: nxp,imx95-sysctr-timer

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-names:
    const: per

  nxp,no-divider:
    description: if present, means there is no internal base clk divider.
    type: boolean

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

additionalProperties: false

NXP system counter 예제

55-65

예제는 `timer@306a0000`에 0x20000-byte register 영역, `clk_8m`을 `per` clock으로 연결하고 GIC SPI 47 level-high interrupt를 지정합니다.

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>

    timer@306a0000 {
        compatible = "nxp,sysctr-timer";
        reg = <0x306a0000 0x20000>;
        clocks = <&clk_8m>;
        clock-names = "per";
        interrupts = <GIC_SPI 47 IRQ_TYPE_LEVEL_HIGH>;
     };