Documentation/devicetree/bindings/watchdog/intel,keembay-wdt.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / Watchdog

Intel Keem Bay Non-Secure Watchdog

Keem Bay non-secure 워치독의 threshold·timeout interrupt와 timer 클록을 설명합니다.

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

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

1. 요약·해설

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

요약과 해설

intel,keembay-wdt.yaml:1-60

Keem Bay non-secure 워치독의 threshold·timeout interrupt와 timer 클록을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, GPIO, 예제와 원문 줄 좌표를 원형대로 보존합니다.

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/intel,keembay-wdt.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Intel Keem Bay SoC non-secure Watchdog Timer
8
9 maintainers:
10 - Wan Ahmad Zainie <[email protected]>
11
12 allOf:
13 - $ref: watchdog.yaml#
14
15 properties:
16 compatible:
17 enum:
18 - intel,keembay-wdt
19
20 reg:
21 maxItems: 1
22
23 clocks:
24 maxItems: 1
25
26 interrupts:
27 items:
28 - description: interrupt specifier for threshold interrupt line
29 - description: interrupt specifier for timeout interrupt line
30
31 interrupt-names:
32 items:
33 - const: threshold
34 - const: timeout
35
36 required:
37 - compatible
38 - reg
39 - interrupts
40 - interrupt-names
41 - clocks
42
43 unevaluatedProperties: false
44
45 examples:
46 - |
47 #include <dt-bindings/interrupt-controller/arm-gic.h>
48 #include <dt-bindings/interrupt-controller/irq.h>
49 #define KEEM_BAY_A53_TIM
50
51 watchdog: watchdog@2033009c {
52 compatible = "intel,keembay-wdt";
53 reg = <0x2033009c 0x10>;
54 interrupts = <GIC_SPI 1 IRQ_TYPE_LEVEL_HIGH>,
55 <GIC_SPI 2 IRQ_TYPE_LEVEL_HIGH>;
56 interrupt-names = "threshold", "timeout";
57 clocks = <&scmi_clk KEEM_BAY_A53_TIM>;
58 };
59
60 ...
61

3. 한국어 전문 번역

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

Intel Keem Bay non-secure 워치독

1-11

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 스키마는 Intel Keem Bay SoC의 non-secure 워치독 타이머를 정의합니다. 관리자는 Wan Ahmad Zainie입니다.

threshold·timeout interrupt

12-44

공통 `watchdog.yaml`을 상속하고 `compatible`은 `intel,keembay-wdt`입니다. `reg`와 `clocks`는 각각 최대 하나입니다.

`interrupts`에는 첫째 threshold interrupt line, 둘째 timeout interrupt line의 specifier를 제공합니다. `interrupt-names`도 같은 순서로 `threshold`, `timeout`을 사용합니다. `compatible`, `reg`, `interrupts`, `interrupt-names`, `clocks`가 모두 필수이며 평가되지 않은 추가 속성은 허용하지 않습니다.

allOf:
  - $ref: watchdog.yaml#

properties:
  compatible:
    enum:
      - intel,keembay-wdt

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  interrupts:
    items:
      - description: interrupt specifier for threshold interrupt line
      - description: interrupt specifier for timeout interrupt line

  interrupt-names:
    items:
      - const: threshold
      - const: timeout

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

unevaluatedProperties: false

Keem Bay A53 timer 예제

45-60

예제는 주소 `0x2033009c`의 Keem Bay 워치독에 level-high GIC SPI 1과 2를 각각 threshold, timeout interrupt로 연결합니다. SCMI clock의 `KEEM_BAY_A53_TIM`도 제공합니다.

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

    watchdog: watchdog@2033009c {
        compatible = "intel,keembay-wdt";
        reg = <0x2033009c 0x10>;
        interrupts = <GIC_SPI 1 IRQ_TYPE_LEVEL_HIGH>,
                     <GIC_SPI 2 IRQ_TYPE_LEVEL_HIGH>;
        interrupt-names = "threshold", "timeout";
        clocks = <&scmi_clk KEEM_BAY_A53_TIM>;
    };

...