← Documents Documentation/devicetree/bindings/usb/cypress,cypd4226.yaml GitHub 원문 ↗

Linux 6.18.37 · Devicetree Bindings / USB

Cypress CYPD4226 Type-C Controller

CYPD4226 dual Type-C controller의 I2C 주소, 제품별 firmware, connector 최소 조건과 role-switch endpoint를 설명합니다.

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

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

1. 요약·해설

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

요약과 해설

cypress,cypd4226.yaml:1-93

CYPD4226 dual Type-C controller의 I2C 주소, 제품별 firmware, connector 최소 조건과 role-switch endpoint를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, clock, interrupt, connector, PHY, DMA, source path와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.

원문 전체 펼치기
1 # SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/usb/cypress,cypd4226.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6
7 title: Cypress cypd4226 Type-C Controller
8
9 maintainers:
10 - Wayne Chang <waynec@nvidia.com>
11
12 description:
13 The Cypress cypd4226 is a dual Type-C controller that is controlled
14 via an I2C interface.
15
16 properties:
17 compatible:
18 const: cypress,cypd4226
19
20 '#address-cells':
21 const: 1
22
23 '#size-cells':
24 const: 0
25
26 reg:
27 const: 0x08
28
29 interrupts:
30 items:
31 - description: cypd4226 host interrupt
32
33 firmware-name:
34 enum:
35 - nvidia,gpu
36 - nvidia,jetson-agx-xavier
37 description: |
38 The name of the CCGx firmware built for product series.
39 should be set one of following:
40 - "nvidia,gpu" for the NVIDIA RTX product series
41 - "nvidia,jetson-agx-xavier" for the NVIDIA Jetson product series
42
43 patternProperties:
44 '^connector@[01]$':
45 $ref: /schemas/connector/usb-connector.yaml#
46 required:
47 - reg
48
49 required:
50 - compatible
51 - reg
52 - interrupts
53
54 anyOf:
55 - required:
56 - connector@0
57 - required:
58 - connector@1
59
60 additionalProperties: false
61
62 examples:
63 - |
64 #include <dt-bindings/interrupt-controller/arm-gic.h>
65 i2c {
66 #address-cells = <1>;
67 #size-cells = <0>;
68
69 typec@8 {
70 compatible = "cypress,cypd4226";
71 reg = <0x08>;
72 interrupts = <2 IRQ_TYPE_LEVEL_LOW>;
73 firmware-name = "nvidia,jetson-agx-xavier";
74 #address-cells = <1>;
75 #size-cells = <0>;
76 connector@0 {
77 compatible = "usb-c-connector";
78 reg = <0>;
79 label = "USB-C";
80 data-role = "dual";
81 ports {
82 #address-cells = <1>;
83 #size-cells = <0>;
84 port@0 {
85 reg = <0>;
86 endpoint {
87 remote-endpoint = <&usb_role_switch0>;
88 };
89 };
90 };
91 };
92 };
93 };
94

3. 한국어 전문 번역

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

Cypress CCGx dual Type-C controller

1-15

GPL-2.0 또는 BSD-2-Clause 라이선스의 이 schema는 I2C interface로 제어하는 dual Type-C controller Cypress CYPD4226을 정의합니다. 관리자는 Wayne Chang입니다.

I2C 주소, interrupt와 firmware

16-42

`compatible`은 `cypress,cypd4226`, `#address-cells = 1`, `#size-cells = 0`, I2C `reg = 0x08`입니다. `interrupts`는 CYPD4226 host interrupt 한 항목입니다.

`firmware-name`은 NVIDIA RTX 제품군의 `nvidia,gpu` 또는 NVIDIA Jetson 제품군의 `nvidia,jetson-agx-xavier`입니다. 이 이름은 해당 제품군용으로 build한 CCGx firmware를 선택합니다.

properties:
  compatible:
    const: cypress,cypd4226

  '#address-cells':
    const: 1

  '#size-cells':
    const: 0

  reg:
    const: 0x08

  interrupts:
    items:
      - description: cypd4226 host interrupt

  firmware-name:
    enum:
      - nvidia,gpu
      - nvidia,jetson-agx-xavier
    description: |
      The name of the CCGx firmware built for product series.
      should be set one of following:
      - "nvidia,gpu" for the NVIDIA RTX product series
      - "nvidia,jetson-agx-xavier" for the NVIDIA Jetson product series

두 Type-C connector 중 최소 하나

43-61

`connector@0`과 `connector@1`은 공통 `usb-connector.yaml`을 따르며 각 connector의 `reg`가 필수입니다. Controller 자체의 필수 속성은 `compatible`, `reg`, `interrupts`입니다.

두 connector 중 적어도 `connector@0` 또는 `connector@1` 하나는 반드시 존재해야 합니다. 정의되지 않은 추가 속성은 허용하지 않습니다.

patternProperties:
  '^connector@[01]$':
    $ref: /schemas/connector/usb-connector.yaml#
    required:
      - reg

required:
  - compatible
  - reg
  - interrupts

anyOf:
  - required:
      - connector@0
  - required:
      - connector@1

additionalProperties: false

Jetson dual-role connector 예제

62-93

예제 `typec@8`은 I2C 주소 0x08, level-low interrupt 2, Jetson AGX Xavier firmware를 사용합니다. `connector@0`은 label `USB-C`이고 data role은 `dual`입니다.

Connector port 0의 endpoint는 `usb_role_switch0`을 remote endpoint로 참조해 Type-C data path를 role switch에 연결합니다.

examples:
  - |
    #include <dt-bindings/interrupt-controller/arm-gic.h>
    i2c {
      #address-cells = <1>;
      #size-cells = <0>;

      typec@8 {
        compatible = "cypress,cypd4226";
        reg = <0x08>;
        interrupts = <2 IRQ_TYPE_LEVEL_LOW>;
        firmware-name = "nvidia,jetson-agx-xavier";
        #address-cells = <1>;
        #size-cells = <0>;
        connector@0 {
          compatible = "usb-c-connector";
          reg = <0>;
          label = "USB-C";
          data-role = "dual";
          ports {
            #address-cells = <1>;
            #size-cells = <0>;
            port@0 {
              reg = <0>;
              endpoint {
                remote-endpoint = <&usb_role_switch0>;
              };
            };
          };
        };
      };
    };