Realtek RTD Type-C Detection

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

1. 요약·해설

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

요약과 해설

realtek,rtd-type-c.yaml:1-82

Realtek RTD Type-C connector detection, eFuse calibration과 external Rd를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, interrupt, clock, PHY, regulator, graph endpoint, source path와 원문 줄 좌표를 원형대로 보존합니다.

2. 영어 원문 전체

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

원문 전체 펼치기

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

3 %YAML 1.2

4 ---

5 $id: http://devicetree.org/schemas/usb/realtek,rtd-type-c.yaml#

6 $schema: http://devicetree.org/meta-schemas/core.yaml#

8 title: Realtek DHC RTD SoCs USB Type-C Connector detection

10 maintainers:

11 - Stanley Chang <[email protected]>

13 description:

14 Realtek digital home center (DHC) RTD series SoCs include a type c module.

15 This module is able to detect the state of type c connector.

17 properties:

18 compatible:

19 enum:

20 - realtek,rtd1295-type-c

21 - realtek,rtd1312c-type-c

22 - realtek,rtd1315e-type-c

23 - realtek,rtd1319-type-c

24 - realtek,rtd1319d-type-c

25 - realtek,rtd1395-type-c

26 - realtek,rtd1619-type-c

27 - realtek,rtd1619b-type-c

29 reg:

30 maxItems: 1

32 interrupts:

33 maxItems: 1

35 nvmem-cell-names:

36 items:

37 - const: usb-cal

39 nvmem-cells:

40 maxItems: 1

41 description:

42 The phandle to nvmem cell that contains the trimming data.

43 The type c parameter trimming data specified via efuse.

44 If unspecified, default value is used.

46 realtek,rd-ctrl-gpios:

47 description: The gpio node to control external Rd on board.

48 maxItems: 1

50 connector:

51 $ref: /schemas/connector/usb-connector.yaml#

52 description: Properties for usb c connector.

53 type: object

55 required:

56 - compatible

57 - reg

58 - interrupts

60 additionalProperties: false

62 examples:

63 - |

64 #include <dt-bindings/interrupt-controller/irq.h>

66 type-c@7220 {

67 compatible = "realtek,rtd1619b-type-c";

68 reg = <0x7220 0x20>;

69 interrupts = <0 60 IRQ_TYPE_LEVEL_HIGH>;

71 pinctrl-names = "default";

72 pinctrl-0 = <&usb_cc1_pins>, <&usb_cc2_pins>;

73 nvmem-cells = <&otp_usb_cal>;

74 nvmem-cell-names = "usb-cal";

76 connector {

77 compatible = "usb-c-connector";

78 label = "USB-C";

79 data-role = "dual";

80 power-role = "dual";

81 };

82 };

3. 한국어 전문 번역

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

1-16

GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 schema는 Realtek DHC RTD SoC의 USB Type-C connector detection module을 정의합니다. module은 Type-C connector 상태를 감지하며 관리자는 Stanley Chang입니다.

Calibration, external Rd와 connector

17-54

compatible은 RTD1295, RTD1312C, RTD1315E, RTD1319, RTD1319D, RTD1395, RTD1619, RTD1619B Type-C variant 중 하나입니다. `reg`와 interrupt는 각각 하나입니다.

`nvmem-cells`는 eFuse에 지정된 Type-C parameter trimming data가 든 cell 하나를 가리키고 이름은 `usb-cal`입니다. 생략하면 기본 calibration 값을 사용합니다. `realtek,rd-ctrl-gpios`는 board의 external Rd를 제어하는 GPIO 하나입니다. `connector`는 공통 USB connector schema를 따릅니다.

properties:
  compatible:
    enum:
      - realtek,rtd1295-type-c
      - realtek,rtd1312c-type-c
      - realtek,rtd1315e-type-c
      - realtek,rtd1319-type-c
      - realtek,rtd1319d-type-c
      - realtek,rtd1395-type-c
      - realtek,rtd1619-type-c
      - realtek,rtd1619b-type-c

  reg:
    maxItems: 1

  interrupts:
    maxItems: 1

  nvmem-cell-names:
    items:
      - const: usb-cal

  nvmem-cells:
    maxItems: 1
    description:
      The phandle to nvmem cell that contains the trimming data.
      The type c parameter trimming data specified via efuse.
      If unspecified, default value is used.

  realtek,rd-ctrl-gpios:
    description: The gpio node to control external Rd on board.
    maxItems: 1

  connector:
    $ref: /schemas/connector/usb-connector.yaml#
    description: Properties for usb c connector.
    type: object

세 필수 속성

55-61

필수 속성은 `compatible`, `reg`, `interrupts`입니다. 정의되지 않은 추가 속성은 허용하지 않습니다.

required:
  - compatible
  - reg
  - interrupts

additionalProperties: false

RTD1619B dual-role connector

62-82

예제 `type-c@7220`은 0x20-byte register 영역, level-high interrupt 60, CC1·CC2 pinctrl과 `otp_usb_cal` calibration cell을 사용합니다. USB-C connector의 data role과 power role은 모두 `dual`입니다.

examples:
  - |
    #include <dt-bindings/interrupt-controller/irq.h>

    type-c@7220 {
        compatible = "realtek,rtd1619b-type-c";
        reg = <0x7220 0x20>;
        interrupts = <0 60 IRQ_TYPE_LEVEL_HIGH>;

        pinctrl-names = "default";
        pinctrl-0 = <&usb_cc1_pins>, <&usb_cc2_pins>;
        nvmem-cells = <&otp_usb_cal>;
        nvmem-cell-names = "usb-cal";

        connector {
            compatible = "usb-c-connector";
            label = "USB-C";
            data-role = "dual";
            power-role = "dual";
        };
    };