From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Cyrus-Session-Id: sloti22d1t05-800753-1517406343-2-5397865524651704869 X-Sieve: CMU Sieve 3.0 X-Spam-known-sender: no ("Email failed DMARC policy for domain") X-Spam-score: 0.0 X-Spam-hits: BAYES_00 -1.9, HEADER_FROM_DIFFERENT_DOMAINS 0.001, RCVD_IN_DNSWL_HI -5, T_RP_MATCHES_RCVD -0.01, LANGUAGES en, BAYES_USED global, SA_VERSION 3.4.0 X-Spam-source: IP='209.132.180.67', Host='vger.kernel.org', Country='US', FromHeader='com', MailFrom='org' X-Spam-charsets: X-IgnoreVacation: yes ("Email failed DMARC policy for domain") X-Resolved-to: greg@kroah.com X-Delivered-to: greg@kroah.com X-Mail-from: linux-usb-owner@vger.kernel.org ARC-Seal: i=1; a=rsa-sha256; cv=none; d=messagingengine.com; s=arctest; t=1517406342; b=EUDpN7XUvAhQEOxB2/ezPtTH/p+6seCeju+uvA6xNuoSj8j U0vviegX/dYbsqZktZcdwmeWLpmWQBJn3h/u1VfQYHyybU2dmzWEuLMIUBODhRJ5 i70LFtyS7k5enVKCDj+uj5xlkIXxwsdgxjYwtupEyly/AGkiRIaaXrZ/zqhmiyJy JHpReUFWB8SknCmb052fi8auH+3e0bnaiac3uctTQOGbxLMipqBnfkzznX4aKDxF J3C6xVbPEBTHgNj0gn46c9BLn0+EHusjx4bEBtbn+7coykzActwwEb5HhlyLGqDL TnoZ4mCrZjkUc/AE+de5jkjXfDXRnqWeueLZVdw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=from:to:cc:subject:date:message-id :in-reply-to:references:sender:list-id; s=arctest; t=1517406342; bh=g+KDQPoFSgdMhwZBW/iVasY46z09MzGgBhthH1C64Sk=; b=bLIX2GWpIgND s/7mOmnmWQIAYWc7kZ9f4MYvhY4+nVHVudL5CTkQWd4faZ7skEnRUftQqGDgMlKB DFjihsUD+iqtTiF4qkH9OSGmzMVFOY1yecvwAjvV1PWrESRzSNjXDf8NNksqHi/x hyoMcNFQdSW42x0xa6FGYVlNUTWTpxauJ6hjDdoNWic8iIEtmOwkd/e/mF7HDSpf Cw2sKaW0Xt9zfGEDFFWhQ0uKXfZ04rHipQ2rl6T6CLwdjeEkY04L6Cu5ZKPYNGAE zJpmtQp3rFIjDPqge2xMkMw+VSigTBDhOHUagoUbhID0kspeBWRAUTDUjgYyNzEl 1Q7ovuegJw== ARC-Authentication-Results: i=1; mx3.messagingengine.com; arc=none (no signatures found); dkim=fail (body has been altered; 1024-bit rsa key sha256) header.d=samsung.com header.i=@samsung.com header.b=k1x7U0C6 x-bits=1024 x-keytype=rsa x-algorithm=sha256 x-selector=mail20170921; dmarc=fail (p=none,has-list-id=yes,d=none) header.from=samsung.com; iprev=pass policy.iprev=209.132.180.67 (vger.kernel.org); spf=none smtp.mailfrom=linux-usb-owner@vger.kernel.org smtp.helo=vger.kernel.org; x-aligned-from=fail; x-ptr=pass x-ptr-helo=vger.kernel.org x-ptr-lookup=vger.kernel.org; x-return-mx=pass smtp.domain=vger.kernel.org smtp.result=pass smtp_org.domain=kernel.org smtp_org.result=pass smtp_is_org_domain=no header.domain=samsung.com header.result=pass header_is_org_domain=yes Authentication-Results: mx3.messagingengine.com; arc=none (no signatures found); dkim=fail (body has been altered; 1024-bit rsa key sha256) header.d=samsung.com header.i=@samsung.com header.b=k1x7U0C6 x-bits=1024 x-keytype=rsa x-algorithm=sha256 x-selector=mail20170921; dmarc=fail (p=none,has-list-id=yes,d=none) header.from=samsung.com; iprev=pass policy.iprev=209.132.180.67 (vger.kernel.org); spf=none smtp.mailfrom=linux-usb-owner@vger.kernel.org smtp.helo=vger.kernel.org; x-aligned-from=fail; x-ptr=pass x-ptr-helo=vger.kernel.org x-ptr-lookup=vger.kernel.org; x-return-mx=pass smtp.domain=vger.kernel.org smtp.result=pass smtp_org.domain=kernel.org smtp_org.result=pass smtp_is_org_domain=no header.domain=samsung.com header.result=pass header_is_org_domain=yes Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753139AbeAaNpG (ORCPT ); Wed, 31 Jan 2018 08:45:06 -0500 Received: from mailout1.w1.samsung.com ([210.118.77.11]:55524 "EHLO mailout1.w1.samsung.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752602AbeAaNpB (ORCPT ); Wed, 31 Jan 2018 08:45:01 -0500 DKIM-Filter: OpenDKIM Filter v2.11.0 mailout1.w1.samsung.com 20180131134458euoutp01cc06360b1e4c1c63e8583616c6157b49~O6P1FQ8D02447124471euoutp01q X-AuditID: cbfec7f4-f790c6d0000075d3-9a-5a71c8594659 From: Andrzej Hajda To: devicetree@vger.kernel.org (open list:OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS) Cc: Andrzej Hajda , Bartlomiej Zolnierkiewicz , Marek Szyprowski , dri-devel@lists.freedesktop.org, Inki Dae , Rob Herring , Mark Rutland , Krzysztof Kozlowski , Chanwoo Choi , Archit Taneja , Laurent Pinchart , linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-samsung-soc@vger.kernel.org, linux-usb@vger.kernel.org Subject: [RFC PATCH v2 1/5] dt-bindings: add bindings for USB physical connector Date: Wed, 31 Jan 2018 14:44:31 +0100 Message-id: <20180131134435.12216-2-a.hajda@samsung.com> X-Mailer: git-send-email 2.15.1 In-reply-to: <20180131134435.12216-1-a.hajda@samsung.com> X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrNIsWRmVeSWpSXmKPExsWy7djPc7qRJwqjDGb061vcWneO1aKp4y2r xcYZ61ktrn95zmox/whQ7MrX92wWk+5PYLE4f34Du0XnxCXsFpseX2O1uLxrDpvFjPP7mCwW LWtltlh75C67xdLrF5ksWvceYXcQ8Fgzbw2jx+W+XiaP2R0zWT02repk87jffZzJY/OSeo++ LasYPT5vkgvgiOKySUnNySxLLdK3S+DKWHilmbVgknhF/3W9BsZHQl2MnBwSAiYSsy61MkHY YhIX7q1n62Lk4hASWMooMa9/KZTzmVFi+amrLDAdy77dY4FILGOUuH3yJ5Tzn1Hi7rMJbCBV bAKaEn833wSzRQRiJd5d2sUMUsQscIFF4sLpV+wgCWGBIInTq3vAxrIIqEr03D3FCmLzClhI zFo/kRVinbzEhC1NYDWcApYS91bsAbtJQuA5m8SMt23MEEUuEg+nnYRqEJZ4dXwLO4QtI3F5 cjcLREM3o8Sn/hPsEM4URol/H2ZAdVtLHD5+EaybWYBPYtK26UBxDqA4r0RHGzSYPCQmrvsF Ve4o0bbxIzPEzz3AkJnWyDqBUXoBI8MqRpHU0uLc9NRiE73ixNzi0rx0veT83E2MwCRx+t/x LzsYFx+zOsQowMGoxMObUFUQJcSaWFZcmXuIUYKDWUmE91tMYZQQb0piZVVqUX58UWlOavEh RmkOFiVxXtuotkghgfTEktTs1NSC1CKYLBMHp1QDY86rhfufzTvM76Z1o66wg2XWu+4jfw6e W+kk2BeSqe1w5v/ZHyJbjiQJK5c71Dy091/aIczGVbOqOuOL/9qUyArVbz4P9vTtvb/16ddr PhpfbRsbcsNOS5+I+n3v2txozn33HyeecVgm3heVWTJHMV48LZFr6Qneq+Xssjp3JPpernvR tXD/KyWW4oxEQy3mouJEAKmh2+AOAwAA X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFjrLLMWRmVeSWpSXmKPExsVy+t/xy7qRJwqjDH6fE7a4te4cq0VTx1tW i40z1rNaXP/ynNVi/hGg2JWv79ksJt2fwGJx/vwGdovOiUvYLTY9vsZqcXnXHDaLGef3MVks WtbKbLH2yF12i6XXLzJZtO49wu4g4LFm3hpGj8t9vUwesztmsnpsWtXJ5nG/+ziTx+Yl9R59 W1YxenzeJBfAEcVlk5Kak1mWWqRvl8CVsfBKM2vBJPGK/ut6DYyPhLoYOTkkBEwkln27xwJh i0lcuLeerYuRi0NIYAmjxKRl+1hBEkICjUwSczckgthsApoSfzffZAOxRQRiJd6e+swM0sAs cIFF4vfEmewgCWGBAIkXyxYygtgsAqoSPXdPgQ3iFbCQmLV+IivENnmJCVuawDZzClhK3Fux hw1imYXEv00NbBMYeRcwMqxiFEktLc5Nzy020itOzC0uzUvXS87P3cQIDORtx35u2cHY9S74 EKMAB6MSDy9nRUGUEGtiWXFl7iFGCQ5mJRHebzGFUUK8KYmVValF+fFFpTmpxYcYpTlYlMR5 e/esjhQSSE8sSc1OTS1ILYLJMnFwSjUwXu/y/yonccDGM+DqRq7U/T8DeE8JP2k+s255dK9i xbE97bFZdZv37AldlzJPs55FI1hoxoVJDv+i57cyMs3f9c7e14Ol7fyCSZ4Of/QeJRubuk6u 32gyRaliL4f4Yg3rDR16axMyBd0XcatNnXs34/KGokmLhVbvY+k+v6eLVXjK+ntrq2+9V2Ip zkg01GIuKk4EACsDSTdgAgAA X-CMS-MailID: 20180131134457eucas1p128394aef86e0d76cfc6ccb72ee22d4b1 X-Msg-Generator: CA CMS-TYPE: 201P X-CMS-RootMailID: 20180131134457eucas1p128394aef86e0d76cfc6ccb72ee22d4b1 X-RootMTR: 20180131134457eucas1p128394aef86e0d76cfc6ccb72ee22d4b1 References: <20180131134435.12216-1-a.hajda@samsung.com> Sender: linux-usb-owner@vger.kernel.org X-Mailing-List: linux-usb@vger.kernel.org X-getmail-retrieved-from-mailbox: INBOX X-Mailing-List: linux-kernel@vger.kernel.org List-ID: These bindings allow 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 --- v2: - moved connector type(A,B,C) to compatible string (Rob), - renamed size property to type (Rob), - changed type description to be less confusing (Laurent), - removed vendor specific compatibles (implied by graph port number), - added requirement of connector being a child of IC (Rob), - removed max-mode (subtly suggested by Rob, it should be detected anyway by USB Controller in runtime, downside is that device is not able to report its real capabilities, maybe better would be to make it optional(?)), - assigned port numbers to data buses (Rob). Regards Andrzej Signed-off-by: Andrzej Hajda --- .../bindings/connector/usb-connector.txt | 48 ++++++++++++++++++++++ 1 file changed, 48 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..02020f5d760a --- /dev/null +++ b/Documentation/devicetree/bindings/connector/usb-connector.txt @@ -0,0 +1,48 @@ +USB Connector +============= + +USB connector node represents physical USB connector. It should be +a child of USB interface controller. + +Required properties: +- compatible: describes type of the connector, must be one of: + "usb-a-connector", "usb-b-connector", "usb-c-connector", + +Optional properties: +- label: symbolic name for the connector +- type: size of the connector, should be specified in case of USB-A, USB-B + non-standard (large) connector sizes: "mini", "micro" + +Required nodes: +- any data bus to the connector should be modeled using the OF graph bindings + specified in bindings/graph.txt, unless the bus is between parent node and + the connector. Since single connector can have multpile data buses every bus + has assigned OF graph port number as follows: + 0: High Speed (HS), present in all connectors, + 1: Super Speed (SS), present in SS capable connectors, + 2: Sideband use (SBU), present in USB-C, + 3: Mobile High-Definition Link (MHL), present in 11-pin Samsung micro-USB + +Example +------- + +muic_max77843@66 { + ... + musb_con: connector { + compatible = "usb-b-connector"; + label = "micro-USB"; + type = "micro"; + + ports { + #address-cells = <1>; + #size-cells = <0>; + + port@3 { + reg = <3>; + musb_con_mhl_in: endpoint { + remote-endpoint = <&mhl_out>; + }; + }; + }; + }; +}; -- 2.15.1