Documentation/devicetree/bindings/usb/parade,ps5511.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / USB

Parade PS5511 USB 3.2 Hub Controller

PS5511/55A1 peer hub, port 1~5와 variant별 port 5 제한을 설명합니다.

Source pathDocumentation/devicetree/bindings/usb/parade,ps5511.yaml
Source versionLinux v6.18.37
TranslationDUJINLABS 전문 번역 + 해설

요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.

1. 요약·해설

원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.

요약과 해설

parade,ps5511.yaml:1-108

PS5511/55A1 peer hub, port 1~5와 variant별 port 5 제한을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, interrupt, clock, GPIO, regulator, source path와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.

원문 전체 펼치기
1 # SPDX-License-Identifier: GPL-2.0-only OR BSD-2-Clause
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/usb/parade,ps5511.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Parade PS5511 4+1 Port USB 3.2 Gen 1 Hub Controller
8
9 maintainers:
10 - Pin-yen Lin <[email protected]>
11
12 properties:
13 compatible:
14 enum:
15 - usb1da0,5511
16 - usb1da0,55a1
17
18 reset-gpios:
19 items:
20 - description: GPIO specifier for RESETB pin.
21
22 vddd11-supply:
23 description:
24 1V1 power supply to the hub
25
26 vdd33-supply:
27 description:
28 3V3 power supply to the hub
29
30 peer-hub: true
31
32 ports:
33 $ref: /schemas/graph.yaml#/properties/ports
34
35 patternProperties:
36 '^port@':
37 $ref: /schemas/graph.yaml#/properties/port
38
39 properties:
40 reg:
41 minimum: 1
42 maximum: 5
43
44 additionalProperties:
45 properties:
46 reg:
47 minimum: 1
48 maximum: 5
49
50 required:
51 - peer-hub
52
53 allOf:
54 - $ref: usb-hub.yaml#
55 - if:
56 not:
57 properties:
58 compatible:
59 enum:
60 - usb1da0,55a1
61 then:
62 properties:
63 ports:
64 properties:
65 port@5: false
66
67 patternProperties:
68 '^.*@5$': false
69
70 examples:
71 - |
72 usb {
73 #address-cells = <1>;
74 #size-cells = <0>;
75
76 /* 2.0 hub on port 1 */
77 hub_2_0: hub@1 {
78 compatible = "usb1da0,55a1";
79 reg = <1>;
80 peer-hub = <&hub_3_0>;
81 #address-cells = <1>;
82 #size-cells = <0>;
83 /* USB 2.0 device on port 5 */
84 device@5 {
85 reg = <5>;
86 compatible = "usb123,4567";
87 };
88 };
89
90 /* 3.0 hub on port 2 */
91 hub_3_0: hub@2 {
92 compatible = "usb1da0,5511";
93 reg = <2>;
94 peer-hub = <&hub_2_0>;
95
96 ports {
97 #address-cells = <1>;
98 #size-cells = <0>;
99 /* Type-A connector on port 3 */
100 port@3 {
101 reg = <3>;
102 endpoint {
103 remote-endpoint = <&usb_a0_ss>;
104 };
105 };
106 };
107 };
108 };
109

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.

Parade PS5511 4+1-port hub

1-11

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 schema는 Parade PS5511 4+1 Port USB 3.2 Gen 1 Hub Controller를 정의합니다. 관리자는 Pin-yen Lin입니다.

두 product ID와 hub 전원

12-30

`compatible`은 `usb1da0,5511` 또는 `usb1da0,55a1`입니다. `reset-gpios`는 RESETB pin용 GPIO 하나를 지정합니다. `vddd11-supply`는 hub의 1.1 V 전원, `vdd33-supply`는 3.3 V 전원입니다.

`peer-hub`는 같은 compound hub의 USB 2.0·3.0 peer를 서로 연결합니다.

properties:
  compatible:
    enum:
      - usb1da0,5511
      - usb1da0,55a1

  reset-gpios:
    items:
      - description: GPIO specifier for RESETB pin.

  vddd11-supply:
    description:
      1V1 power supply to the hub

  vdd33-supply:
    description:
      3V3 power supply to the hub

  peer-hub: true

Port 1~5와 child address

31-49

graph `ports` 아래 `port@N`의 `reg`는 1~5입니다. hub 아래 다른 child node의 `reg`도 1~5 범위로 제한됩니다.


  ports:
    $ref: /schemas/graph.yaml#/properties/ports

    patternProperties:
      '^port@':
        $ref: /schemas/graph.yaml#/properties/port

        properties:
          reg:
            minimum: 1
            maximum: 5

additionalProperties:
  properties:
    reg:
      minimum: 1
      maximum: 5

Peer 필수와 port 5 조건

50-69

필수 속성은 `peer-hub`이며 공통 `usb-hub.yaml`을 상속합니다.

`compatible`이 `usb1da0,55a1`이 아니면 graph `port@5`와 이름이 `@5`로 끝나는 child를 둘 수 없습니다. 따라서 port 5는 `usb1da0,55a1` variant에서만 허용됩니다.

required:
  - peer-hub

allOf:
  - $ref: usb-hub.yaml#
  - if:
      not:
        properties:
          compatible:
            enum:
              - usb1da0,55a1
    then:
      properties:
        ports:
          properties:
            port@5: false

      patternProperties:
        '^.*@5$': false

USB 2.0·3.0 peer hub 예제

70-108

예제 USB 2.0 `hub@1`은 `usb1da0,55a1`이고 USB 3.0 `hub@2`를 `peer-hub`로 가리킵니다. 허용된 port 5에는 `usb123,4567` device가 있습니다.

USB 3.0 `hub@2`는 `usb1da0,5511`이고 반대로 USB 2.0 hub를 가리킵니다. graph `port@3` endpoint는 Type-A SuperSpeed connector `usb_a0_ss`에 연결됩니다.

examples:
  - |
    usb {
        #address-cells = <1>;
        #size-cells = <0>;

        /* 2.0 hub on port 1 */
        hub_2_0: hub@1 {
            compatible = "usb1da0,55a1";
            reg = <1>;
            peer-hub = <&hub_3_0>;
            #address-cells = <1>;
            #size-cells = <0>;
            /* USB 2.0 device on port 5 */
            device@5 {
                reg = <5>;
                compatible = "usb123,4567";
            };
        };

        /* 3.0 hub on port 2 */
        hub_3_0: hub@2 {
            compatible = "usb1da0,5511";
            reg = <2>;
            peer-hub = <&hub_2_0>;

            ports {
                #address-cells = <1>;
                #size-cells = <0>;
                /* Type-A connector on port 3 */
                port@3 {
                    reg = <3>;
                    endpoint {
                        remote-endpoint = <&usb_a0_ss>;
                    };
                };
            };
        };
    };