요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/usb/spacemit,k1-dwc3.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: SpacemiT K1 SuperSpeed DWC3 USB SoC Controller
maintainers:
- Ze Huang <[email protected]>
description: |
The SpacemiT K1 embeds a DWC3 USB IP Core which supports Host functions
for USB 3.0 and DRD for USB 2.0.
Key features:
- USB3.0 SuperSpeed and USB2.0 High/Full/Low-Speed support
- Supports low-power modes (USB2.0 suspend, USB3.0 U1/U2/U3)
- Internal DMA controller and flexible endpoint FIFO sizing
Communication Interface:
- Use of PIPE3 (125MHz) interface for USB3.0 PHY
- Use of UTMI+ (30/60MHz) interface for USB2.0 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
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.
required:
- compatible
- reg
- clocks
- clock-names
- interrupts
- phys
- phy-names
- resets
- reset-names
unevaluatedProperties: false
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>;
};
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
SpacemiT K1 SuperSpeed DWC3
1-24GPL-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-73reset 세 개는 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>;
};
};
요약과 해설
spacemit,k1-dwc3.yaml:1-121K1 DWC3의 PIPE3·UTMI+, reset sequence와 peer hub를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, interrupt, clock, reset, regulator, graph endpoint, source path와 원문 줄 좌표를 원형대로 보존합니다.