Synopsys HSDK reset controller

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

1. 요약·해설

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

snps,hsdk-reset.txt:1-28

reset provider와 consumer의 관계 및 지정자 형식을 해설하고, 접을 수 있는 영어 원문 전체와 원문 줄 좌표를 보존한 한국어 전문 번역을 제공합니다.

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

원문 전체 펼치기

1 Binding for the Synopsys HSDK reset controller

3 This binding uses the common reset binding[1].

5 [1] Documentation/devicetree/bindings/reset/reset.txt

7 Required properties:

8 - compatible: should be "snps,hsdk-reset".

9 - reg: should always contain 2 pairs address - length: first for reset

10 configuration register and second for corresponding SW reset and status bits

11 register.

12 - #reset-cells: from common reset binding; Should always be set to 1.

14 Example:

15 reset: reset@880 {

16 compatible = "snps,hsdk-reset";

17 #reset-cells = <1>;

18 reg = <0x8A0 0x4>, <0xFF0 0x4>;

19 };

21 Specifying reset lines connected to IP modules:

22 ethernet@.... {

23 ....

24 resets = <&reset HSDK_V1_ETH_RESET>;

25 ....

26 };

28 The index could be found in <dt-bindings/reset/snps,hsdk-reset.h>

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

1-5

이 문서는 Synopsys HSDK reset controller 바인딩을 설명하며 공통 reset 바인딩인 `Documentation/devicetree/bindings/reset/reset.txt`를 사용합니다.

6-12

`compatible`은 `snps,hsdk-reset`이어야 합니다. `reg`에는 주소와 길이의 쌍이 항상 두 개 들어갑니다. 첫 쌍은 reset 구성 레지스터용이고, 둘째 쌍은 대응하는 소프트웨어 reset 및 상태 비트 레지스터용입니다.

공통 reset 바인딩에서 가져온 `#reset-cells`는 항상 1로 설정합니다.

13-19

예제는 `0x8A0`의 reset 구성 레지스터와 `0xFF0`의 소프트웨어 reset·상태 레지스터를 각각 4바이트 범위로 선언합니다.

reset: reset@880 {
        compatible = "snps,hsdk-reset";
        #reset-cells = <1>;
        reg = <0x8A0 0x4>, <0xFF0 0x4>;
};

20-28

Ethernet 장치는 `HSDK_V1_ETH_RESET` 인덱스로 reset line을 요청합니다. 인덱스 정의는 `<dt-bindings/reset/snps,hsdk-reset.h>`에서 찾을 수 있습니다.

ethernet@.... {
        ....
        resets = <&reset HSDK_V1_ETH_RESET>;
        ....
};