From patchwork Sun Oct 8 21:17:11 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Martin Blumenstingl X-Patchwork-Id: 9992003 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 26EC160230 for ; Sun, 8 Oct 2017 21:18:07 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 0D796285FE for ; Sun, 8 Oct 2017 21:18:07 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 0110C2862A; Sun, 8 Oct 2017 21:18:06 +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_ADSP_CUSTOM_MED, DKIM_SIGNED, DKIM_VALID, FREEMAIL_FROM, 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 6D564285FE for ; Sun, 8 Oct 2017 21:18:06 +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=PbBXm9m+Fg8zznQ5v0hraH8Yvn9orhqRPC+JgsNSjXQ=; b=uvecMzuPtVM7Lc81dGdQvwRFzH XTyTmNDePg0RQ2tW62Uhoq3DGxdvMiqwxMPJNokQ+YQ6gZWn6jYEZjv0SYH7Fn1TMrnrpnDnamcvE XU9s7GPhPMsQ1TAl7MHP4KG0EAEG1TADv6yNzQd+etZodL1B2G5Lpn2XuNGqs18pg+Kw+uApwgPLD U8yo9rU5WKt1QqoP+CqAcsu1RykKs8TKezImVw8gHua8oqRtXFp949mssENOeZfL7Qx3RxlC3X1Ty Tn+nC5IIegs9qFyVLr2utW7WHDjGBOUvmpee59tpB7eF93on6rSW2SLrtFj73Hj54jxX2rxMBg+vI PMuBLaeA==; Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.87 #1 (Red Hat Linux)) id 1e1IxH-0006Tx-N9; Sun, 08 Oct 2017 21:17:47 +0000 Received: from mail-wm0-x243.google.com ([2a00:1450:400c:c09::243]) by bombadil.infradead.org with esmtps (Exim 4.87 #1 (Red Hat Linux)) id 1e1IxD-0006DA-GK for linux-amlogic@lists.infradead.org; Sun, 08 Oct 2017 21:17:46 +0000 Received: by mail-wm0-x243.google.com with SMTP id b189so18346420wmd.2 for ; Sun, 08 Oct 2017 14:17:22 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlemail.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=zaFyjXulMLFOhVyZW3dDVhln8QQz0hD8t9D5c9+Vvvg=; b=a6FywC0oaiZfPxdyWssI14P+kToiPSW49//pJ8Rg+5BM7mthOrlm6SWL/GY+L7TpoN NyCCCIemjAe9bm1lp4huo5hFUK7jdZgV49SUPzb3MaMIw+82wVYWIgalGg80ZZpy8MFn Hu7AAwnL3/35OyI3lg35J3dPE4j2K0LnjQTnrJp5/he8nMiDJ7y9J9xmxXWsKGY2Bz7a UJzOQJaV8YhgMqOph0DS8b2kT0kjduWf43dMIVXtciyUfvLVvjNtz1AWPJo3jl76NOxV 4h8aJbveUo+66UqLqHewctSnNURqQ/Z88GNT+MixMaLshsia+WZCT7WfgGD+DOy7ScfJ 2kxQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=zaFyjXulMLFOhVyZW3dDVhln8QQz0hD8t9D5c9+Vvvg=; b=sMu4+k1sO4m8WTn4sV/T6Je3w6KPIm5LrjqKdVUCVbQRLMOGCX1PCRoAh2X3NSjEc8 MNsfyv3Wk1ri2ABKjmsx5v3WLw7Ln7/Pg9sm8MZUPKYA99dWlU+9IQW42uI6sN/YlKwZ GFjY1HQNUWdGthBhHZIg/MbkU8iqY52A6IIJ3AheZbLwRi1JnRYKoHfpgRm/KvwmG27V A3/Diu0PnvHx2JMCz6e8a27bqH6NoZ39Ot7mjvk+DgCmdjZdx19xDMLk47hzgs0LtXhB x5fc8Vlrw8pMDHfLL97KWeNKew5gPxj64z/BLqmW3aHE4sCBPeb0soYm6DVYeCU927nC JLkg== X-Gm-Message-State: AMCzsaU99IlS+QerKMggUlkCioXsoSN6oy1HN1xf4fSxmp2WNJfHV9Av Bua9LAAy46OBS2Qvn1zc9gE= X-Google-Smtp-Source: AOwi7QAdM7msDyDLbSHvtBG8gjS47Bk28txboDpEmDdQC546RE8cb0rLrX39Frwi8BJxFE5aRzvRTw== X-Received: by 10.223.186.140 with SMTP id p12mr7142078wrg.235.1507497441316; Sun, 08 Oct 2017 14:17:21 -0700 (PDT) Received: from blackbox.darklights.net (p200300DCD3DC7704A06B630ABD9CCA81.dip0.t-ipconnect.de. [2003:dc:d3dc:7704:a06b:630a:bd9c:ca81]) by smtp.googlemail.com with ESMTPSA id i16sm11772150wrf.19.2017.10.08.14.17.20 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 08 Oct 2017 14:17:20 -0700 (PDT) From: Martin Blumenstingl To: linux-usb@vger.kernel.org, gregkh@linuxfoundation.org, felipe.balbi@linux.intel.com, mathias.nyman@intel.com Subject: [RFC usb-next v5 1/3] dt-bindings: usb: add the documentation for USB root-hub Date: Sun, 8 Oct 2017 23:17:11 +0200 Message-Id: <20171008211713.18696-2-martin.blumenstingl@googlemail.com> X-Mailer: git-send-email 2.14.2 In-Reply-To: <20171008211713.18696-1-martin.blumenstingl@googlemail.com> References: <20171008211713.18696-1-martin.blumenstingl@googlemail.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20171008_141743_750365_06853451 X-CRM114-Status: GOOD ( 15.23 ) X-BeenThere: linux-amlogic@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@arm.com, devicetree@vger.kernel.org, arnd@arndb.de, Martin Blumenstingl , robh+dt@kernel.org, chunfeng.yun@mediatek.com, linux-amlogic@lists.infradead.org MIME-Version: 1.0 Sender: "linux-amlogic" Errors-To: linux-amlogic-bounces+patchwork-linux-amlogic=patchwork.kernel.org@lists.infradead.org X-Virus-Scanned: ClamAV using ClamSMTP A USB root-hub may have several PHYs which need to be configured before the root-hub starts working. This adds the documentation for such a USB root-hub as well as a hint regarding the child-nodes on XHCI controllers which can include the roothub. Signed-off-by: Martin Blumenstingl Acked-by: Rob Herring --- .../devicetree/bindings/usb/usb-roothub.txt | 46 ++++++++++++++++++++++ Documentation/devicetree/bindings/usb/usb-xhci.txt | 7 ++++ 2 files changed, 53 insertions(+) create mode 100644 Documentation/devicetree/bindings/usb/usb-roothub.txt diff --git a/Documentation/devicetree/bindings/usb/usb-roothub.txt b/Documentation/devicetree/bindings/usb/usb-roothub.txt new file mode 100644 index 000000000000..fc0797d7cee9 --- /dev/null +++ b/Documentation/devicetree/bindings/usb/usb-roothub.txt @@ -0,0 +1,46 @@ +Generic USB root-hub Properties + +similar to the USB device bindings (documented in usb-device.txt from the +current directory) this provides support for configuring the root-hub. + +Required properties: +- compatible: should be at least one of "usb1d6b,3", "usb1d6b,2" +- reg: must be 0. +- address-cells: must be 1 +- size-cells: must be 0 + +Required sub-nodes: +a sub-node per actual USB port is required. each sub-node supports the +following properties: + Required properties: + - reg: the port number on the root-hub (mandatory) + Optional properties: + - phys: optional, from the *Generic PHY* bindings (mandatory needed + when phy-names is given) + - phy-names: optional, from the *Generic PHY* bindings; supported names + are "usb2-phy" or "usb3-phy" + +Example: + &usb1 { + #address-cells = <1>; + #size-cells = <0>; + + roothub@0 { + compatible = "usb1d6b,3", "usb1d6b,2"; + #address-cells = <1>; + #size-cells = <0>; + reg = <0>; + + port@1 { + reg = <1>; + phys = <&usb2_phy1>, <&usb3_phy1>; + phy-names = "usb2-phy", "usb3-phy"; + }; + + port@2 { + reg = <2>; + phys = <&usb2_phy2>, <&usb3_phy2>; + phy-names = "usb2-phy", "usb3-phy"; + }; + }; + } diff --git a/Documentation/devicetree/bindings/usb/usb-xhci.txt b/Documentation/devicetree/bindings/usb/usb-xhci.txt index ae6e484a8d7c..5b49ba9f2f9a 100644 --- a/Documentation/devicetree/bindings/usb/usb-xhci.txt +++ b/Documentation/devicetree/bindings/usb/usb-xhci.txt @@ -30,6 +30,13 @@ Optional properties: - usb3-lpm-capable: determines if platform is USB3 LPM capable - quirk-broken-port-ped: set if the controller has broken port disable mechanism +sub-nodes: +- optionally there can be a node for the root-hub, see usb-roothub.txt in the + current directory +- one or more nodes with reg 1-31 for each port to which a device is connected. + See usb-device.txt in the current directory for more information. + + Example: usb@f0931000 { compatible = "generic-xhci";