Timer driver updates from Bob Doiron

ChangeLog

@@ -7290,3 +7290,5 @@
 	  counter (2014-5-5).
 	* configs/sam4s-xplained-pro:  Clean-up of LED usage and also some
 	  integration of new timer features.  From Bob Doiron  (2014-5-5).
+	* drivers/timer.c and include/nuttx/timer.h:  Timer driver updates from
+	  Bob Doiron (2014-5-5).

drivers/timer.c

@@ -374,7 +374,7 @@ static int timer_ioctl(FAR struct file *filep, int cmd, unsigned long arg)
 
     /* cmd:         TCIOC_SETHANDLER
      * Description: Call this handler on timeout
-     * Argument:    A pointer to struct timer_capture_s.
+     * Argument:    A pointer to struct timer_sethandler_s.
      *
      * NOTE: This ioctl cannot be support in the kernel build mode. In that
      * case direct callbacks from kernel space into user space is forbidden.
@@ -383,20 +383,20 @@ static int timer_ioctl(FAR struct file *filep, int cmd, unsigned long arg)
 #ifndef CONFIG_NUTTX_KERNEL
     case TCIOC_SETHANDLER:
       {
-        FAR struct timer_capture_s *capture;
+        FAR struct timer_sethandler_s *sethandler;
 
         /* Don't reset on timer timeout; instead, call this user
          * provider timeout handler.  NOTE:  Providing handler==NULL will
          * restore the reset behavior.
          */
 
-        if (lower->ops->capture) /* Optional */
+        if (lower->ops->sethandler) /* Optional */
           {
-            capture = (FAR struct timer_capture_s *)((uintptr_t)arg);
+            sethandler = (FAR struct timer_sethandler_s *)((uintptr_t)arg);
-            if (capture)
+            if (sethandler)
               {
-                capture->oldhandler =
+                sethandler->oldhandler =
-                  lower->ops->capture(lower, capture->newhandler);
+                  lower->ops->sethandler(lower, sethandler->newhandler);
                 ret = OK;
               }
             else

include/nuttx/timer.h

@@ -68,13 +68,14 @@
  * TCIOC_SETTIMEOUT - Reset the timer timeout to this value
  *                    Argument: A 32-bit timeout value in microseconds.
  * TCIOC_SETHANDLER - Call this handler on timer expiration
- *                    Argument: A pointer to struct timer_capture_s.
+ *                    Argument: A pointer to struct timer_sethandler_s.
  *
  * WARNING: May change TCIOC_SETTIMEOUT to pass pointer to 64bit nanoseconds
  * or timespec structure.
  *
- * NOTE: This ioctl cannot be support in the kernel build mode. In that
+ * NOTE: The TCIOC_SETHANDLER ioctl cannot be supported in the kernel build
- * case direct callbacks from kernel space into user space is forbidden.
+ * mode. In that case direct callbacks from kernel space into user space is
+ * forbidden.
  */
 
 #define TCIOC_START      _TCIOC(0x001)
@@ -87,7 +88,7 @@
 /* Bit settings for the struct timer_status_s flags field */
 
 #define TCFLAGS_ACTIVE   (1 << 0) /* 1=The timer is running */
-#define TCFLAGS_CAPTURE  (1 << 1) /* 1=Call the user function when the
+#define TCFLAGS_HANDLER  (1 << 1) /* 1=Call the user function when the
                                    *   timer expires */
 
 /****************************************************************************
@@ -102,10 +103,10 @@ typedef bool (*tccb_t)(FAR uint32_t *next_interval_us);
 
 /* This is the type of the argument passed to the TCIOC_SETHANDLER ioctl */
 
-struct timer_capture_s
+struct timer_sethandler_s
 {
-  CODE tccb_t newhandler;   /* The new timer capture handler */
+  CODE tccb_t newhandler;   /* The new timer interrupt handler */
-  CODE tccb_t oldhandler;   /* The previous timer capture handler (if any) */
+  CODE tccb_t oldhandler;   /* The previous timer interrupt handler (if any) */
 };
 
 /* This is the type of the argument passed to the TCIOC_GETSTATUS ioctl and
@@ -115,9 +116,9 @@ struct timer_capture_s
 struct timer_status_s
 {
   uint32_t  flags;          /* See TCFLAGS_* definitions above */
-  uint32_t  timeout;        /* The current timeout setting (in milliseconds) */
+  uint32_t  timeout;        /* The current timeout setting (in microseconds) */
   uint32_t  timeleft;       /* Time left until the timer expiration
-                             * (in milliseconds) */
+                             * (in microseconds) */
 };
 
 /* This structure provides the "lower-half" driver operations available to
@@ -150,8 +151,8 @@ struct timer_ops_s
    * NOTE:  Providing handler==NULL disable.
    */
 
-  CODE tccb_t (*capture)(FAR struct timer_lowerhalf_s *lower,
+  CODE tccb_t (*sethandler)(FAR struct timer_lowerhalf_s *lower,
-                         CODE tccb_t handler);
+                            CODE tccb_t handler);
 
   /* Any ioctl commands that are not recognized by the "upper-half" driver
    * are forwarded to the lower half driver through this method.
@@ -210,7 +211,7 @@ extern "C"
  *
  *   NOTE:  Normally, this function would not be called by application code.
  *   Rather it is called indirectly through the architecture-specific
- *   interface up_timerinitialize() described below.
+ *   initialization.
  *
  * Input parameters:
  *   dev path - The full path to the driver to be registers in the NuttX
@@ -255,27 +256,6 @@ void timer_unregister(FAR void *handle);
  * Architecture-specific Application Interfaces
  ****************************************************************************/
 
-/****************************************************************************
- * Name: up_timerinitialize()
- *
- * Description:
- *   Perform architecture-specific initialization of the timer hardware.
- *   This interface should be provided by all configurations using
- *   to avoid exposed platform-dependent logic.
- * 
- *   At a minimum, this function should call timer_register() which is
- *   described above.
- *
- * Input parameters:
- *   None
- *
- * Returned Value:
- *   Zero on success; a negated errno value on failure.
- *
- ****************************************************************************/
-
-int up_timerinitialize(void);
-
 #undef EXTERN
 #ifdef __cplusplus
 }