These bindings allows to describe most known standard USB connectors and it should be possible to extend it if necessary. USB connectors, beside USB can be used to route other protocols, for example UART, Audio, MHL. In such case every device passing data through the connector should have appropriate graph bindings.
Signed-off-by: Andrzej Hajda a.hajda@samsung.com --- There are few things for discussion (IMO): 1. vendor specific connectors, I have added them here, but maybe better is to place them in separate files. 2. physical connector description - I have split it to three properties: type(a,b,ab,c), max-mode(ls,fs,hs,ss,ss+), size(mini,micro,powered). This tripled is able to describe all USB-standard connectors, but there are also impossible combinations, for example(c, *, micro). Maybe better would be to just enumerate all possible connectors in include file. 3. Numbering of port/remote nodes, currently only 0 is assigned for Interface Controller. Maybe other functions should be also assigned: HS, SS, CC, SBU, ... whatever. Maybe functions should be described as an additional property of remote node? ...
Regards Andrzej --- .../bindings/connector/usb-connector.txt | 49 ++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 Documentation/devicetree/bindings/connector/usb-connector.txt
diff --git a/Documentation/devicetree/bindings/connector/usb-connector.txt b/Documentation/devicetree/bindings/connector/usb-connector.txt new file mode 100644 index 000000000000..f3a4e85122d5 --- /dev/null +++ b/Documentation/devicetree/bindings/connector/usb-connector.txt @@ -0,0 +1,49 @@ +USB Connector +============= + +Required properties: +- compatible: "usb-connector" + connectors with vendor specific extensions can add one of additional + compatibles: + "samsung,usb-connector-11pin": 11-pin Samsung micro-USB connector +- type: the USB connector type: "a", "b", "ab", "c" +- max-mode: max USB speed mode supported by the connector: + "ls", "fs", "hs", "ss", "ss+" + +Optional properties: +- label: a symbolic name for the connector +- size: size of the connector, should be specified in case of + non-standard USB connectors: "mini", "micro", "powered" + +Required nodes: +- any data bus to the connector should be modeled using the + OF graph bindings specified in bindings/graph.txt. + There should be exactly one port with at least one endpoint to + different device nodes. The first endpoint (reg = <0>) should + point to USB Interface Controller. + +Example +------- + +musb_con: connector { + compatible = "samsung,usb-connector-11pin", "usb-connector"; + label = "usb"; + type = "b"; + size = "micro"; + max-mode = "hs"; + + port { + #address-cells = <1>; + #size-cells = <0>; + + musb_con_usb_in: endpoint@0 { + reg = <0>; + remote-endpoint = <&muic_usb_out>; + }; + + musb_con_mhl_in: endpoint@1 { + reg = <1>; + remote-endpoint = <&mhl_out>; + }; + }; +};