From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from m12-16.163.com ([220.181.12.16]:59095 "EHLO m12-16.163.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750971AbeEEKLG (ORCPT ); Sat, 5 May 2018 06:11:06 -0400 From: sunjg79@163.com Subject: [PATCH v2 1/2] dt-bindings: usb: add bindings doc for HiSilicon STB xHCI host controller Date: Sat, 5 May 2018 18:09:49 +0800 Message-Id: <1525514990-18207-2-git-send-email-sunjg79@163.com> In-Reply-To: <1525514990-18207-1-git-send-email-sunjg79@163.com> References: <1525514990-18207-1-git-send-email-sunjg79@163.com> Sender: devicetree-owner@vger.kernel.org To: mathias.nyman@intel.com, gregkh@linuxfoundation.org, robh+dt@kernel.org Cc: shawn.guo@linaro.org, xuejiancheng@hisilicon.com, chunfeng.yun@mediatek.com, linux-usb@vger.kernel.org, devicetree@vger.kernel.org, Jianguo Sun List-ID: From: Jianguo Sun This commit adds bindings doc for HiSilicon STB xHCI host controller. Signed-off-by: Jianguo Sun --- .../bindings/usb/hisilicon,histb-xhci.txt | 46 ++++++++++++++++++++++ 1 file changed, 46 insertions(+) create mode 100644 Documentation/devicetree/bindings/usb/hisilicon,histb-xhci.txt diff --git a/Documentation/devicetree/bindings/usb/hisilicon,histb-xhci.txt b/Documentation/devicetree/bindings/usb/hisilicon,histb-xhci.txt new file mode 100644 index 0000000..b1a06f1 --- /dev/null +++ b/Documentation/devicetree/bindings/usb/hisilicon,histb-xhci.txt @@ -0,0 +1,46 @@ +HiSilicon STB xHCI + +The device node for HiSilicon STB xHCI host controller + +Required properties: + - compatible: should be "hisilicon,hi3798cv200-xhci" + - reg: specifies physical base address and size of the registers + - interrupts : interrupt used by the controller + - clocks: a list of phandle + clock-specifier pairs, one for each + entry in clock-names + - clock-names: must contain + "bus": for bus clock + "utmi": for utmi clock + "pipe": for pipeE clock + "suspend": for suspend clock + - resets: a list of phandle and reset specifier pairs as listed in + reset-names property. + - reset-names: must contain + "soft": for soft reset + - phys: a list of phandle + phy specifier pairs + - phy-names: must contain at least one of following: + "inno": for inno phy + "combo": for combo phy + +Optional properties: + - usb2-lpm-disable: indicate if we don't want to enable USB2 HW LPM + - usb3-lpm-capable: determines if platform is USB3 LPM capable + - quirk-broken-port-ped: set if the controller has broken port disable mechanism + - imod-interval-ns: default interrupt moderation interval is 40000ns + +Example: + +xhci0: xchi@f98a0000 { + compatible = "hisilicon,hi3798cv200-xhci"; + reg = <0xf98a0000 0x10000>; + interrupts = ; + clocks = <&crg HISTB_USB3_BUS_CLK>, + <&crg HISTB_USB3_UTMI_CLK>, + <&crg HISTB_USB3_PIPE_CLK>, + <&crg HISTB_USB3_SUSPEND_CLK>; + clock-names = "bus", "utmi", "pipe", "suspend"; + resets = <&crg 0xb0 12>; + reset-names = "soft"; + phys = <&usb2_phy1_port1 0>, <&combphy0 PHY_TYPE_USB3>; + phy-names = "inno", "combo"; +}; -- 2.7.4 From mboxrd@z Thu Jan 1 00:00:00 1970 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: base64 Subject: [v2,1/2] dt-bindings: usb: add bindings doc for HiSilicon STB xHCI host controller From: sunjg79@163.com Message-Id: <1525514990-18207-2-git-send-email-sunjg79@163.com> Date: Sat, 5 May 2018 18:09:49 +0800 To: mathias.nyman@intel.com, gregkh@linuxfoundation.org, robh+dt@kernel.org Cc: shawn.guo@linaro.org, xuejiancheng@hisilicon.com, chunfeng.yun@mediatek.com, linux-usb@vger.kernel.org, devicetree@vger.kernel.org, Jianguo Sun List-ID: RnJvbTogSmlhbmd1byBTdW4gPHN1bmppYW5ndW8xQGh1YXdlaS5jb20+CgpUaGlzIGNvbW1pdCBh ZGRzIGJpbmRpbmdzIGRvYyBmb3IgSGlTaWxpY29uIFNUQiB4SENJIGhvc3QgY29udHJvbGxlci4K ClNpZ25lZC1vZmYtYnk6IEppYW5ndW8gU3VuIDxzdW5qaWFuZ3VvMUBodWF3ZWkuY29tPgotLS0K IC4uLi9iaW5kaW5ncy91c2IvaGlzaWxpY29uLGhpc3RiLXhoY2kudHh0ICAgICAgICAgIHwgNDYg KysrKysrKysrKysrKysrKysrKysrKwogMSBmaWxlIGNoYW5nZWQsIDQ2IGluc2VydGlvbnMoKykK IGNyZWF0ZSBtb2RlIDEwMDY0NCBEb2N1bWVudGF0aW9uL2RldmljZXRyZWUvYmluZGluZ3MvdXNi L2hpc2lsaWNvbixoaXN0Yi14aGNpLnR4dAoKZGlmZiAtLWdpdCBhL0RvY3VtZW50YXRpb24vZGV2 aWNldHJlZS9iaW5kaW5ncy91c2IvaGlzaWxpY29uLGhpc3RiLXhoY2kudHh0IGIvRG9jdW1lbnRh dGlvbi9kZXZpY2V0cmVlL2JpbmRpbmdzL3VzYi9oaXNpbGljb24saGlzdGIteGhjaS50eHQKbmV3 IGZpbGUgbW9kZSAxMDA2NDQKaW5kZXggMDAwMDAwMC4uYjFhMDZmMQotLS0gL2Rldi9udWxsCisr KyBiL0RvY3VtZW50YXRpb24vZGV2aWNldHJlZS9iaW5kaW5ncy91c2IvaGlzaWxpY29uLGhpc3Ri LXhoY2kudHh0CkBAIC0wLDAgKzEsNDYgQEAKK0hpU2lsaWNvbiBTVEIgeEhDSQorCitUaGUgZGV2 aWNlIG5vZGUgZm9yIEhpU2lsaWNvbiBTVEIgeEhDSSBob3N0IGNvbnRyb2xsZXIKKworUmVxdWly ZWQgcHJvcGVydGllczoKKyAtIGNvbXBhdGlibGU6IHNob3VsZCBiZSAiaGlzaWxpY29uLGhpMzc5 OGN2MjAwLXhoY2kiCisgLSByZWc6IHNwZWNpZmllcyBwaHlzaWNhbCBiYXNlIGFkZHJlc3MgYW5k IHNpemUgb2YgdGhlIHJlZ2lzdGVycworIC0gaW50ZXJydXB0cyA6IGludGVycnVwdCB1c2VkIGJ5 IHRoZSBjb250cm9sbGVyCisgLSBjbG9ja3M6IGEgbGlzdCBvZiBwaGFuZGxlICsgY2xvY2stc3Bl Y2lmaWVyIHBhaXJzLCBvbmUgZm9yIGVhY2gKKwllbnRyeSBpbiBjbG9jay1uYW1lcworIC0gY2xv Y2stbmFtZXM6IG11c3QgY29udGFpbgorCSJidXMiOiBmb3IgYnVzIGNsb2NrCisJInV0bWkiOiBm b3IgdXRtaSBjbG9jaworCSJwaXBlIjogZm9yIHBpcGVFIGNsb2NrCisJInN1c3BlbmQiOiBmb3Ig c3VzcGVuZCBjbG9jaworIC0gcmVzZXRzOiBhIGxpc3Qgb2YgcGhhbmRsZSBhbmQgcmVzZXQgc3Bl Y2lmaWVyIHBhaXJzIGFzIGxpc3RlZCBpbgorCXJlc2V0LW5hbWVzIHByb3BlcnR5LgorIC0gcmVz ZXQtbmFtZXM6IG11c3QgY29udGFpbgorCSJzb2Z0IjogZm9yIHNvZnQgcmVzZXQKKyAtIHBoeXM6 IGEgbGlzdCBvZiBwaGFuZGxlICsgcGh5IHNwZWNpZmllciBwYWlycworIC0gcGh5LW5hbWVzOiBt dXN0IGNvbnRhaW4gYXQgbGVhc3Qgb25lIG9mIGZvbGxvd2luZzoKKwkiaW5ubyI6IGZvciBpbm5v IHBoeQorCSJjb21ibyI6IGZvciBjb21ibyBwaHkKKworT3B0aW9uYWwgcHJvcGVydGllczoKKyAg LSB1c2IyLWxwbS1kaXNhYmxlOiBpbmRpY2F0ZSBpZiB3ZSBkb24ndCB3YW50IHRvIGVuYWJsZSBV U0IyIEhXIExQTQorICAtIHVzYjMtbHBtLWNhcGFibGU6IGRldGVybWluZXMgaWYgcGxhdGZvcm0g aXMgVVNCMyBMUE0gY2FwYWJsZQorICAtIHF1aXJrLWJyb2tlbi1wb3J0LXBlZDogc2V0IGlmIHRo ZSBjb250cm9sbGVyIGhhcyBicm9rZW4gcG9ydCBkaXNhYmxlIG1lY2hhbmlzbQorICAtIGltb2Qt aW50ZXJ2YWwtbnM6IGRlZmF1bHQgaW50ZXJydXB0IG1vZGVyYXRpb24gaW50ZXJ2YWwgaXMgNDAw MDBucworCitFeGFtcGxlOgorCit4aGNpMDogeGNoaUBmOThhMDAwMCB7CisJY29tcGF0aWJsZSA9 ICJoaXNpbGljb24saGkzNzk4Y3YyMDAteGhjaSI7CisJcmVnID0gPDB4Zjk4YTAwMDAgMHgxMDAw MD47CisJaW50ZXJydXB0cyA9IDxHSUNfU1BJIDY5IElSUV9UWVBFX0xFVkVMX0hJR0g+OworCWNs b2NrcyA9IDwmY3JnIEhJU1RCX1VTQjNfQlVTX0NMSz4sCisJCSA8JmNyZyBISVNUQl9VU0IzX1VU TUlfQ0xLPiwKKwkJIDwmY3JnIEhJU1RCX1VTQjNfUElQRV9DTEs+LAorCQkgPCZjcmcgSElTVEJf VVNCM19TVVNQRU5EX0NMSz47CisJY2xvY2stbmFtZXMgPSAiYnVzIiwgInV0bWkiLCAicGlwZSIs ICJzdXNwZW5kIjsKKwlyZXNldHMgPSA8JmNyZyAweGIwIDEyPjsKKwlyZXNldC1uYW1lcyA9ICJz b2Z0IjsKKwlwaHlzID0gPCZ1c2IyX3BoeTFfcG9ydDEgMD4sIDwmY29tYnBoeTAgUEhZX1RZUEVf VVNCMz47CisJcGh5LW5hbWVzID0gImlubm8iLCAiY29tYm8iOworfTsK