From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751447AbaIJMQZ (ORCPT ); Wed, 10 Sep 2014 08:16:25 -0400 Received: from mail-la0-f43.google.com ([209.85.215.43]:62487 "EHLO mail-la0-f43.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750925AbaIJMQX (ORCPT ); Wed, 10 Sep 2014 08:16:23 -0400 X-Google-Original-Sender: Date: Wed, 10 Sep 2014 14:14:24 +0200 From: Johan Hovold To: Boris BREZILLON Cc: Nicolas Ferre , Jean-Christophe Plagniol-Villard , Alexandre Belloni , Andrew Victor , Alessandro Zummo , rtc-linux@googlegroups.com, Rob Herring , Pawel Moll , Mark Rutland , Ian Campbell , Kumar Gala , devicetree@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH 5/5] rtc: at91sam9: add DT bindings documentation Message-ID: <20140910121424.GG2974@localhost> References: <1409733934-14465-1-git-send-email-boris.brezillon@free-electrons.com> <1409733934-14465-6-git-send-email-boris.brezillon@free-electrons.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1409733934-14465-6-git-send-email-boris.brezillon@free-electrons.com> User-Agent: Mutt/1.5.22 (2013-10-16) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Wed, Sep 03, 2014 at 10:45:34AM +0200, Boris BREZILLON wrote: > Signed-off-by: Boris BREZILLON > --- > .../devicetree/bindings/rtc/atmel,at91sam9-rtc.txt | 20 ++++++++++++++++++++ > 1 file changed, 20 insertions(+) > create mode 100644 Documentation/devicetree/bindings/rtc/atmel,at91sam9-rtc.txt > > diff --git a/Documentation/devicetree/bindings/rtc/atmel,at91sam9-rtc.txt b/Documentation/devicetree/bindings/rtc/atmel,at91sam9-rtc.txt > new file mode 100644 > index 0000000..9ca455f > --- /dev/null > +++ b/Documentation/devicetree/bindings/rtc/atmel,at91sam9-rtc.txt > @@ -0,0 +1,20 @@ > +Atmel AT91SAM9260 Real Time Timer > + > +Required properties: > +- compatible: should be: "atmel,at91sam9260-rtt" > +- reg: should contain 2 memory regions > + * the first one encodes the memory region of the RTT controller > + * the second one encodes the GPBR (General Purpose Backup Resgisters) > + memory region used to store the current time > +- interrupts: rtc alarm/event interrupt > +- clocks: should contain one clock pointing the the slow clk > + > +Example: > + > +rtc@fffffe00 { > + compatible = "atmel,at91sam9260-rtt"; > + reg = <0xfffffd20 0x10 > + 0xfffffd50 0x4>; > + interrupts = <1 4 7>; > + clocks = <&clk32k>; > +}; This does not describe the hardware, but rather a specific software configuration. The RTT is first of all not an RTC (although it can be used as one in a specific software configuration). And the second register resource above is not an RTT register, but a general-purpose backup register could be used for other purposes (which register to use is currently configurable for legacy booting using CONFIG_RTC_DRV_AT91SAM9_GPBR). This was discussed in the thread where I posted an RFC for this last year (which you linked to in your original submission thread), but no conclusion was reached: http://www.spinics.net/lists/arm-kernel/msg236292.html Johan