Add usblib and utils

1 files changed, 261 insertions, 0 deletions

diff --git a/usblib/device/usbdcomp.h b/usblib/device/usbdcomp.h
new file mode 100644
index 0000000..e064193
--- /dev/null
+++ b/usblib/device/usbdcomp.h
@@ -0,0 +1,261 @@
+//*****************************************************************************

+//

+// usbdcomp.h - USB composite device class driver.

+//

+// Copyright (c) 2010-2014 Texas Instruments Incorporated.  All rights reserved.

+// Software License Agreement

+// 

+// Texas Instruments (TI) is supplying this software for use solely and

+// exclusively on TI's microcontroller products. The software is owned by

+// TI and/or its suppliers, and is protected under applicable copyright

+// laws. You may not combine this software with "viral" open-source

+// software in order to form a larger program.

+// 

+// THIS SOFTWARE IS PROVIDED "AS IS" AND WITH ALL FAULTS.

+// NO WARRANTIES, WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT

+// NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR

+// A PARTICULAR PURPOSE APPLY TO THIS SOFTWARE. TI SHALL NOT, UNDER ANY

+// CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL, OR CONSEQUENTIAL

+// DAMAGES, FOR ANY REASON WHATSOEVER.

+// 

+// This is part of revision 2.1.0.12573 of the Tiva USB Library.

+//

+//*****************************************************************************

+

+#ifndef __USBDCOMP_H__

+#define __USBDCOMP_H__

+

+//*****************************************************************************

+//

+// If building with a C++ compiler, make all of the definitions in this header

+// have a C binding.

+//

+//*****************************************************************************

+#ifdef __cplusplus

+extern "C"

+{

+#endif

+

+//*****************************************************************************

+//

+// Return to default packing when using the IAR Embedded Workbench compiler.

+//

+//*****************************************************************************

+#ifdef ewarm

+#pragma pack()

+#endif

+

+//*****************************************************************************

+//

+//! \addtogroup composite_device_class_api

+//! @{

+//

+//*****************************************************************************

+

+//

+// Defines a single entry in a table of device types supported by the composite

+// device.

+//

+typedef struct

+{

+    //

+    // This is set internally by the composite class so it can be left

+    // uninitialized by the application.

+    //

+    const tDeviceInfo *psDeviceInfo;

+

+    //

+    // This should be the header to the configuration header for a class.

+    //

+    const tConfigHeader *psConfigHeader;

+

+    //

+    // The offset to this devices interface, filled in by the composite class.

+    //

+    uint8_t ui8IfaceOffset;

+}

+tUSBDCompositeEntry;

+

+//*****************************************************************************

+//

+// PRIVATE

+//

+// This structure defines the private instance data and state variables for the

+// composite device class.  The memory for this structure is included in

+// the sPrivateData field in the tUSBDCompositeDevice structure passed on

+// USBDCompositeInit() and should not be modified by any code outside of the

+// composite device code.

+//

+//*****************************************************************************

+typedef struct

+{

+    //

+    // Saves which USB controller is in use.

+    //

+    uint32_t ui32USBBase;

+

+    //

+    // The device information pointer.

+    //

+    tDeviceInfo sDevInfo;

+

+    //

+    // This is the configuration descriptor for this instance.

+    //

+    tConfigDescriptor sConfigDescriptor;

+

+    //

+    // This is the device descriptor for this instance.

+    //

+    tDeviceDescriptor sDeviceDescriptor;

+

+    //

+    // The configuration header for this instance.

+    //

+    tConfigHeader sCompConfigHeader;

+

+    //

+    // These are the configuration sections that will be built from the

+    // Configuration Descriptor header and the descriptors from the devices

+    // that are part of this composite device.

+    //

+    tConfigSection psCompSections[2];

+    tConfigSection *ppsCompSections[2];

+

+    //

+    // The size and pointer to the data used by the instance.

+    //

+    uint32_t ui32DataSize;

+    uint8_t *pui8Data;

+

+    //

+    // The current "owner" of endpoint 0.  This is used to track the device

+    // class which is currently transferring data on EP0.

+    //

+    uint32_t ui32EP0Owner;

+}

+tCompositeInstance;

+

+//*****************************************************************************

+//

+//! The structure used by the application to define operating parameters for

+//! the composite device class.

+//

+//*****************************************************************************

+typedef struct

+{

+    //

+    //! The vendor ID that this device is to present in the device descriptor.

+    //

+    const uint16_t ui16VID;

+

+    //

+    //! The product ID that this device is to present in the device descriptor.

+    //

+    const uint16_t ui16PID;

+

+    //

+    //! The maximum power consumption of the device, expressed in mA.

+    //

+    const uint16_t ui16MaxPowermA;

+

+    //

+    //! Indicates whether the device is self or bus-powered and whether or not

+    //! it supports remote wake up.  Valid values are \b USB_CONF_ATTR_SELF_PWR

+    //! or \b USB_CONF_ATTR_BUS_PWR, optionally ORed with

+    //! \b USB_CONF_ATTR_RWAKE.

+    //

+    const uint8_t ui8PwrAttributes;

+

+    //

+    //! A pointer to the callback function which will be called to notify

+    //! the application of events relating to the operation of the composite

+    //! device.

+    //

+    const tUSBCallback pfnCallback;

+

+    //

+    //! A pointer to the string descriptor array for this device.  This array

+    //! must contain the following string descriptor pointers in this order.

+    //! Language descriptor, Manufacturer name string (language 1), Product

+    //! name string (language 1), Serial number string (language 1), Composite

+    //! device interface description string (language 1), Configuration

+    //! description string (language 1).

+    //!

+    //! If supporting more than 1 language, the descriptor block (except for

+    //! string descriptor 0) must be repeated for each language defined in the

+    //! language descriptor.

+    //!

+    //

+    const uint8_t * const *ppui8StringDescriptors;

+

+    //

+    //! The number of descriptors provided in the ppStringDescriptors

+    //! array.  This must be 1 + ((5 + (number of strings)) *

+    //!                           (number of languages)).

+    //

+    const uint32_t ui32NumStringDescriptors;

+

+    //

+    //! The number of devices in the psDevices array.

+    //

+    const uint32_t ui32NumDevices;

+

+    //

+    //! This application supplied array holds the the top level device class

+    //! information as well as the Instance data for that class.

+    //

+    tCompositeEntry * const psDevices;

+

+    //

+    //! The private data for this device instance.  This memory must remain

+    //! accessible for as long as the composite device is in use and must

+    //! not be modified by any code outside the composite class driver.

+    //

+    tCompositeInstance sPrivateData;

+}

+tUSBDCompositeDevice;

+

+//*****************************************************************************

+//

+// Return to default packing when using the IAR Embedded Workbench compiler.

+//

+//*****************************************************************************

+#ifdef ewarm

+#pragma pack()

+#endif

+

+//*****************************************************************************

+//

+// Composite specific device class driver events

+//

+//*****************************************************************************

+

+//*****************************************************************************

+//

+// API Function Prototypes

+//

+//*****************************************************************************

+extern void *USBDCompositeInit(uint32_t ui32Index,

+                               tUSBDCompositeDevice *psCompDevice,

+                               uint32_t ui32Size, uint8_t *pui8Data);

+extern void USBDCompositeTerm(void *pvInstance);

+

+//*****************************************************************************

+//

+// Close the Doxygen group.

+//! @}

+//

+//*****************************************************************************

+

+//*****************************************************************************

+//

+// Mark the end of the C bindings section for C++ compilers.

+//

+//*****************************************************************************

+#ifdef __cplusplus

+}

+#endif

+

+#endif

+