← Documents Documentation/devicetree/bindings/usb/spacemit,k1-dwc3.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / USB

SpacemiT K1 SuperSpeed DWC3 Controller

K1 DWC3의 PIPE3·UTMI+, reset sequence와 peer hub를 설명합니다.

Source pathDocumentation/devicetree/bindings/usb/spacemit,k1-dwc3.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

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

1. 요약·해설

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

요약과 해설

spacemit,k1-dwc3.yaml:1-121

K1 DWC3의 PIPE3·UTMI+, reset sequence와 peer hub를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, interrupt, clock, reset, regulator, graph endpoint, source path와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기
1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/usb/spacemit,k1-dwc3.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: SpacemiT K1 SuperSpeed DWC3 USB SoC Controller
8
9 maintainers:
10 - Ze Huang <huang.ze@linux.dev>
11
12 description: |
13 The SpacemiT K1 embeds a DWC3 USB IP Core which supports Host functions
14 for USB 3.0 and DRD for USB 2.0.
15
16 Key features:
17 - USB3.0 SuperSpeed and USB2.0 High/Full/Low-Speed support
18 - Supports low-power modes (USB2.0 suspend, USB3.0 U1/U2/U3)
19 - Internal DMA controller and flexible endpoint FIFO sizing
20
21 Communication Interface:
22 - Use of PIPE3 (125MHz) interface for USB3.0 PHY
23 - Use of UTMI+ (30/60MHz) interface for USB2.0 PHY
24
25 allOf:
26 - $ref: snps,dwc3-common.yaml#
27
28 properties:
29 compatible:
30 const: spacemit,k1-dwc3
31
32 reg:
33 maxItems: 1
34
35 clocks:
36 maxItems: 1
37
38 clock-names:
39 const: usbdrd30
40
41 interrupts:
42 maxItems: 1
43
44 phys:
45 items:
46 - description: phandle to USB2/HS PHY
47 - description: phandle to USB3/SS PHY
48
49 phy-names:
50 items:
51 - const: usb2-phy
52 - const: usb3-phy
53
54 resets:
55 items:
56 - description: USB3.0 AHB reset
57 - description: USB3.0 VCC reset
58 - description: USB3.0 PHY reset
59
60 reset-names:
61 items:
62 - const: ahb
63 - const: vcc
64 - const: phy
65
66 reset-delay:
67 $ref: /schemas/types.yaml#/definitions/uint32
68 default: 2
69 description: delay after reset sequence [us]
70
71 vbus-supply:
72 description: A phandle to the regulator supplying the VBUS voltage.
73
74 required:
75 - compatible
76 - reg
77 - clocks
78 - clock-names
79 - interrupts
80 - phys
81 - phy-names
82 - resets
83 - reset-names
84
85 unevaluatedProperties: false
86
87 examples:
88 - |
89 usb@c0a00000 {
90 compatible = "spacemit,k1-dwc3";
91 reg = <0xc0a00000 0x10000>;
92 clocks = <&syscon_apmu 16>;
93 clock-names = "usbdrd30";
94 interrupts = <125>;
95 phys = <&usb2phy>, <&usb3phy>;
96 phy-names = "usb2-phy", "usb3-phy";
97 resets = <&syscon_apmu 8>,
98 <&syscon_apmu 9>,
99 <&syscon_apmu 10>;
100 reset-names = "ahb", "vcc", "phy";
101 reset-delay = <2>;
102 vbus-supply = <&usb3_vbus>;
103 #address-cells = <1>;
104 #size-cells = <0>;
105
106 hub_2_0: hub@1 {
107 compatible = "usb2109,2817";
108 reg = <1>;
109 vdd-supply = <&usb3_vhub>;
110 peer-hub = <&hub_3_0>;
111 reset-gpios = <&gpio 3 28 1>;
112 };
113
114 hub_3_0: hub@2 {
115 compatible = "usb2109,817";
116 reg = <2>;
117 vdd-supply = <&usb3_vhub>;
118 peer-hub = <&hub_2_0>;
119 reset-gpios = <&gpio 3 28 1>;
120 };
121 };
122

3. 한국어 전문 번역

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

SpacemiT K1 SuperSpeed DWC3

1-24

GPL-2.0 또는 BSD-2-Clause로 배포되는 이 스키마는 SpacemiT K1 DWC3 USB controller를 정의합니다. K1은 USB 3.0 host와 USB 2.0 DRD, SuperSpeed 및 High/Full/Low-Speed, USB2 suspend와 USB3 U1/U2/U3, internal DMA와 flexible endpoint FIFO sizing을 지원합니다.

USB3 PHY 통신에는 125MHz PIPE3, USB2 PHY에는 30/60MHz UTMI+ interface를 사용합니다. 관리자는 Ze Huang입니다.

clock, interrupt와 두 PHY

25-53

`snps,dwc3-common.yaml`을 상속하며 compatible은 `spacemit,k1-dwc3`입니다. register, `usbdrd30` clock, interrupt는 각각 하나입니다. PHY는 USB2/HS와 USB3/SS 순서로 두 개이며 이름은 `usb2-phy`, `usb3-phy`입니다.

allOf:
  - $ref: snps,dwc3-common.yaml#

properties:
  compatible:
    const: spacemit,k1-dwc3

  reg:
    maxItems: 1

  clocks:
    maxItems: 1

  clock-names:
    const: usbdrd30

  interrupts:
    maxItems: 1

  phys:
    items:
      - description: phandle to USB2/HS PHY
      - description: phandle to USB3/SS PHY

  phy-names:
    items:
      - const: usb2-phy
      - const: usb3-phy

세 reset, delay와 VBUS

54-73

reset 세 개는 USB3 AHB, VCC, PHY 순서이며 이름은 `ahb`, `vcc`, `phy`입니다. reset sequence 뒤 delay는 microsecond 단위이고 기본값은 2입니다. `vbus-supply`는 VBUS 전압을 공급하는 regulator phandle입니다.

resets:
  items:
    - description: USB3.0 AHB reset
    - description: USB3.0 VCC reset
    - description: USB3.0 PHY reset

reset-names:
  items:
    - const: ahb
    - const: vcc
    - const: phy

reset-delay:
  $ref: /schemas/types.yaml#/definitions/uint32
  default: 2
  description: delay after reset sequence [us]

vbus-supply:
  description: A phandle to the regulator supplying the VBUS voltage.

필수 속성과 확장 제한

74-86

필수 속성은 compatible, register, clock과 이름, interrupt, 두 PHY와 이름, 세 reset과 이름입니다. 공통 schema 외의 평가되지 않은 속성은 허용하지 않습니다.

required:
  - compatible
  - reg
  - clocks
  - clock-names
  - interrupts
  - phys
  - phy-names
  - resets
  - reset-names

unevaluatedProperties: false

K1 DWC3와 peer hub 예제

87-121

예제 `usb@c0a00000`은 0x10000-byte 영역, APMU clock 16, interrupt 125, 두 PHY, AHB·VCC·PHY reset 8·9·10, 2us delay와 USB3 VBUS regulator를 사용합니다.

child USB2 hub `usb2109,2817`과 USB3 hub `usb2109,817`은 같은 virtual-hub regulator와 reset GPIO를 쓰고 서로를 `peer-hub`로 참조합니다.

examples:
  - |
    usb@c0a00000 {
        compatible = "spacemit,k1-dwc3";
        reg = <0xc0a00000 0x10000>;
        clocks = <&syscon_apmu 16>;
        clock-names = "usbdrd30";
        interrupts = <125>;
        phys = <&usb2phy>, <&usb3phy>;
        phy-names = "usb2-phy", "usb3-phy";
        resets = <&syscon_apmu 8>,
                 <&syscon_apmu 9>,
                 <&syscon_apmu 10>;
        reset-names = "ahb", "vcc", "phy";
        reset-delay = <2>;
        vbus-supply = <&usb3_vbus>;
        #address-cells = <1>;
        #size-cells = <0>;

        hub_2_0: hub@1 {
            compatible = "usb2109,2817";
            reg = <1>;
            vdd-supply = <&usb3_vhub>;
            peer-hub = <&hub_3_0>;
            reset-gpios = <&gpio 3 28 1>;
        };

        hub_3_0: hub@2 {
            compatible = "usb2109,817";
            reg = <2>;
            vdd-supply = <&usb3_vhub>;
            peer-hub = <&hub_2_0>;
            reset-gpios = <&gpio 3 28 1>;
        };
    };