1# SPDX-License-Identifier: GPL-2.0-only 2%YAML 1.2 3--- 4$id: http://devicetree.org/schemas/connector/usb-connector.yaml# 5$schema: http://devicetree.org/meta-schemas/core.yaml# 6 7title: USB Connector 8 9maintainers: 10 - Rob Herring <robh@kernel.org> 11 12description: 13 A USB connector node represents a physical USB connector. It should be a child 14 of a USB interface controller or a separate node when it is attached to both 15 MUX and USB interface controller. 16 17properties: 18 compatible: 19 oneOf: 20 - enum: 21 - usb-a-connector 22 - usb-b-connector 23 - usb-c-connector 24 25 - items: 26 - const: gpio-usb-b-connector 27 - const: usb-b-connector 28 29 - items: 30 - const: samsung,usb-connector-11pin 31 - const: usb-b-connector 32 33 reg: 34 maxItems: 1 35 36 label: 37 description: Symbolic name for the connector. 38 39 type: 40 description: Size of the connector, should be specified in case of 41 non-fullsize 'usb-a-connector' or 'usb-b-connector' compatible 42 connectors. 43 $ref: /schemas/types.yaml#/definitions/string 44 45 enum: 46 - mini 47 - micro 48 49 self-powered: 50 description: Set this property if the USB device has its own power source. 51 type: boolean 52 53 # The following are optional properties for "usb-b-connector". 54 id-gpios: 55 description: An input gpio for USB ID pin. 56 maxItems: 1 57 58 vbus-gpios: 59 description: An input gpio for USB VBus pin, used to detect presence of 60 VBUS 5V. 61 maxItems: 1 62 63 vbus-supply: 64 description: A phandle to the regulator for USB VBUS if needed when host 65 mode or dual role mode is supported. 66 Particularly, if use an output GPIO to control a VBUS regulator, should 67 model it as a regulator. See bindings/regulator/fixed-regulator.yaml 68 69 power-role: 70 description: Determines the power role that the Type C connector will 71 support. "dual" refers to Dual Role Port (DRP). 72 $ref: /schemas/types.yaml#/definitions/string 73 74 enum: 75 - source 76 - sink 77 - dual 78 79 try-power-role: 80 description: Preferred power role. 81 $ref: /schemas/types.yaml#/definitions/string 82 83 enum: 84 - source 85 - sink 86 - dual 87 88 data-role: 89 description: Data role if Type C connector supports USB data. "dual" refers 90 Dual Role Device (DRD). 91 $ref: /schemas/types.yaml#/definitions/string 92 93 enum: 94 - host 95 - device 96 - dual 97 98 typec-power-opmode: 99 description: Determines the power operation mode that the Type C connector 100 will support and will advertise through CC pins when it has no power 101 delivery support. 102 - "default" corresponds to default USB voltage and current defined by the 103 USB 2.0 and USB 3.2 specifications, 5V 500mA for USB 2.0 ports and 104 5V 900mA or 1500mA for USB 3.2 ports in single-lane or dual-lane 105 operation respectively. 106 - "1.5A" and "3.0A", 5V 1.5A and 5V 3.0A respectively, as defined in USB 107 Type-C Cable and Connector specification, when Power Delivery is not 108 supported. 109 $ref: /schemas/types.yaml#/definitions/string 110 enum: 111 - default 112 - 1.5A 113 - 3.0A 114 115 pd-disable: 116 description: Set this property if the Type-C connector has no power delivery support. 117 type: boolean 118 119 # The following are optional properties for "usb-c-connector" with power 120 # delivery support. 121 sink-vdos: 122 description: An array of u32 with each entry, a Vendor Defined Message Object (VDO), 123 providing additional information corresponding to the product, the detailed bit 124 definitions and the order of each VDO can be found in 125 "USB Power Delivery Specification Revision 3.0, Version 2.0 + ECNs 2020-12-10" 126 chapter 6.4.4.3.1 Discover Identity. User can specify the VDO array via 127 VDO_IDH/_CERT/_PRODUCT/_UFP/_DFP/_PCABLE/_ACABLE(1/2)/_VPD() defined in 128 dt-bindings/usb/pd.h. 129 minItems: 3 130 maxItems: 6 131 $ref: /schemas/types.yaml#/definitions/uint32-array 132 133 sink-vdos-v1: 134 description: An array of u32 with each entry, a Vendor Defined Message Object (VDO), 135 providing additional information corresponding to the product, the detailed bit 136 definitions and the order of each VDO can be found in 137 "USB Power Delivery Specification Revision 2.0, Version 1.3" chapter 6.4.4.3.1 Discover 138 Identity. User can specify the VDO array via VDO_IDH/_CERT/_PRODUCT/_CABLE/_AMA defined in 139 dt-bindings/usb/pd.h. 140 minItems: 3 141 maxItems: 6 142 $ref: /schemas/types.yaml#/definitions/uint32-array 143 144 accessory-mode-audio: 145 type: boolean 146 description: Whether the device supports Audio Adapter Accessory Mode. This 147 is only necessary if there are no other means to discover supported 148 alternative modes (e.g. through the UCSI firmware interface). 149 150 accessory-mode-debug: 151 type: boolean 152 description: Whether the device supports Debug Accessory Mode. This 153 is only necessary if there are no other means to discover supported 154 alternative modes (e.g. through the UCSI firmware interface). 155 156 altmodes: 157 type: object 158 description: List of Alternative Modes supported by the schematics on the 159 particular device. This is only necessary if there are no other means to 160 discover supported alternative modes (e.g. through the UCSI firmware 161 interface). 162 163 additionalProperties: false 164 165 patternProperties: 166 "^(displayport)$": 167 type: object 168 description: 169 A single USB-C Alternative Mode as supported by the USB-C connector logic. 170 171 additionalProperties: false 172 173 properties: 174 svid: 175 $ref: /schemas/types.yaml#/definitions/uint16 176 description: Unique value assigned by USB-IF to the Vendor / AltMode. 177 enum: [ 0xff01 ] 178 vdo: 179 $ref: /schemas/types.yaml#/definitions/uint32 180 description: VDO returned by Discover Modes USB PD command. 181 182 port: 183 $ref: /schemas/graph.yaml#/properties/port 184 description: OF graph bindings modeling a data bus to the connector, e.g. 185 there is a single High Speed (HS) port present in this connector. If there 186 is more than one bus (several port, with 'reg' property), they can be grouped 187 under 'ports'. 188 189 ports: 190 $ref: /schemas/graph.yaml#/properties/ports 191 description: OF graph bindings modeling any data bus to the connector 192 unless the bus is between parent node and the connector. Since a single 193 connector can have multiple data buses every bus has an assigned OF graph 194 port number as described below. 195 196 properties: 197 port@0: 198 $ref: /schemas/graph.yaml#/properties/port 199 description: High Speed (HS), present in all connectors. 200 201 port@1: 202 $ref: /schemas/graph.yaml#/properties/port 203 description: Super Speed (SS), present in SS capable connectors. 204 205 port@2: 206 $ref: /schemas/graph.yaml#/properties/port 207 description: Sideband Use (SBU), present in USB-C. This describes the 208 alternate mode connection of which SBU is a part. 209 210 required: 211 - port@0 212 213 new-source-frs-typec-current: 214 description: Initial current capability of the new source when vSafe5V 215 is applied during PD3.0 Fast Role Swap. "Table 6-14 Fixed Supply PDO - Sink" 216 of "USB Power Delivery Specification Revision 3.0, Version 1.2" provides the 217 different power levels and "6.4.1.3.1.6 Fast Role Swap USB Type-C Current" 218 provides a detailed description of the field. The sink PDO from current source 219 reflects the current source's(i.e. transmitter of the FRS signal) power 220 requirement during fr swap. The current sink (i.e. receiver of the FRS signal), 221 a.k.a new source, should check if it will be able to satisfy the current source's, 222 new sink's, requirement during frswap before enabling the frs signal reception. 223 This property refers to maximum current capability that the current sink can 224 satisfy. During FRS, VBUS voltage is at 5V, as the partners are in implicit 225 contract, hence, the power level is only a function of the current capability. 226 "1" refers to default USB power level as described by "Table 6-14 Fixed Supply PDO - Sink". 227 "2" refers to 1.5A@5V. 228 "3" refers to 3.0A@5V. 229 $ref: /schemas/types.yaml#/definitions/uint32 230 enum: [1, 2, 3] 231 232 slow-charger-loop: 233 description: Allows PMIC charger loops which are slow(i.e. cannot meet the 15ms deadline) to 234 still comply to pSnkStby i.e Maximum power that can be consumed by sink while in Sink Standby 235 state as defined in 7.4.2 Sink Electrical Parameters of USB Power Delivery Specification 236 Revision 3.0, Version 1.2. When the property is set, the port requests pSnkStby(2.5W - 237 5V@500mA) upon entering SNK_DISCOVERY(instead of 3A or the 1.5A, Rp current advertised, during 238 SNK_DISCOVERY) and the actual current limit after reception of PS_Ready for PD link or during 239 SNK_READY for non-pd link. 240 type: boolean 241 242 capabilities: 243 description: A child node to contain all the selectable USB Power Delivery capabilities. 244 type: object 245 246 patternProperties: 247 "^caps-[0-9]+$": 248 description: Child nodes under "capabilities" node. Each node contains a selectable USB 249 Power Delivery capability. 250 type: object 251 $ref: "#/$defs/capabilities" 252 unevaluatedProperties: false 253 254 additionalProperties: false 255 256 sink-wait-cap-time-ms: 257 description: Represents the max time in ms that USB Type-C port (in sink 258 role) should wait for the port partner (source role) to send source caps. 259 SinkWaitCap timer starts when port in sink role attaches to the source. 260 This timer will stop when sink receives PD source cap advertisement before 261 timeout in which case it'll move to capability negotiation stage. A 262 timeout leads to a hard reset message by the port. 263 minimum: 310 264 maximum: 620 265 default: 310 266 267 ps-source-off-time-ms: 268 description: Represents the max time in ms that a DRP in source role should 269 take to turn off power after the PsSourceOff timer starts. PsSourceOff 270 timer starts when a sink's PHY layer receives EOP of the GoodCRC message 271 (corresponding to an Accept message sent in response to a PR_Swap or a 272 FR_Swap request). This timer stops when last bit of GoodCRC EOP 273 corresponding to the received PS_RDY message is transmitted by the PHY 274 layer. A timeout shall lead to error recovery in the type-c port. 275 minimum: 750 276 maximum: 920 277 default: 920 278 279 cc-debounce-time-ms: 280 description: Represents the max time in ms that a port shall wait to 281 determine if it's attached to a partner. 282 minimum: 100 283 maximum: 200 284 default: 200 285 286 sink-bc12-completion-time-ms: 287 description: Represents the max time in ms that a port in sink role takes 288 to complete Battery Charger (BC1.2) Detection. BC1.2 detection is a 289 hardware mechanism, which in some TCPC implementations, can run in 290 parallel once the Type-C connection state machine reaches the "potential 291 connect as sink" state. In TCPCs where this causes delays to respond to 292 the incoming PD messages, sink-bc12-completion-time-ms is used to delay 293 PD negotiation till BC1.2 detection completes. 294 default: 0 295 296 pd-revision: 297 description: Specifies the maximum USB PD revision and version supported by 298 the connector. This property is specified in the following order; 299 <revision_major, revision_minor, version_major, version_minor>. 300 $ref: /schemas/types.yaml#/definitions/uint8-array 301 maxItems: 4 302 303 sink-load-step: 304 description: Indicates the preferred load step slew rate in mA/usec for 305 the port (in sink mode). This property is defined in "6.5.13.7" of 306 "USB Power Delivery Specification Revision 3.1 Version 1.8". 307 $ref: /schemas/types.yaml#/definitions/uint32 308 enum: [150, 500] 309 default: 150 310 311 sink-load-characteristics: 312 description: Indicates the port's (in sink mode) preferred load 313 characteristics. Users can leverage SINK_LOAD_CHAR() defined in 314 dt-bindings/usb/pd.h to populate this field. This property is defined in 315 "6.5.13.8" of "USB Power Delivery Specification Revision 3.1 Version 1.8". 316 $ref: /schemas/types.yaml#/definitions/uint16 317 318 sink-compliance: 319 description: Represents the types of sources the sink device has been tested 320 and certified with. This property is defined in "6.5.13.9" of 321 "USB Power Delivery Specification Revision 3.1 Version 1.8" 322 Bit 0 when set indicates it has been tested on LPS compliant source 323 Bit 1 when set indicates it has been tested on PS1 compliant source 324 Bit 2 when set indicates it has been tested on PS2 compliant source 325 $ref: /schemas/types.yaml#/definitions/uint8 326 maximum: 7 327 328 charging-adapter-pdp-milliwatt: 329 description: This corresponds to the Power Delivery Profile rating of the 330 charging adapter shipped or recommended for use with the connector port. 331 This property is a requirement to infer the USB PD property 332 "SPR Sink Operational PDP" given in "6.5.13.14" of 333 "USB Power Delivery Specification Revision 3.1 Version 1.8". 334 minimum: 0 335 maximum: 100000 336 337dependencies: 338 sink-vdos-v1: [ sink-vdos ] 339 sink-vdos: [ sink-vdos-v1 ] 340 341required: 342 - compatible 343 344$defs: 345 capabilities: 346 type: object 347 348 properties: 349 source-pdos: 350 description: An array of u32 with each entry providing supported power 351 source data object(PDO), the detailed bit definitions of PDO can be found 352 in "Universal Serial Bus Power Delivery Specification" chapter 6.4.1.2 353 Source_Capabilities Message, the order of each entry(PDO) should follow 354 the PD spec chapter 6.4.1. Required for power source and power dual role. 355 User can specify the source PDO array via PDO_FIXED/BATT/VAR/PPS_APDO() 356 defined in dt-bindings/usb/pd.h. 357 minItems: 1 358 maxItems: 7 359 $ref: /schemas/types.yaml#/definitions/uint32-array 360 361 sink-pdos: 362 description: An array of u32 with each entry providing supported power sink 363 data object(PDO), the detailed bit definitions of PDO can be found in 364 "Universal Serial Bus Power Delivery Specification" chapter 6.4.1.3 365 Sink Capabilities Message, the order of each entry(PDO) should follow the 366 PD spec chapter 6.4.1. Required for power sink and power dual role. User 367 can specify the sink PDO array via 368 PDO_FIXED/BATT/VAR/PPS_APDO/SPR_AVS_SNK_APDO() defined in 369 dt-bindings/usb/pd.h. 370 minItems: 1 371 maxItems: 7 372 $ref: /schemas/types.yaml#/definitions/uint32-array 373 374 op-sink-microwatt: 375 description: Sink required operating power in microwatt, if source can't 376 offer the power, Capability Mismatch is set. Required for power sink and 377 power dual role. 378 379allOf: 380 - $ref: "#/$defs/capabilities" 381 - if: 382 properties: 383 compatible: 384 contains: 385 const: gpio-usb-b-connector 386 then: 387 anyOf: 388 - required: 389 - vbus-gpios 390 - required: 391 - id-gpios 392 393 - if: 394 properties: 395 compatible: 396 contains: 397 const: samsung,usb-connector-11pin 398 then: 399 properties: 400 type: 401 const: micro 402 403anyOf: 404 - not: 405 required: 406 - typec-power-opmode 407 - new-source-frs-typec-current 408 409unevaluatedProperties: false 410 411examples: 412 # Micro-USB connector with HS lines routed via controller (MUIC). 413 - | 414 muic-max77843 { 415 usb_con1: connector { 416 compatible = "usb-b-connector"; 417 label = "micro-USB"; 418 type = "micro"; 419 }; 420 }; 421 422 # USB-C connector attached to CC controller (s2mm005), HS lines routed 423 # to companion PMIC (max77865), SS lines to USB3 PHY and SBU to DisplayPort. 424 # DisplayPort video lines are routed to the connector via SS mux in USB3 PHY. 425 - | 426 ccic: s2mm005 { 427 usb_con2: connector { 428 compatible = "usb-c-connector"; 429 label = "USB-C"; 430 431 altmodes { 432 displayport { 433 svid = /bits/ 16 <0xff01>; 434 vdo = <0x00001c46>; 435 }; 436 }; 437 438 ports { 439 #address-cells = <1>; 440 #size-cells = <0>; 441 442 port@0 { 443 reg = <0>; 444 usb_con_hs: endpoint { 445 remote-endpoint = <&max77865_usbc_hs>; 446 }; 447 }; 448 port@1 { 449 reg = <1>; 450 usb_con_ss: endpoint { 451 remote-endpoint = <&usbdrd_phy_ss>; 452 }; 453 }; 454 port@2 { 455 reg = <2>; 456 usb_con_sbu: endpoint { 457 remote-endpoint = <&dp_aux>; 458 }; 459 }; 460 }; 461 }; 462 }; 463 464 # USB-C connector attached to a typec port controller(ptn5110), which has 465 # power delivery support, explicitly defines time properties and enables drp. 466 - | 467 #include <dt-bindings/usb/pd.h> 468 typec: ptn5110 { 469 usb_con3: connector { 470 compatible = "usb-c-connector"; 471 label = "USB-C"; 472 power-role = "dual"; 473 try-power-role = "sink"; 474 source-pdos = <PDO_FIXED(5000, 2000, PDO_FIXED_USB_COMM)>; 475 sink-pdos = <PDO_FIXED(5000, 2000, PDO_FIXED_USB_COMM) 476 PDO_VAR(5000, 12000, 2000)>; 477 op-sink-microwatt = <10000000>; 478 sink-wait-cap-time-ms = <465>; 479 ps-source-off-time-ms = <835>; 480 cc-debounce-time-ms = <101>; 481 sink-bc12-completion-time-ms = <500>; 482 }; 483 }; 484 485 # USB-C connector attached to SoC with a single High-Speed controller 486 - | 487 connector { 488 compatible = "usb-c-connector"; 489 label = "USB-C"; 490 491 port { 492 high_speed_ep: endpoint { 493 remote-endpoint = <&usb_hs_ep>; 494 }; 495 }; 496 }; 497 498 # USB-C connector attached to SoC and USB3 typec port controller(hd3ss3220) 499 # with SS 2:1 MUX. HS lines routed to SoC, SS lines routed to the MUX and 500 # the output of MUX is connected to the SoC. 501 - | 502 connector { 503 compatible = "usb-c-connector"; 504 label = "USB-C"; 505 data-role = "dual"; 506 507 ports { 508 #address-cells = <1>; 509 #size-cells = <0>; 510 port@0 { 511 reg = <0>; 512 hs_ep: endpoint { 513 remote-endpoint = <&usb3_hs_ep>; 514 }; 515 }; 516 port@1 { 517 reg = <1>; 518 ss_ep: endpoint { 519 remote-endpoint = <&hd3ss3220_in_ep>; 520 }; 521 }; 522 }; 523 }; 524 525 # USB connector with GPIO control lines 526 - | 527 #include <dt-bindings/gpio/gpio.h> 528 529 usb { 530 connector { 531 compatible = "gpio-usb-b-connector", "usb-b-connector"; 532 type = "micro"; 533 id-gpios = <&pio 12 GPIO_ACTIVE_HIGH>; 534 vbus-supply = <&usb_p0_vbus>; 535 }; 536 }; 537 538 # Micro-USB connector with HS lines routed via controller (MUIC) and MHL 539 # lines connected to HDMI-MHL bridge (sii8620) on Samsung Exynos5433-based 540 # mobile phone 541 - | 542 muic-max77843 { 543 usb_con4: connector { 544 compatible = "samsung,usb-connector-11pin", "usb-b-connector"; 545 label = "micro-USB"; 546 type = "micro"; 547 548 ports { 549 #address-cells = <1>; 550 #size-cells = <0>; 551 552 port@0 { 553 reg = <0>; 554 muic_to_usb: endpoint { 555 remote-endpoint = <&usb_to_muic>; 556 }; 557 }; 558 port@3 { 559 reg = <3>; 560 usb_con_mhl: endpoint { 561 remote-endpoint = <&sii8620_mhl>; 562 }; 563 }; 564 }; 565 }; 566 }; 567