From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1759213AbcCDJET (ORCPT ); Fri, 4 Mar 2016 04:04:19 -0500 Received: from mail-qk0-f196.google.com ([209.85.220.196]:33828 "EHLO mail-qk0-f196.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1759192AbcCDJEJ (ORCPT ); Fri, 4 Mar 2016 04:04:09 -0500 MIME-Version: 1.0 In-Reply-To: <20160302183309.GA2449@rob-hp-laptop> References: <1456483912-32090-1-git-send-email-alexandre.torgue@gmail.com> <1456483912-32090-3-git-send-email-alexandre.torgue@gmail.com> <20160302183309.GA2449@rob-hp-laptop> Date: Fri, 4 Mar 2016 10:04:07 +0100 Message-ID: Subject: Re: [PATCH v3 2/4] Documentation: Bindings: Add STM32 DWMAC glue From: Alexandre Torgue To: Rob Herring Cc: Maxime Coquelin , Giuseppe Cavallaro , netdev , linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org, devicetree@vger.kernel.org Content-Type: text/plain; charset=UTF-8 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hi Rob, 2016-03-02 19:33 GMT+01:00 Rob Herring : > On Fri, Feb 26, 2016 at 11:51:50AM +0100, Alexandre TORGUE wrote: >> Signed-off-by: Alexandre TORGUE >> >> diff --git a/Documentation/devicetree/bindings/net/stm32-dwmac.txt b/Documentation/devicetree/bindings/net/stm32-dwmac.txt >> new file mode 100644 >> index 0000000..67fceda >> --- /dev/null >> +++ b/Documentation/devicetree/bindings/net/stm32-dwmac.txt >> @@ -0,0 +1,40 @@ >> +STMicroelectronics STM32 / MCU DWMAC glue layer controller >> + >> +This file documents platform glue layer for stmmac. >> +Please see stmmac.txt for the other unchanged properties. >> + >> +The device node has following properties. >> + >> +Required properties: >> +- compatible: Should be "st,stm32-dwmac" to select glue, and >> + "snps,dwmac-3.50a" to select IP vesrion. >> +- clocks: Should contain the GMAC main clock, and tx clock >> +- compatible: Should be "st,stm32-dwmac" to select glue and >> + "snps,dwmac-3.50a" to select IP version. >> +- clocks: Should contain the MAC main clock >> +- clock-names: Should contain the clock names "stmmaceth". >> +- st,syscon : Should be phandle/offset pair. The phandle to the syscon node which >> + encompases the glue register, and the offset of the control register. >> + >> +Optional properties: >> +- clocks: Could contain: >> + - the tx clock, >> + - the rx clock >> +- clock-names: Could contain the clock names "tx-clk", "rx-clk" > > Either the IP block has 3 clocks or it has 1. If you have a case where 1 > clock feeds all 3 inputs, then list the clock 3 times. I agree. I will move rx/tx clock to required properties and then send a v4. Regards. Alexandre > > Rob From mboxrd@z Thu Jan 1 00:00:00 1970 From: alexandre.torgue@gmail.com (Alexandre Torgue) Date: Fri, 4 Mar 2016 10:04:07 +0100 Subject: [PATCH v3 2/4] Documentation: Bindings: Add STM32 DWMAC glue In-Reply-To: <20160302183309.GA2449@rob-hp-laptop> References: <1456483912-32090-1-git-send-email-alexandre.torgue@gmail.com> <1456483912-32090-3-git-send-email-alexandre.torgue@gmail.com> <20160302183309.GA2449@rob-hp-laptop> Message-ID: To: linux-arm-kernel@lists.infradead.org List-Id: linux-arm-kernel.lists.infradead.org Hi Rob, 2016-03-02 19:33 GMT+01:00 Rob Herring : > On Fri, Feb 26, 2016 at 11:51:50AM +0100, Alexandre TORGUE wrote: >> Signed-off-by: Alexandre TORGUE >> >> diff --git a/Documentation/devicetree/bindings/net/stm32-dwmac.txt b/Documentation/devicetree/bindings/net/stm32-dwmac.txt >> new file mode 100644 >> index 0000000..67fceda >> --- /dev/null >> +++ b/Documentation/devicetree/bindings/net/stm32-dwmac.txt >> @@ -0,0 +1,40 @@ >> +STMicroelectronics STM32 / MCU DWMAC glue layer controller >> + >> +This file documents platform glue layer for stmmac. >> +Please see stmmac.txt for the other unchanged properties. >> + >> +The device node has following properties. >> + >> +Required properties: >> +- compatible: Should be "st,stm32-dwmac" to select glue, and >> + "snps,dwmac-3.50a" to select IP vesrion. >> +- clocks: Should contain the GMAC main clock, and tx clock >> +- compatible: Should be "st,stm32-dwmac" to select glue and >> + "snps,dwmac-3.50a" to select IP version. >> +- clocks: Should contain the MAC main clock >> +- clock-names: Should contain the clock names "stmmaceth". >> +- st,syscon : Should be phandle/offset pair. The phandle to the syscon node which >> + encompases the glue register, and the offset of the control register. >> + >> +Optional properties: >> +- clocks: Could contain: >> + - the tx clock, >> + - the rx clock >> +- clock-names: Could contain the clock names "tx-clk", "rx-clk" > > Either the IP block has 3 clocks or it has 1. If you have a case where 1 > clock feeds all 3 inputs, then list the clock 3 times. I agree. I will move rx/tx clock to required properties and then send a v4. Regards. Alexandre > > Rob