From patchwork Sun Sep 3 21:38:27 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Martin Blumenstingl X-Patchwork-Id: 809358 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=none (mailfrom) smtp.mailfrom=vger.kernel.org (client-ip=209.132.180.67; helo=vger.kernel.org; envelope-from=devicetree-owner@vger.kernel.org; receiver=) Authentication-Results: ozlabs.org; dkim=fail reason="signature verification failed" (2048-bit key; unprotected) header.d=googlemail.com header.i=@googlemail.com header.b="CZba0ers"; dkim-atps=neutral Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 3xlmZf4kwZz9t30 for ; Mon, 4 Sep 2017 07:39:06 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753005AbdICVi6 (ORCPT ); Sun, 3 Sep 2017 17:38:58 -0400 Received: from mail-wm0-f68.google.com ([74.125.82.68]:36329 "EHLO mail-wm0-f68.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752944AbdICVi4 (ORCPT ); Sun, 3 Sep 2017 17:38:56 -0400 Received: by mail-wm0-f68.google.com with SMTP id p17so4856494wmd.3; Sun, 03 Sep 2017 14:38:55 -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=P3ZlqS5JVBhBs6jJ6moRqY1679lbIZBiIlgHJtDC7xM=; b=CZba0ershdYpTDycSSr1MwOskPqgteKSMtQ4HPkvSb1oKnP59KwdAJS7ny4UVv8lyh sJsjspPZ0JYTgFJSYSe4Bdi8UvvX0fTpiHLiOmG11uzawB4o67VoN8LdGvMuUjHKpBvH jexekm0bOKEH60QkFAh5OiVw2Z+Ia8LW/yezY+bYh3wc0zX6KjsSryIA0FN1/1wGW+l/ 7ztA/seXH9t4r+NSi6C6mE5DqYhnM5IACCZlWgVxAZFdTQVvhAmR8NeRnnR5/gFf39Zh QwGXSwK0GCUQ6UcKcaqOxIb2txWgC1dlbjR80LkP9UzFXGWJjuNS8aqWWb2+4XWRE3og xUhw== 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=P3ZlqS5JVBhBs6jJ6moRqY1679lbIZBiIlgHJtDC7xM=; b=pUN5d3Yn2ar3h7xgi8ZOVRSPX+uk38TqjYPXJeWY32yJaypHU9rrKll+WUpRxsaEXO MioWycWv3MSjN6E6sJ4xi9CNxf4vyqyZH59/j4zx3s2ElxYXQLKr3aE9V5DYYhgbmnxB Z1+01Wv8gV7f/GoD+pNLSdPW5Y8fjNUKbPCDtgV39ykJpDE/SFGsUiSieYLQDSipD00A kfyXZNXI0RWGy+S2s/4B/NFP0YKMDTEO8bBqYJJCY3o0mwNZmW/+jb48JMmQ+gmGM1x2 BUkl5HtAmyLHykDuM0hTPhNhxuszigwk+dpq25i6H7DpdwKw5WA6PLQZYlW6GuHA4Gtr DNQw== X-Gm-Message-State: AHPjjUjSmwjOUUf3MdFseHpNbfePNjw5yiZT8fT3xhuaQAw0IORwPkqW Pk84NAPHo/sTJA5Yxoc= X-Google-Smtp-Source: ADKCNb42RZU0+Qm9xpYa51/CXzEDg72DuYW8GqhC1YzmQPQPMo8ykDncdKO9hd13jKrsewK0D994Cw== X-Received: by 10.28.175.76 with SMTP id y73mr3113867wme.33.1504474734487; Sun, 03 Sep 2017 14:38:54 -0700 (PDT) Received: from blackbox.darklights.net (p200300DCD3D58204A0117FABC96C39BD.dip0.t-ipconnect.de. [2003:dc:d3d5:8204:a011:7fab:c96c:39bd]) by smtp.googlemail.com with ESMTPSA id e8sm17786198wmf.37.2017.09.03.14.38.52 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sun, 03 Sep 2017 14:38:53 -0700 (PDT) From: Martin Blumenstingl To: linux-usb@vger.kernel.org, gregkh@linuxfoundation.org, felipe.balbi@linux.intel.com, mathias.nyman@intel.com Cc: robh+dt@kernel.org, devicetree@vger.kernel.org, mark.rutland@arm.com, arnd@arndb.de, linux-amlogic@lists.infradead.org, chunfeng.yun@mediatek.com, Martin Blumenstingl Subject: [PATCH v4 1/3] dt-bindings: usb: add the documentation for USB root-hub Date: Sun, 3 Sep 2017 23:38:27 +0200 Message-Id: <20170903213829.6589-2-martin.blumenstingl@googlemail.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20170903213829.6589-1-martin.blumenstingl@googlemail.com> References: <20170903213829.6589-1-martin.blumenstingl@googlemail.com> Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org 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 2d80b60eeabe..31b4f681e9ca 100644 --- a/Documentation/devicetree/bindings/usb/usb-xhci.txt +++ b/Documentation/devicetree/bindings/usb/usb-xhci.txt @@ -29,6 +29,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";