Commit eea54570 authored by Amit Sunil Dhamne's avatar Amit Sunil Dhamne Committed by Greg Kroah-Hartman
Browse files

dt-bindings: connector: Add properties to define time values 



This commit adds the following properties:
  * sink-wait-cap-time-ms
  * ps-source-off-time-ms
  * cc-debounce-time-ms

This is to enable setting of platform/board specific timer values as
these timers have a range of acceptable values.

Signed-off-by: default avatarAmit Sunil Dhamne <amitsd@google.com>
Reviewed-by: default avatarRob Herring (Arm) <robh@kernel.org>
Link: https://lore.kernel.org/r/20241022-pd-dt-time-props-v1-1-fea96f51b302@google.com


Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent f390525d

Documentation/devicetree/bindings/connector/usb-connector.yaml

+34 −1
Original line number Diff line number Diff line
@@ -253,6 +253,36 @@ properties: 


    additionalProperties: false



  sink-wait-cap-time-ms:

    description: Represents the max time in ms that USB Type-C port (in sink

      role) should wait for the port partner (source role) to send source caps.

      SinkWaitCap timer starts when port in sink role attaches to the source.

      This timer will stop when sink receives PD source cap advertisement before

      timeout in which case it'll move to capability negotiation stage. A

      timeout leads to a hard reset message by the port.

    minimum: 310

    maximum: 620

    default: 310



  ps-source-off-time-ms:

    description: Represents the max time in ms that a DRP in source role should

      take to turn off power after the PsSourceOff timer starts. PsSourceOff

      timer starts when a sink's PHY layer receives EOP of the GoodCRC message

      (corresponding to an Accept message sent in response to a PR_Swap or a

      FR_Swap request). This timer stops when last bit of GoodCRC EOP

      corresponding to the received PS_RDY message is transmitted by the PHY

      layer. A timeout shall lead to error recovery in the type-c port.

    minimum: 750

    maximum: 920

    default: 920



  cc-debounce-time-ms:

    description: Represents the max time in ms that a port shall wait to

      determine if it's attached to a partner.

    minimum: 100

    maximum: 200

    default: 200



dependencies:

  sink-vdos-v1: [ sink-vdos ]

  sink-vdos: [ sink-vdos-v1 ]
@@ -380,7 +410,7 @@ examples: 
    };



  # USB-C connector attached to a typec port controller(ptn5110), which has

  # power delivery support and enables drp.

  # power delivery support, explicitly defines time properties and enables drp.

  - |

    #include <dt-bindings/usb/pd.h>

    typec: ptn5110 {
@@ -393,6 +423,9 @@ examples: 
            sink-pdos = <PDO_FIXED(5000, 2000, PDO_FIXED_USB_COMM)

                         PDO_VAR(5000, 12000, 2000)>;

            op-sink-microwatt = <10000000>;

            sink-wait-cap-time-ms = <465>;

            ps-source-off-time-ms = <835>;

            cc-debounce-time-ms = <101>;

        };

    };