96 lines
3.6 KiB
C
96 lines
3.6 KiB
C
/**
|
|
(c) 2006, Bertrik Sikken, bertrik@sikken.nl
|
|
|
|
@file
|
|
*/
|
|
|
|
|
|
#include "type.h"
|
|
#include "usbstruct.h" // for TSetupPacket
|
|
|
|
/*************************************************************************
|
|
USB configuration
|
|
**************************************************************************/
|
|
|
|
#define MAX_PACKET_SIZE0 64 /**< maximum packet size for EP 0 */
|
|
|
|
/*************************************************************************
|
|
USB hardware interface
|
|
**************************************************************************/
|
|
|
|
// endpoint status sent through callback
|
|
#define EP_STATUS_DATA (1<<0) /**< EP has data */
|
|
#define EP_STATUS_STALLED (1<<1) /**< EP is stalled */
|
|
#define EP_STATUS_SETUP (1<<2) /**< EP received setup packet */
|
|
#define EP_STATUS_NACKED (1<<3) /**< EP sent NAK */
|
|
#define EP_STATUS_ERROR (1<<4) /**< EP data was overwritten by setup packet */
|
|
|
|
// device status sent through callback
|
|
#define DEV_STATUS_CONNECT (1<<0) /**< device just got connected */
|
|
#define DEV_STATUS_SUSPEND (1<<2) /**< device entered suspend state */
|
|
#define DEV_STATUS_RESET (1<<4) /**< device just got reset */
|
|
|
|
// interrupt bits for NACK events in USBHwNakIntEnable
|
|
// (these bits conveniently coincide with the LPC214x USB controller bit)
|
|
#define INACK_CI (1<<1) /**< interrupt on NACK for control in */
|
|
#define INACK_CO (1<<2) /**< interrupt on NACK for control out */
|
|
#define INACK_II (1<<3) /**< interrupt on NACK for interrupt in */
|
|
#define INACK_IO (1<<4) /**< interrupt on NACK for interrupt out */
|
|
#define INACK_BI (1<<5) /**< interrupt on NACK for bulk in */
|
|
#define INACK_BO (1<<6) /**< interrupt on NACK for bulk out */
|
|
|
|
BOOL USBHwInit (void);
|
|
void USBHwISR (void);
|
|
|
|
void USBHwNakIntEnable (U8 bIntBits);
|
|
|
|
void USBHwConnect (BOOL fConnect);
|
|
|
|
void USBHwSetAddress (U8 bAddr);
|
|
void USBHwConfigDevice (BOOL fConfigured);
|
|
|
|
// endpoint operations
|
|
void USBHwEPConfig (U8 bEP, U16 wMaxPacketSize);
|
|
int USBHwEPRead (U8 bEP, U8 *pbBuf, int iMaxLen);
|
|
int USBHwEPWrite (U8 bEP, U8 *pbBuf, int iLen);
|
|
void USBHwEPStall (U8 bEP, BOOL fStall);
|
|
BOOL USBHwEPIsStalled (U8 bEP);
|
|
|
|
/** Endpoint interrupt handler callback */
|
|
typedef void (TFnEPIntHandler) (U8 bEP, U8 bEPStatus);
|
|
void USBHwRegisterEPIntHandler (U8 bEP, TFnEPIntHandler *pfnHandler);
|
|
|
|
/** Device status handler callback */
|
|
typedef void (TFnDevIntHandler) (U8 bDevStatus);
|
|
void USBHwRegisterDevIntHandler (TFnDevIntHandler *pfnHandler);
|
|
|
|
/** Frame event handler callback */
|
|
typedef void (TFnFrameHandler)(U16 wFrame);
|
|
void USBHwRegisterFrameHandler(TFnFrameHandler *pfnHandler);
|
|
|
|
|
|
/*************************************************************************
|
|
USB application interface
|
|
**************************************************************************/
|
|
|
|
// initialise the complete stack, including HW
|
|
BOOL USBInit(void);
|
|
|
|
/** Request handler callback (standard, vendor, class) */
|
|
typedef BOOL (TFnHandleRequest)(TSetupPacket *pSetup, int *piLen, U8 **ppbData);
|
|
void USBRegisterRequestHandler(int iType, TFnHandleRequest *pfnHandler, U8 *pbDataStore);
|
|
void USBRegisterCustomReqHandler(TFnHandleRequest *pfnHandler);
|
|
|
|
/** Descriptor handler callback */
|
|
typedef BOOL (TFnGetDescriptor)(U16 wTypeIndex, U16 wLangID, int *piLen, U8 **ppbData);
|
|
|
|
/** Default standard request handler */
|
|
BOOL USBHandleStandardRequest(TSetupPacket *pSetup, int *piLen, U8 **ppbData);
|
|
|
|
/** Default EP0 handler */
|
|
void USBHandleControlTransfer(U8 bEP, U8 bEPStat);
|
|
|
|
/** Descriptor handling */
|
|
void USBRegisterDescriptors(const U8 *pabDescriptors);
|
|
BOOL USBGetDescriptor(U16 wTypeIndex, U16 wLangID, int *piLen, U8 **ppbData);
|