[PATCH 02/48] ARM: at91: Document new TCB bindings
From: robh@kernel.org (Rob Herring)
Date: 2016-06-21 20:08:15
Also in:
linux-devicetree, linux-pwm, lkml
On Wed, Jun 15, 2016 at 09:29:55AM +0200, Boris Brezillon wrote:
On Tue, 14 Jun 2016 16:47:37 -0500 Rob Herring [off-list ref] wrote:quoted
On Sat, Jun 11, 2016 at 12:03:05AM +0200, Alexandre Belloni wrote:quoted
The current binding for the TCB is not flexible enough for some use cases and prevents proper utilization of all the channels. Cc: Daniel Lezcano <redacted> Cc: Thierry Reding <redacted> Cc: linux-pwm at vger.kernel.org Cc: Rob Herring <robh+dt@kernel.org> Cc: devicetree at vger.kernel.org Signed-off-by: Alexandre Belloni <redacted> --- .../devicetree/bindings/arm/atmel-at91.txt | 32 ----------- .../devicetree/bindings/mfd/atmel-tcb.txt | 62 ++++++++++++++++++++++ .../devicetree/bindings/pwm/atmel-tcb-pwm.txt | 12 +++-- 3 files changed, 69 insertions(+), 37 deletions(-) create mode 100644 Documentation/devicetree/bindings/mfd/atmel-tcb.txt[...]quoted
diff --git a/Documentation/devicetree/bindings/mfd/atmel-tcb.txt b/Documentation/devicetree/bindings/mfd/atmel-tcb.txt new file mode 100644 index 000000000000..48196752c78f --- /dev/null +++ b/Documentation/devicetree/bindings/mfd/atmel-tcb.txt@@ -0,0 +1,62 @@ +* Device tree bindings for Atmel Timer Counter Blocks +- compatible: Should be "atmel,<chip>-tcb", "simple-mfd", "syscon". + <chip> can be "at91rm9200" or "at91sam9x5" +- reg: Should contain registers location and length +- #address-cells: has to be 1 +- #size-cells: has to be 0 +- interrupts: Should contain all interrupts for the TC block + Note that you can specify several interrupt cells if the TC + block has one interrupt per channel. +- clock-names: tuple listing input clock names. + Required elements: "t0_clk", "slow_clk" + Optional elements: "t1_clk", "t2_clk" +- clocks: phandles to input clocks.What is the order of clocks?quoted
+ +The TCB can expose multiple subdevices: + * a clocksource and clockevent deviceNo. These compatible names are linuxisms. Describe features of the timers to be able to select which timer to use if you need to pick certain timers. For example, interrupt capability could be used to select the clkevt.Would 'atmel,tcb-free-running-timer' (to replace 'atmel,tcb-clksrc') and 'atmel,tcb-programmable-timer' (to replace 'atmel,tcb-clkevt') be acceptable?
If that somehow matches the documentation or accurately describes the h/w capabilities for them, then yes. Rob