| Message ID | 1384800901-21711-2-git-send-email-tim.kryger@linaro.org |
|---|---|
| State | New |
| Headers | show |
On Mon, Nov 18, 2013 at 06:54:57PM +0000, Tim Kryger wrote: > Add the binding description for the kona-pwm block found on Broadcom's > mobile SoCs. > > Signed-off-by: Tim Kryger <tim.kryger@linaro.org> > Reviewed-by: Alex Elder <elder@linaro.org> > Reviewed-by: Markus Mayer <markus.mayer@linaro.org> > --- > .../devicetree/bindings/pwm/bcm-kona-pwm.txt | 24 ++++++++++++++++++++++ > 1 file changed, 24 insertions(+) > create mode 100644 Documentation/devicetree/bindings/pwm/bcm-kona-pwm.txt > > diff --git a/Documentation/devicetree/bindings/pwm/bcm-kona-pwm.txt b/Documentation/devicetree/bindings/pwm/bcm-kona-pwm.txt > new file mode 100644 > index 0000000..5c3ea1b > --- /dev/null > +++ b/Documentation/devicetree/bindings/pwm/bcm-kona-pwm.txt > @@ -0,0 +1,24 @@ > +Broadcom's PWM Controller Device Tree bindings > + > +Broadcom's Kona PWM Controller has 6 channels > + > +Required Properties : > +- compatible: should be "brcm,kona-pwm" > +- reg: physical base address and length of the controller's registers > +- clocks: clock specifier for the kona pwm external clock Minor nit: phandle + clock-specifier pair > +- #pwm-cells: should be 2. The first cell specifies the per-chip index > + of the PWM to use and the second cell is the period in nanoseconds. > + > +Refer to pwm/pwm.txt for generic pwm controller node properties. > + > +Refer to clocks/clock-bindings.txt for generic clock consumer > +properties > + > +Example: > + > +pwm: pwm@3e01a000 { > + compatible = "brcm,bcm11351-pwm", "brcm,kona-pwm"; > + reg = <0x3e01a000 0xc4>; > + clocks = <&pwm_clk>; > + #pwm-cells = <2>; > +}; Otherwise this looks fine. Mark.
On Mon, Nov 18, 2013 at 10:54:57AM -0800, Tim Kryger wrote: > Add the binding description for the kona-pwm block found on Broadcom's > mobile SoCs. > > Signed-off-by: Tim Kryger <tim.kryger@linaro.org> > Reviewed-by: Alex Elder <elder@linaro.org> > Reviewed-by: Markus Mayer <markus.mayer@linaro.org> > --- > .../devicetree/bindings/pwm/bcm-kona-pwm.txt | 24 ++++++++++++++++++++++ > 1 file changed, 24 insertions(+) > create mode 100644 Documentation/devicetree/bindings/pwm/bcm-kona-pwm.txt > > diff --git a/Documentation/devicetree/bindings/pwm/bcm-kona-pwm.txt b/Documentation/devicetree/bindings/pwm/bcm-kona-pwm.txt > new file mode 100644 > index 0000000..5c3ea1b > --- /dev/null > +++ b/Documentation/devicetree/bindings/pwm/bcm-kona-pwm.txt > @@ -0,0 +1,24 @@ > +Broadcom's PWM Controller Device Tree bindings This sounds somewhat strange, like Broadcom owns the bindings... perhaps just: Broadcom PWM controller device tree bindings Or for consistency: Broadcom Kona PWM controller device tree bindings since apparently there exist other Broadcom PWM controllers. > +Broadcom's Kona PWM Controller has 6 channels "controller" and end the sentence with a full stop. > + > +Required Properties : > +- compatible: should be "brcm,kona-pwm" > +- reg: physical base address and length of the controller's registers > +- clocks: clock specifier for the kona pwm external clock Please use the correct spelling "PWM" in prose here and elsewhere. Also you should pick one of "kona", "Kona" or "KONA" and stick with it consistently. Might also be useful to mention what Kona is. Doesn't necessarily have to be in the document, but if for nothing else, then just for my curiosity. > +- #pwm-cells: should be 2. The first cell specifies the per-chip index > + of the PWM to use and the second cell is the period in nanoseconds. > + > +Refer to pwm/pwm.txt for generic pwm controller node properties. > + > +Refer to clocks/clock-bindings.txt for generic clock consumer > +properties This sentence should also end with a full stop. Thierry
On Tue, Nov 19, 2013 at 5:56 AM, Mark Rutland <mark.rutland@arm.com> wrote: > On Mon, Nov 18, 2013 at 06:54:57PM +0000, Tim Kryger wrote: >> +Required Properties : >> +- compatible: should be "brcm,kona-pwm" >> +- reg: physical base address and length of the controller's registers >> +- clocks: clock specifier for the kona pwm external clock > > Minor nit: phandle + clock-specifier pair I will incorporate this change into my next version. Thanks. -Tim
On Mon, Nov 25, 2013 at 3:17 AM, Thierry Reding <thierry.reding@gmail.com> wrote: > On Mon, Nov 18, 2013 at 10:54:57AM -0800, Tim Kryger wrote: >> +++ b/Documentation/devicetree/bindings/pwm/bcm-kona-pwm.txt >> @@ -0,0 +1,24 @@ >> +Broadcom's PWM Controller Device Tree bindings > > This sounds somewhat strange, like Broadcom owns the bindings... perhaps > just: > > Broadcom PWM controller device tree bindings > > Or for consistency: > > Broadcom Kona PWM controller device tree bindings Yes that sounds better. >> +Broadcom's Kona PWM Controller has 6 channels > > "controller" and end the sentence with a full stop. Sure. >> +- clocks: clock specifier for the kona pwm external clock > > Please use the correct spelling "PWM" in prose here and elsewhere. Also > you should pick one of "kona", "Kona" or "KONA" and stick with it > consistently. Might also be useful to mention what Kona is. Doesn't > necessarily have to be in the document, but if for nothing else, then > just for my curiosity. Agreed. It should be "Kona" here. Kona roughly defines the set of common IP used on multiple mobile SoCs. >> +- #pwm-cells: should be 2. The first cell specifies the per-chip index >> + of the PWM to use and the second cell is the period in nanoseconds. >> + >> +Refer to pwm/pwm.txt for generic pwm controller node properties. >> + >> +Refer to clocks/clock-bindings.txt for generic clock consumer >> +properties > > This sentence should also end with a full stop. Sure thing. Thanks again. -Tim
diff --git a/Documentation/devicetree/bindings/pwm/bcm-kona-pwm.txt b/Documentation/devicetree/bindings/pwm/bcm-kona-pwm.txt new file mode 100644 index 0000000..5c3ea1b --- /dev/null +++ b/Documentation/devicetree/bindings/pwm/bcm-kona-pwm.txt @@ -0,0 +1,24 @@ +Broadcom's PWM Controller Device Tree bindings + +Broadcom's Kona PWM Controller has 6 channels + +Required Properties : +- compatible: should be "brcm,kona-pwm" +- reg: physical base address and length of the controller's registers +- clocks: clock specifier for the kona pwm external clock +- #pwm-cells: should be 2. The first cell specifies the per-chip index + of the PWM to use and the second cell is the period in nanoseconds. + +Refer to pwm/pwm.txt for generic pwm controller node properties. + +Refer to clocks/clock-bindings.txt for generic clock consumer +properties + +Example: + +pwm: pwm@3e01a000 { + compatible = "brcm,bcm11351-pwm", "brcm,kona-pwm"; + reg = <0x3e01a000 0xc4>; + clocks = <&pwm_clk>; + #pwm-cells = <2>; +};