1.4.0 Release

Updated SFE SAMD boards for 1.8+
Beta release of LilyPad LilyMini

Author: Mike Grusin

IDE_Board_Manager/package_sparkfun_index.json

@@ -268,8 +268,8 @@
           "category": "Contributed",
           "url": "https://github.com/sparkfun/Arduino_Boards/raw/LilyMini_testing/IDE_Board_Manager/sparkfun-samd-1.4.0.tar.bz2",
           "archiveFileName": "sparkfun-samd-1.4.0.tar.bz2",
-          "checksum": "SHA-256:D2DBAFABE77F60A1A085A80DE3E086328681FE90F16D026B417554B3FB9EDFDD",
-          "size": "288700",
+          "checksum": "SHA-256:B3F09095478EFD13388E2A786021D2FC1C1FA7A6236CC7B28152E4DDB94561B2",
+          "size": "289527",
           "help": {
             "online": "https://forums.sparkfun.com"
           },

IDE_Board_Manager/sparkfun-samd-1.4.0.tar.bz2

@@ -1,6 +1,8 @@
 # SparkFun Arduino Boards
 
-This repository contains support for the following SparkFun Arduino-compatible development boards:
+This repository contains support for the following SparkFun Arduino-compatible development boards.
+
+**IMPORTANT NOTE:** These board files have been updated for compatibility with Arduino version 1.8 and higher. Some boards (e.g. SAMD) may not compile correctly with earlier versions of Arduino. If you need compatibility with earlier versions of Arduino, you can choose previous releases of these boards from the Boards Manager.
 
 #### AVR Boards
 
@@ -21,6 +23,7 @@ This repository contains support for the following SparkFun Arduino-compatible d
 
 * [SparkFun SAMD21 Dev Breakout](https://www.sparkfun.com/products/13672)
 * [SparkFun SAMD21 Mini Breakout](https://www.sparkfun.com/products/13664)
+* [SparkFun 9DoF Razor IMU M0 (SAMD21)](https://www.sparkfun.com/products/14001)
 * [SparkFun LilyMini ProtoSnap (SAMD11)](https://www.sparkfun.com/products/14063)
 * [SparkFun LilyMini (SAMD11)](https://www.sparkfun.com/products/14064)
 
@@ -29,37 +32,43 @@ This repository contains support for the following SparkFun Arduino-compatible d
 * [ESP8266 Thing](https://www.sparkfun.com/products/13231)
 * [ESP8266 WiFi Shield](https://www.sparkfun.com/products/13287)
 
-Each board will be added as an entry to the Arduino **Tools** > **Board** menu.
-
-![Example image](example.png)
-
 ### Installation Instructions
 
-To add board support for our products, go to **File** > **Preferences**, and paste this URL into the 'Additional Boards Manager URLs' input field:
+To add board support for our products, start Arduino and open the Preferences window (**File** > **Preferences**). Now copy and paste the following URL into the 'Additional Boards Manager URLs' input field:
 
 	https://raw.githubusercontent.com/sparkfun/Arduino_Boards/master/IDE_Board_Manager/package_sparkfun_index.json
 
-![Adding a board manager list](https://cdn.sparkfun.com/assets/learn_tutorials/4/5/4/arduino-board-add.png)
+![Location of Additional Boards Manager URL input field](prefs-arrow.png)
+
+If there is already an URL from another manufacturer in that field, click the button at the right end of the field. This will open an editing window allowing you to paste the above URL onto a new line.
+
+### AVR and ESP Installation Instructions
+
+Open the Boards Manager window by selecting **Tools** > **Board**, scroll to the top of the board list, and select **Boards Manager**.
+
+![Boards Manager Menu](manager-menu.png)
+
+If you type "sparkfun" (without quotes) into the "filter your search" field, you will see options to install SparkFun's AVR and ESP board files. Click in the desired box, and click the "Install" button that appears. Once installed, the boards will appear at the bottom of the board list.
+
+![Sparkfun Boards](sparkfunboards.png)
 
-This field can be found in 'Preferences...' under the Arduino File menu.
+### SAMD Installation Instructions
 
-Now, under the **Tools** > **Board** > **Boards Manager...**, if you type in "sparkfun", you will see an option to install board files for SparkFun Arduino compatible boards. Click "Install" to add these to your list.
+When installing SAMD boards, you will need to first install Arduino SAMD support, then SparkFun's SAMD boards.
 
-**NOTE: If you are using Arduino 1.6.6 and the link isn't working for you, change "https" at the beginning of the link to "http" and try again. We're working to figure out why this is happening in version 1.6.6.**
+Open the Boards Manager window by selecting **Tools** > **Board**, scroll to the top of the board list, and select **Boards Manager**. Now type "samd" (without quotes) into the "filter your search" field at the top of the window. Two entries should show up, one for Arduino SAMD boards, and one for SparkFun SAMD boards. We'll install both of these, starting with Arduino SAMD boards.
 
-![SparkFun Boards image](https://cdn.sparkfun.com/assets/learn_tutorials/4/5/4/sparkfun-arduino-board-install.png)
+Click anywhere in the "Arduino SAMD Boards" box, and click "Install". This is a large installation and will take a while.
 
-Now, when you select the Boards list, you will see a collection of new boards for SparkFun.
+![Arduino SAMD Boards](manager-arrow.png)
 
-![SparkFun Boards List](boards_list.png)
+Now click anywhere in the "SparkFun SAMD Boards" box, and click "Install". This is a small installation and will happen much faster.
 
-### Cleaning up the Boards Menu
+![SparkFun SAMD Boards](manager-arrow2.png)
 
-Each entry in the boards list is defined in [boards.txt](https://github.com/sparkfun/Arduino_Boards/blob/master/sparkfun/avr/boards.txt). If you want to de-clutter the menu, you can comment out a board by inserting a `#` at the beginning of each line.
+You're now ready to use SparkFun SAMD boards. They will appear at the bottom the board list.
 
 ### Notes
 
-* **Please note: This will only work under Arduino IDE versions 1.5 and up.**
-* Some boards such as the Pro Micro and the Mega Pro come in more than one form.  For these **you must select the correct processor** in the 'Tools' menu.
+* Some boards such as the Arduino Pro and Pro Mini come in more than one flavor.  For these **you must select the correct processor** in the 'Tools' menu.
 * Information on compiling and programming the bootloaders can be found in the bootloaders directory.
-* **Bugs introduced in the Arduino IDE version 1.6.6 through at least 1.6.9 produce errors indicating there is something wrong with these files. This can be resolved by reverting back to 1.6.5-r5. So far all reports seem to indicated that 1.6.10 has also fixed the issues. These intermittent issues are difficult to reliably reproduce.**

README.md

@@ -55,6 +55,10 @@ extern "C"{
 
 void yield( void ) ;
 
+/* system functions */
+int main( void );
+void init( void );
+
 /* sketch */
 void setup( void ) ;
 void loop( void ) ;

SparkFunBoards.png

@@ -24,7 +24,15 @@ extern "C" {
 #endif
 
 #define NVM_MEMORY ((volatile uint16_t *)0x000000)
+
+#if (ARDUINO_SAMD_VARIANT_COMPLIANCE >= 10610)
+
+extern const uint32_t __text_start__;
+#define APP_START ((volatile uint32_t)(&__text_start__) + 4)
+
+#else
 #define APP_START 0x00002004
+#endif
 
 static inline bool nvmReady(void) {
         return NVMCTRL->INTFLAG.reg & NVMCTRL_INTFLAG_READY;
@@ -35,6 +43,13 @@ static void banzai() {
 	// Disable all interrupts
 	__disable_irq();
 
+	// Avoid erasing the application if APP_START is < than the minimum bootloader size
+	// This could happen if without_bootloader linker script was chosen
+	// Minimum bootloader size in SAMD21 family is 512bytes (RM section 22.6.5)
+	if (APP_START < (0x200 + 4)) {
+		goto reset;
+	}
+
 	// Erase application
 	while (!nvmReady())
 		;
@@ -44,6 +59,7 @@ static void banzai() {
 	while (!nvmReady())
 		;
 
+reset:
 	// Reset the device
 	NVIC_SystemReset() ;
 

boards_list.png

@@ -240,13 +240,13 @@ void SERCOM::enableSPI()
 
 void SERCOM::disableSPI()
 {
-  //Setting the enable bit to 0
-  sercom->SPI.CTRLA.bit.ENABLE = 0;
 
   while(sercom->SPI.SYNCBUSY.bit.ENABLE)
   {
     //Waiting then enable bit from SYNCBUSY is equal to 0;
   }
+  //Setting the enable bit to 0
+  sercom->SPI.CTRLA.bit.ENABLE = 0;
 }
 
 void SERCOM::setDataOrderSPI(SercomDataOrder dataOrder)

example.png

@@ -48,6 +48,7 @@ class USBDevice_SAMD21G18x {
 
 	inline void runInStandby()   { usb.CTRLA.bit.RUNSTDBY = 1; }
 	inline void noRunInStandby() { usb.CTRLA.bit.RUNSTDBY = 0; }
+	inline void wakeupHost()     { usb.CTRLB.bit.UPRSM = 1; }
 
 	// USB speed
 	inline void setFullSpeed()       { usb.CTRLB.bit.SPDCONF = USB_DEVICE_CTRLB_SPDCONF_FS_Val;   }
@@ -106,7 +107,7 @@ class USBDevice_SAMD21G18x {
 	inline void epBank0EnableStalled(ep_t ep)          { usb.DeviceEndpoint[ep].EPINTENSET.bit.STALL0 = 1; }
 	inline void epBank1EnableStalled(ep_t ep)          { usb.DeviceEndpoint[ep].EPINTENSET.bit.STALL1 = 1; }
 	inline void epBank0EnableTransferComplete(ep_t ep) { usb.DeviceEndpoint[ep].EPINTENSET.bit.TRCPT0 = 1; }
-	inline void epBank1EnableTransferComplete(ep_t ep) { usb.DeviceEndpoint[ep].EPINTENSET.bit.TRCPT0 = 1; }
+	inline void epBank1EnableTransferComplete(ep_t ep) { usb.DeviceEndpoint[ep].EPINTENSET.bit.TRCPT1 = 1; }
 
 	inline void epBank0DisableSetupReceived(ep_t ep)    { usb.DeviceEndpoint[ep].EPINTENCLR.bit.RXSTP = 1; }
 	inline void epBank0DisableStalled(ep_t ep)          { usb.DeviceEndpoint[ep].EPINTENCLR.bit.STALL0 = 1; }
@@ -318,21 +319,24 @@ class DoubleBufferedEPOutHandler : public EPHandler {
 			usbd.epBank0AckTransferComplete(ep);
 			//usbd.epBank0AckTransferFailed(ep); // XXX
 
-			// Update counters and swap banks
+			// Update counters and swap banks for non-ZLP's
 			if (incoming == 0) {
 				last0 = usbd.epBank0ByteCount(ep);
+				if (last0 != 0) {
 				incoming = 1;
 				usbd.epBank0SetAddress(ep, const_cast<uint8_t *>(data1));
-				ready0 = true;
 				synchronized {
+						ready0 = true;
 					if (ready1) {
 						notify = true;
 						return;
 					}
 					notify = false;
 				}
+				}
 			} else {
 				last1 = usbd.epBank0ByteCount(ep);
+				if (last1 != 0) {
 				incoming = 0;
 				usbd.epBank0SetAddress(ep, const_cast<uint8_t *>(data0));
 				synchronized {
@@ -344,6 +348,7 @@ class DoubleBufferedEPOutHandler : public EPHandler {
 					notify = false;
 				}
 			}
+			}
 			release();
 		}
 	}

manager-arrow.png

@@ -65,6 +65,8 @@ class USBDeviceClass {
 	bool configured();
 	bool connected();
 
+	void standby();
+
 	// Setup API
 	bool handleClassInterfaceSetup(USBSetup &setup);
 	bool handleStandardSetup(USBSetup &setup);

manager-arrow2.png

@@ -250,6 +250,11 @@ bool USBDeviceClass::sendDescriptor(USBSetup &setup)
 	return true;
 }
 
+void USBDeviceClass::standby() {
+	usbd.noRunInStandby();
+}
+
+
 void USBDeviceClass::handleEndpoint(uint8_t ep)
 {
 #if defined(CDC_ENABLED)

manager-menu.png

@@ -258,7 +258,7 @@ _Pragma("pack()")
  *    idVendor, idProduct, bcdDevice, iManufacturer, iProduct, iSerialNumber, bNumConfigurations */
 
 #define D_CONFIG(_totalLength,_interfaces) \
-	{ 9, 2, _totalLength,_interfaces, 1, 0, USB_CONFIG_BUS_POWERED, USB_CONFIG_POWER_MA(500) }
+	{ 9, 2, _totalLength,_interfaces, 1, 0, USB_CONFIG_BUS_POWERED | USB_CONFIG_REMOTE_WAKEUP, USB_CONFIG_POWER_MA(500) }
 /* Table 9-10. Standard Configuration Descriptor
  * bLength, bDescriptorType, wTotalLength, bNumInterfaces, bConfigurationValue, iConfiguration
  * bmAttributes, bMaxPower */

prefs-arrow.png

@@ -41,7 +41,7 @@
 #define CDC_TX CDC_ENDPOINT_IN
 #endif
 
-#define ISERIAL_MAX_LEN        20
+#define ISERIAL_MAX_LEN        33
 
 // Defined string description
 #define IMANUFACTURER	1

sparkfun/samd/cores/arduino/Arduino.h

@@ -31,7 +31,7 @@ Uart::Uart(SERCOM *_s, uint8_t _pinRX, uint8_t _pinTX, SercomRXPad _padRX, Serco
 
 void Uart::begin(unsigned long baudrate)
 {
-  begin(baudrate, (uint8_t)SERIAL_8N1);
+  begin(baudrate, SERIAL_8N1);
 }
 
 void Uart::begin(unsigned long baudrate, uint16_t config)

sparkfun/samd/cores/arduino/Reset.cpp

@@ -42,6 +42,7 @@ class UDP : public Stream {
 
 public:
   virtual uint8_t begin(uint16_t) =0;	// initialize, start listening on specified port. Returns 1 if successful, 0 if there are no sockets available to use
+  virtual uint8_t beginMulticast(IPAddress, uint16_t) { return 0; }  // initialize, start listening on specified multicast IP address and port. Returns 1 if successful, 0 on failure
   virtual void stop() =0;  // Finish with the UDP socket
 
   // Sending UDP packets

sparkfun/samd/cores/arduino/SERCOM.cpp

@@ -174,15 +174,15 @@ void SysTick_Handler(void)
   SysTick_DefaultHandler();
 }
 
-//static void (*usb_isr)(void) = NULL;
-//
-//void USB_Handler(void)
-//{
-//  if (usb_isr)
-//    usb_isr();
-//}
-//
-//void USB_SetHandler(void (*new_usb_isr)(void))
-//{
-//  usb_isr = new_usb_isr;
-//}
+static void (*usb_isr)(void) = NULL;
+
+void USB_Handler(void)
+{
+  if (usb_isr)
+    usb_isr();
+}
+
+void USB_SetHandler(void (*new_usb_isr)(void))
+{
+  usb_isr = new_usb_isr;
+}

sparkfun/samd/cores/arduino/USB/SAMD21_USBDevice.h

@@ -122,7 +122,7 @@ extern char* ltoa( long value, char *string, int radix )
   return string;
 }
 
-extern char* utoa( unsigned long value, char *string, int radix )
+extern char* utoa( unsigned int value, char *string, int radix )
 {
   return ultoa( value, string, radix ) ;
 }

sparkfun/samd/cores/arduino/USB/USBAPI.h

@@ -26,7 +26,7 @@ extern "C"{
 
 extern char* itoa( int value, char *string, int radix ) ;
 extern char* ltoa( long value, char *string, int radix ) ;
-extern char* utoa( unsigned long value, char *string, int radix ) ;
+extern char* utoa( unsigned int value, char *string, int radix ) ;
 extern char* ultoa( unsigned long value, char *string, int radix ) ;
 
 #ifdef __cplusplus