VIA/WonderMedia VT8500 Timer

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

1. 요약·해설

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

요약과 해설

via,vt8500-timer.yaml:1-51

VT8500의 3 MHz counter·match interrupt·watchdog 동작을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며 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/via,vt8500-timer.yaml#

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

7 title: VIA/Wondermedia VT8500 Timer

9 description:

10 This is the timer block that is a standalone part of the system power

11 management controller on VIA/WonderMedia SoCs (VIA VT8500 and alike).

12 The hardware has a single 32-bit counter running at 3 MHz and four match

13 registers, each of which is associated with a dedicated match interrupt,

14 and the first of which can also serve as the system watchdog (if the

15 watchdog function is enabled, it will reset the system upon match instead

16 of triggering its respective interrupt)

18 maintainers:

19 - Alexey Charkov <alchark@gmail.com>

21 properties:

22 compatible:

23 const: via,vt8500-timer

25 reg:

26 maxItems: 1

28 interrupts:

29 minItems: 1

30 items:

31 - description: Channel 0 match. Note that if the watchdog function

32 is enabled, this interrupt will not fire and the system will

33 reboot instead once the counter reaches match register 0 value

34 - description: Channel 1 match

35 - description: Channel 2 match

36 - description: Channel 3 match

38 required:

39 - compatible

40 - reg

41 - interrupts

43 additionalProperties: false

45 examples:

46 - |

47 timer@d8130100 {

48 compatible = "via,vt8500-timer";

49 reg = <0xd8130100 0x28>;

50 interrupts = <36>;

51 };

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

1-20

GPL-2.0-only 또는 BSD-2-Clause 라이선스의 이 스키마는 VIA VT8500 계열을 포함한 VIA/WonderMedia SoC에서 system power management controller의 독립된 부분으로 존재하는 timer block을 정의합니다. Hardware에는 3 MHz로 동작하는 단일 32-bit counter와 match register 네 개가 있습니다.

각 match register에는 전용 match interrupt가 연결됩니다. 첫 match register는 system watchdog로도 사용할 수 있으며, watchdog 기능을 enable하면 match 시 해당 interrupt를 발생시키는 대신 system을 reset합니다. Maintainer는 Alexey Charkov입니다.

네 match channel과 watchdog 동작

21-44

`compatible`은 `via,vt8500-timer`이고 `reg`는 최대 한 영역입니다. `interrupts`는 최소 한 항목이며 channel 0·1·2·3 match interrupt 순서로 최대 네 개를 기술할 수 있습니다. Watchdog 기능이 enable된 경우 channel 0 interrupt는 발생하지 않고 counter가 match register 0 값에 도달하면 system이 reboot됩니다. `compatible`, `reg`, `interrupts`가 필수이며 추가 속성은 허용하지 않습니다.

properties:
  compatible:
    const: via,vt8500-timer

  reg:
    maxItems: 1

  interrupts:
    minItems: 1
    items:
      - description: Channel 0 match. Note that if the watchdog function
          is enabled, this interrupt will not fire and the system will
          reboot instead once the counter reaches match register 0 value
      - description: Channel 1 match
      - description: Channel 2 match
      - description: Channel 3 match

required:
  - compatible
  - reg
  - interrupts

additionalProperties: false

VT8500 timer 예제

45-51

예제 `timer@d8130100`은 0x28-byte register 영역과 interrupt 36을 지정합니다.

examples:
  - |
    timer@d8130100 {
        compatible = "via,vt8500-timer";
        reg = <0xd8130100 0x28>;
        interrupts = <36>;
    };