Add SAM3/4 RTT driver. From Bob Doiron

arch/arm/src/sam34/Make.defs

@@ -134,6 +134,10 @@ ifeq ($(CONFIG_SAM34_RTC),y)
 CHIP_CSRCS += sam_rtc.c
 endif
 
+ifeq ($(CONFIG_SAM34_RTT),y)
+CHIP_CSRCS += sam_rtt.c
+endif
+
 ifeq ($(CONFIG_SAM34_WDT),y)
 CHIP_CSRCS += sam_wdt.c
 endif

arch/arm/src/sam34/sam_rtc.c

@@ -54,20 +54,25 @@
 #include "up_arch.h"
 #include "sam_rtc.h"
 
+#if defined(CONFIG_RTC_HIRES) && defined (CONFIG_SAM34_RTT)
+#  include "sam_rtt.h"
+#  include "sam_periphclks.h"
+#endif
+
 #ifdef CONFIG_RTC
 
 /************************************************************************************
  * Pre-processor Definitions
  ************************************************************************************/
 /* Configuration ********************************************************************/
-/* This RTC implementation supports only date/time RTC hardware */
-
-#ifndef CONFIG_RTC_DATETIME
-#  error "CONFIG_RTC_DATETIME must be set to use this driver"
-#endif
 
 #ifdef CONFIG_RTC_HIRES
-#  error "CONFIG_RTC_HIRES must NOT be set with this driver"
+# if !defined(CONFIG_SAM34_RTT)
+#  error RTT is required to emulate high resolution RTC
+# endif
+# if (CONFIG_RTC_FREQUENCY > 32768) || ((32768 % CONFIG_RTC_FREQUENCY) != 0)
+#  error CONFIG_RTC_FREQUENCY must be an integer division of 32768
+# endif
 #endif
 
 #if defined(CONFIG_RTC_ALARM) && !defined(CONFIG_SCHED_WORKQUEUE)
@@ -119,6 +124,12 @@ struct work_s g_alarmwork;
 
 volatile bool g_rtc_enabled = false;
 
+/* g_rtt_offset holds the rtt->rtc count offset */
+
+#if defined(CONFIG_RTC_HIRES) && defined (CONFIG_SAM34_RTT)
+uint32_t g_rtt_offset = 0;
+#endif
+
 /************************************************************************************
  * Private Functions
  ************************************************************************************/
@@ -302,6 +313,40 @@ static int rtc_interrupt(int irq, void *context)
 }
 #endif
 
+/************************************************************************************
+ * Name: rtc_sync
+ *
+ * Description:
+ *   Waits and returns immediately after 1 sec tick. For best accuracy,
+ *   call with interrupts disabled.
+ *
+ * Returns value of the TIMR register
+ *
+ ************************************************************************************/
+
+static uint32_t rtc_sync(void)
+{
+  uint32_t r0, r1;
+
+  /* Get start second (stable) */
+
+  do
+    {
+      r0 = getreg32(SAM_RTC_TIMR);
+    }
+  while (r0 != getreg32(SAM_RTC_TIMR));
+
+  /* Now read until it changes */
+
+  do
+    {
+      r1 = getreg32(SAM_RTC_TIMR);
+    }
+  while (r1 == r0);
+
+  return r1;
+}
+
 /************************************************************************************
  * Public Functions
  ************************************************************************************/
@@ -370,6 +415,32 @@ int up_rtcinitialize(void)
 
 #endif
 
+#if defined(CONFIG_RTC_HIRES) && defined (CONFIG_SAM34_RTT)
+   /* Using the RTT for subsecond ticks. */
+
+  sam_rtt_enableclk();
+
+  /* Disable ints, set prescaler, start counter */
+
+  putreg32(RTT_MR_RTPRES(32768/CONFIG_RTC_FREQUENCY) | RTT_MR_RTTRST, SAM_RTT_MR);
+
+  /* wait for a second tick to get the RTT offset.
+   * Interrupts are assumed to still be off at this point.
+   */
+
+  rtc_sync();
+
+  /* Probably safe to read the RTT_VR register now since the clock just ticked,
+   * but we'll be careful anyway.
+   */
+
+  do
+    {
+      g_rtt_offset = getreg32(SAM_RTT_VR);
+    }
+  while(getreg32(SAM_RTT_VR) != g_rtt_offset);
+#endif
+
   rtc_dumpregs("After Initialization");
   return OK;
 }
@@ -681,4 +752,55 @@ int up_rtc_setalarm(FAR const struct timespec *tp, alarmcb_t callback)
 }
 #endif
 
+
+/************************************************************************************
+ * Name: up_rtc_gettime
+ *
+ * Description:
+ *   Get the current time from the high resolution RTC clock/counter.  This interface
+ *   is only supported by the high-resolution RTC/counter hardware implementation.
+ *   It is used to replace the system timer.
+ *
+ * Input Parameters:
+ *   tp - The location to return the high resolution time value.
+ *
+ * Returned Value:
+ *   Zero (OK) on success; a negated errno on failure
+ *
+ ************************************************************************************/
+
+#if defined(CONFIG_RTC_HIRES) && defined (CONFIG_SAM34_RTT)
+
+int up_rtc_gettime(FAR struct timespec *tp)
+{
+  /* This is a hack to emulate a high resolution rtc using the rtt */
+  uint32_t rtc_cal, rtc_tim, rtt_val;
+  struct tm t;
+
+  do
+  {
+    rtc_cal = getreg32(SAM_RTC_CALR);
+    rtc_tim = getreg32(SAM_RTC_TIMR);
+    rtt_val = getreg32(SAM_RTT_VR);
+  } while((rtc_cal != getreg32(SAM_RTC_CALR)) ||
+          (rtc_tim != getreg32(SAM_RTC_TIMR)) ||
+          (rtt_val != getreg32(SAM_RTT_VR)));
+
+  t.tm_sec  = rtc_bcd2bin((rtc_tim & RTC_TIMR_SEC_MASK)   >> RTC_TIMR_SEC_SHIFT);
+  t.tm_min  = rtc_bcd2bin((rtc_tim & RTC_TIMR_MIN_MASK)   >> RTC_TIMR_MIN_SHIFT);
+  t.tm_hour = rtc_bcd2bin((rtc_tim & RTC_TIMR_HOUR_MASK)  >> RTC_TIMR_HOUR_SHIFT);
+  t.tm_mday = rtc_bcd2bin((rtc_cal & RTC_CALR_DATE_MASK)  >> RTC_CALR_DATE_SHIFT);
+  t.tm_mon  = rtc_bcd2bin((rtc_cal & RTC_CALR_MONTH_MASK) >> RTC_CALR_MONTH_SHIFT);
+  t.tm_year = (rtc_bcd2bin((rtc_cal & RTC_CALR_CENT_MASK) >> RTC_CALR_CENT_SHIFT) * 100)
+             + rtc_bcd2bin((rtc_cal & RTC_CALR_YEAR_MASK) >> RTC_CALR_YEAR_SHIFT)
+             - 1900;
+
+  tp->tv_sec = mktime(&t);
+  tp->tv_nsec = (((rtt_val-g_rtt_offset) & (CONFIG_RTC_FREQUENCY-1)) * 1000000000ULL) /
+                CONFIG_RTC_FREQUENCY;
+
+  return OK;
+}
+#endif
+
 #endif /* CONFIG_RTC */

arch/arm/src/sam34/sam_rtt.h

@@ -0,0 +1,100 @@
+/****************************************************************************
+ * arch/arm/src/sam34/sam_rtt.h
+ *
+ *   Copyright (C) 2014 Gregory Nutt. All rights reserved.
+ *   Authors: Gregory Nutt <gnutt@nuttx.org>
+ *            Bob Doiron
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions
+ * are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright
+ *    notice, this list of conditions and the following disclaimer.
+ * 2. Redistributions in binary form must reproduce the above copyright
+ *    notice, this list of conditions and the following disclaimer in
+ *    the documentation and/or other materials provided with the
+ *    distribution.
+ * 3. Neither the name NuttX nor the names of its contributors may be
+ *    used to endorse or promote products derived from this software
+ *    without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+ * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
+ * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
+ * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+ * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+ * POSSIBILITY OF SUCH DAMAGE.
+ *
+ ****************************************************************************/
+
+#ifndef __ARCH_ARM_SRC_SAM34_RTT_H
+#define __ARCH_ARM_SRC_SAM34_RTT_H
+
+/****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+
+#include "chip.h"
+#include "chip/sam_rtt.h"
+
+#ifdef CONFIG_TIMER
+
+/****************************************************************************
+ * Pre-processor Definitions
+ ****************************************************************************/
+
+#ifndef __ASSEMBLY__
+
+#undef EXTERN
+#if defined(__cplusplus)
+#define EXTERN extern "C"
+extern "C"
+{
+#else
+#define EXTERN extern
+#endif
+
+/****************************************************************************
+ * Public Functions
+ ****************************************************************************/
+
+#if defined(CONFIG_SAM34_RTT)
+
+/****************************************************************************
+ * Name: sam_rttinitialize
+ *
+ * Description:
+ *   Initialize the timer.  The timer is initialized and registers as
+ *   'devpath.  The initial state of the timer is disabled.
+ *
+ * Input Parameters:
+ *   devpath - The full path to the timer.  This should be of the form
+ *     /dev/rtt0
+ *
+ * Returned Values:
+ *   None
+ *
+ ****************************************************************************/
+
+void sam_rttinitialize(FAR const char *devpath);
+
+#endif // CONFIG_SAM34_RTT
+
+
+#undef EXTERN
+#if defined(__cplusplus)
+}
+#endif
+
+#endif /* __ASSEMBLY__ */
+#endif /* CONFIG_TIMER */
+#endif /* __ARCH_ARM_SRC_SAM34_RTT_H */

arch/arm/src/sam34/sam_tc.c

@@ -106,7 +106,6 @@ struct sam34_lowerhalf_s
   uint32_t clkticks;        /* actual clock ticks for current interval */
   bool     started;         /* The timer has been started */
   uint16_t periphid;        /* peripheral id */
-  uint16_t debug;
 };
 
 /****************************************************************************
@@ -134,7 +133,7 @@ static int      sam34_getstatus(FAR struct timer_lowerhalf_s *lower,
                   FAR struct timer_status_s *status);
 static int      sam34_settimeout(FAR struct timer_lowerhalf_s *lower,
                   uint32_t timeout);
-static tccb_t   sam34_capture(FAR struct timer_lowerhalf_s *lower,
+static tccb_t   sam34_sethandler(FAR struct timer_lowerhalf_s *lower,
                   tccb_t handler);
 static int      sam34_ioctl(FAR struct timer_lowerhalf_s *lower, int cmd,
                   unsigned long arg);
@@ -150,7 +149,7 @@ static const struct timer_ops_s g_tcops =
   .stop       = sam34_stop,
   .getstatus  = sam34_getstatus,
   .settimeout = sam34_settimeout,
-  .capture    = sam34_capture,
+  .sethandler = sam34_sethandler,
   .ioctl      = sam34_ioctl,
 };
 
@@ -267,15 +266,13 @@ static void sam34_putreg(uint32_t val, uint32_t addr)
 static int sam34_interrupt(int irq, FAR void *context)
 {
   FAR struct sam34_lowerhalf_s *priv = &g_tcdevs[irq-SAM_IRQ_TC0];
-  uint16_t regval;
 
   tcvdbg("Entry\n");
   DEBUGASSERT((irq >= SAM_IRQ_TC0) && (irq <= SAM_IRQ_TC5));
 
   /* Check if the interrupt is really pending */
 
-  regval = sam34_getreg(priv->base + SAM_TC_SR_OFFSET);
+  if ((sam34_getreg(priv->base + SAM_TC_SR_OFFSET) & TC_INT_CPCS) != 0)
-  if ((regval & TC_INT_CPCS) != 0)
     {
       uint32_t timeout;
 
@@ -283,7 +280,7 @@ static int sam34_interrupt(int irq, FAR void *context)
 
       if (priv->handler && priv->handler(&priv->timeout))
         {
-          /* Calculate new ticks */
+          /* Calculate new ticks / dither adjustment */
 
           priv->clkticks = ((uint64_t)(priv->adjustment + priv->timeout))*TC_FCLK / 1000000;
 
@@ -323,7 +320,7 @@ static int sam34_interrupt(int irq, FAR void *context)
 static int sam34_start(FAR struct timer_lowerhalf_s *lower)
 {
   FAR struct sam34_lowerhalf_s *priv = (FAR struct sam34_lowerhalf_s *)lower;
-  uint32_t mr_val = 0;
+  uint32_t mr_val;
 
   tcvdbg("Entry\n");
   DEBUGASSERT(priv);
@@ -335,13 +332,14 @@ static int sam34_start(FAR struct timer_lowerhalf_s *lower)
 
   sam_enableperiph0(priv->periphid);                            /* Enable peripheral clock */
   sam34_putreg(TC_CCR_CLKDIS, priv->base + SAM_TC_CCR_OFFSET);  /* Disable counter */
+  sam34_putreg(0, priv->base + SAM_TC_CV_OFFSET);               /* clear counter */
 
   /* TC_CMR_WAVE - waveform mode
    * TC_CMR_WAVSEL_UPAUTO - reset on RC compare (interval timer)
    * TC_CMR_TCCLKS_TIMERCLOCK5 = SCLK
    */
 
-  mr_val |= (TC_CMR_WAVE + TC_CMR_WAVSEL_UPAUTO + TC_CMR_TCCLKS_TIMERCLOCK5);
+  mr_val = (TC_CMR_WAVE + TC_CMR_WAVSEL_UPAUTO + TC_CMR_TCCLKS_TIMERCLOCK5);
   sam34_putreg(mr_val, priv->base + SAM_TC_CMR_OFFSET);
 
   sam34_putreg(priv->clkticks, priv->base + SAM_TC_RC_OFFSET);   /* Set interval */
@@ -381,7 +379,7 @@ static int sam34_stop(FAR struct timer_lowerhalf_s *lower)
   tcvdbg("Entry\n");
   DEBUGASSERT(priv);
 
-  if(!priv->started)
+  if (!priv->started)
     {
       return -EINVAL;
     }
@@ -430,7 +428,7 @@ static int sam34_getstatus(FAR struct timer_lowerhalf_s *lower,
 
   if (priv->handler)
     {
-      status->flags |= TCFLAGS_CAPTURE;
+      status->flags |= TCFLAGS_HANDLER;
     }
 
   /* Return the actual timeout is milliseconds */
@@ -440,7 +438,7 @@ static int sam34_getstatus(FAR struct timer_lowerhalf_s *lower,
   /* Get the time remaining until the timer expires (in microseconds) */
 
   elapsed = sam34_getreg(priv->base + SAM_TC_CV_OFFSET);
-  status->timeleft = (priv->timeout * elapsed) / (priv->clkticks + 1); /* TODO - check on this +1 */
+  status->timeleft = ((uint64_t)priv->timeout * elapsed) / (priv->clkticks + 1); /* TODO - check on this +1 */
 
   tcvdbg("  flags    : %08x\n", status->flags);
   tcvdbg("  timeout  : %d\n", status->timeout);
@@ -470,6 +468,12 @@ static int sam34_settimeout(FAR struct timer_lowerhalf_s *lower,
   FAR struct sam34_lowerhalf_s *priv = (FAR struct sam34_lowerhalf_s *)lower;
 
   DEBUGASSERT(priv);
+
+  if (priv->started)
+    {
+      return -EPERM;
+    }
+
   tcvdbg("Entry: timeout=%d\n", timeout);
 
   /* Can this timeout be represented? */
@@ -486,21 +490,17 @@ static int sam34_settimeout(FAR struct timer_lowerhalf_s *lower,
   timeout = (1000000ULL * priv->clkticks) / TC_FCLK;          /* Truncated timeout */
   priv->adjustment = priv->timeout - timeout;                 /* Truncated time to be added to next interval (dither) */
 
-  tcvdbg("fwdt=%d reload=%d timout=%d, adjustment=%d\n",
+  tcvdbg("fclk=%d clkticks=%d timout=%d, adjustment=%d\n",
-         TC_FCLK, reload, priv->timeout, priv->adjustment);
+         TC_FCLK, priv->clkticks, priv->timeout, priv->adjustment);
-
-  /* Don't commit to MR register until started! */
 
   return OK;
 }
 
 /****************************************************************************
- * Name: sam34_capture
+ * Name: sam34_sethandler
  *
  * Description:
- *   Don't reset on timer timeout; instead, call this user provider
+ *   Call this user provided timeout handler.
- *   timeout handler.  NOTE:  Providing handler==NULL will restore the reset
- *   behavior.
  *
  * Input Parameters:
  *   lower      - A pointer the publicly visible representation of the "lower-half"
@@ -511,13 +511,12 @@ static int sam34_settimeout(FAR struct timer_lowerhalf_s *lower,
  *
  * Returned Values:
  *   The previous timer expiration function pointer or NULL is there was
- *   no previous function pointer, i.e., if the previous behavior was
+ *   no previous function pointer.
- *   reset-on-expiration (NULL is also returned if an error occurs).
  *
  ****************************************************************************/
 
-static tccb_t sam34_capture(FAR struct timer_lowerhalf_s *lower,
+static tccb_t sam34_sethandler(FAR struct timer_lowerhalf_s *lower,
-                            tccb_t handler)
+                               tccb_t handler)
 {
   FAR struct sam34_lowerhalf_s *priv = (FAR struct sam34_lowerhalf_s *)lower;
   irqstate_t flags;