Cavium SuperSpeed DWC3 USB SoC Controller | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

dwc3-cavium.txt:1-28

Cavium Octeon 7130 UCTL wrapper의 필수 compatible, DWC3 child와 XHCI 예제를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, reset, PHY, power, source path와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 Cavium SuperSpeed DWC3 USB SoC controller

3 Required properties:

4 - compatible: Should contain "cavium,octeon-7130-usb-uctl"

6 Required child node:

7 A child node must exist to represent the core DWC3 IP block. The name of

8 the node is not important. The content of the node is defined in dwc3.txt.

10 Example device node:

12 uctl@1180069000000 {

13 compatible = "cavium,octeon-7130-usb-uctl";

14 reg = <0x00011800 0x69000000 0x00000000 0x00000100>;

15 ranges;

16 #address-cells = <0x00000002>;

17 #size-cells = <0x00000002>;

18 refclk-frequency = <0x05f5e100>;

19 refclk-type-ss = "dlmc_ref_clk0";

20 refclk-type-hs = "dlmc_ref_clk0";

21 power = <0x00000002 0x00000002 0x00000001>;

22 xhci@1690000000000 {

23 compatible = "cavium,octeon-7130-xhci", "snps,dwc3";

24 reg = <0x00016900 0x00000000 0x00000010 0x00000000>;

25 interrupt-parent = <0x00000010>;

26 interrupts = <0x00000009 0x00000004>;

27 };

28 };

3. 한국어 전문 번역

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

Cavium Octeon DWC3 wrapper

1-9

이 binding은 Cavium SuperSpeed DWC3 USB SoC controller를 설명합니다. 필수 `compatible` 값은 `cavium,octeon-7130-usb-uctl`입니다.

DWC3 IP core를 나타내는 child node가 반드시 있어야 합니다. node 이름은 중요하지 않으며 내용은 원문이 가리키는 `dwc3.txt` 정의를 따릅니다.

UCTL과 XHCI child 예제

10-28

예제 UCTL wrapper는 register, 빈 `ranges`, 2-cell address와 size, 100 MHz reference clock, SuperSpeed·HighSpeed의 `dlmc_ref_clk0`, power specifier를 지정합니다.

child `xhci@1690000000000`은 Cavium Octeon 7130 XHCI와 `snps,dwc3` compatible, 64-bit register 범위, interrupt parent와 interrupt specifier를 사용합니다.

Example device node:

                    uctl@1180069000000 {
                            compatible = "cavium,octeon-7130-usb-uctl";
                            reg = <0x00011800 0x69000000 0x00000000 0x00000100>;
                            ranges;
                            #address-cells = <0x00000002>;
                            #size-cells = <0x00000002>;
                            refclk-frequency = <0x05f5e100>;
                            refclk-type-ss = "dlmc_ref_clk0";
                            refclk-type-hs = "dlmc_ref_clk0";
                            power = <0x00000002 0x00000002 0x00000001>;
                            xhci@1690000000000 {
                                    compatible = "cavium,octeon-7130-xhci", "snps,dwc3";
                                    reg = <0x00016900 0x00000000 0x00000010 0x00000000>;
                                    interrupt-parent = <0x00000010>;
                                    interrupts = <0x00000009 0x00000004>;
                            };
                    };