SAMD/L21: Add a USB driver. Developed for Filament Inc. by Offcode, LTD.

arch/arm/src/samdl/Kconfig

@@ -466,6 +466,10 @@ config SAMDL_HAVE_TC7
 	bool
 	default n
 
+config SAMDL_HAVE_USB
+	bool
+	default n
+
 config SAMDL_AC
 	bool "Analog Comparator"
 	default n
@@ -737,3 +741,25 @@ config SAMDL_I2C_REGDEBUG
 		Enable very low-level register access debug.  Depends on DEBUG_I2C.
 
 endif # SAMDL_HAVE_I2C
+
+if SAMDL_HAVE_USB
+
+config SAMDL_USB_ENABLE_PPEP
+	bool "Enable Ping-Pong Endpoints"
+	default n
+	---help---
+		To maximize throughput, an endpoint can be configured for ping-pong
+		operation.  When this is done the input and output endpoint with the same
+		address are used in the same direction.  The CPU or DMA Controller can
+		then read/write one data buffer while the USB module writes/reads from
+		the other buffer.  This gives double buffered communication.
+
+config SAMDL_USB_REGDEBUG
+	bool "USB register-Level Debug"
+	default n
+	depends on DEBUG_USB_INFO
+	---help---
+		Enable very low-level register access debug.  Depends on
+		CONFIG_DEBUG_USB_INFO.
+
+endif # SAMDL_HAVE_USB

arch/arm/src/samdl/Make.defs

@@ -98,3 +98,7 @@ endif
 ifeq ($(CONFIG_SAMDL_HAVE_I2C),y)
 CHIP_CSRCS += sam_i2c_master.c
 endif
+
+ifeq ($(CONFIG_SAMDL_USB),y)
+CHIP_CSRCS += sam_usb.c
+endif

arch/arm/src/samdl/chip/saml_usb.h

@@ -37,6 +37,7 @@
  *
  ********************************************************************************************/
 
+
 #ifndef __ARCH_ARM_SRC_SAMDL_CHIP_SAML_USB_H
 #define __ARCH_ARM_SRC_SAMDL_CHIP_SAML_USB_H
 
@@ -53,6 +54,29 @@
 /********************************************************************************************
  * Pre-processor Definitions
  ********************************************************************************************/
+
+/* Capabilities and characteristics of endpoints ********************************************/
+
+/*   EP  EP BANKS  EP SIZE   EP TYPE
+ *   --- --------- --------- ---------
+ *    0      2      64/1023     Control/Bulk/Iso/Interrupt
+ *    1      2      64/1023     Control/Bulk/Iso/Interrupt
+ *    2      2      64/1023     Control/Bulk/Iso/Interrupt
+ *    3      2      64/1023     Control/Bulk/Iso/Interrupt
+ *    4      2      64/1023     Control/Bulk/Iso/Interrupt
+ *    5      2      64/1023     Control/Bulk/Iso/Interrupt
+ *    6      2      64/1023     Control/Bulk/Iso/Interrupt
+ *    7      2      64/1023     Control/Bulk/Iso/Interrupt
+ */
+
+#define SAM_USB_NENDPOINTS             (8)
+#define SAM_USB_MAXPACKETSIZE(ep)      (64)
+#define SAM_USB_NBANKS(ep)             (2)
+#define SAM_USB_CONTROL(ep)            (true)
+#define SAM_USB_BULK(ep)               (true)
+#define SAM_USB_ISOCHRONOUS(ep)        (true)
+#define SAM_USB_INTERRUPT(ep)          (true)
+
 /* USB register offsets ********************************************************************/
 
 /* Common USB Device/Host Register Offsets */

arch/arm/src/samdl/sam_usb.h

@@ -0,0 +1,99 @@
+/******************************************************************************
+ * arch/arm/src/samdl/sam_usb.h
+ *
+ *   Copyright (C) 2015 Filament - www.filament.com
+ *   Copyright (C) 2015 Offcode Ltd. All rights reserved.
+ *   Author: Janne Rosberg <janne@offcode.fi>
+ *
+ * This driver is derived from the SAM34 UDP driver:
+ *   Copyright (C) 2014 Gregory Nutt. All rights reserved.
+ *   Author: Gregory Nutt <gnutt@nuttx.org>
+ *
+ * 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_SAMDL_SAM_USB_H
+#define __ARCH_ARM_SRC_SAMDL_SAM_USB_H
+
+/*****************************************************************************
+ * Included Files
+ ****************************************************************************/
+
+#include <nuttx/config.h>
+#include <nuttx/usb/usbdev.h>
+#include <stdint.h>
+
+#include "chip.h"
+#include "chip/saml_usb.h"
+
+/*****************************************************************************
+ * Public Function Prototypes
+ ****************************************************************************/
+
+#ifndef __ASSEMBLY__
+
+#undef EXTERN
+#if defined(__cplusplus)
+#define EXTERN extern "C"
+extern "C"
+{
+#else
+#define EXTERN extern
+#endif
+
+/*****************************************************************************
+ * Name:  sam_usb_suspend
+ *
+ * Description:
+ *   Board logic must provide the sam_usb_suspend logic if the USB driver is
+ *   used. This function is called whenever the USB enters or leaves
+ *   suspend mode.
+ *
+ *   When 'resume' is false, this function call provides an opportunity to
+ *   perform board-specific power-saving actions so that less power is consumed
+ *   while the USB is suspended.
+ *
+ * XXX:
+ *   Certain power-saving operations are performed by the UDP driver when it
+ *   enters suspend mode:  The USB device peripheral clocks are be switched off.
+ *   MCK and UDPCK are switched off and the USB transceiver is disabled.
+ *
+ *   When 'resume' is true, normal clocking and operations must all be restored.
+ *
+ *****************************************************************************/
+
+void sam_udp_suspend(FAR struct usbdev_s *dev, bool resume);
+
+#undef EXTERN
+#if defined(__cplusplus)
+}
+#endif
+
+#endif /* __ASSEMBLY__ */
+#endif /* __ARCH_ARM_SRC_SAMDL_SAM_USB_H */

configs/samd21-xplained/include/board.h

@@ -480,6 +480,19 @@
 
 #define BOARD_SERCOM5_FREQUENCY      BOARD_GCLK0_FREQUENCY
 
+/* USB definitions ******************************************************************/
+/* This is the source clock generator for the GCLK_USB clock
+ */
+
+#define BOARD_USB_GCLKGEN            0
+#define BOARD_USB_FREQUENCY          BOARD_GCLK0_FREQUENCY
+
+/* default USB Pad calibration (not used yet by USB driver) */
+
+#define BOARD_USB_PADCAL_P       29
+#define BOARD_USB_PADCAL_N       5
+#define BOARD_USB_PADCAL_TRIM    3
+
 /* LED definitions ******************************************************************/
 /* There are three LEDs on board the SAMD21 Xplained Pro board:  The EDBG
  * controls two of the LEDs, a power LED and a status LED.  There is only

configs/saml21-xplained/include/board.h

@@ -604,6 +604,19 @@
 
 #define BOARD_SERCOM5_FREQUENCY      BOARD_GCLK0_FREQUENCY
 
+/* USB definitions ******************************************************************/
+/* This is the source clock generator for the GCLK_USB clock
+ */
+
+#define BOARD_USB_GCLKGEN            0
+#define BOARD_USB_FREQUENCY          BOARD_GCLK0_FREQUENCY
+
+/* default USB Pad calibration (not used yet by USB driver) */
+
+#define BOARD_USB_PADCAL_P       29
+#define BOARD_USB_PADCAL_N       5
+#define BOARD_USB_PADCAL_TRIM    3
+
 /* LED definitions ******************************************************************/
 /* There are three LEDs on board the SAML21 Xplained Pro board:  The EDBG
  * controls two of the LEDs, a power LED and a status LED.  There is only