From patchwork Wed Jan 31 13:44:31 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrzej Hajda X-Patchwork-Id: 10194017 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id D610160380 for ; Wed, 31 Jan 2018 13:45:24 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id C3EC2285CC for ; Wed, 31 Jan 2018 13:45:24 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id B83F5285ED; Wed, 31 Jan 2018 13:45:24 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-4.2 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,RCVD_IN_DNSWL_MED autolearn=ham version=3.3.1 Received: from bombadil.infradead.org (bombadil.infradead.org [65.50.211.133]) (using TLSv1.2 with cipher AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 2DC3C285CC for ; Wed, 31 Jan 2018 13:45:23 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20170209; h=Sender: Content-Transfer-Encoding:Content-Type:MIME-Version:Cc:List-Subscribe: List-Help:List-Post:List-Archive:List-Unsubscribe:List-Id:References: In-reply-to:Message-id:Date:Subject:To:From:Reply-To:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:List-Owner; bh=3uAoC+VIBL9fpn9gICBwEyBnuhg9yJRDCydpzCic9wQ=; b=lWu+GpclarxMMvrurP4INkEgfN YS1BjUTEQ2pEjU2184BauauRQGLc6UCv6CBy4LOv97sHrqUJCkIEXaNCmnMDbVyg2uHxxPptpHpSY Fpz5ZNsnSiwpJqssvAb2XPyTWagDddFW8VCgIXAJB6wuAq2ldiyK/bjmxSKzcYFzF6Cyi/FyLD2l7 1u1M0gDamnrxDIx2eEVLTvaeKozC31akajImWDUVRIKE5mcXRwrcUaEMNgeOkMNDMKTr232JqL08x EHopx29Khzdgkl0Zk4KHaJUPv4pwxgPf+9I2Ur1iOnMS9CVxAFwKbrfm3oIzVG1fsp5Or1ewHvYOG z4OEJISQ==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.89 #1 (Red Hat Linux)) id 1egshU-0006x8-Lc; Wed, 31 Jan 2018 13:45:20 +0000 Received: from mailout1.w1.samsung.com ([210.118.77.11]) by bombadil.infradead.org with esmtps (Exim 4.89 #1 (Red Hat Linux)) id 1egshR-0005j0-8N for linux-arm-kernel@lists.infradead.org; Wed, 31 Jan 2018 13:45:19 +0000 Received: from eucas1p2.samsung.com (unknown [182.198.249.207]) by mailout1.w1.samsung.com (KnoxPortal) with ESMTP id 20180131134458euoutp01cc06360b1e4c1c63e8583616c6157b49~O6P1FQ8D02447124471euoutp01q; Wed, 31 Jan 2018 13:44:58 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 mailout1.w1.samsung.com 20180131134458euoutp01cc06360b1e4c1c63e8583616c6157b49~O6P1FQ8D02447124471euoutp01q DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=samsung.com; s=mail20170921; t=1517406299; bh=lDy2FMyMyuAVc7OHI3TRZI3URVVOrsERyHj/Dcln+no=; h=From:To:Cc:Subject:Date:In-reply-to:References:From; b=k1x7U0C6xHMFA+AtlDLY1zVHcE++phjYLynW01vftnal3lyfWzdAjveCcJ1k6HeHg B9SoC+5BCn1lbN0OR1EcM7ueGehmTLDYuNrzAVON/f9BrVoWpBa5YvedlxX3DUGhTl FdxXayM5bXQVudjS3RZKMCqSVhriPwBWGneT6Rds= Received: from eusmges4.samsung.com (unknown [203.254.199.244]) by eucas1p2.samsung.com (KnoxPortal) with ESMTP id 20180131134458eucas1p29f19e8c36e5356c19e29c0b642082bb6~O6P0Quqqb0037200372eucas1p2I; Wed, 31 Jan 2018 13:44:58 +0000 (GMT) Received: from eucas1p1.samsung.com ( [182.198.249.206]) by eusmges4.samsung.com (EUCPMTA) with SMTP id 14.60.30163.958C17A5; Wed, 31 Jan 2018 13:44:57 +0000 (GMT) Received: from eusmgms2.samsung.com (unknown [182.198.249.180]) by eucas1p1.samsung.com (KnoxPortal) with ESMTP id 20180131134457eucas1p128394aef86e0d76cfc6ccb72ee22d4b1~O6PzmEC7q2533825338eucas1p1y; Wed, 31 Jan 2018 13:44:57 +0000 (GMT) X-AuditID: cbfec7f4-f790c6d0000075d3-9a-5a71c8594659 Received: from eusync1.samsung.com ( [203.254.199.211]) by eusmgms2.samsung.com (EUCPMTA) with SMTP id 2A.A2.20118.958C17A5; Wed, 31 Jan 2018 13:44:57 +0000 (GMT) Received: from AMDC2768.DIGITAL.local ([106.120.43.17]) by eusync1.samsung.com (Oracle Communications Messaging Server 7.0.5.31.0 64bit (built May 5 2014)) with ESMTPA id <0P3F00KEJA6V2O00@eusync1.samsung.com>; Wed, 31 Jan 2018 13:44:57 +0000 (GMT) From: Andrzej Hajda To: devicetree@vger.kernel.org (open list:OPEN FIRMWARE AND FLATTENED DEVICE TREE BINDINGS) 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> X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Mark Rutland , Archit Taneja , linux-samsung-soc@vger.kernel.org, Laurent Pinchart , Chanwoo Choi , Bartlomiej Zolnierkiewicz , linux-usb@vger.kernel.org, linux-kernel@vger.kernel.org, dri-devel@lists.freedesktop.org, Inki Dae , Andrzej Hajda , Rob Herring , Krzysztof Kozlowski , linux-arm-kernel@lists.infradead.org, Marek Szyprowski MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP 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>; + }; + }; + }; + }; +};