]> git.sur5r.net Git - freertos/blob - FreeRTOS/Demo/CORTEX_LPC1768_GCC_RedSuite/src/LPCUSB/usbapi.h
Add FreeRTOS-Plus directory.
[freertos] / FreeRTOS / Demo / CORTEX_LPC1768_GCC_RedSuite / src / LPCUSB / usbapi.h
1 /*\r
2         LPCUSB, an USB device driver for LPC microcontrollers   \r
3         Copyright (C) 2006 Bertrik Sikken (bertrik@sikken.nl)\r
4 \r
5         Redistribution and use in source and binary forms, with or without\r
6         modification, are permitted provided that the following conditions are met:\r
7 \r
8         1. Redistributions of source code must retain the above copyright\r
9            notice, this list of conditions and the following disclaimer.\r
10         2. Redistributions in binary form must reproduce the above copyright\r
11            notice, this list of conditions and the following disclaimer in the\r
12            documentation and/or other materials provided with the distribution.\r
13         3. The name of the author may not be used to endorse or promote products\r
14            derived from this software without specific prior written permission.\r
15 \r
16         THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR\r
17         IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES\r
18         OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.\r
19         IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, \r
20         INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT\r
21         NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,\r
22         DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY\r
23         THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT\r
24         (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF\r
25         THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\r
26 */\r
27 \r
28 /**\r
29         @file\r
30 */\r
31 \r
32 #include "usbstruct.h"          // for TSetupPacket\r
33 \r
34 /*************************************************************************\r
35         USB configuration\r
36 **************************************************************************/\r
37 \r
38 #define MAX_PACKET_SIZE0        64              /**< maximum packet size for EP 0 */\r
39 \r
40 /*************************************************************************\r
41         USB hardware interface\r
42 **************************************************************************/\r
43 \r
44 // endpoint status sent through callback\r
45 #define EP_STATUS_DATA          (1<<0)          /**< EP has data */\r
46 #define EP_STATUS_STALLED       (1<<1)          /**< EP is stalled */\r
47 #define EP_STATUS_SETUP         (1<<2)          /**< EP received setup packet */\r
48 #define EP_STATUS_ERROR         (1<<3)          /**< EP data was overwritten by setup packet */\r
49 #define EP_STATUS_NACKED        (1<<4)          /**< EP sent NAK */\r
50 \r
51 // device status sent through callback\r
52 #define DEV_STATUS_CONNECT              (1<<0)  /**< device just got connected */\r
53 #define DEV_STATUS_SUSPEND              (1<<2)  /**< device entered suspend state */\r
54 #define DEV_STATUS_RESET                (1<<4)  /**< device just got reset */\r
55 \r
56 // interrupt bits for NACK events in USBHwNakIntEnable\r
57 // (these bits conveniently coincide with the LPC176x USB controller bit)\r
58 #define INACK_CI                (1<<1)                  /**< interrupt on NACK for control in */\r
59 #define INACK_CO                (1<<2)                  /**< interrupt on NACK for control out */\r
60 #define INACK_II                (1<<3)                  /**< interrupt on NACK for interrupt in */\r
61 #define INACK_IO                (1<<4)                  /**< interrupt on NACK for interrupt out */\r
62 #define INACK_BI                (1<<5)                  /**< interrupt on NACK for bulk in */\r
63 #define INACK_BO                (1<<6)                  /**< interrupt on NACK for bulk out */\r
64 \r
65 BOOL USBHwInit                  (void);\r
66 void USBHwISR                   (void);\r
67 \r
68 void USBHwNakIntEnable  (unsigned char bIntBits);\r
69 \r
70 void USBHwConnect               (BOOL fConnect);\r
71 \r
72 void USBHwSetAddress    (unsigned char bAddr);\r
73 void USBHwConfigDevice  (BOOL fConfigured);\r
74 \r
75 // endpoint operations\r
76 void USBHwEPConfig              (unsigned char bEP, unsigned short wMaxPacketSize);\r
77 int  USBHwEPRead                (unsigned char bEP, unsigned char *pbBuf, int iMaxLen);\r
78 int      USBHwEPWrite           (unsigned char bEP, unsigned char *pbBuf, int iLen);\r
79 void USBHwEPStall               (unsigned char bEP, BOOL fStall);\r
80 unsigned char   USBHwEPGetStatus        (unsigned char bEP);\r
81 \r
82 /** Endpoint interrupt handler callback */\r
83 typedef void (TFnEPIntHandler)  (unsigned char bEP, unsigned char bEPStatus);\r
84 void USBHwRegisterEPIntHandler  (unsigned char bEP, TFnEPIntHandler *pfnHandler);\r
85 \r
86 /** Device status handler callback */\r
87 typedef void (TFnDevIntHandler) (unsigned char bDevStatus);\r
88 void USBHwRegisterDevIntHandler (TFnDevIntHandler *pfnHandler);\r
89 \r
90 /** Frame event handler callback */\r
91 typedef void (TFnFrameHandler)(unsigned short wFrame);\r
92 void USBHwRegisterFrameHandler(TFnFrameHandler *pfnHandler);\r
93 \r
94 \r
95 /*************************************************************************\r
96         USB application interface\r
97 **************************************************************************/\r
98 \r
99 // initialise the complete stack, including HW\r
100 BOOL USBInit(void);\r
101 \r
102 /** Request handler callback (standard, vendor, class) */\r
103 typedef BOOL (TFnHandleRequest)(TSetupPacket *pSetup, int *piLen, unsigned char **ppbData);\r
104 void USBRegisterRequestHandler(int iType, TFnHandleRequest *pfnHandler, unsigned char *pbDataStore);\r
105 void USBRegisterCustomReqHandler(TFnHandleRequest *pfnHandler);\r
106 \r
107 /** Descriptor handler callback */\r
108 typedef BOOL (TFnGetDescriptor)(unsigned short wTypeIndex, unsigned short wLangID, int *piLen, unsigned char **ppbData);\r
109 \r
110 /** Default standard request handler */\r
111 BOOL USBHandleStandardRequest(TSetupPacket *pSetup, int *piLen, unsigned char **ppbData);\r
112 \r
113 /** Default EP0 handler */\r
114 void USBHandleControlTransfer(unsigned char bEP, unsigned char bEPStat);\r
115 \r
116 /** Descriptor handling */\r
117 void USBRegisterDescriptors(const unsigned char *pabDescriptors);\r
118 BOOL USBGetDescriptor(unsigned short wTypeIndex, unsigned short wLangID, int *piLen, unsigned char **ppbData);\r