요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
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. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, 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와 원문 줄 좌표를 원형대로 보존합니다.