On Tue, Sep 26, 2017 at 12:05:13PM +0800, Li Jun wrote:
> port-type is required for any typec port; default-role is only required
> for drp; power source capable needs src-pdos; power sink capable needs
> snk-pdos, max-snk-mv, max-snk-ma, op-snk-mw.
"dt-bindings: usb: ..." for the subject prefix.
>
> Signed-off-by: Li Jun <jun.li@xxxxxxx>
> ---
> Documentation/devicetree/bindings/usb/typec.txt | 46 +++++++++++++++++++++++++
> 1 file changed, 46 insertions(+)
>
> diff --git a/Documentation/devicetree/bindings/usb/typec.txt b/Documentation/devicetree/bindings/usb/typec.txt
> new file mode 100644
> index 0000000..36d4467
> --- /dev/null
> +++ b/Documentation/devicetree/bindings/usb/typec.txt
> @@ -0,0 +1,46 @@
> +Generic typec and power delivery properties
> +-------------------------------------------
What node do these apply to? A type C connector node? The PD
microcontroller?
I'm reluctant to accept just a random list of properties without a more
complete Type-C binding which I'd expect to have a connector node, OF
graph ports to connect to video outputs, connection to USB controller,
and connection to the PD controller.
> +
> +Required properties:
> +- port-type: should be one of "source", "sink" or "dual".
> +- default-role: preferred power role if drp, should be "sink" or "source".
> +- src-pdos: An array of u32 with each entry providing supported power
> + source data object(PDO), the detailed bit definitions of
> + PDO can be found in "Universal Serial Bus Power Delivery
> + Specification" chapter 6.4.1.2 Source_Capabilities Message,
> + the order of each entry(PDO) should follow the PD spec chapter
> + 6.4.1. Required only for power source and power dual role with
> + power delivery support.
> +- snk-pdos: An array of u32 with each entry providing supported power
> + sink data object(PDO), the detailed bit definitions of PDO
> + can be found in "Universal Serial Bus Power Delivery
> + Specification" chapter 6.4.1.3 Sink Capabilities Message,
> + the order of each entry(PDO) should follow the PD spec chapter
> + 6.4.1. Required only for power sink and power dual role with
> + power delivery support.
> +- max-snk-mv: The max voltage the sink can support in millivoltage, required
> + only for power sink and power dual role with power delivery
> + support.
> +- max-snk-ma: The max current the sink can support in milliampere, required
> + only for power sink and power dual role with power delivery
> + support.
> +- op-snk-mw: Sink required operating power in milliwatts, if source offered
> + power is less then it, Capability Mismatch is set, required
> + only for power sink and power dual role with power delivery
> + support.
Use the standard unit suffixes as defined in property-units.txt
> +
> +Example:
> +
> +ptn5110@50 {
> + compatible = "usb,tcpci";
> + reg = <0x50>;
> + interrupt-parent = <&gpio3>;
> + interrupts = <3 IRQ_TYPE_LEVEL_LOW>;
> + port-type = "dual";
> + default-role = "sink";
> + src-pdos = <0x380190c8>;
> + snk-pdos = <0x380190c8 0x3802d0c8>;
> + max-snk-mv = <9000>;
> + max-snk-ma = <1000>;
> + op-snk-mw = <9000>;
> +};
> --
> 2.6.6
>
> --
> To unsubscribe from this list: send the line "unsubscribe devicetree" in
> the body of a message to majordomo@xxxxxxxxxxxxxxx
> More majordomo info at http://vger.kernel.org/majordomo-info.html
--
To unsubscribe from this list: send the line "unsubscribe linux-usb" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
