요약·해설과 원문, 전문 번역을 서로 분리했습니다. API 이름, symbol, source path는 원문 표기를 사용합니다.
1. 요약·해설
원문의 핵심 논리와 kernel programming 관점의 보충 설명입니다. 아래의 전문 번역과는 별도로 작성했습니다.
2. 영어 원문 전체
번역 기준이 된 Linux v6.18.37 원문입니다. 줄 번호는 이 버전의 파일 좌표입니다.
원문 전체 펼치기
# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/usb/nxp,ptn5110.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#
title: NXP PTN5110 Type-C Port Controller
maintainers:
- Li Jun <jun.li@nxp.com>
properties:
compatible:
items:
- const: nxp,ptn5110
- const: tcpci
reg:
maxItems: 1
interrupts:
maxItems: 1
connector:
type: object
$ref: /schemas/connector/usb-connector.yaml#
unevaluatedProperties: false
required:
- compatible
- reg
- interrupts
- connector
additionalProperties: false
examples:
- |
#include <dt-bindings/interrupt-controller/arm-gic.h>
#include <dt-bindings/usb/pd.h>
i2c {
#address-cells = <1>;
#size-cells = <0>;
tcpci@50 {
compatible = "nxp,ptn5110", "tcpci";
reg = <0x50>;
interrupt-parent = <&gpio3>;
interrupts = <3 IRQ_TYPE_LEVEL_LOW>;
usb_con: connector {
compatible = "usb-c-connector";
label = "USB-C";
data-role = "dual";
power-role = "dual";
try-power-role = "sink";
source-pdos = <PDO_FIXED(5000, 2000, PDO_FIXED_USB_COMM)>;
sink-pdos = <PDO_FIXED(5000, 2000, PDO_FIXED_USB_COMM) PDO_VAR(5000, 12000, 2000)>;
op-sink-microwatt = <10000000>;
ports {
#address-cells = <1>;
#size-cells = <0>;
port@0 {
reg = <0>;
typec1_dr_sw: endpoint {
remote-endpoint = <&usb1_drd_sw>;
};
};
};
};
};
};
3. 한국어 전문 번역
영어 원문의 문단 순서와 의미를 유지한 전체 번역입니다. 코드, 함수명, symbol과 URL은 원문 표기를 유지합니다.
NXP PTN5110 Type-C port controller
1-11GPL-2.0 또는 BSD-2-Clause로 배포되는 이 schema는 NXP PTN5110 Type-C Port Controller를 정의합니다. 관리자는 Li Jun입니다.
TCPCI와 USB connector
12-28`compatible`은 `nxp,ptn5110`, `tcpci` 두 문자열을 이 순서로 사용합니다. `reg`와 `interrupts`는 각각 하나입니다. `connector` child object는 공통 `usb-connector.yaml`을 따르며 평가되지 않은 추가 속성을 허용하지 않습니다.
properties:
compatible:
items:
- const: nxp,ptn5110
- const: tcpci
reg:
maxItems: 1
interrupts:
maxItems: 1
connector:
type: object
$ref: /schemas/connector/usb-connector.yaml#
unevaluatedProperties: false
네 필수 속성
29-36필수 속성은 `compatible`, `reg`, `interrupts`, `connector`입니다. controller 최상위에는 정의되지 않은 추가 속성을 둘 수 없습니다.
required:
- compatible
- reg
- interrupts
- connector
additionalProperties: false
Dual-role USB-C와 PDO 예제
37-74예제 `tcpci@50`은 I2C 주소 0x50, GPIO3 pin 3의 level-low interrupt를 사용합니다. USB-C connector의 data role과 power role은 모두 `dual`이고 우선 시도 power role은 `sink`입니다.
source PDO는 USB communication을 지원하는 5 V 2 A fixed PDO입니다. sink PDO는 같은 fixed PDO와 5~12 V 2 A variable PDO이며 동작 sink power는 10,000,000 microwatt, 즉 10 W입니다.
connector의 `port@0` endpoint는 `usb1_drd_sw`에 연결됩니다.
examples:
- |
#include <dt-bindings/interrupt-controller/arm-gic.h>
#include <dt-bindings/usb/pd.h>
i2c {
#address-cells = <1>;
#size-cells = <0>;
tcpci@50 {
compatible = "nxp,ptn5110", "tcpci";
reg = <0x50>;
interrupt-parent = <&gpio3>;
interrupts = <3 IRQ_TYPE_LEVEL_LOW>;
usb_con: connector {
compatible = "usb-c-connector";
label = "USB-C";
data-role = "dual";
power-role = "dual";
try-power-role = "sink";
source-pdos = <PDO_FIXED(5000, 2000, PDO_FIXED_USB_COMM)>;
sink-pdos = <PDO_FIXED(5000, 2000, PDO_FIXED_USB_COMM) PDO_VAR(5000, 12000, 2000)>;
op-sink-microwatt = <10000000>;
ports {
#address-cells = <1>;
#size-cells = <0>;
port@0 {
reg = <0>;
typec1_dr_sw: endpoint {
remote-endpoint = <&usb1_drd_sw>;
};
};
};
};
};
};
요약과 해설
nxp,ptn5110.yaml:1-74PTN5110 TCPCI controller의 interrupt, USB-C dual role과 PDO 구성을 설명합니다. 접을 수 있는 영어 원문 전체와 한국어 전문 번역을 함께 제공하며, compatible, register, interrupt, clock, PHY, power, source path와 원문 줄 좌표를 원형대로 보존합니다.