Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753511AbcKIJde (ORCPT ); Wed, 9 Nov 2016 04:33:34 -0500 Received: from mail-pf0-f179.google.com ([209.85.192.179]:35191 "EHLO mail-pf0-f179.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753271AbcKIJd3 (ORCPT ); Wed, 9 Nov 2016 04:33:29 -0500 From: Yendapally Reddy Dhananjaya Reddy To: Rob Herring , Mark Rutland , Russell King , Ray Jui , Scott Branden , Jon Mason , Florian Fainelli , Kishon Vijay Abraham I Cc: bcm-kernel-feedback-list@broadcom.com, netdev@vger.kernel.org, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, Yendapally Reddy Dhananjaya Reddy Subject: [PATCH 1/6] dt-bindings: mdio-mux: Add documentation for mdio mux for NSP SoC Date: Wed, 9 Nov 2016 04:33:09 -0500 Message-Id: <1478683994-12008-2-git-send-email-yendapally.reddy@broadcom.com> X-Mailer: git-send-email 2.1.0 In-Reply-To: <1478683994-12008-1-git-send-email-yendapally.reddy@broadcom.com> References: <1478683994-12008-1-git-send-email-yendapally.reddy@broadcom.com> Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 2430 Lines: 73 Add documentation for mdio mux available in Broadcom NSP SoC Signed-off-by: Yendapally Reddy Dhananjaya Reddy --- .../devicetree/bindings/net/brcm,mdio-mux-nsp.txt | 57 ++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 Documentation/devicetree/bindings/net/brcm,mdio-mux-nsp.txt diff --git a/Documentation/devicetree/bindings/net/brcm,mdio-mux-nsp.txt b/Documentation/devicetree/bindings/net/brcm,mdio-mux-nsp.txt new file mode 100644 index 0000000..b749a2b --- /dev/null +++ b/Documentation/devicetree/bindings/net/brcm,mdio-mux-nsp.txt @@ -0,0 +1,57 @@ +Properties for an MDIO bus multiplexer available in Broadcom NSP SoC. + +This MDIO bus multiplexer defines buses that could access the internal +phys as well as external to SoCs. When child bus is selected, one needs +to select the below properties to generate desired MDIO transaction on +appropriate bus. + +Required properties in addition to the generic multiplexer properties: + +MDIO multiplexer node: +- compatible: brcm,mdio-mux-iproc. +- reg: Should contain registers location and length. +- reg-names: Should contain the resource reg names. + - bus-ctrl: mdio bus control register address space required to + select the bus master. This property is not required for SoC's + that doesn't provide master selection. + - mgmt-ctrl: mdio management control register address space + +Sub-nodes: + Each bus master should be represented as a sub-node. + +Sub-nodes required properties: +- reg: Bus master number. Should be 0x10 to access the external mdio devices. +- address-cells: should be 1 +- size-cells: should be 0 + +Every non-ethernet PHY requires a compatible property so that it could be +probed based on this compatible string. + +Additional information regarding generic multiplexer properties can be found +at- Documentation/devicetree/bindings/net/mdio-mux.txt + +example: + + mdio_mux: mdio-mux@3f190 { + compatible = "brcm,mdio-mux-nsp"; + reg = <0x3f190 0x4>, + <0x32000 0x4>; + reg-names = "bus-ctrl", "mgmt-ctrl"; + mdio-parent-bus = <&mdio>; + #address-cells = <1>; + #size-cells = <0>; + + mdio@0 { + reg = <0x0>; + #address-cells = <1>; + #size-cells = <0>; + + usb3_phy: usb3-phy@10 { + compatible = "brcm,nsp-usb3-phy"; + reg = <0x10>; + usb3-ctrl-syscon = <&usb3_ctrl>; + #phy-cells = <0>; + status = "disabled"; + }; + }; + }; -- 2.1.0