Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1758033Ab3J2DtJ (ORCPT ); Mon, 28 Oct 2013 23:49:09 -0400 Received: from va3ehsobe005.messaging.microsoft.com ([216.32.180.31]:48659 "EHLO va3outboundpool.messaging.microsoft.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1756892Ab3J2Ds7 convert rfc822-to-8bit (ORCPT ); Mon, 28 Oct 2013 23:48:59 -0400 X-Forefront-Antispam-Report: CIP:70.37.183.190;KIP:(null);UIP:(null);IPV:NLI;H:mail.freescale.net;RD:none;EFVD:NLI X-SpamScore: -2 X-BigFish: VS-2(zz1432I168aJzz1f42h208ch1ee6h1de0h1fdah2073h1202h1e76h1d1ah1d2ah1fc6hzz1de098h8275bh1de097hz2dh2a8h839h8e2h8e3h944hd25hf0ah1220h1288h12a5h12a9h12bdh137ah13b6h1441h1504h1537h153bh15d0h162dh1631h1758h18e1h1946h19b5h1ad9h1b0ah1b2fh1fb3h1d0ch1d2eh1d3fh1dfeh1dffh1e1dh1fe8h1ff5h21a6h2216hbe9i1155h) From: Xiubo Li-B47053 To: Kumar Gala CC: Guo Shawn-R65073 , "thierry.reding@gmail.com" , "grant.likely@linaro.org" , "ian.campbell@citrix.com" , "mark.rutland@arm.com" , "pawel.moll@arm.com" , "rob.herring@calxeda.com" , "matt.porter@linaro.org" , "s.hauer@pengutronix.de" , "swarren@wwwdotorg.org" , "t.figa@samsung.com" , "linux@arm.linux.org.uk" , "rob@landley.net" , "linux-arm-kernel@lists.infradead.org" , "linux-pwm@vger.kernel.org" , "linux-kernel@vger.kernel.org" , "devicetree@vger.kernel.org" , "linux-doc@vger.kernel.org" Subject: RE: [RFC][PATCHv5 4/4] Documentation: Add device tree bindings for Freescale FTM PWM. Thread-Topic: [RFC][PATCHv5 4/4] Documentation: Add device tree bindings for Freescale FTM PWM. Thread-Index: AQHO08LfYi/1z3wBeU2R0CDTuhA9LZoJ8hSAgAD12nA= Date: Tue, 29 Oct 2013 03:48:47 +0000 Message-ID: <1DD289F6464F0949A2FCA5AA6DC23F8286BD27@039-SN2MPN1-013.039d.mgd.msft.net> References: <1382951151-31517-1-git-send-email-Li.Xiubo@freescale.com> <224C2E26-6C33-4DBB-BC06-A4BA470FDA39@codeaurora.org> In-Reply-To: <224C2E26-6C33-4DBB-BC06-A4BA470FDA39@codeaurora.org> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-originating-ip: [10.192.208.78] Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 8BIT MIME-Version: 1.0 X-OriginatorOrg: freescale.com X-FOPE-CONNECTOR: Id%0$Dn%*$RO%0$TLS%0$FQDN%$TlsDn% Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 3301 Lines: 87 > > This adds the Document for Freescale FTM PWM driver under > > Documentation/devicetree/bindings/pwm/. > > > > Signed-off-by: Xiubo Li > > --- > > .../devicetree/bindings/pwm/pwm-fsl-ftm.txt | 34 > ++++++++++++++++++++++ > > 1 file changed, 34 insertions(+) > > create mode 100644 > > Documentation/devicetree/bindings/pwm/pwm-fsl-ftm.txt > > > > diff --git a/Documentation/devicetree/bindings/pwm/pwm-fsl-ftm.txt > > b/Documentation/devicetree/bindings/pwm/pwm-fsl-ftm.txt > > new file mode 100644 > > index 0000000..175b762 > > --- /dev/null > > +++ b/Documentation/devicetree/bindings/pwm/pwm-fsl-ftm.txt > > @@ -0,0 +1,34 @@ > > +Freescale FTM PWM controller > > What does FTM stand for, and can we spell out PWM at least once early on. > "FTM" is for short of "FlexTimer Module", I'll use the full name then. > > + > > +Required properties: > > +- compatible: Should be "fsl,vf610-ftm-pwm" > > +- reg: Physical base address and length of the controller's registers > > +- #pwm-cells: Should be 3. See pwm.txt in this directory for a > > +description of > > + the cells format. > > +- clock-names : Includes the following module clock source entries: > > + "ftm0" (system clock), > > + "ftm0_fix_sel" (fixed frequency clock), > > + "ftm0_ext_sel" (external clock) > > +- clocks : Must contain a clock specifier for each entry in > > +clock-names, > > + See ../clock/clock-bindings.txt for details of the property values. > > +- fsl,pwm-counter-clk: The FTM PWM counter clock source, should be > > +one of the > > + entries in clock-names. > > Why do we need this, why not just have only the clock-names/clocks > reference the clk that is actually used? > As I have replied before, the FTM has two clock sources: the module clock and the counter clock. The counter clock source is selectable depends on different board and also the hardware design: +++++ * FTM source clock is selectable * Source clock can be the system clock, the fixed frequency clock, or an external clock * Fixed frequency clock is an additional clock input to allow the selection of an on chip clock source other than the system clock * Selecting external clock connects FTM clock to a chip level input pin therefore allowing to synchronize the FTM counter with an off chip clock source ----- >From the above description we can see that the external clock source can allow to synchronize the FTM counter with an off chip clock source. As the chip spec permits the counter clock source be selectable, so the different board maybe has different implementation, if the driver do not support, this will be a bug. > > +- pinctrl-names: must contain a "default" entry. > > +- pinctrl-NNN: One property must exist for each entry in pinctrl-names. > > + See ../pinctrl/pinctrl-bindings.txt for details of the property > values. > > let's drop the .. when making directory references. > Is absolute path " Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt " or just "pinctrl/pinctrl-bindings.txt " ? -- Xiubo -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/