blob: 334f2f06e18de646ec348e105e946ed2d064e7b4 [file] [log] [blame]
# Copyright 2022 The Chromium OS Authors
# SPDX-License-Identifier: Apache-2.0
description: |
A USB Type-C connector node represents a physical USB Type-C connector.
It should be a child of a USB-C interface controller or a separate node
when it is attached to both MUX and USB-C interface controller.
This is based on Linux, documentation:
https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/Documentation/devicetree/bindings/connector/usb-connector.yaml?h=v5.19&id=3d7cb6b04c3f3115719235cc6866b10326de34cd
Example:
USB-C connector attached to a STM32 UCPD typec port controller, which has
power delivery support and enables SINK.
vbus1: vbus {
compatible = "zephyr,usb-c-vbus-adc";
io-channels = <&adc2 8>;
output-ohms = <49900>;
full-ohms = <(330000 + 49900)>;
};
ports {
#address-cells = <1>;
#size-cells = <0>;
port1: usb-c-port@1 {
compatible = "usb-c-connector";
reg = <1>;
tcpc = <&ucpd1>;
vbus = <&vbus1>;
power-role = "sink";
sink-pdos = <PDO_FIXED(5000, 2000, PDO_FIXED_USB_COMM)
PDO_VAR(5000, 12000, 2000)>;
op-sink-microwatt = <10000000>;
};
};
compatible: "usb-c-connector"
include: base.yaml
properties:
tcpc:
type: phandle
required: true
description: |
Type-C Port Controller for this port.
vbus:
type: phandle
required: true
description: |
VBUS measurement and control for this port.
ppc:
type: phandle
description: |
Power path controller for this port
power-role:
type: string
required: true
enum:
- "sink"
- "source"
- "dual"
description: |
The Port power role. "dual" for Dual Role Port.
try-power-role:
type: string
enum:
- "sink"
- "source"
- "dual"
description: |
Preferred power role.
data-role:
type: string
enum:
- "host"
- "device"
- "dual"
description: |
The Port data role.
* "host" for Downstream Facing Port (DFP)
* "device" for Upstream Facing Port (UFP)
* "dual" for Dual Role Data
typec-power-opmode:
type: string
enum:
- "default"
- "1.5A"
- "3.0A"
description: |
Initial Type C advertised power, determined by the Rp when
operating as a Source.
* "default" corresponds to default USB voltage and current
defined by the USB 2.0 and USB 3.2 specifications.
* 5V@500mA for USB 2.0
* 5V@900mA for USB 3.2 single-lane
* 5V@1500mA for USB 3.2 dual-lane
* "1.5A" and "3.0A", 5V@1.5A and 5V@3.0A.
pd-disable:
type: boolean
description: |
Disables power delivery when true
source-pdos:
type: array
description: |
An array of source Power Data Objects (PDOs).
Use the following macros to define the PDOs, defined in
dt-bindings/usb-c/pd.h.
* PDO_FIXED
* PDO_BATT
* PDO_VAR
* PDO_PPS_APDO
Valid range: 1 - 7
sink-pdos:
type: array
description: |
An array of sink Power Data Objects (PDOs).
Use the following macros to define the PDOs, defined in
dt-bindings/usb-c/pd.h.
* PDO_FIXED
* PDO_BATT
* PDO_VAR
* PDO_PPS_APDO
Valid range: 1 - 7
sink-vdos:
type: array
description: |
An array of sink Vendor Defined Objects (VDOs).
Use the following macros to define the VDOs, defined in
dt-bindings/usb-c/pd.h.
* VDO_IDH
* VDO_CERT
* VDO_PRODUCT
* VDO_UFP
* VDO_DFP
* VDO_PCABLE
* VDO_ACABLE
* VDO_VPD
Valid range: 3 - 6
sink-vdos-v1:
type: array
description: |
An array of sink Vendor Defined Objects (VDOs).
Use the following macros to define the VDOs, defined in
dt-bindings/usb-c/pd.h.
* VDO_IDH
* VDO_CERT
* VDO_PRODUCT
* VDO_CABLE
* VDO_AMA
Valid range: 3 - 6
op-sink-microwatt:
type: int
description: |
Minimum power, in microwatts, needed by the sink. A Capability
Mismatch is sent to the Source if the power can't be met.