diff mbox

[2/4] documentaion: DT: allow a A5 compatible string in global timer

Message ID 1394452294-24552-3-git-send-email-matthew.leach@arm.com (mailing list archive)
State New, archived
Headers show

Commit Message

Matthew Leach March 10, 2014, 11:51 a.m. UTC
The global timer is present on the Cortex A5. Add a compatibility
string to the DT binding to allow a Cortex A5 global timer.

Signed-off-by: Matthew Leach <matthew.leach@arm.com>
---
 Documentation/devicetree/bindings/arm/global_timer.txt | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

Comments

Mark Rutland March 10, 2014, 11:57 a.m. UTC | #1
On Mon, Mar 10, 2014 at 11:51:32AM +0000, Matthew Leach wrote:
> The global timer is present on the Cortex A5. Add a compatibility
> string to the DT binding to allow a Cortex A5 global timer.
> 
> Signed-off-by: Matthew Leach <matthew.leach@arm.com>

Acked-by: Mark Rutland <mark.rutland@arm.com>

Mark.

> ---
>  Documentation/devicetree/bindings/arm/global_timer.txt | 6 ++++--
>  1 file changed, 4 insertions(+), 2 deletions(-)
> 
> diff --git a/Documentation/devicetree/bindings/arm/global_timer.txt b/Documentation/devicetree/bindings/arm/global_timer.txt
> index 1e54898..0932891 100644
> --- a/Documentation/devicetree/bindings/arm/global_timer.txt
> +++ b/Documentation/devicetree/bindings/arm/global_timer.txt
> @@ -4,8 +4,10 @@
>  
>  ** Timer node required properties:
>  
> -- compatible : Should be "arm,cortex-a9-global-timer"
> -		Driver supports versions r2p0 and above.
> +- compatible : should contain
> +	     * "arm,cortex-a5-global-timer" for Cortex-A5 global timers.
> +	     * "arm,cortex-a9-global-timer" for Cortex-A9 global timers
> +	         or any compatible implementation.
>  
>  - interrupts : One interrupt to each core
>  
> -- 
> 1.8.5.3
>
Rob Herring March 10, 2014, 4:27 p.m. UTC | #2
On Mon, Mar 10, 2014 at 6:51 AM, Matthew Leach <matthew.leach@arm.com> wrote:
> The global timer is present on the Cortex A5. Add a compatibility
> string to the DT binding to allow a Cortex A5 global timer.
>
> Signed-off-by: Matthew Leach <matthew.leach@arm.com>
> ---
>  Documentation/devicetree/bindings/arm/global_timer.txt | 6 ++++--
>  1 file changed, 4 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/devicetree/bindings/arm/global_timer.txt b/Documentation/devicetree/bindings/arm/global_timer.txt
> index 1e54898..0932891 100644
> --- a/Documentation/devicetree/bindings/arm/global_timer.txt
> +++ b/Documentation/devicetree/bindings/arm/global_timer.txt
> @@ -4,8 +4,10 @@
>
>  ** Timer node required properties:
>
> -- compatible : Should be "arm,cortex-a9-global-timer"
> -               Driver supports versions r2p0 and above.

Shouldn't you keep this information for the A9?

> +- compatible : should contain
> +            * "arm,cortex-a5-global-timer" for Cortex-A5 global timers.
> +            * "arm,cortex-a9-global-timer" for Cortex-A9 global timers
> +                or any compatible implementation.
>
>  - interrupts : One interrupt to each core
>
> --
> 1.8.5.3
>
>
>
> _______________________________________________
> linux-arm-kernel mailing list
> linux-arm-kernel@lists.infradead.org
> http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
Rob Herring March 10, 2014, 4:28 p.m. UTC | #3
On Mon, Mar 10, 2014 at 6:51 AM, Matthew Leach <matthew.leach@arm.com> wrote:
> The global timer is present on the Cortex A5. Add a compatibility
> string to the DT binding to allow a Cortex A5 global timer.

Also, please use get_maintainers.pl so you copy the right people and list.

Rob

>
> Signed-off-by: Matthew Leach <matthew.leach@arm.com>
> ---
>  Documentation/devicetree/bindings/arm/global_timer.txt | 6 ++++--
>  1 file changed, 4 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/devicetree/bindings/arm/global_timer.txt b/Documentation/devicetree/bindings/arm/global_timer.txt
> index 1e54898..0932891 100644
> --- a/Documentation/devicetree/bindings/arm/global_timer.txt
> +++ b/Documentation/devicetree/bindings/arm/global_timer.txt
> @@ -4,8 +4,10 @@
>
>  ** Timer node required properties:
>
> -- compatible : Should be "arm,cortex-a9-global-timer"
> -               Driver supports versions r2p0 and above.
> +- compatible : should contain
> +            * "arm,cortex-a5-global-timer" for Cortex-A5 global timers.
> +            * "arm,cortex-a9-global-timer" for Cortex-A9 global timers
> +                or any compatible implementation.
>
>  - interrupts : One interrupt to each core
>
> --
> 1.8.5.3
>
>
>
> _______________________________________________
> linux-arm-kernel mailing list
> linux-arm-kernel@lists.infradead.org
> http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
Mark Rutland March 10, 2014, 4:51 p.m. UTC | #4
On Mon, Mar 10, 2014 at 04:27:09PM +0000, Rob Herring wrote:
> On Mon, Mar 10, 2014 at 6:51 AM, Matthew Leach <matthew.leach@arm.com> wrote:
> > The global timer is present on the Cortex A5. Add a compatibility
> > string to the DT binding to allow a Cortex A5 global timer.
> >
> > Signed-off-by: Matthew Leach <matthew.leach@arm.com>
> > ---
> >  Documentation/devicetree/bindings/arm/global_timer.txt | 6 ++++--
> >  1 file changed, 4 insertions(+), 2 deletions(-)
> >
> > diff --git a/Documentation/devicetree/bindings/arm/global_timer.txt b/Documentation/devicetree/bindings/arm/global_timer.txt
> > index 1e54898..0932891 100644
> > --- a/Documentation/devicetree/bindings/arm/global_timer.txt
> > +++ b/Documentation/devicetree/bindings/arm/global_timer.txt
> > @@ -4,8 +4,10 @@
> >
> >  ** Timer node required properties:
> >
> > -- compatible : Should be "arm,cortex-a9-global-timer"
> > -               Driver supports versions r2p0 and above.
> 
> Shouldn't you keep this information for the A9?

To me it feels like documenting the driver rather than the binding for
the hardware.

I'm happy to retain notes about the constraints imposed by Linux
drivers, but I'd prefer if it were the exception rather than the rule.

Mark.

> 
> > +- compatible : should contain
> > +            * "arm,cortex-a5-global-timer" for Cortex-A5 global timers.
> > +            * "arm,cortex-a9-global-timer" for Cortex-A9 global timers
> > +                or any compatible implementation.
> >
> >  - interrupts : One interrupt to each core
> >
> > --
> > 1.8.5.3
> >
> >
> >
> > _______________________________________________
> > linux-arm-kernel mailing list
> > linux-arm-kernel@lists.infradead.org
> > http://lists.infradead.org/mailman/listinfo/linux-arm-kernel
>
Rob Herring March 10, 2014, 5:57 p.m. UTC | #5
On Mon, Mar 10, 2014 at 11:51 AM, Mark Rutland <mark.rutland@arm.com> wrote:
> On Mon, Mar 10, 2014 at 04:27:09PM +0000, Rob Herring wrote:
>> On Mon, Mar 10, 2014 at 6:51 AM, Matthew Leach <matthew.leach@arm.com> wrote:
>> > The global timer is present on the Cortex A5. Add a compatibility
>> > string to the DT binding to allow a Cortex A5 global timer.
>> >
>> > Signed-off-by: Matthew Leach <matthew.leach@arm.com>
>> > ---
>> >  Documentation/devicetree/bindings/arm/global_timer.txt | 6 ++++--
>> >  1 file changed, 4 insertions(+), 2 deletions(-)
>> >
>> > diff --git a/Documentation/devicetree/bindings/arm/global_timer.txt b/Documentation/devicetree/bindings/arm/global_timer.txt
>> > index 1e54898..0932891 100644
>> > --- a/Documentation/devicetree/bindings/arm/global_timer.txt
>> > +++ b/Documentation/devicetree/bindings/arm/global_timer.txt
>> > @@ -4,8 +4,10 @@
>> >
>> >  ** Timer node required properties:
>> >
>> > -- compatible : Should be "arm,cortex-a9-global-timer"
>> > -               Driver supports versions r2p0 and above.
>>
>> Shouldn't you keep this information for the A9?
>
> To me it feels like documenting the driver rather than the binding for
> the hardware.
>
> I'm happy to retain notes about the constraints imposed by Linux
> drivers, but I'd prefer if it were the exception rather than the rule.

Isn't the driver constraint based on the global timer h/w being broken
on pre r2p0? If it is truly a Linux limitation that could be fixed,
then I agree.

Rob
Mark Rutland March 10, 2014, 6:11 p.m. UTC | #6
On Mon, Mar 10, 2014 at 05:57:32PM +0000, Rob Herring wrote:
> On Mon, Mar 10, 2014 at 11:51 AM, Mark Rutland <mark.rutland@arm.com> wrote:
> > On Mon, Mar 10, 2014 at 04:27:09PM +0000, Rob Herring wrote:
> >> On Mon, Mar 10, 2014 at 6:51 AM, Matthew Leach <matthew.leach@arm.com> wrote:
> >> > The global timer is present on the Cortex A5. Add a compatibility
> >> > string to the DT binding to allow a Cortex A5 global timer.
> >> >
> >> > Signed-off-by: Matthew Leach <matthew.leach@arm.com>
> >> > ---
> >> >  Documentation/devicetree/bindings/arm/global_timer.txt | 6 ++++--
> >> >  1 file changed, 4 insertions(+), 2 deletions(-)
> >> >
> >> > diff --git a/Documentation/devicetree/bindings/arm/global_timer.txt b/Documentation/devicetree/bindings/arm/global_timer.txt
> >> > index 1e54898..0932891 100644
> >> > --- a/Documentation/devicetree/bindings/arm/global_timer.txt
> >> > +++ b/Documentation/devicetree/bindings/arm/global_timer.txt
> >> > @@ -4,8 +4,10 @@
> >> >
> >> >  ** Timer node required properties:
> >> >
> >> > -- compatible : Should be "arm,cortex-a9-global-timer"
> >> > -               Driver supports versions r2p0 and above.
> >>
> >> Shouldn't you keep this information for the A9?
> >
> > To me it feels like documenting the driver rather than the binding for
> > the hardware.
> >
> > I'm happy to retain notes about the constraints imposed by Linux
> > drivers, but I'd prefer if it were the exception rather than the rule.
> 
> Isn't the driver constraint based on the global timer h/w being broken
> on pre r2p0? If it is truly a Linux limitation that could be fixed,
> then I agree.

Unfortunately, I must admit ignorance on this matter.

From a quick look, the comparator behaviour on Cortex-A9 cores prior to
r2p0 seems to make it unusable in practice (though I'm not aware of the
precise behaviour, perhaps there is some possible workaround).

We can note the problem in the binding document, but we don't need to
refer to any particular driver. :)

Cheers,
Mark.
diff mbox

Patch

diff --git a/Documentation/devicetree/bindings/arm/global_timer.txt b/Documentation/devicetree/bindings/arm/global_timer.txt
index 1e54898..0932891 100644
--- a/Documentation/devicetree/bindings/arm/global_timer.txt
+++ b/Documentation/devicetree/bindings/arm/global_timer.txt
@@ -4,8 +4,10 @@ 
 
 ** Timer node required properties:
 
-- compatible : Should be "arm,cortex-a9-global-timer"
-		Driver supports versions r2p0 and above.
+- compatible : should contain
+	     * "arm,cortex-a5-global-timer" for Cortex-A5 global timers.
+	     * "arm,cortex-a9-global-timer" for Cortex-A9 global timers
+	         or any compatible implementation.
 
 - interrupts : One interrupt to each core