← Documents Documentation/devicetree/bindings/watchdog/mediatek,mtk-wdt.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / Watchdog

MediaTek SoC Watchdog Timer

MediaTek SoC 워치독의 pre-timeout interrupt와 reset 제어 속성을 설명합니다.

Source pathDocumentation/devicetree/bindings/watchdog/mediatek,mtk-wdt.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

mediatek,mtk-wdt.yaml:1-90

MediaTek SoC 워치독의 pre-timeout interrupt와 reset 제어 속성을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, GPIO, reset, 예제와 원문 줄 좌표를 원형대로 보존합니다.

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/watchdog/mediatek,mtk-wdt.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: MediaTek SoCs Watchdog timer
8
9 maintainers:
10 - Matthias Brugger <[email protected]>
11
12 description:
13 The watchdog supports a pre-timeout interrupt that fires
14 timeout-sec/2 before the expiry.
15
16 allOf:
17 - $ref: watchdog.yaml#
18
19 properties:
20 compatible:
21 oneOf:
22 - enum:
23 - mediatek,mt2712-wdt
24 - mediatek,mt6589-wdt
25 - mediatek,mt6735-wdt
26 - mediatek,mt6795-wdt
27 - mediatek,mt7986-wdt
28 - mediatek,mt7988-wdt
29 - mediatek,mt8183-wdt
30 - mediatek,mt8186-wdt
31 - mediatek,mt8188-wdt
32 - mediatek,mt8192-wdt
33 - mediatek,mt8195-wdt
34 - items:
35 - enum:
36 - mediatek,mt2701-wdt
37 - mediatek,mt6572-wdt
38 - mediatek,mt6582-wdt
39 - mediatek,mt6797-wdt
40 - mediatek,mt7622-wdt
41 - mediatek,mt7623-wdt
42 - mediatek,mt7629-wdt
43 - mediatek,mt8173-wdt
44 - mediatek,mt8365-wdt
45 - mediatek,mt8516-wdt
46 - const: mediatek,mt6589-wdt
47
48 reg:
49 maxItems: 1
50
51 interrupts:
52 items:
53 - description: Watchdog pre-timeout (bark) interrupt
54
55 mediatek,disable-extrst:
56 description: Disable sending output reset signal
57 type: boolean
58
59 mediatek,reset-by-toprgu:
60 description: The Top Reset Generation Unit (TOPRGU) generates reset signals
61 and distributes them to each IP. If present, the watchdog timer will be
62 reset by TOPRGU once system resets.
63 type: boolean
64
65 '#reset-cells':
66 const: 1
67
68 required:
69 - compatible
70 - reg
71
72 unevaluatedProperties: false
73
74 examples:
75 - |
76 #include <dt-bindings/interrupt-controller/arm-gic.h>
77
78 soc {
79 #address-cells = <2>;
80 #size-cells = <2>;
81
82 watchdog: watchdog@10007000 {
83 compatible = "mediatek,mt8183-wdt";
84 reg = <0 0x10007000 0 0x100>;
85 interrupts = <GIC_SPI 139 IRQ_TYPE_LEVEL_LOW>;
86 mediatek,disable-extrst;
87 timeout-sec = <10>;
88 #reset-cells = <1>;
89 };
90 };
91

3. 한국어 전문 번역

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

MediaTek SoC 워치독과 pre-timeout

1-18

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 스키마는 MediaTek SoC Watchdog Timer를 정의합니다. 이 워치독은 만료 시점보다 `timeout-sec/2`만큼 앞서 발생하는 pre-timeout interrupt를 지원합니다. 공통 `watchdog.yaml`을 상속하며 관리자는 Matthias Brugger입니다.

직접 호환 SoC와 fallback 계열

19-47

`compatible`에는 MT2712, MT6589, MT6735, MT6795, MT7986, MT7988, MT8183, MT8186, MT8188, MT8192, MT8195 전용 문자열을 직접 사용할 수 있습니다.

MT2701, MT6572, MT6582, MT6797, MT7622, MT7623, MT7629, MT8173, MT8365, MT8516은 각 SoC 문자열 뒤에 `mediatek,mt6589-wdt`를 fallback으로 나열합니다.

properties:
  compatible:
    oneOf:
      - enum:
          - mediatek,mt2712-wdt
          - mediatek,mt6589-wdt
          - mediatek,mt6735-wdt
          - mediatek,mt6795-wdt
          - mediatek,mt7986-wdt
          - mediatek,mt7988-wdt
          - mediatek,mt8183-wdt
          - mediatek,mt8186-wdt
          - mediatek,mt8188-wdt
          - mediatek,mt8192-wdt
          - mediatek,mt8195-wdt
      - items:
          - enum:
              - mediatek,mt2701-wdt
              - mediatek,mt6572-wdt
              - mediatek,mt6582-wdt
              - mediatek,mt6797-wdt
              - mediatek,mt7622-wdt
              - mediatek,mt7623-wdt
              - mediatek,mt7629-wdt
              - mediatek,mt8173-wdt
              - mediatek,mt8365-wdt
              - mediatek,mt8516-wdt
          - const: mediatek,mt6589-wdt

bark interrupt와 외부 reset 제어

48-73

`reg`는 항목 하나만 받습니다. `interrupts`의 유일한 항목은 워치독 pre-timeout, 즉 bark interrupt입니다.

boolean `mediatek,disable-extrst`는 외부 reset 신호 출력을 막습니다. `mediatek,reset-by-toprgu`가 있으면 Top Reset Generation Unit(TOPRGU)이 각 IP로 reset 신호를 분배하고, 시스템 reset 시 워치독 타이머도 TOPRGU에 의해 reset됩니다.

`#reset-cells`는 1입니다. `compatible`과 `reg`가 필수이며 공통 스키마에서 평가되지 않은 속성은 허용하지 않습니다.

  reg:
    maxItems: 1

  interrupts:
    items:
      - description: Watchdog pre-timeout (bark) interrupt

  mediatek,disable-extrst:
    description: Disable sending output reset signal
    type: boolean

  mediatek,reset-by-toprgu:
    description: The Top Reset Generation Unit (TOPRGU) generates reset signals
      and distributes them to each IP. If present, the watchdog timer will be
      reset by TOPRGU once system resets.
    type: boolean

  '#reset-cells':
    const: 1

required:
  - compatible
  - reg

unevaluatedProperties: false

MT8183 bark interrupt 예제

74-90

예제는 MT8183 워치독 레지스터에 active-low GIC SPI 139를 bark interrupt로 연결하고, 외부 reset 출력을 끄며 timeout을 10초로 설정합니다. 이 노드는 reset controller로도 쓰이므로 `#reset-cells = <1>`을 선언합니다.

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

    soc {
        #address-cells = <2>;
        #size-cells = <2>;

        watchdog: watchdog@10007000 {
            compatible = "mediatek,mt8183-wdt";
            reg = <0 0x10007000 0 0x100>;
            interrupts = <GIC_SPI 139 IRQ_TYPE_LEVEL_LOW>;
            mediatek,disable-extrst;
            timeout-sec = <10>;
            #reset-cells = <1>;
        };
    };