ARMv7-M SysTick

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

1. 요약·해설

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

요약과 해설

arm,armv7m-systick.yaml:1-54

SysTick의 provider clock 또는 고정 clock-frequency 구성을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며 register, interrupt, clock, phandle, erratum, 수치와 줄 좌표를 원형대로 보존합니다.

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/arm,armv7m-systick.yaml#

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

7 title: ARMv7M System Timer

9 maintainers:

10 - Alexandre Torgue <[email protected]>

11 - Fabrice Gasnier <[email protected]>

13 description: ARMv7-M includes a system timer, known as SysTick.

15 properties:

16 compatible:

17 const: arm,armv7m-systick

19 reg:

20 maxItems: 1

22 clocks:

23 maxItems: 1

25 clock-frequency: true

27 oneOf:

28 - required:

29 - clocks

30 - required:

31 - clock-frequency

33 required:

34 - compatible

35 - reg

37 additionalProperties: false

39 examples:

40 - |

41 timer@e000e010 {

42 compatible = "arm,armv7m-systick";

43 reg = <0xe000e010 0x10>;

44 clocks = <&clk_systick>;

45 };

47 - |

48 timer@e000e010 {

49 compatible = "arm,armv7m-systick";

50 reg = <0xe000e010 0x10>;

51 clock-frequency = <90000000>;

52 };

54 ...

3. 한국어 전문 번역

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

1-14

GPL-2.0-only 또는 BSD-2-Clause 라이선스의 이 스키마는 ARMv7-M에 포함된 system timer인 SysTick을 정의합니다. Maintainer는 Alexandre Torgue와 Fabrice Gasnier입니다.

Clock source 선택

15-38

`compatible`은 `arm,armv7m-systick`, `reg`와 `clocks`는 각각 최대 한 항목이며 `clock-frequency`도 사용할 수 있습니다. Clock provider를 가리키는 `clocks` 또는 고정 주파수를 직접 적는 `clock-frequency` 중 하나가 반드시 필요합니다. 공통 필수 속성은 `compatible`과 `reg`이고 추가 속성은 허용되지 않습니다.

properties:
  compatible:
    const: arm,armv7m-systick

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-frequency: true

oneOf:
  - required:
      - clocks
  - required:
      - clock-frequency

required:
  - compatible
  - reg

additionalProperties: false

Provider clock과 90MHz 고정 clock

39-54

첫 예제는 `timer@e000e010`의 0x10-byte 영역에 `clk_systick` phandle을 연결합니다. 둘째 예제는 같은 register 영역에서 phandle 대신 `clock-frequency = <90000000>`을 사용합니다.

  - |
    timer@e000e010 {
        compatible = "arm,armv7m-systick";
        reg = <0xe000e010 0x10>;
        clocks = <&clk_systick>;
    };

  - |
    timer@e000e010 {
        compatible = "arm,armv7m-systick";
        reg = <0xe000e010 0x10>;
        clock-frequency = <90000000>;
    };

...