Intel Keem Bay Non-Secure Watchdog | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

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#

7 title: Intel Keem Bay SoC non-secure Watchdog Timer

9 maintainers:

10 - Wan Ahmad Zainie <wan.ahmad.zainie.wan.mohamad@intel.com>

12 allOf:

13 - $ref: watchdog.yaml#

15 properties:

16 compatible:

17 enum:

18 - intel,keembay-wdt

20 reg:

21 maxItems: 1

23 clocks:

24 maxItems: 1

26 interrupts:

27 items:

28 - description: interrupt specifier for threshold interrupt line

29 - description: interrupt specifier for timeout interrupt line

31 interrupt-names:

32 items:

33 - const: threshold

34 - const: timeout

36 required:

37 - compatible

38 - reg

39 - interrupts

40 - interrupt-names

41 - clocks

43 unevaluatedProperties: false

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

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 };

60 ...

3. 한국어 전문 번역

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

...