From patchwork Tue Mar 25 23:34:42 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: dinguyen@altera.com X-Patchwork-Id: 333756 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 1F94D14008F for ; Wed, 26 Mar 2014 12:10:36 +1100 (EST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754148AbaCZBKe (ORCPT ); Tue, 25 Mar 2014 21:10:34 -0400 Received: from mail-bn1on0117.outbound.protection.outlook.com ([157.56.110.117]:47579 "EHLO na01-bn1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1753357AbaCZBKd (ORCPT ); Tue, 25 Mar 2014 21:10:33 -0400 Received: from BL2FFO11FD046.protection.gbl (10.173.160.33) by BL2FFO11HUB010.protection.gbl (10.173.161.112) with Microsoft SMTP Server (TLS) id 15.0.908.10; Tue, 25 Mar 2014 23:37:00 +0000 Received: from SJ-ITEXEDGE02.altera.priv.altera.com (66.35.236.232) by BL2FFO11FD046.mail.protection.outlook.com (10.173.161.208) with Microsoft SMTP Server (TLS) id 15.0.908.10 via Frontend Transport; Tue, 25 Mar 2014 23:37:00 +0000 Received: from sj-mail01.altera.com (137.57.1.6) by SJ-ITEXEDGE02.altera.priv.altera.com (66.35.236.232) with Microsoft SMTP Server id 8.3.342.0; Tue, 25 Mar 2014 16:23:57 -0700 Received: from linux-builds1.altera.com (linux-builds1.altera.com [137.57.188.114]) by sj-mail01.altera.com (8.13.7+Sun/8.13.7) with ESMTP id s2PNargD018949; Tue, 25 Mar 2014 16:36:57 -0700 (PDT) From: To: , , , CC: , , , , , , , , , , Dinh Nguyen Subject: [PATCH 3/3] dts: documentation: Update documentation for the stmmac ethernet controller Date: Tue, 25 Mar 2014 18:34:42 -0500 Message-ID: <1395790482-3957-4-git-send-email-dinguyen@altera.com> X-Mailer: git-send-email 1.7.9.5 In-Reply-To: <1395790482-3957-1-git-send-email-dinguyen@altera.com> References: <1395790482-3957-1-git-send-email-dinguyen@altera.com> MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-Forefront-Antispam-Report: =?us-ascii?Q?CIP:66.35.236.232; CTRY:US; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(1001?= =?us-ascii?Q?9001)(6009001)(458001)(199002)(189002)(56816005)(63696002)(4?= =?us-ascii?Q?7776003)(90146001)(87936001)(79102001)(20776003)(84676001)(3?= =?us-ascii?Q?6756003)(85306002)(89996001)(31966008)(74502001)(74662001)(4?= =?us-ascii?Q?7446002)(76482001)(87266001)(77156001)(56776001)(54316002)(8?= =?us-ascii?Q?7286001)(77982001)(77096001)(59766001)(53806001)(95416001)(5?= =?us-ascii?Q?0466002)(94946001)(80976001)(46102001)(97736001)(19580395003?= =?us-ascii?Q?)(88136002)(74706001)(76796001)(69226001)(575784001)(5022600?= =?us-ascii?Q?1)(97186001)(6806004)(80022001)(65816001)(62966002)(97336001?= =?us-ascii?Q?)(44976005)(74876001)(95666003)(83322001)(19580405001)(33646?= =?us-ascii?Q?001)(51856001)(93136001)(81816001)(81342001)(83072002)(74366?= =?us-ascii?Q?001)(86362001)(4396001)(93516002)(81686001)(85852003)(767860?= =?us-ascii?Q?01)(86152002)(98676001)(2201001)(92726001)(92566001)(4773600?= =?us-ascii?Q?1)(81542001)(50986001)(49866001)(47976001)(53416003)(4837600?= =?us-ascii?Q?2)(93916002)(94316002); DIR:OUT; SFP:1102; SCL:1; SRVR:BL2FFO11H?= =?us-ascii?Q?UB010; H:SJ-ITEXEDGE02.altera.priv.altera.com; FPR:AC50F66E.B9?= =?us-ascii?Q?2605C9.5FFC9742.CD6F95F.20314; MLV:sfv; PTR:InfoDomainNonexist?= =?us-ascii?Q?ent;A:1;MX:1;LANG:en;?= X-OriginatorOrg: altera.onmicrosoft.com X-Forefront-PRVS: 01613DFDC8 Received-SPF: SoftFail (: domain of transitioning altera.com discourages use of 66.35.236.232 as permitted sender) Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org From: Dinh Nguyen * Add optional clocks and clock-names property into the base stmmac document. * Update socfpga-dwmac.txt with new compatible string and example binding. Signed-off-by: Arnd Bergmann Signed-off-by: Dinh Nguyen --- .../devicetree/bindings/net/socfpga-dwmac.txt | 38 ++++++++------------ Documentation/devicetree/bindings/net/stmmac.txt | 6 ++++ 2 files changed, 21 insertions(+), 23 deletions(-) diff --git a/Documentation/devicetree/bindings/net/socfpga-dwmac.txt b/Documentation/devicetree/bindings/net/socfpga-dwmac.txt index d53d376..1ef6db7 100644 --- a/Documentation/devicetree/bindings/net/socfpga-dwmac.txt +++ b/Documentation/devicetree/bindings/net/socfpga-dwmac.txt @@ -1,35 +1,27 @@ Altera SOCFPGA SoC DWMAC controller -The device node has following properties. +This is a variant of the dwmac/stmmac driver an inherits all descriptions +present in Documentation/devicetree/bindings/net/stmmac.txt. + +The device node has additional properties: Required properties: - - compatible : Should contain "altr,socfpga-stmmac" + - compatible : Should contain "altr,socfpga-stmmac" along with + "snps,dwmac" and any applicable more detailed + designware version numbers documented in stmmac.txt - altr,sysmgr-syscon : Should be the phandle to the system manager node that encompasses the glue register, and the register offset. -Sub-nodes: -The dwmac core should be added as subnode to SOCFPGA dwmac glue. -- dwmac : The binding details of dwmac can be found in - Documentation/devicetree/bindings/net/stmmac.txt - Example: -ethernet0: ethernet0 { - #address-cells = <1>; - #size-cells = <1>; - - compatible = "altr,socfpga-stmmac"; +gmac0: ethernet@ff700000 { + compatible = "altr,socfpga-stmmac", "snps,dwmac-3.70a", "snps,dwmac"; altr,sysmgr-syscon = <&sysmgr 0x60>; status = "disabled"; - ranges; - - gmac0: gmac0@ff700000 { - compatible = "snps,dwmac-3.70a", "snps,dwmac"; - reg = <0xff700000 0x2000>; - interrupts = <0 115 4>; - interrupt-names = "macirq"; - mac-address = [00 00 00 00 00 00];/* Filled in by U-Boot */ - clocks = <&emac0_clk>; - clock-names = "stmmaceth"; - }; + reg = <0xff700000 0x2000>; + interrupts = <0 115 4>; + interrupt-names = "macirq"; + mac-address = [00 00 00 00 00 00];/* Filled in by U-Boot */ + clocks = <&emac0_clk>; + clocks-names = "stmmaceth"; }; diff --git a/Documentation/devicetree/bindings/net/stmmac.txt b/Documentation/devicetree/bindings/net/stmmac.txt index 9d92d42..9a0c1b7 100644 --- a/Documentation/devicetree/bindings/net/stmmac.txt +++ b/Documentation/devicetree/bindings/net/stmmac.txt @@ -34,6 +34,10 @@ Optional properties: reset phandle is given - max-frame-size: Maximum Transfer Unit (IEEE defined MTU), rather than the maximum frame size. +- clocks: If present, the first clock should be the GMAC main clock, + further clocks may be specified in derived bindings. +- clocks-names: One name for each entry in the clocks property, the + first one should be "stmmaceth". Examples: @@ -46,4 +50,6 @@ Examples: mac-address = [000000000000]; /* Filled in by U-Boot */ max-frame-size = <3800>; phy-mode = "gmii"; + clocks = <&clock>; + clock-names = "stmmaceth">; };