Merging in changes from 2016-04-27 release:

* Removed requirement to implement system_config.h for USB. Stack now only uses usb_config.h for configuration.
* USBInitialize() and USBTasks() removed. Use USBDeviceTasks()/USBHostTasks() or USBHostInit()/USBDeviceInit() as required.
* Fixed dereferencing type-punned pointer will break strict-aliasing warning on full optimization.
* Added MSDTransferTerminated() function.
* Added error checking for NULL data handler
* Added return for case in USBHostDeviceStatus() for when the device state variable was invalid value.
* Fixed error when parsing HID descriptors resulting in invalid errors reported on well formed HID report descriptors.
* Added support for the PIC24FJ1024GB610 family devices.

Author: davidflowers

doc/help_mla_usb.jar

@@ -42,8 +42,7 @@ please contact [email protected]
 #ifndef _USB_H_
 #define _USB_H_
 
-#include "system.h"
-#include "system_config.h"          // Must be defined by the application
+#include "usb_config.h"
 
 #include "usb_common.h"         // Common USB library definitions
 #include "usb_ch9.h"            // USB device framework definitions

doc/help_mla_usb.pdf

@@ -47,9 +47,6 @@ please contact [email protected]
 #include <stdbool.h>
 #include <stdint.h>
 
-#include "system.h"
-#include "system_config.h"
-
 // *****************************************************************************
 // *****************************************************************************
 // Section: USB Constants
@@ -465,108 +462,6 @@ stalled (ie. bit 0 = EP0, bit 1 = EP1, etc.)
 
 typedef bool (*USB_EVENT_HANDLER) ( USB_EVENT event, void *data, unsigned int size );
 
-
-// *****************************************************************************
-// *****************************************************************************
-// Section: USB Application Program Interface (API) Routines
-// *****************************************************************************
-// *****************************************************************************
-
-/****************************************************************************
-    Function:
-        bool USBInitialize ( unsigned long flags )
-
-    Summary:
-        This interface initializes the variables of the USB host stack.
-
-    Description:
-        This interface initializes the USB stack.
-
-    Precondition:
-        None
-
-    Parameters:
-        flags - reserved
-
-    Return Values:
-        true  - Initialization successful
-        false - Initialization failure
-
-    Remarks:
-        This interface is implemented as a macro that can be defined by the
-        application or by default is defined correctly for the stack mode.
-        
-  ***************************************************************************/
-
-#ifndef USBInitialize   
-    #if defined( USB_SUPPORT_DEVICE )
-        #if defined( USB_SUPPORT_HOST )
-            #if defined( USB_SUPPORT_OTG )
-                #error "USB OTG is not yet supported."
-            #else
-                #define USBInitialize(f) \
-                        (USBDEVInitialize(f) && USBHostInit(f)) ? \
-                        true : false
-            #endif
-        #else
-            #define USBInitialize(f) USBDeviceInit()
-        #endif
-    #else
-        #if defined( USB_SUPPORT_HOST )
-            #define USBInitialize(f) USBHostInit(f)
-        #else
-            #error "Application must define support mode in usb_config.h"
-        #endif
-    #endif
-#endif
-
-
-/****************************************************************************
-    Function:
-        void USBTasks( void )
-
-    Summary:
-        This function executes the tasks for USB operation.
-
-    Description:
-        This function executes the tasks for USB host operation.  It must be
-        executed on a regular basis to keep everything functioning.
-
-    Precondition:
-        USBInitialize() has been called.
-
-    Parameters:
-        None
-
-    Returns:
-        None
-
-    Remarks:
-        This interface is implemented as a macro that can be defined by the
-        application or by default is defined correctly for the stack mode.
-        
-  ***************************************************************************/
-
-#ifndef USBTasks    // Implemented as a macro that can be overridden.
-    #if defined( USB_SUPPORT_DEVICE )
-        #if defined( USB_SUPPORT_HOST )
-            #if defined( USB_SUPPORT_OTG )
-                #error "USB OTG is not yet supported."
-            #else
-                #define USBTasks() {USBHostTasks(); USBHALHandleBusEvent();}
-            #endif
-        #else
-            #define USBTasks() USBDeviceTasks()
-        #endif
-    #else
-        #if defined( USB_SUPPORT_HOST )
-            #define USBTasks() USBHostTasks()
-        #else
-            #error "Application must define support mode in usb_config.h"
-        #endif
-    #endif
-#endif
-
 #define USB_PING_PONG__NO_PING_PONG         0x00    //0b00
 #define USB_PING_PONG__EP0_OUT_ONLY         0x01    //0b01
 #define USB_PING_PONG__FULL_PING_PONG       0x02    //0b10

inc/usb.h

@@ -38,9 +38,10 @@ please contact [email protected]
 #ifndef _USB_DEVICE_H
 #define _USB_DEVICE_H
 
-#include "usb_common.h"
 #include <stdint.h>
 
+#include "usb_common.h"
+#include "usb_config.h"
 
 #if defined(__XC8)
     #define __attribute__(a)
@@ -2040,14 +2041,6 @@ typedef struct __attribute__ ((packed))
     CTRL_TRF_RETURN (*pFunc)(CTRL_TRF_PARAMS);
 }OUT_PIPE;
 
-/************* DWF - SHOULD BE REIMPLEMENTED AS AN EVENT *******************/
-//#if defined(ENABLE_EP0_DATA_RECEIVED_CALLBACK)
-//    void USBCBEP0DataReceived(void);
-//    #define USBCB_EP0_DATA_RECEIVED() USBCBEP0DataReceived()
-//#else
-//    #define USBCB_EP0_DATA_RECEIVED()
-//#endif
-
 extern USB_VOLATILE bool RemoteWakeup;
 extern USB_VOLATILE bool USBBusIsSuspended;
 extern USB_VOLATILE USB_DEVICE_STATE USBDeviceState;

inc/usb_common.h

@@ -519,8 +519,6 @@ typedef struct
 } LUN_FUNCTIONS;
 
 /** Section: Externs *********************************************************/
-extern USB_HANDLE USBMSDOutHandle;  
-extern USB_HANDLE USBMSDInHandle;
 extern volatile USB_MSD_CBW msd_cbw;
 extern volatile USB_MSD_CSW msd_csw;
 extern volatile char msd_buffer[512];
@@ -618,7 +616,33 @@ void USBMSDInit(void);
   **************************************************************************/
 #define LUNSoftAttach(LUN) SoftDetach[LUN]=false;
 
-
+/******************************************************************************
+ 	Function:
+ 		void MSDTransferTerminated(USB_HANDLE handle)
+ 		
+ 	Description:
+        Check if the host recently did a clear endpoint halt on the MSD OUT endpoint.
+        In this case, we want to re-arm the MSD OUT endpoint, so we are prepared
+        to receive the next CBW that the host might want to send.
+        Note: If however the STALL was due to a CBW not valid condition,
+        then we are required to have a persistent STALL, where it cannot
+        be cleared (until MSD reset recovery takes place).  See MSD BOT
+        specs v1.0, section 6.6.1.
+ 	PreCondition:
+        A transfer was terminated.  This should be called from the transfer
+        terminated event handler.
+ 		
+ 	Parameters:
+        USB_HANDLE handle - the handle of the transfer that was terminated.
+
+ 	Return Values:
+ 		None
+ 		
+ 	Remarks:
+ 		None
+ 			
+  *****************************************************************************/
+void MSDTransferTerminated(USB_HANDLE handle);
 
 
 #endif

inc/usb_device.h

@@ -28,7 +28,7 @@ please contact [email protected]
 /*****************************************************************************/
 
 #include "system.h"
-#include "system_config.h"
+#include "usb_config.h"
 
 #include <stdint.h>
 #include <string.h>

inc/usb_device_msd.h

@@ -26,12 +26,13 @@ please contact [email protected]
 /****** include files ********************************************************/
 /*****************************************************************************/
 
+#include <xc.h>
+
 #include <stdint.h>
 #include <stdbool.h>
 #include <string.h>
-#include <system.h>
 
-#include "system_config.h"
+#include "usb_config.h"
 
 #ifdef __cplusplus  // Provide C++ Compatability
     extern "C" {

inc/usb_hal_dspic33e.h

@@ -47,8 +47,7 @@ please contact [email protected]
 
 #include <string.h>
 
-#include "system.h"
-#include "system_config.h"
+#include "usb_config.h"
 
 #ifdef __cplusplus  // Provide C++ Compatability
     extern "C" {

inc/usb_hal_pic16f1.h

@@ -26,8 +26,8 @@ please contact [email protected]
 /****** include files ********************************************************/
 /*****************************************************************************/
 
-#include "system.h"
-#include "system_config.h"
+#include <xc.h>
+#include "usb_config.h"
 
 #include <stdint.h>
 #include <string.h>