| Message ID | 1384220218-12716-5-git-send-email-Li.Xiubo@freescale.com (mailing list archive) |
|---|---|
| State | New, archived |
| Headers | show |
On Tue, Nov 12, 2013 at 09:36:58AM +0800, Xiubo Li wrote: > This adds the Document for Freescale FTM PWM driver under s/Document/binding documentation/? > Documentation/devicetree/bindings/pwm/. > > Signed-off-by: Xiubo Li <Li.Xiubo@freescale.com> > Reviewed-by: Sascha Hauer <s.hauer@pengutronix.de> > Acked-by: Kumar Gala <galak@codeaurora.org> > --- > .../devicetree/bindings/pwm/pwm-fsl-ftm.txt | 29 ++++++++++++++++++++++ > 1 file changed, 29 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..5c1cd2b > --- /dev/null > +++ b/Documentation/devicetree/bindings/pwm/pwm-fsl-ftm.txt > @@ -0,0 +1,29 @@ > +Freescale FlexTimer Module(FTM) PWM controller I think it's customary to have a space before the opening parenthesis. > +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 : Should includes the following module clock source entries: s/includes/include/ > + "ftm0" (module clock), > + "ftm0_counter" (counter clock), > +- clocks : Must contain a clock specifier for each entry in clock-names, > + See clock/clock-bindings.txt for details of the property values. Note that the order is significant here, at least from the way the driver currently implements this. You can probably make this more generic in the driver by using of_property_match_string() on the clock-names property to find the index of "ftm0_counter" and pass that index to the of_parse_phandle_with_args() function to cope with the situation where the device tree has the clocks in a different order. > +Example: > + > +pwm0: pwm@40038000 { > + compatible = "fsl,vf610-ftm-pwm"; > + reg = <0x40038000 0x1000>; > + #pwm-cells = <3>; > + clock-names = "ftm0", "ftm0_counter; There's a missing " at the end here. Thierry
> > > + "ftm0" (module clock), > > + "ftm0_counter" (counter clock), > > +- clocks : Must contain a clock specifier for each entry in > > +clock-names, > > + See clock/clock-bindings.txt for details of the property values. > > Note that the order is significant here, at least from the way the driver > currently implements this. You can probably make this more generic in the > driver by using of_property_match_string() on the clock-names property to > find the index of "ftm0_counter" and pass that index to the > of_parse_phandle_with_args() function to cope with the situation where the > device tree has the clocks in a different order. > Yes, that's much better.
> > + "ftm0" (module clock), > > + "ftm0_counter" (counter clock), > > +- clocks : Must contain a clock specifier for each entry in > > +clock-names, > > + See clock/clock-bindings.txt for details of the property values. > > Note that the order is significant here, at least from the way the driver > currently implements this. You can probably make this more generic in the > driver by using of_property_match_string() on the clock-names property to > find the index of "ftm0_counter" and pass that index to the > of_parse_phandle_with_args() function to cope with the situation where the > device tree has the clocks in a different order. > Yes, this's much better. As this is still under discussing, I will improve about this after that. And I will also revise other as you have piontet out. -- Best Regards,
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..5c1cd2b --- /dev/null +++ b/Documentation/devicetree/bindings/pwm/pwm-fsl-ftm.txt @@ -0,0 +1,29 @@ +Freescale FlexTimer Module(FTM) PWM controller + +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 : Should includes the following module clock source entries: + "ftm0" (module clock), + "ftm0_counter" (counter clock), +- clocks : Must contain a clock specifier for each entry in clock-names, + See clock/clock-bindings.txt for details of the property values. +- 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. + + +Example: + +pwm0: pwm@40038000 { + compatible = "fsl,vf610-ftm-pwm"; + reg = <0x40038000 0x1000>; + #pwm-cells = <3>; + clock-names = "ftm0", "ftm0_counter; + clocks = <&clks VF610_CLK_FTM0>, + <&clks VF610_CLK_FTM0_FIX_SEL>; + pinctrl-names = "default"; + pinctrl-0 = <&pinctrl_pwm0_1>; +};