From patchwork Thu Apr 21 09:18:39 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Pramod Kumar X-Patchwork-Id: 8897991 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork1.web.kernel.org (Postfix) with ESMTP id BBD6B9F1C1 for ; Thu, 21 Apr 2016 09:20:43 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id E9B63202EC for ; Thu, 21 Apr 2016 09:20:42 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 0775D200DF for ; Thu, 21 Apr 2016 09:20:42 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1atAlR-0001us-PS; Thu, 21 Apr 2016 09:19:09 +0000 Received: from mail-gw1-out.broadcom.com ([216.31.210.62]) by bombadil.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1atAlE-0001mH-TY for linux-arm-kernel@lists.infradead.org; Thu, 21 Apr 2016 09:18:57 +0000 X-IronPort-AV: E=Sophos;i="5.24,512,1455004800"; d="scan'208";a="93484043" Received: from mail-irv-18.broadcom.com ([10.15.198.37]) by mail-gw1-out.broadcom.com with ESMTP; 21 Apr 2016 03:00:39 -0700 Received: from mail-irva-12.broadcom.com (mail-irva-12.broadcom.com [10.11.16.101]) by mail-irv-18.broadcom.com (Postfix) with ESMTP id 4BCC982023; Thu, 21 Apr 2016 02:18:36 -0700 (PDT) Received: from pramodku-OptiPlex-7010.ban.broadcom.com (unknown [10.132.81.79]) by mail-irva-12.broadcom.com (Postfix) with ESMTP id 8456612763C; Thu, 21 Apr 2016 02:18:27 -0700 (PDT) From: Pramod Kumar To: Rob Herring , Catalin Marinas , Will Deacon , Masahiro Yamada , Chen-Yu Tsai Subject: [PATCH 2/6] Documentation: DT binding doc for iProc Shared MDIO Controller. Date: Thu, 21 Apr 2016 14:48:39 +0530 Message-Id: <1461230323-27891-3-git-send-email-pramod.kumar@broadcom.com> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1461230323-27891-1-git-send-email-pramod.kumar@broadcom.com> References: <1461230323-27891-1-git-send-email-pramod.kumar@broadcom.com> X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20160421_021857_011430_DBE9962B X-CRM114-Status: GOOD ( 10.68 ) X-Spam-Score: -5.2 (-----) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Mark Rutland , devicetree@vger.kernel.org, Pawel Moll , Arnd Bergmann , Suzuki K Poulose , netdev@vger.kernel.org, Punit Agrawal , linux-kernel@vger.kernel.org, Pramod Kumar , BCM Kernel Feedback , linux-arm-kernel@lists.infradead.org MIME-Version: 1.0 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Spam-Status: No, score=-5.2 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Add DT binding doc for iProc Shared MDIO Controller which populate all masters to Shared MDIO framework. Signed-off-by: Pramod Kumar Reviewed-by: Ray Jui Reviewed-by: Scott Branden --- .../bindings/bus/brcm,iproc-shared-mdio.txt | 76 ++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 Documentation/devicetree/bindings/bus/brcm,iproc-shared-mdio.txt diff --git a/Documentation/devicetree/bindings/bus/brcm,iproc-shared-mdio.txt b/Documentation/devicetree/bindings/bus/brcm,iproc-shared-mdio.txt new file mode 100644 index 0000000..f455f3d --- /dev/null +++ b/Documentation/devicetree/bindings/bus/brcm,iproc-shared-mdio.txt @@ -0,0 +1,76 @@ +Broadcom iProc Shared MDIO Controller + +Required properties: +- compatible: + "brcm,iproc-shared-mdio" for shared MDIO controller. +- reg: specifies the base physical address and size of the registers +- reg-names: should be "mdio" +- #address-cells: must be 1. +- #size-cells: must be 0. + +optional: +child nodes: Masters are represented as a child node of shared MDIO controller +and all the PHYs handled by this master are represented as its child node. + +Master nodes properties are defined as- + +Required properties: +- compatible: Used to match driver of this PHY. +- reg: MDIO master ID. +- #address-cells: must be 1. +- #size-cells: must be 0. + +optional: +-brcm,phy-internal: if presents, PHYs are internal. Absence shows phy is +external. +-brcm,is-c45: if presents, Controller uses Clause-45 to issue MDIO transaction. +else Controller uses Clause-22 for transactions. + +PHY nodes are represented as the child node of Master. Child nodes properties +are defined as- + +Required properties: +-reg: phy id of attached PHY. + +optional: +There could be additional properties required to configure the specific phy like +phy-mode in case of gpphy node below. These should be defined here and used by +respective drivers. + +Example: +iproc_mdio: iproc_mdio@663f0000 { + compatible = "brcm,iproc-shared-mdio"; + reg = <0x6602023c 0x14>; + reg-names = "mdio"; + #address-cells = <1>; + #size-cells = <0>; + + sata-master@6 { + compatible = "brcm,iproc-ns2-sata-phy"; + reg = <0x6>; + #address-cells = <1>; + #size-cells = <0>; + brcm,phy-internal; + + sata_phy0: sata-phy@1 { + reg = <0x1>; + #phy-cells = <0>; + }; + + sata_phy1: sata-phy@2 { + reg = <0x2>; + #phy-cells = <0>; + }; + }; + + eth-master@0 { + compatible = "brcm,iproc-mdio-master-eth"; + reg = <0x0>; + #address-cells = <1>; + #size-cells = <0>; + gphy0: eth-phy@10 { + reg = <0x10>; + phy-mode = "mii"; + }; + }; +};