Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1425476AbdD1UaR (ORCPT ); Fri, 28 Apr 2017 16:30:17 -0400 Received: from mail-qt0-f175.google.com ([209.85.216.175]:33020 "EHLO mail-qt0-f175.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1424672AbdD1U36 (ORCPT ); Fri, 28 Apr 2017 16:29:58 -0400 From: Jon Mason To: Florian Fainelli , Kishon Vijay Abraham I , Rob Herring , Mark Rutland Cc: bcm-kernel-feedback-list@broadcom.com, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org Subject: [PATCH 1/3] dt-bindings: phy: Add documentation for NS2 USB3 PHY Date: Fri, 28 Apr 2017 16:29:39 -0400 Message-Id: <1493411381-16833-2-git-send-email-jon.mason@broadcom.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1493411381-16833-1-git-send-email-jon.mason@broadcom.com> References: <1493411381-16833-1-git-send-email-jon.mason@broadcom.com> Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 2957 Lines: 101 From: Yendapally Reddy Dhananjaya Reddy Add documentation for USB3 PHY available in NS2 SoC Signed-off-by: Yendapally Reddy Dhananjaya Reddy Signed-off-by: Jon Mason --- .../devicetree/bindings/phy/brcm,ns2-usb3-phy.txt | 82 ++++++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 Documentation/devicetree/bindings/phy/brcm,ns2-usb3-phy.txt diff --git a/Documentation/devicetree/bindings/phy/brcm,ns2-usb3-phy.txt b/Documentation/devicetree/bindings/phy/brcm,ns2-usb3-phy.txt new file mode 100644 index 0000000..5bb8d53 --- /dev/null +++ b/Documentation/devicetree/bindings/phy/brcm,ns2-usb3-phy.txt @@ -0,0 +1,82 @@ +Broadcom USB3 dual port phy for Northstar2 SoC +This is a child bus node of "brcm,mdio-mux-iproc" node. + +Required mdio bus properties: +- reg: MDIO Bus number for the MDIO interface +- #address-cells: must be 1 +- #size-cells: must be 0 + +Required PHY properties: +- compatible: should be "brcm,ns2-usb3-phy" +- reg: Phy address in the MDIO interface +- usb3-ctrl-syscon: handler of syscon node defining physical address + of usb3 control register. +- usb3-phy-cfg-syscon: handler of syscon node defining physical base + address and length of usb3 phy config region. +- usb3-rst-ctrl-syscon: handler of syscon node defining physical base + address and length of idm reset control of two ports. +- #phy-cells: must be 0 +- #address-cells: must be 1 +- #size-cells: must be 0 + +Sub-nodes: + Each port's PHY should be represented as a sub-node. + +Sub-nodes required properties: + - reg: the PHY number + - phy-cells: from the generic PHY bindings, must be 0 + +Required usb3 control properties: +- compatible: should be "brcm,ns2-usb3-ctrl" +- reg: offset and length of the control registers + +Required usb3 phy config properties: +- compatible: should be "brcm,ns2-usb3-phy-cfg" +- reg: offset and length of the phy config registers + +Required usb3 reset control properties: +- compatible: should be "brcm,ns2-usb3-rst-ctrl" +- reg: offset and length of the reset control registers + +Example: + +mdio@1 { + reg = <0x1>; + #address-cells = <1>; + #size-cells = <0>; + + usb3phy: usb3phy@0 { + compatible = "brcm,ns2-usb3-phy"; + reg = <0x0>; + #address-cells = <1>; + #size-cells = <0>; + usb3-ctrl-syscon = <&usb3_ctrl>; + usb3-phy-cfg-syscon = <&usb3_phy_cfg>; + usb3-rst-ctrl-syscon = <&usb3_rst_ctrl>; + + usb3phy0: usbphy@0 { + reg = <0>; + #phy-cells = <0>; + }; + + usb3phy1: usbphy@1 { + reg = <1>; + #phy-cells = <0>; + }; + }; +}; + +usb3_ctrl: syscon@6501d144 { + compatible = "brcm,ns2-usb3-ctrl", "syscon"; + reg = <0x6501d144 0x4>; +}; + +usb3_phy_cfg: syscon@66000910 { + compatible = "brcm,ns2-usb3-phy-cfg", "syscon"; + reg = <0x66000910 0x14>; +}; + +usb3_rst_ctrl: syscon@67000800 { + compatible = "brcm,ns2-usb3-rst-ctrl", "syscon"; + reg = <0x67000800 0x1808>; +}; -- 2.7.4