Realtek RTD DWC3 Glue | Linux 6.18.37

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

1. 요약·해설

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

요약과 해설

realtek,rtd-dwc3.yaml:1-80

Realtek RTD DWC3 wrapper·PM register와 dual-role child 구성을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, interrupt, clock, PHY, regulator, graph endpoint, source path와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)

3 %YAML 1.2

4 ---

5 $id: http://devicetree.org/schemas/usb/realtek,rtd-dwc3.yaml#

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

8 title: Realtek DWC3 USB SoC Controller Glue

10 maintainers:

11 - Stanley Chang <[email protected]>

13 description:

14 The Realtek DHC SoC embeds a DWC3 USB IP Core configured for USB 2.0

15 and USB 3.0 in host or dual-role mode.

17 properties:

18 compatible:

19 items:

20 - enum:

21 - realtek,rtd1295-dwc3

22 - realtek,rtd1315e-dwc3

23 - realtek,rtd1319-dwc3

24 - realtek,rtd1319d-dwc3

25 - realtek,rtd1395-dwc3

26 - realtek,rtd1619-dwc3

27 - realtek,rtd1619b-dwc3

28 - const: realtek,rtd-dwc3

30 reg:

31 items:

32 - description: Address and length of register set for wrapper of dwc3 core.

33 - description: Address and length of register set for pm control.

35 '#address-cells':

36 const: 1

38 '#size-cells':

39 const: 1

41 ranges: true

43 patternProperties:

44 "^usb@[0-9a-f]+$":

45 $ref: snps,dwc3.yaml#

46 description: Required child node

48 required:

49 - compatible

50 - reg

51 - "#address-cells"

52 - "#size-cells"

53 - ranges

55 additionalProperties: false

57 examples:

58 - |

59 usb@98013e00 {

60 compatible = "realtek,rtd1319d-dwc3", "realtek,rtd-dwc3";

61 reg = <0x98013e00 0x140>, <0x98013f60 0x4>;

62 #address-cells = <1>;

63 #size-cells = <1>;

64 ranges;

66 usb@98050000 {

67 compatible = "snps,dwc3";

68 reg = <0x98050000 0x9000>;

69 interrupts = <0 94 4>;

70 phys = <&usb2phy &usb3phy>;

71 phy-names = "usb2-phy", "usb3-phy";

72 dr_mode = "otg";

73 usb-role-switch;

74 role-switch-default-mode = "host";

75 snps,dis_u2_susphy_quirk;

76 snps,parkmode-disable-ss-quirk;

77 snps,parkmode-disable-hs-quirk;

78 maximum-speed = "high-speed";

79 };

80 };

3. 한국어 전문 번역

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

Realtek DWC3 glue

1-16

GPL-2.0 또는 BSD-2-Clause로 배포되는 이 schema는 Realtek DWC3 USB SoC Controller Glue를 정의합니다. Realtek DHC SoC는 USB 2.0·3.0 host 또는 dual-role mode용 DWC3 IP core를 내장하며 관리자는 Stanley Chang입니다.

SoC compatible과 두 register

17-42

RTD1295, RTD1315E, RTD1319, RTD1319D, RTD1395, RTD1619, RTD1619B의 SoC-specific compatible 뒤에 `realtek,rtd-dwc3` fallback을 둡니다.

`reg` 첫 항목은 DWC3 core wrapper register, 둘째는 power-management control register입니다. address cell과 size cell은 모두 1이고 direct `ranges`를 사용합니다.

properties:
  compatible:
    items:
      - enum:
          - realtek,rtd1295-dwc3
          - realtek,rtd1315e-dwc3
          - realtek,rtd1319-dwc3
          - realtek,rtd1319d-dwc3
          - realtek,rtd1395-dwc3
          - realtek,rtd1619-dwc3
          - realtek,rtd1619b-dwc3
      - const: realtek,rtd-dwc3

  reg:
    items:
      - description: Address and length of register set for wrapper of dwc3 core.
      - description: Address and length of register set for pm control.

  '#address-cells':
    const: 1

  '#size-cells':
    const: 1

  ranges: true

필수 DWC3 child

43-56

`usb@주소` child는 `snps,dwc3.yaml`을 따르는 필수 node입니다. wrapper 필수 속성은 `compatible`, `reg`, `#address-cells`, `#size-cells`, `ranges`이며 정의되지 않은 추가 속성은 허용하지 않습니다.

patternProperties:
  "^usb@[0-9a-f]+$":
    $ref: snps,dwc3.yaml#
    description: Required child node

required:
  - compatible
  - reg
  - "#address-cells"
  - "#size-cells"
  - ranges

additionalProperties: false

RTD1319D dual-role 예제

57-80

예제 wrapper `usb@98013e00`은 0x140-byte wrapper 영역과 0x4-byte PM control 영역을 사용합니다. child `usb@98050000`은 0x9000-byte DWC3 영역, interrupt 94, USB2·USB3 PHY를 정의합니다.

child는 OTG role switch이며 기본 role은 host입니다. U2 suspend PHY, SuperSpeed·High-Speed park mode를 끄는 quirk를 사용하고 maximum speed를 high-speed로 제한합니다.

examples:
  - |
    usb@98013e00 {
        compatible = "realtek,rtd1319d-dwc3", "realtek,rtd-dwc3";
        reg = <0x98013e00 0x140>, <0x98013f60 0x4>;
        #address-cells = <1>;
        #size-cells = <1>;
        ranges;

        usb@98050000 {
            compatible = "snps,dwc3";
            reg = <0x98050000 0x9000>;
            interrupts = <0 94 4>;
            phys = <&usb2phy &usb3phy>;
            phy-names = "usb2-phy", "usb3-phy";
            dr_mode = "otg";
            usb-role-switch;
            role-switch-default-mode = "host";
            snps,dis_u2_susphy_quirk;
            snps,parkmode-disable-ss-quirk;
            snps,parkmode-disable-hs-quirk;
            maximum-speed = "high-speed";
        };
    };