Documentation/devicetree/bindings/usb/cypress,hx3.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / USB

Cypress HX3 USB 3.0 Hub Controller Family

Cypress HX3 hub의 USB product compatible, 1.2 V·3.3 V 전원, reset과 USB2·USB3 peer hub 관계를 설명합니다.

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

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

1. 요약·해설

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

요약과 해설

cypress,hx3.yaml:1-89

Cypress HX3 hub의 USB product compatible, 1.2 V·3.3 V 전원, reset과 USB2·USB3 peer hub 관계를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, connector, PHY, DMA, 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/cypress,hx3.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Cypress HX3 USB 3.0 hub controller family
8
9 maintainers:
10 - Benjamin Bara <[email protected]>
11
12 allOf:
13 - $ref: usb-device.yaml#
14
15 properties:
16 compatible:
17 oneOf:
18 - enum:
19 - usb4b4,6504
20 - usb4b4,6506
21 - items:
22 - enum:
23 - usb4b4,6500
24 - usb4b4,6508
25 - const: usb4b4,6504
26 - items:
27 - enum:
28 - usb4b4,6502
29 - usb4b4,6503
30 - usb4b4,6507
31 - usb4b4,650a
32 - const: usb4b4,6506
33
34 reg: true
35
36 reset-gpios:
37 items:
38 - description: GPIO specifier for RESETN pin.
39
40 vdd-supply:
41 description:
42 1V2 power supply (VDD_EFUSE, AVDD12, DVDD12).
43
44 vdd2-supply:
45 description:
46 3V3 power supply (AVDD33, VDD_IO).
47
48 peer-hub:
49 $ref: /schemas/types.yaml#/definitions/phandle
50 description:
51 phandle to the peer hub on the controller.
52
53 required:
54 - compatible
55 - reg
56 - peer-hub
57 - vdd-supply
58 - vdd2-supply
59
60 additionalProperties: false
61
62 examples:
63 - |
64 #include <dt-bindings/gpio/gpio.h>
65
66 usb {
67 #address-cells = <1>;
68 #size-cells = <0>;
69
70 /* 2.0 hub on port 1 */
71 hub_2_0: hub@1 {
72 compatible = "usb4b4,6504";
73 reg = <1>;
74 peer-hub = <&hub_3_0>;
75 reset-gpios = <&gpio1 11 GPIO_ACTIVE_LOW>;
76 vdd-supply = <&reg_1v2_usb>;
77 vdd2-supply = <&reg_3v3_usb>;
78 };
79
80 /* 3.0 hub on port 2 */
81 hub_3_0: hub@2 {
82 compatible = "usb4b4,6506";
83 reg = <2>;
84 peer-hub = <&hub_2_0>;
85 reset-gpios = <&gpio1 11 GPIO_ACTIVE_LOW>;
86 vdd-supply = <&reg_1v2_usb>;
87 vdd2-supply = <&reg_3v3_usb>;
88 };
89 };
90

3. 한국어 전문 번역

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

Cypress HX3 USB 3.0 hub family

1-14

GPL-2.0-only 또는 BSD-2-Clause 라이선스의 이 schema는 Cypress HX3 USB 3.0 hub controller family를 정의하고 공통 `usb-device.yaml`을 참조합니다. 관리자는 Benjamin Bara입니다.

USB product ID와 fallback

15-33

`usb4b4,6504`와 `usb4b4,6506`은 단독 compatible입니다. Product 6500과 6508은 6504를 fallback으로 둡니다. Product 6502, 6503, 6507, 650a는 6506을 fallback으로 둡니다.

properties:
  compatible:
    oneOf:
      - enum:
          - usb4b4,6504
          - usb4b4,6506
      - items:
          - enum:
              - usb4b4,6500
              - usb4b4,6508
          - const: usb4b4,6504
      - items:
          - enum:
              - usb4b4,6502
              - usb4b4,6503
              - usb4b4,6507
              - usb4b4,650a
          - const: usb4b4,6506

Reset, 두 전원과 peer hub

34-52

`reg`를 사용합니다. `reset-gpios`는 RESETN pin용 GPIO 한 항목입니다. `vdd-supply`는 VDD_EFUSE·AVDD12·DVDD12용 1.2 V 전원이고 `vdd2-supply`는 AVDD33·VDD_IO용 3.3 V 전원입니다.

`peer-hub`는 같은 controller에 있는 상대 hub를 가리키는 phandle입니다.

reg: true

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

vdd-supply:
  description:
    1V2 power supply (VDD_EFUSE, AVDD12, DVDD12).

vdd2-supply:
  description:
    3V3 power supply (AVDD33, VDD_IO).

peer-hub:
  $ref: /schemas/types.yaml#/definitions/phandle
  description:
    phandle to the peer hub on the controller.

필수 속성

53-61

필수 속성은 `compatible`, `reg`, `peer-hub`, `vdd-supply`, `vdd2-supply`입니다. Reset GPIO는 선택 사항이고 추가 속성은 허용하지 않습니다.

required:
  - compatible
  - reg
  - peer-hub
  - vdd-supply
  - vdd2-supply

additionalProperties: false

USB 2.0·3.0 peer hub 예제

62-89

예제에서 port 1의 `hub_2_0`은 product 6504이고 port 2의 `hub_3_0`은 product 6506입니다. 두 node는 `peer-hub`로 서로를 참조합니다.

두 hub는 동일한 active-low GPIO1 11번 RESETN과 1.2 V `reg_1v2_usb`, 3.3 V `reg_3v3_usb` 전원을 공유합니다.

examples:
  - |
    #include <dt-bindings/gpio/gpio.h>

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

        /* 2.0 hub on port 1 */
        hub_2_0: hub@1 {
            compatible = "usb4b4,6504";
            reg = <1>;
            peer-hub = <&hub_3_0>;
            reset-gpios = <&gpio1 11 GPIO_ACTIVE_LOW>;
            vdd-supply = <&reg_1v2_usb>;
            vdd2-supply = <&reg_3v3_usb>;
        };

        /* 3.0 hub on port 2 */
        hub_3_0: hub@2 {
            compatible = "usb4b4,6506";
            reg = <2>;
            peer-hub = <&hub_2_0>;
            reset-gpios = <&gpio1 11 GPIO_ACTIVE_LOW>;
            vdd-supply = <&reg_1v2_usb>;
            vdd2-supply = <&reg_3v3_usb>;
        };
    };