← Documents Documentation/devicetree/bindings/usb/parade,ps8830.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / USB

Parade PS883x USB/DisplayPort Retimer

PS8830/PS8833의 clock, reset, supply와 세 Type-C endpoint를 설명합니다.

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

요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.

1. 요약·해설

원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.

요약과 해설

parade,ps8830.yaml:1-144

PS8830/PS8833의 clock, reset, supply와 세 Type-C endpoint를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, 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,ps8830.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Parade PS883x USB and DisplayPort Retimer
8
9 maintainers:
10 - Abel Vesa <abel.vesa@linaro.org>
11
12 properties:
13 compatible:
14 oneOf:
15 - items:
16 - const: parade,ps8833
17 - const: parade,ps8830
18 - const: parade,ps8830
19
20 reg:
21 maxItems: 1
22
23 clocks:
24 items:
25 - description: XO Clock
26
27 reset-gpios:
28 maxItems: 1
29
30 vdd-supply:
31 description: power supply (1.07V)
32
33 vdd33-supply:
34 description: power supply (3.3V)
35
36 vdd33-cap-supply:
37 description: power supply (3.3V)
38
39 vddar-supply:
40 description: power supply (1.07V)
41
42 vddat-supply:
43 description: power supply (1.07V)
44
45 vddio-supply:
46 description: power supply (1.2V or 1.8V)
47
48 orientation-switch: true
49 retimer-switch: true
50
51 ports:
52 $ref: /schemas/graph.yaml#/properties/ports
53 properties:
54 port@0:
55 $ref: /schemas/graph.yaml#/properties/port
56 description: Super Speed (SS) Output endpoint to the Type-C connector
57
58 port@1:
59 $ref: /schemas/graph.yaml#/$defs/port-base
60 description: Super Speed (SS) Input endpoint from the Super-Speed PHY
61 unevaluatedProperties: false
62
63 port@2:
64 $ref: /schemas/graph.yaml#/properties/port
65 description:
66 Sideband Use (SBU) AUX lines endpoint to the Type-C connector for the purpose of
67 handling altmode muxing and orientation switching.
68
69 required:
70 - compatible
71 - reg
72 - clocks
73 - reset-gpios
74 - vdd-supply
75 - vdd33-supply
76 - vdd33-cap-supply
77 - vddat-supply
78 - vddio-supply
79 - orientation-switch
80 - retimer-switch
81
82 allOf:
83 - $ref: usb-switch.yaml#
84 - $ref: usb-switch-ports.yaml#
85
86 additionalProperties: false
87
88 examples:
89 - |
90 #include <dt-bindings/gpio/gpio.h>
91
92 i2c {
93 #address-cells = <1>;
94 #size-cells = <0>;
95
96 typec-mux@8 {
97 compatible = "parade,ps8830";
98 reg = <0x8>;
99
100 clocks = <&clk_rtmr_xo>;
101
102 vdd-supply = <&vreg_rtmr_1p15>;
103 vdd33-supply = <&vreg_rtmr_3p3>;
104 vdd33-cap-supply = <&vreg_rtmr_3p3>;
105 vddar-supply = <&vreg_rtmr_1p15>;
106 vddat-supply = <&vreg_rtmr_1p15>;
107 vddio-supply = <&vreg_rtmr_1p8>;
108
109 reset-gpios = <&tlmm 10 GPIO_ACTIVE_LOW>;
110
111 retimer-switch;
112 orientation-switch;
113
114 ports {
115 #address-cells = <1>;
116 #size-cells = <0>;
117
118 port@0 {
119 reg = <0>;
120
121 endpoint {
122 remote-endpoint = <&typec_con_ss>;
123 };
124 };
125
126 port@1 {
127 reg = <1>;
128
129 endpoint {
130 remote-endpoint = <&usb_phy_ss>;
131 };
132 };
133
134 port@2 {
135 reg = <2>;
136
137 endpoint {
138 remote-endpoint = <&typec_dp_aux>;
139 };
140 };
141 };
142 };
143 };
144 ...
145

3. 한국어 전문 번역

영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.

Parade PS883x USB/DisplayPort retimer

1-11

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 schema는 Parade PS883x USB 및 DisplayPort Retimer를 정의합니다. 관리자는 Abel Vesa입니다.

Clock, reset과 여섯 supply

12-49

PS8833은 `parade,ps8833`, `parade,ps8830` 두 compatible을 순서대로 사용하며 PS8830은 `parade,ps8830` 하나를 사용합니다. `reg`는 하나이고 `clocks` 항목은 XO clock, `reset-gpios`는 GPIO 하나입니다.

전원은 1.07 V `vdd`, 3.3 V `vdd33`, 3.3 V `vdd33-cap`, 1.07 V `vddar`, 1.07 V `vddat`, 1.2 V 또는 1.8 V `vddio`입니다. orientation switch와 retimer switch를 지원합니다.

properties:
  compatible:
    oneOf:
      - items:
          - const: parade,ps8833
          - const: parade,ps8830
      - const: parade,ps8830

  reg:
    maxItems: 1

  clocks:
    items:
      - description: XO Clock

  reset-gpios:
    maxItems: 1

  vdd-supply:
    description: power supply (1.07V)

  vdd33-supply:
    description: power supply (3.3V)

  vdd33-cap-supply:
    description: power supply (3.3V)

  vddar-supply:
    description: power supply (1.07V)

  vddat-supply:
    description: power supply (1.07V)

  vddio-supply:
    description: power supply (1.2V or 1.8V)

  orientation-switch: true
  retimer-switch: true

세 Type-C graph port

50-68

`port@0`은 Type-C connector로 향하는 SuperSpeed output, `port@1`은 SuperSpeed PHY에서 들어오는 input입니다. `port@2`는 altmode muxing과 orientation switching을 위한 Type-C SBU AUX line endpoint입니다.


ports:
  $ref: /schemas/graph.yaml#/properties/ports
  properties:
    port@0:
      $ref: /schemas/graph.yaml#/properties/port
      description: Super Speed (SS) Output endpoint to the Type-C connector

    port@1:
      $ref: /schemas/graph.yaml#/$defs/port-base
      description: Super Speed (SS) Input endpoint from the Super-Speed PHY
      unevaluatedProperties: false

    port@2:
      $ref: /schemas/graph.yaml#/properties/port
      description:
        Sideband Use (SBU) AUX lines endpoint to the Type-C connector for the purpose of
        handling altmode muxing and orientation switching.

11개 필수 속성과 공통 switch schema

69-87

필수 속성은 `compatible`, `reg`, `clocks`, `reset-gpios`, `vdd-supply`, `vdd33-supply`, `vdd33-cap-supply`, `vddat-supply`, `vddio-supply`, `orientation-switch`, `retimer-switch`의 11개입니다. `vddar-supply`는 정의되어 있지만 필수 목록에는 없습니다.

`usb-switch.yaml`과 `usb-switch-ports.yaml`을 상속하며 정의되지 않은 추가 속성은 허용하지 않습니다.

required:
  - compatible
  - reg
  - clocks
  - reset-gpios
  - vdd-supply
  - vdd33-supply
  - vdd33-cap-supply
  - vddat-supply
  - vddio-supply
  - orientation-switch
  - retimer-switch

allOf:
  - $ref: usb-switch.yaml#
  - $ref: usb-switch-ports.yaml#

additionalProperties: false

PS8830 세 endpoint 예제

88-144

예제 `typec-mux@8`은 주소 0x8, `clk_rtmr_xo`, 여섯 supply와 TLMM GPIO 10 active-low reset을 사용하고 retimer·orientation switch를 활성화합니다.

세 endpoint는 Type-C SuperSpeed `typec_con_ss`, SuperSpeed PHY `usb_phy_ss`, DisplayPort AUX `typec_dp_aux`에 각각 연결됩니다.

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

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

        typec-mux@8 {
            compatible = "parade,ps8830";
            reg = <0x8>;

            clocks = <&clk_rtmr_xo>;

            vdd-supply = <&vreg_rtmr_1p15>;
            vdd33-supply = <&vreg_rtmr_3p3>;
            vdd33-cap-supply = <&vreg_rtmr_3p3>;
            vddar-supply = <&vreg_rtmr_1p15>;
            vddat-supply = <&vreg_rtmr_1p15>;
            vddio-supply = <&vreg_rtmr_1p8>;

            reset-gpios = <&tlmm 10 GPIO_ACTIVE_LOW>;

            retimer-switch;
            orientation-switch;

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

                port@0 {
                    reg = <0>;

                    endpoint {
                        remote-endpoint = <&typec_con_ss>;
                    };
                };

                port@1 {
                    reg = <1>;

                    endpoint {
                        remote-endpoint = <&usb_phy_ss>;
                    };
                };

                port@2 {
                    reg = <2>;

                    endpoint {
                        remote-endpoint = <&typec_dp_aux>;
                    };
                };
            };
        };
    };
...