{"id":809358,"url":"http://patchwork.ozlabs.org/api/1.0/patches/809358/?format=json","project":{"id":37,"url":"http://patchwork.ozlabs.org/api/1.0/projects/37/?format=json","name":"Devicetree Bindings","link_name":"devicetree-bindings","list_id":"devicetree.vger.kernel.org","list_email":"devicetree@vger.kernel.org","web_url":"","scm_url":"","webscm_url":""},"msgid":"<20170903213829.6589-2-martin.blumenstingl@googlemail.com>","date":"2017-09-03T21:38:27","name":"[v4,1/3] dt-bindings: usb: add the documentation for USB root-hub","commit_ref":null,"pull_url":null,"state":"not-applicable","archived":true,"hash":"f9928467fb904a0fcbba7bb6e9bd4e16c3c9ef28","submitter":{"id":66366,"url":"http://patchwork.ozlabs.org/api/1.0/people/66366/?format=json","name":"Martin Blumenstingl","email":"martin.blumenstingl@googlemail.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/devicetree-bindings/patch/20170903213829.6589-2-martin.blumenstingl@googlemail.com/mbox/","series":[{"id":1276,"url":"http://patchwork.ozlabs.org/api/1.0/series/1276/?format=json","date":"2017-09-03T21:38:26","name":"initialize (multiple) PHYs in xhci-plat","version":4,"mbox":"http://patchwork.ozlabs.org/series/1276/mbox/"}],"check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/809358/checks/","tags":{},"headers":{"Return-Path":"","X-Original-To":"incoming-dt@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming-dt@bilbo.ozlabs.org","Authentication-Results":["ozlabs.org;\n\tspf=none (mailfrom) smtp.mailfrom=vger.kernel.org\n\t(client-ip=209.132.180.67; helo=vger.kernel.org;\n\tenvelope-from=devicetree-owner@vger.kernel.org; receiver=)","ozlabs.org;\n\tdkim=fail reason=\"signature verification failed\" (2048-bit key;\n\tunprotected) header.d=googlemail.com header.i=@googlemail.com\n\theader.b=\"CZba0ers\"; dkim-atps=neutral"],"Received":["from vger.kernel.org (vger.kernel.org [209.132.180.67])\n\tby ozlabs.org (Postfix) with ESMTP id 3xlmZf4kwZz9t30\n\tfor ;\n\tMon, 4 Sep 2017 07:39:06 +1000 (AEST)","(majordomo@vger.kernel.org) by vger.kernel.org via listexpand\n\tid S1753005AbdICVi6 (ORCPT\n\t);\n\tSun, 3 Sep 2017 17:38:58 -0400","from mail-wm0-f68.google.com ([74.125.82.68]:36329 \"EHLO\n\tmail-wm0-f68.google.com\" rhost-flags-OK-OK-OK-OK) by vger.kernel.org\n\twith ESMTP id S1752944AbdICVi4 (ORCPT\n\t); Sun, 3 Sep 2017 17:38:56 -0400","by mail-wm0-f68.google.com with SMTP id p17so4856494wmd.3;\n\tSun, 03 Sep 2017 14:38:55 -0700 (PDT)","from blackbox.darklights.net\n\t(p200300DCD3D58204A0117FABC96C39BD.dip0.t-ipconnect.de.\n\t[2003:dc:d3d5:8204:a011:7fab:c96c:39bd])\n\tby smtp.googlemail.com with ESMTPSA id\n\te8sm17786198wmf.37.2017.09.03.14.38.52\n\t(version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);\n\tSun, 03 Sep 2017 14:38:53 -0700 (PDT)"],"DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=googlemail.com; s=20161025;\n\th=from:to:cc:subject:date:message-id:in-reply-to:references;\n\tbh=P3ZlqS5JVBhBs6jJ6moRqY1679lbIZBiIlgHJtDC7xM=;\n\tb=CZba0ershdYpTDycSSr1MwOskPqgteKSMtQ4HPkvSb1oKnP59KwdAJS7ny4UVv8lyh\n\tsJsjspPZ0JYTgFJSYSe4Bdi8UvvX0fTpiHLiOmG11uzawB4o67VoN8LdGvMuUjHKpBvH\n\tjexekm0bOKEH60QkFAh5OiVw2Z+Ia8LW/yezY+bYh3wc0zX6KjsSryIA0FN1/1wGW+l/\n\t7ztA/seXH9t4r+NSi6C6mE5DqYhnM5IACCZlWgVxAZFdTQVvhAmR8NeRnnR5/gFf39Zh\n\tQwGXSwK0GCUQ6UcKcaqOxIb2txWgC1dlbjR80LkP9UzFXGWJjuNS8aqWWb2+4XWRE3og\n\txUhw==","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20161025;\n\th=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to\n\t:references;\n\tbh=P3ZlqS5JVBhBs6jJ6moRqY1679lbIZBiIlgHJtDC7xM=;\n\tb=pUN5d3Yn2ar3h7xgi8ZOVRSPX+uk38TqjYPXJeWY32yJaypHU9rrKll+WUpRxsaEXO\n\tMioWycWv3MSjN6E6sJ4xi9CNxf4vyqyZH59/j4zx3s2ElxYXQLKr3aE9V5DYYhgbmnxB\n\tZ1+01Wv8gV7f/GoD+pNLSdPW5Y8fjNUKbPCDtgV39ykJpDE/SFGsUiSieYLQDSipD00A\n\tkfyXZNXI0RWGy+S2s/4B/NFP0YKMDTEO8bBqYJJCY3o0mwNZmW/+jb48JMmQ+gmGM1x2\n\tBUkl5HtAmyLHykDuM0hTPhNhxuszigwk+dpq25i6H7DpdwKw5WA6PLQZYlW6GuHA4Gtr\n\tDNQw==","X-Gm-Message-State":"AHPjjUjSmwjOUUf3MdFseHpNbfePNjw5yiZT8fT3xhuaQAw0IORwPkqW\n\tPk84NAPHo/sTJA5Yxoc=","X-Google-Smtp-Source":"ADKCNb42RZU0+Qm9xpYa51/CXzEDg72DuYW8GqhC1YzmQPQPMo8ykDncdKO9hd13jKrsewK0D994Cw==","X-Received":"by 10.28.175.76 with SMTP id y73mr3113867wme.33.1504474734487;\n\tSun, 03 Sep 2017 14:38:54 -0700 (PDT)","From":"Martin Blumenstingl ","To":"linux-usb@vger.kernel.org, gregkh@linuxfoundation.org,\n\tfelipe.balbi@linux.intel.com, mathias.nyman@intel.com","Cc":"robh+dt@kernel.org, devicetree@vger.kernel.org,\n\tmark.rutland@arm.com, arnd@arndb.de,\n\tlinux-amlogic@lists.infradead.org, chunfeng.yun@mediatek.com,\n\tMartin Blumenstingl ","Subject":"[PATCH v4 1/3] dt-bindings: usb: add the documentation for USB\n\troot-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"},"content":"A USB root-hub may have several PHYs which need to be configured before\nthe root-hub starts working.\nThis adds the documentation for such a USB root-hub as well as a hint\nregarding the child-nodes on XHCI controllers which can include the\nroothub.\n\nSigned-off-by: Martin Blumenstingl \nAcked-by: Rob Herring \n---\n .../devicetree/bindings/usb/usb-roothub.txt | 46 ++++++++++++++++++++++\n Documentation/devicetree/bindings/usb/usb-xhci.txt | 7 ++++\n 2 files changed, 53 insertions(+)\n create mode 100644 Documentation/devicetree/bindings/usb/usb-roothub.txt","diff":"diff --git a/Documentation/devicetree/bindings/usb/usb-roothub.txt b/Documentation/devicetree/bindings/usb/usb-roothub.txt\nnew file mode 100644\nindex 000000000000..fc0797d7cee9\n--- /dev/null\n+++ b/Documentation/devicetree/bindings/usb/usb-roothub.txt\n@@ -0,0 +1,46 @@\n+Generic USB root-hub Properties\n+\n+similar to the USB device bindings (documented in usb-device.txt from the\n+current directory) this provides support for configuring the root-hub.\n+\n+Required properties:\n+- compatible: should be at least one of \"usb1d6b,3\", \"usb1d6b,2\"\n+- reg: must be 0.\n+- address-cells: must be 1\n+- size-cells: must be 0\n+\n+Required sub-nodes:\n+a sub-node per actual USB port is required. each sub-node supports the\n+following properties:\n+ Required properties:\n+ - reg: the port number on the root-hub (mandatory)\n+ Optional properties:\n+ - phys: optional, from the *Generic PHY* bindings (mandatory needed\n+ when phy-names is given)\n+ - phy-names: optional, from the *Generic PHY* bindings; supported names\n+ are \"usb2-phy\" or \"usb3-phy\"\n+\n+Example:\n+\t&usb1 {\n+\t\t#address-cells = <1>;\n+\t\t#size-cells = <0>;\n+\n+\t\troothub@0 {\n+\t\t\tcompatible = \"usb1d6b,3\", \"usb1d6b,2\";\n+\t\t\t#address-cells = <1>;\n+\t\t\t#size-cells = <0>;\n+\t\t\treg = <0>;\n+\n+\t\t\tport@1 {\n+\t\t\t\treg = <1>;\n+\t\t\t\tphys = <&usb2_phy1>, <&usb3_phy1>;\n+\t\t\t\tphy-names = \"usb2-phy\", \"usb3-phy\";\n+\t\t\t};\n+\n+\t\t\tport@2 {\n+\t\t\t\treg = <2>;\n+\t\t\t\tphys = <&usb2_phy2>, <&usb3_phy2>;\n+\t\t\t\tphy-names = \"usb2-phy\", \"usb3-phy\";\n+\t\t\t};\n+\t\t};\n+\t}\ndiff --git a/Documentation/devicetree/bindings/usb/usb-xhci.txt b/Documentation/devicetree/bindings/usb/usb-xhci.txt\nindex 2d80b60eeabe..31b4f681e9ca 100644\n--- a/Documentation/devicetree/bindings/usb/usb-xhci.txt\n+++ b/Documentation/devicetree/bindings/usb/usb-xhci.txt\n@@ -29,6 +29,13 @@ Optional properties:\n - usb3-lpm-capable: determines if platform is USB3 LPM capable\n - quirk-broken-port-ped: set if the controller has broken port disable mechanism\n \n+sub-nodes:\n+- optionally there can be a node for the root-hub, see usb-roothub.txt in the\n+ current directory\n+- one or more nodes with reg 1-31 for each port to which a device is connected.\n+ See usb-device.txt in the current directory for more information.\n+\n+\n Example:\n \tusb@f0931000 {\n \t\tcompatible = \"generic-xhci\";\n","prefixes":["v4","1/3"]}