요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
# SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
%YAML 1.2
---
$id: http://devicetree.org/schemas/usb/realtek,rts5411.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: Realtek RTS5411 USB 3.0 hub controller
maintainers:
- Matthias Kaehlcke <[email protected]>
allOf:
- $ref: usb-hub.yaml#
properties:
compatible:
items:
- enum:
- usbbda,5411
- usbbda,411
vdd-supply:
description:
phandle to the regulator that provides power to the hub.
peer-hub: true
ports:
$ref: /schemas/graph.yaml#/properties/ports
patternProperties:
'^port@':
$ref: /schemas/graph.yaml#/properties/port
properties:
reg:
minimum: 1
maximum: 4
additionalProperties:
properties:
reg:
minimum: 1
maximum: 4
required:
- peer-hub
- compatible
- reg
examples:
- |
usb {
dr_mode = "host";
#address-cells = <1>;
#size-cells = <0>;
/* 2.0 hub on port 1 */
hub_2_0: hub@1 {
compatible = "usbbda,5411";
reg = <1>;
vdd-supply = <&pp3300_hub>;
peer-hub = <&hub_3_0>;
#address-cells = <1>;
#size-cells = <0>;
/* USB 2.0 device on port 2 */
device@2 {
compatible = "usb123,4567";
reg = <2>;
};
};
/* 3.0 hub on port 2 */
hub_3_0: hub@2 {
compatible = "usbbda,411";
reg = <2>;
vdd-supply = <&pp3300_hub>;
peer-hub = <&hub_2_0>;
ports {
#address-cells = <1>;
#size-cells = <0>;
/* Type-A connector on port 4 */
port@4 {
reg = <4>;
endpoint {
remote-endpoint = <&usb_a0_ss>;
};
};
};
};
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
Realtek RTS5411 USB 3.0 hub
1-14GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 schema는 Realtek RTS5411 USB 3.0 hub controller를 정의합니다. 관리자는 Matthias Kaehlcke이며 공통 `usb-hub.yaml`을 상속합니다.
Hub supply, peer와 port 1~4
15-45compatible은 `usbbda,5411` 또는 `usbbda,411`입니다. `vdd-supply`는 hub 전원 regulator이고 `peer-hub`는 compound hub의 USB 2.0·3.0 peer를 연결합니다.
graph port와 hub 아래 다른 child의 `reg`는 모두 1~4 범위입니다.
properties:
compatible:
items:
- enum:
- usbbda,5411
- usbbda,411
vdd-supply:
description:
phandle to the regulator that provides power to the hub.
peer-hub: true
ports:
$ref: /schemas/graph.yaml#/properties/ports
patternProperties:
'^port@':
$ref: /schemas/graph.yaml#/properties/port
properties:
reg:
minimum: 1
maximum: 4
additionalProperties:
properties:
reg:
minimum: 1
maximum: 4
세 필수 속성
46-50필수 속성은 `peer-hub`, `compatible`, `reg`입니다.
required:
- peer-hub
- compatible
- reg
USB 2.0·3.0 peer hub 예제
51-92host USB bus의 USB 2.0 `hub@1`은 `usbbda,5411`, USB 3.0 `hub@2`는 `usbbda,411`이며 둘 다 `pp3300_hub` supply를 사용하고 서로를 `peer-hub`로 가리킵니다.
2.0 hub의 port 2에는 `usb123,4567` device가 있고, 3.0 hub의 graph `port@4`는 Type-A SuperSpeed connector `usb_a0_ss`에 연결됩니다.
examples:
- |
usb {
dr_mode = "host";
#address-cells = <1>;
#size-cells = <0>;
/* 2.0 hub on port 1 */
hub_2_0: hub@1 {
compatible = "usbbda,5411";
reg = <1>;
vdd-supply = <&pp3300_hub>;
peer-hub = <&hub_3_0>;
#address-cells = <1>;
#size-cells = <0>;
/* USB 2.0 device on port 2 */
device@2 {
compatible = "usb123,4567";
reg = <2>;
};
};
/* 3.0 hub on port 2 */
hub_3_0: hub@2 {
compatible = "usbbda,411";
reg = <2>;
vdd-supply = <&pp3300_hub>;
peer-hub = <&hub_2_0>;
ports {
#address-cells = <1>;
#size-cells = <0>;
/* Type-A connector on port 4 */
port@4 {
reg = <4>;
endpoint {
remote-endpoint = <&usb_a0_ss>;
};
};
};
};
};
요약과 해설
realtek,rts5411.yaml:1-92RTS5411 USB 2.0·3.0 peer hub, regulator와 port graph를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, interrupt, clock, PHY, regulator, graph endpoint, source path와 원문 줄 좌표를 원형대로 보존합니다.