← Documents Documentation/devicetree/bindings/power/reset/keystone-reset.txt GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings

TI Keystone Reset

최대 네 watchdog의 reset mux와 hard·soft SoC reset binding입니다.

Source pathDocumentation/devicetree/bindings/power/reset/keystone-reset.txt
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

keystone-reset.txt:1-67

PLL·device syscon offset pair, WDT index 목록과 hard·soft reset 예제를 정리합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 * Device tree bindings for Texas Instruments keystone reset
2
3 This node is intended to allow SoC reset in case of software reset
4 of selected watchdogs.
5
6 The Keystone SoCs can contain up to 4 watchdog timers to reset
7 SoC. Each watchdog timer event input is connected to the Reset Mux
8 block. The Reset Mux block can be configured to cause reset or not.
9
10 Additionally soft or hard reset can be configured.
11
12 Required properties:
13
14 - compatible: ti,keystone-reset
15
16 - ti,syscon-pll: phandle/offset pair. The phandle to syscon used to
17 access pll controller registers and the offset to use
18 reset control registers.
19
20 - ti,syscon-dev: phandle/offset pair. The phandle to syscon used to
21 access device state control registers and the offset
22 in order to use mux block registers for all watchdogs.
23
24 Optional properties:
25
26 - ti,soft-reset: Boolean option indicating soft reset.
27 By default hard reset is used.
28
29 - ti,wdt-list: WDT list that can cause SoC reset. It's not related
30 to WDT driver, it's just needed to enable a SoC related
31 reset that's triggered by one of WDTs. The list is
32 in format: <0>, <2>; It can be in random order and
33 begins from 0 to 3, as keystone can contain up to 4 SoC
34 reset watchdogs and can be in random order.
35
36 Example 1:
37 Setup keystone reset so that in case software reset or
38 WDT0 is triggered it issues hard reset for SoC.
39
40 pllctrl: pll-controller@2310000 {
41 compatible = "ti,keystone-pllctrl", "syscon";
42 reg = <0x02310000 0x200>;
43 };
44
45 devctrl: device-state-control@2620000 {
46 compatible = "ti,keystone-devctrl", "syscon";
47 reg = <0x02620000 0x1000>;
48 };
49
50 rstctrl: reset-controller {
51 compatible = "ti,keystone-reset";
52 ti,syscon-pll = <&pllctrl 0xe4>;
53 ti,syscon-dev = <&devctrl 0x328>;
54 ti,wdt-list = <0>;
55 };
56
57 Example 2:
58 Setup keystone reset so that in case of software reset or
59 WDT0 or WDT2 is triggered it issues soft reset for SoC.
60
61 rstctrl: reset-controller {
62 compatible = "ti,keystone-reset";
63 ti,syscon-pll = <&pllctrl 0xe4>;
64 ti,syscon-dev = <&devctrl 0x328>;
65 ti,wdt-list = <0>, <2>;
66 ti,soft-reset;
67 };
68

3. 한국어 전문 번역

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

Keystone watchdog reset mux

1-11

Texas Instruments Keystone reset node는 선택한 watchdog의 software reset event가 발생할 때 SoC reset을 허용합니다.

Keystone SoC에는 SoC를 reset할 watchdog timer가 최대 4개 있을 수 있습니다. 각 watchdog event input은 Reset Mux block에 연결되고, mux는 그 event가 reset을 일으킬지 설정합니다. Reset은 soft 또는 hard 방식으로 구성할 수 있습니다.

필수·선택 속성

12-35

필수 `compatible`은 `ti,keystone-reset`입니다. `ti,syscon-pll`은 PLL controller register를 접근할 syscon phandle과 reset-control register offset의 pair입니다.

`ti,syscon-dev`는 device-state control register를 접근할 syscon phandle과 모든 watchdog의 mux-block register를 사용할 offset의 pair입니다.

선택적 boolean `ti,soft-reset`이 있으면 soft reset을 사용하며 기본값은 hard reset입니다. `ti,wdt-list`는 SoC reset을 일으킬 수 있게 할 watchdog 목록이고 WDT driver와 직접 관련되지 않습니다.

목록 형식은 `<0>, <2>`처럼 각 WDT index를 cell로 나열합니다. Keystone의 reset watchdog은 최대 4개이므로 index는 0부터 3까지이고 순서는 임의여도 됩니다.

WDT0 hard-reset 예제

36-56

첫 예제는 software reset 또는 WDT0 trigger가 발생하면 SoC hard reset을 내도록 PLL syscon, device-control syscon과 reset controller를 연결합니다.

pllctrl: pll-controller@2310000 {
        compatible = "ti,keystone-pllctrl", "syscon";
        reg = <0x02310000 0x200>;
};

devctrl: device-state-control@2620000 {
        compatible = "ti,keystone-devctrl", "syscon";
        reg = <0x02620000 0x1000>;
};

rstctrl: reset-controller {
        compatible = "ti,keystone-reset";
        ti,syscon-pll = <&pllctrl 0xe4>;
        ti,syscon-dev = <&devctrl 0x328>;
        ti,wdt-list = <0>;
};

WDT0·WDT2 soft-reset 예제

57-67

두 번째 예제는 WDT0 또는 WDT2와 software reset에 반응하고 `ti,soft-reset`으로 SoC soft reset을 선택합니다.

rstctrl: reset-controller {
        compatible = "ti,keystone-reset";
        ti,syscon-pll = <&pllctrl 0xe4>;
        ti,syscon-dev = <&devctrl 0x328>;
        ti,wdt-list = <0>, <2>;
        ti,soft-reset;
};