요약·해설, 영어 원문, 전체 번역을 구분해 실었습니다. API 이름, 코드 심벌, 소스 경로는 원문 표기를 유지합니다.
1. 요약·해설
원문의 핵심 내용을 정리하고 커널 프로그래밍에 필요한 설명을 덧붙였습니다. 아래의 전체 번역과는 별도로 작성한 해설입니다.
2. 영어 원문 전체
번역에 사용한 Linux v6.18.37 원문입니다. 줄 번호는 해당 버전의 소스 파일을 기준으로 합니다.
원문 전체 펼치기
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/usb/willsemi,wusb3801.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: WUSB3801 Type-C port controller
description:
The Will Semiconductor WUSB3801 is a USB Type-C port controller which
supports role and plug orientation detection using the CC pins. It is
compatible with the USB Type-C Cable and Connector Specification v1.2.
maintainers:
- Samuel Holland <[email protected]>
properties:
compatible:
enum:
- willsemi,wusb3801
reg:
maxItems: 1
interrupts:
maxItems: 1
connector:
type: object
$ref: ../connector/usb-connector.yaml#
unevaluatedProperties: false
description:
The managed USB Type-C connector. Since WUSB3801 does not support
Power Delivery, the node should have the "pd-disable" property.
properties:
compatible:
const: usb-c-connector
required:
- pd-disable
required:
- compatible
- reg
- interrupts
- connector
additionalProperties: false
examples:
- |
#include <dt-bindings/interrupt-controller/irq.h>
i2c {
#address-cells = <1>;
#size-cells = <0>;
tcpc@60 {
compatible = "willsemi,wusb3801";
reg = <0x60>;
interrupt-parent = <&gpio0>;
interrupts = <4 IRQ_TYPE_LEVEL_LOW>;
connector {
compatible = "usb-c-connector";
label = "USB-C";
vbus-supply = <&otg_switch>;
power-role = "dual";
try-power-role = "sink";
data-role = "dual";
typec-power-opmode = "default";
pd-disable;
};
};
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미에 맞춰 전체 내용을 번역했습니다. 코드, 함수명, 코드 심벌, URL은 원문 표기를 유지합니다.
WUSB3801 Type-C port controller
1-16GPL-2.0-only 또는 BSD-2-Clause로 배포되는 이 스키마는 Will Semiconductor WUSB3801 USB Type-C port controller를 정의합니다. 이 장치는 CC pin으로 role과 plug orientation을 감지하며 USB Type-C Cable and Connector Specification v1.2와 호환됩니다. 관리자는 Samuel Holland입니다.
I2C 자원과 managed connector
17-35`compatible`은 `willsemi,wusb3801`이며 `reg`와 `interrupts`는 각각 최대 한 항목입니다.
`connector` child는 공통 `connector/usb-connector.yaml`을 따르는 managed USB Type-C connector입니다. WUSB3801은 Power Delivery를 지원하지 않으므로 connector node에 `pd-disable`을 지정해야 합니다.
properties:
compatible:
enum:
- willsemi,wusb3801
reg:
maxItems: 1
interrupts:
maxItems: 1
connector:
type: object
$ref: ../connector/usb-connector.yaml#
unevaluatedProperties: false
description:
The managed USB Type-C connector. Since WUSB3801 does not support
Power Delivery, the node should have the "pd-disable" property.
connector 제약과 필수 속성
36-50connector의 compatible은 `usb-c-connector`로 고정되고 `pd-disable`이 필수입니다. controller node에는 compatible, reg, interrupts와 connector가 모두 필요하며 정의되지 않은 추가 속성은 허용하지 않습니다.
properties:
compatible:
const: usb-c-connector
required:
- pd-disable
required:
- compatible
- reg
- interrupts
- connector
additionalProperties: false
dual-role USB-C connector 예제
51-76예제 I2C controller의 WUSB3801은 address 0x60과 active-low level interrupt를 사용합니다. USB-C connector는 OTG VBUS supply에 연결되고 power role과 data role을 dual로 설정하며 우선 시도할 power role은 sink입니다.
Type-C power mode는 default이고 Power Delivery를 사용하지 않도록 `pd-disable`을 명시합니다.
examples:
- |
#include <dt-bindings/interrupt-controller/irq.h>
i2c {
#address-cells = <1>;
#size-cells = <0>;
tcpc@60 {
compatible = "willsemi,wusb3801";
reg = <0x60>;
interrupt-parent = <&gpio0>;
interrupts = <4 IRQ_TYPE_LEVEL_LOW>;
connector {
compatible = "usb-c-connector";
label = "USB-C";
vbus-supply = <&otg_switch>;
power-role = "dual";
try-power-role = "sink";
data-role = "dual";
typec-power-opmode = "default";
pd-disable;
};
};
};
요약과 해설
willsemi,wusb3801.yaml:1-76WUSB3801의 CC 감지와 Power Delivery 없는 dual-role connector를 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, property, symbol, phandle, example, source path와 원문 줄 좌표를 원형대로 보존합니다.