ARMv7-M SysTick

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

1. 요약·해설

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

요약과 해설

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 <alexandre.torgue@foss.st.com>

11 - Fabrice Gasnier <fabrice.gasnier@foss.st.com>

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

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 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>;
    };

...