SBSA Generic Watchdog | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

arm,sbsa-gwdt.yaml:1-50

SBSA 범용 워치독의 2단계 timeout, control·refresh frame과 WS0 interrupt를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, 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/arm,sbsa-gwdt.yaml#

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

7 title: SBSA (Server Base System Architecture) Generic Watchdog

9 maintainers:

10 - Fu Wei <[email protected]>

12 description: |

13 The SBSA Generic Watchdog Timer is used to force a reset of the system after

14 two stages of timeout have elapsed. A detailed definition of the watchdog

15 timer can be found in the ARM document: ARM-DEN-0029 - Server Base System

16 Architecture (SBSA)

18 allOf:

19 - $ref: watchdog.yaml#

21 properties:

22 compatible:

23 const: arm,sbsa-gwdt

25 reg:

26 items:

27 - description: Watchdog control frame

28 - description: Refresh frame

30 interrupts:

31 description: The Watchdog Signal 0 (WS0) SPI (Shared Peripheral Interrupt)

32 maxItems: 1

34 required:

35 - compatible

36 - reg

37 - interrupts

39 unevaluatedProperties: false

41 examples:

42 - |

43 watchdog@2a440000 {

44 compatible = "arm,sbsa-gwdt";

45 reg = <0x2a440000 0x1000>,

46 <0x2a450000 0x1000>;

47 interrupts = <0 27 4>;

48 timeout-sec = <30>;

49 };

50 ...

3. 한국어 전문 번역

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

SBSA 범용 워치독

1-11

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 스키마는 SBSA(Server Base System Architecture) 범용 워치독을 정의합니다. 관리자는 Fu Wei입니다.

2단계 timeout과 시스템 reset

12-17

SBSA 범용 워치독 타이머는 두 단계의 timeout이 모두 지난 뒤 시스템을 강제로 reset하는 장치입니다. 워치독의 상세 정의는 ARM 문서 `ARM-DEN-0029 - Server Base System Architecture (SBSA)`에서 확인할 수 있습니다.

control·refresh frame과 WS0 interrupt

18-40

공통 `watchdog.yaml`을 상속하고 `compatible`은 `arm,sbsa-gwdt`로 고정합니다. `reg`에는 첫째 Watchdog control frame과 둘째 Refresh frame, 두 레지스터 영역을 이 순서로 제공합니다.

`interrupts`는 Watchdog Signal 0(WS0)에 해당하는 SPI(Shared Peripheral Interrupt) 하나입니다. `compatible`, `reg`, `interrupts`가 모두 필수이며 평가되지 않은 추가 속성은 허용하지 않습니다.

allOf:
  - $ref: watchdog.yaml#

properties:
  compatible:
    const: arm,sbsa-gwdt

  reg:
    items:
      - description: Watchdog control frame
      - description: Refresh frame

  interrupts:
    description: The Watchdog Signal 0 (WS0) SPI (Shared Peripheral Interrupt)
    maxItems: 1

required:
  - compatible
  - reg
  - interrupts

unevaluatedProperties: false

control·refresh frame 배치 예제

41-50

예제는 control frame을 `0x2a440000`, refresh frame을 `0x2a450000`에 각각 `0x1000` 크기로 배치하고 interrupt `<0 27 4>`와 30초 timeout을 설정합니다.

examples:
  - |
    watchdog@2a440000 {
        compatible = "arm,sbsa-gwdt";
        reg = <0x2a440000 0x1000>,
              <0x2a450000 0x1000>;
        interrupts = <0 27 4>;
        timeout-sec = <30>;
    };
...