Re: [PATCH 1/2] devicetree: cadence_ttc: Document binding for timer width
On 09/18/2014 08:36 PM, Mark Rutland wrote: > On Thu, Sep 18, 2014 at 06:07:40AM +0100, Michal Simek wrote: >> On 09/17/2014 06:17 PM, Mark Rutland wrote: >>> On Wed, Sep 17, 2014 at 03:30:49PM +0100, Michal Simek wrote: From: Peter Crosthwaite Modern TTC implementations can extend the timer width to 32 bit. This feature is not self identifying so the driver needs to be made aware via device tree. Signed-off-by: Peter Crosthwaite Signed-off-by: Michal Simek --- Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt | 4 1 file changed, 4 insertions(+) diff --git a/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt b/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt index 993695c659e1..5439976eca6b 100644 --- a/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt +++ b/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt @@ -6,6 +6,9 @@ Required properties: - interrupts : A list of 3 interrupts; one per timer channel. - clocks: phandle to the source clock +Optional properties: +- timer-width: Bit width of the timer. Either 16 or 32 (default 16). >>> >>> Are we expecting TTC implementations with widths other than 16 or 32? >> >> IRC if you use 32bit timer and setup for example 24bit width it should work >> too and you are just ignoring that upper bits. > > Sure, but what I'd like to know is whether we expect HW implementations > other than 16 or 32 bit rather than whether or not the driver will work > in that case. I'm not saying no to this patch; I'm just curious. We are trying to find this information. >>> This looks sane to me, but we might be able to just have a 32-bit-timer >>> property if we don't expect arbitrary widths. >> >> Definitely model different timer width is easily possible to do in qemu >> that's why I think having more generic property timer-width is just better >> than >> having property used just for one case. > > Ok, so if you want to support that can we change the documentation > wording to be: > > - timer-width: Bit width of the timer, necessary if not 16. > > That implies support for other bit widths, and when the property needs > to be set (IMO 'default' sounds too much like a driver description than > a contract description). Default one is just option which is used for origin configuration and we should be backward compatible. I am OK with this description. Will send v2. > Does this apply to one timer register, or are multiple registers > affected? It applies for all 3 timers. All of them are 16 or 32. Thanks, Michal signature.asc Description: OpenPGP digital signature
Re: [PATCH 1/2] devicetree: cadence_ttc: Document binding for timer width
On Thu, Sep 18, 2014 at 06:07:40AM +0100, Michal Simek wrote: > On 09/17/2014 06:17 PM, Mark Rutland wrote: > > On Wed, Sep 17, 2014 at 03:30:49PM +0100, Michal Simek wrote: > >> From: Peter Crosthwaite > >> > >> Modern TTC implementations can extend the timer width to 32 bit. This > >> feature is not self identifying so the driver needs to be made aware > >> via device tree. > >> > >> Signed-off-by: Peter Crosthwaite > >> Signed-off-by: Michal Simek > >> --- > >> > >> Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt | 4 > >> 1 file changed, 4 insertions(+) > >> > >> diff --git a/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt > >> b/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt > >> index 993695c659e1..5439976eca6b 100644 > >> --- a/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt > >> +++ b/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt > >> @@ -6,6 +6,9 @@ Required properties: > >> - interrupts : A list of 3 interrupts; one per timer channel. > >> - clocks: phandle to the source clock > >> > >> +Optional properties: > >> +- timer-width: Bit width of the timer. Either 16 or 32 (default 16). > > > > Are we expecting TTC implementations with widths other than 16 or 32? > > IRC if you use 32bit timer and setup for example 24bit width it should work > too and you are just ignoring that upper bits. Sure, but what I'd like to know is whether we expect HW implementations other than 16 or 32 bit rather than whether or not the driver will work in that case. I'm not saying no to this patch; I'm just curious. > > This looks sane to me, but we might be able to just have a 32-bit-timer > > property if we don't expect arbitrary widths. > > Definitely model different timer width is easily possible to do in qemu > that's why I think having more generic property timer-width is just better > than > having property used just for one case. Ok, so if you want to support that can we change the documentation wording to be: - timer-width: Bit width of the timer, necessary if not 16. That implies support for other bit widths, and when the property needs to be set (IMO 'default' sounds too much like a driver description than a contract description). Does this apply to one timer register, or are multiple registers affected? Mark. -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
Re: [PATCH 1/2] devicetree: cadence_ttc: Document binding for timer width
On 09/17/2014 06:17 PM, Mark Rutland wrote: > On Wed, Sep 17, 2014 at 03:30:49PM +0100, Michal Simek wrote: >> From: Peter Crosthwaite >> >> Modern TTC implementations can extend the timer width to 32 bit. This >> feature is not self identifying so the driver needs to be made aware >> via device tree. >> >> Signed-off-by: Peter Crosthwaite >> Signed-off-by: Michal Simek >> --- >> >> Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt | 4 >> 1 file changed, 4 insertions(+) >> >> diff --git a/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt >> b/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt >> index 993695c659e1..5439976eca6b 100644 >> --- a/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt >> +++ b/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt >> @@ -6,6 +6,9 @@ Required properties: >> - interrupts : A list of 3 interrupts; one per timer channel. >> - clocks: phandle to the source clock >> >> +Optional properties: >> +- timer-width: Bit width of the timer. Either 16 or 32 (default 16). > > Are we expecting TTC implementations with widths other than 16 or 32? IRC if you use 32bit timer and setup for example 24bit width it should work too and you are just ignoring that upper bits. > > This looks sane to me, but we might be able to just have a 32-bit-timer > property if we don't expect arbitrary widths. Definitely model different timer width is easily possible to do in qemu that's why I think having more generic property timer-width is just better than having property used just for one case. Thanks, Michal signature.asc Description: OpenPGP digital signature
Re: [PATCH 1/2] devicetree: cadence_ttc: Document binding for timer width
On Wed, Sep 17, 2014 at 03:30:49PM +0100, Michal Simek wrote: > From: Peter Crosthwaite > > Modern TTC implementations can extend the timer width to 32 bit. This > feature is not self identifying so the driver needs to be made aware > via device tree. > > Signed-off-by: Peter Crosthwaite > Signed-off-by: Michal Simek > --- > > Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt | 4 > 1 file changed, 4 insertions(+) > > diff --git a/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt > b/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt > index 993695c659e1..5439976eca6b 100644 > --- a/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt > +++ b/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt > @@ -6,6 +6,9 @@ Required properties: > - interrupts : A list of 3 interrupts; one per timer channel. > - clocks: phandle to the source clock > > +Optional properties: > +- timer-width: Bit width of the timer. Either 16 or 32 (default 16). Are we expecting TTC implementations with widths other than 16 or 32? This looks sane to me, but we might be able to just have a 32-bit-timer property if we don't expect arbitrary widths. Mark. -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
[PATCH 1/2] devicetree: cadence_ttc: Document binding for timer width
From: Peter Crosthwaite
Modern TTC implementations can extend the timer width to 32 bit. This
feature is not self identifying so the driver needs to be made aware
via device tree.
Signed-off-by: Peter Crosthwaite
Signed-off-by: Michal Simek
---
Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt | 4
1 file changed, 4 insertions(+)
diff --git a/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt
b/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt
index 993695c659e1..5439976eca6b 100644
--- a/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt
+++ b/Documentation/devicetree/bindings/timer/cadence,ttc-timer.txt
@@ -6,6 +6,9 @@ Required properties:
- interrupts : A list of 3 interrupts; one per timer channel.
- clocks: phandle to the source clock
+Optional properties:
+- timer-width: Bit width of the timer. Either 16 or 32 (default 16).
+
Example:
ttc0: ttc0@f8001000 {
@@ -14,4 +17,5 @@ ttc0: ttc0@f8001000 {
compatible = "cdns,ttc";
reg = <0xF8001000 0x1000>;
clocks = <&cpu_clk 3>;
+ timer-width = <32>;
};
--
1.8.2.3
pgp0tc0I8rbeU.pgp
Description: PGP signature
