Ad van der Weiden / myUSBHost

Almost identical to USBHostShell; reads all endpoint descriptors

Dependents:   myBlueUSB mbed_TANK_Kinect myBlueUSB_ros myBlueUSB_localfix

USBHost.h@3:58c785c2b381, 2011-07-01 (annotated)

Committer:
networker
Date:
Fri Jul 01 09:13:39 2011 +0000
Revision:
3:58c785c2b381
Parent:
0:d6bff1c2dab1 
revised massStorage to cope with different endpoint addresses

Who changed what in which revision?

UserRevisionLine numberNew contents of line
networker 0:d6bff1c2dab1 1
networker 0:d6bff1c2dab1 2 /*
networker 0:d6bff1c2dab1 3 Copyright (c) 2010 Peter Barrett
networker 0:d6bff1c2dab1 4
networker 0:d6bff1c2dab1 5 Permission is hereby granted, free of charge, to any person obtaining a copy
networker 0:d6bff1c2dab1 6 of this software and associated documentation files (the "Software"), to deal
networker 0:d6bff1c2dab1 7 in the Software without restriction, including without limitation the rights
networker 0:d6bff1c2dab1 8 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
networker 0:d6bff1c2dab1 9 copies of the Software, and to permit persons to whom the Software is
networker 0:d6bff1c2dab1 10 furnished to do so, subject to the following conditions:
networker 0:d6bff1c2dab1 11
networker 0:d6bff1c2dab1 12 The above copyright notice and this permission notice shall be included in
networker 0:d6bff1c2dab1 13 all copies or substantial portions of the Software.
networker 0:d6bff1c2dab1 14
networker 0:d6bff1c2dab1 15 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
networker 0:d6bff1c2dab1 16 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
networker 0:d6bff1c2dab1 17 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
networker 0:d6bff1c2dab1 18 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
networker 0:d6bff1c2dab1 19 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
networker 0:d6bff1c2dab1 20 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
networker 0:d6bff1c2dab1 21 THE SOFTWARE.
networker 0:d6bff1c2dab1 22 */
networker 0:d6bff1c2dab1 23
networker 0:d6bff1c2dab1 24 #ifndef USBHOST_H
networker 0:d6bff1c2dab1 25 #define USBHOST_H
networker 0:d6bff1c2dab1 26
networker 0:d6bff1c2dab1 27 #ifndef u8
networker 0:d6bff1c2dab1 28 typedef unsigned char u8;
networker 0:d6bff1c2dab1 29 typedef unsigned short u16;
networker 0:d6bff1c2dab1 30 typedef unsigned long u32;
networker 0:d6bff1c2dab1 31
networker 0:d6bff1c2dab1 32 typedef char s8;
networker 0:d6bff1c2dab1 33 typedef short s16;
networker 0:d6bff1c2dab1 34 typedef char s32;
networker 0:d6bff1c2dab1 35 #endif
networker 0:d6bff1c2dab1 36
networker 0:d6bff1c2dab1 37 #define ENDPOINT_CONTROL 0
networker 0:d6bff1c2dab1 38 #define ENDPOINT_ISOCRONOUS 1
networker 0:d6bff1c2dab1 39 #define ENDPOINT_BULK 2
networker 0:d6bff1c2dab1 40 #define ENDPOINT_INTERRUPT 3
networker 0:d6bff1c2dab1 41
networker 0:d6bff1c2dab1 42 #define DESCRIPTOR_TYPE_DEVICE 1
networker 0:d6bff1c2dab1 43 #define DESCRIPTOR_TYPE_CONFIGURATION 2
networker 0:d6bff1c2dab1 44 #define DESCRIPTOR_TYPE_STRING 3
networker 0:d6bff1c2dab1 45 #define DESCRIPTOR_TYPE_INTERFACE 4
networker 0:d6bff1c2dab1 46 #define DESCRIPTOR_TYPE_ENDPOINT 5
networker 0:d6bff1c2dab1 47
networker 0:d6bff1c2dab1 48 #define DESCRIPTOR_TYPE_HID 0x21
networker 0:d6bff1c2dab1 49 #define DESCRIPTOR_TYPE_REPORT 0x22
networker 0:d6bff1c2dab1 50 #define DESCRIPTOR_TYPE_PHYSICAL 0x23
networker 0:d6bff1c2dab1 51 #define DESCRIPTOR_TYPE_HUB 0x29
networker 0:d6bff1c2dab1 52
networker 0:d6bff1c2dab1 53 enum USB_CLASS_CODE
networker 0:d6bff1c2dab1 54 {
networker 0:d6bff1c2dab1 55 CLASS_DEVICE,
networker 0:d6bff1c2dab1 56 CLASS_AUDIO,
networker 0:d6bff1c2dab1 57 CLASS_COMM_AND_CDC_CONTROL,
networker 0:d6bff1c2dab1 58 CLASS_HID,
networker 0:d6bff1c2dab1 59 CLASS_PHYSICAL = 0x05,
networker 0:d6bff1c2dab1 60 CLASS_STILL_IMAGING,
networker 0:d6bff1c2dab1 61 CLASS_PRINTER,
networker 0:d6bff1c2dab1 62 CLASS_MASS_STORAGE,
networker 0:d6bff1c2dab1 63 CLASS_HUB,
networker 0:d6bff1c2dab1 64 CLASS_CDC_DATA,
networker 0:d6bff1c2dab1 65 CLASS_SMART_CARD,
networker 0:d6bff1c2dab1 66 CLASS_CONTENT_SECURITY = 0x0D,
networker 0:d6bff1c2dab1 67 CLASS_VIDEO = 0x0E,
networker 0:d6bff1c2dab1 68 CLASS_DIAGNOSTIC_DEVICE = 0xDC,
networker 0:d6bff1c2dab1 69 CLASS_WIRELESS_CONTROLLER = 0xE0,
networker 0:d6bff1c2dab1 70 CLASS_MISCELLANEOUS = 0xEF,
networker 0:d6bff1c2dab1 71 CLASS_APP_SPECIFIC = 0xFE,
networker 0:d6bff1c2dab1 72 CLASS_VENDOR_SPECIFIC = 0xFF
networker 0:d6bff1c2dab1 73 };
networker 0:d6bff1c2dab1 74
networker 0:d6bff1c2dab1 75 #define DEVICE_TO_HOST 0x80
networker 0:d6bff1c2dab1 76 #define HOST_TO_DEVICE 0x00
networker 0:d6bff1c2dab1 77 #define REQUEST_TYPE_CLASS 0x20
networker 0:d6bff1c2dab1 78 #define RECIPIENT_DEVICE 0x00
networker 0:d6bff1c2dab1 79 #define RECIPIENT_INTERFACE 0x01
networker 0:d6bff1c2dab1 80 #define RECIPIENT_ENDPOINT 0x02
networker 0:d6bff1c2dab1 81 #define RECIPIENT_OTHER 0x03
networker 0:d6bff1c2dab1 82
networker 0:d6bff1c2dab1 83 #define GET_STATUS 0
networker 0:d6bff1c2dab1 84 #define CLEAR_FEATURE 1
networker 0:d6bff1c2dab1 85 #define SET_FEATURE 3
networker 0:d6bff1c2dab1 86 #define SET_ADDRESS 5
networker 0:d6bff1c2dab1 87 #define GET_DESCRIPTOR 6
networker 0:d6bff1c2dab1 88 #define SET_DESCRIPTOR 7
networker 0:d6bff1c2dab1 89 #define GET_CONFIGURATION 8
networker 0:d6bff1c2dab1 90 #define SET_CONFIGURATION 9
networker 0:d6bff1c2dab1 91 #define GET_INTERFACE 10
networker 0:d6bff1c2dab1 92 #define SET_INTERFACE 11
networker 0:d6bff1c2dab1 93 #define SYNCH_FRAME 11
networker 0:d6bff1c2dab1 94
networker 0:d6bff1c2dab1 95 // -5 is nak
networker 0:d6bff1c2dab1 96 /*
networker 0:d6bff1c2dab1 97 0010 ACK Handshake
networker 0:d6bff1c2dab1 98 1010 NAK Handshake
networker 0:d6bff1c2dab1 99 1110 STALL Handshake
networker 0:d6bff1c2dab1 100 0110 NYET (No Response Yet)
networker 0:d6bff1c2dab1 101 */
networker 0:d6bff1c2dab1 102
networker 0:d6bff1c2dab1 103 #define IO_PENDING -100
networker 0:d6bff1c2dab1 104 #define ERR_ENDPOINT_NONE_LEFT -101
networker 0:d6bff1c2dab1 105 #define ERR_ENDPOINT_NOT_FOUND -102
networker 0:d6bff1c2dab1 106 #define ERR_DEVICE_NOT_FOUND -103
networker 0:d6bff1c2dab1 107 #define ERR_DEVICE_NONE_LEFT -104
networker 0:d6bff1c2dab1 108 #define ERR_HUB_INIT_FAILED -105
networker 0:d6bff1c2dab1 109 #define ERR_INTERFACE_NOT_FOUND -106
networker 0:d6bff1c2dab1 110
networker 0:d6bff1c2dab1 111 typedef struct
networker 0:d6bff1c2dab1 112 {
networker 0:d6bff1c2dab1 113 u8 bLength;
networker 0:d6bff1c2dab1 114 u8 bDescriptorType;
networker 0:d6bff1c2dab1 115 u16 bcdUSB;
networker 0:d6bff1c2dab1 116 u8 bDeviceClass;
networker 0:d6bff1c2dab1 117 u8 bDeviceSubClass;
networker 0:d6bff1c2dab1 118 u8 bDeviceProtocol;
networker 0:d6bff1c2dab1 119 u8 bMaxPacketSize;
networker 0:d6bff1c2dab1 120 u16 idVendor;
networker 0:d6bff1c2dab1 121 u16 idProduct;
networker 0:d6bff1c2dab1 122 u16 bcdDevice; // version
networker 0:d6bff1c2dab1 123 u8 iManufacturer;
networker 0:d6bff1c2dab1 124 u8 iProduct;
networker 0:d6bff1c2dab1 125 u8 iSerialNumber;
networker 0:d6bff1c2dab1 126 u8 bNumConfigurations;
networker 0:d6bff1c2dab1 127 } DeviceDescriptor; // 16 bytes
networker 0:d6bff1c2dab1 128
networker 0:d6bff1c2dab1 129 typedef struct
networker 0:d6bff1c2dab1 130 {
networker 0:d6bff1c2dab1 131 u8 bLength;
networker 0:d6bff1c2dab1 132 u8 bDescriptorType;
networker 0:d6bff1c2dab1 133 u16 wTotalLength;
networker 0:d6bff1c2dab1 134 u8 bNumInterfaces;
networker 0:d6bff1c2dab1 135 u8 bConfigurationValue; // Value to use as an argument to select this configuration
networker 0:d6bff1c2dab1 136 u8 iConfiguration; // Index of String Descriptor describing this configuration
networker 0:d6bff1c2dab1 137 u8 bmAttributes; // Bitmap D7 Reserved, set to 1. (USB 1.0 Bus Powered),D6 Self Powered,D5 Remote Wakeup,D4..0 = 0
networker 0:d6bff1c2dab1 138 u8 bMaxPower; // Maximum Power Consumption in 2mA units
networker 0:d6bff1c2dab1 139 } ConfigurationDescriptor;
networker 0:d6bff1c2dab1 140
networker 0:d6bff1c2dab1 141 typedef struct
networker 0:d6bff1c2dab1 142 {
networker 0:d6bff1c2dab1 143 u8 bLength;
networker 0:d6bff1c2dab1 144 u8 bDescriptorType;
networker 0:d6bff1c2dab1 145 u8 bInterfaceNumber;
networker 0:d6bff1c2dab1 146 u8 bAlternateSetting;
networker 0:d6bff1c2dab1 147 u8 bNumEndpoints;
networker 0:d6bff1c2dab1 148 u8 bInterfaceClass;
networker 0:d6bff1c2dab1 149 u8 bInterfaceSubClass;
networker 0:d6bff1c2dab1 150 u8 bInterfaceProtocol;
networker 0:d6bff1c2dab1 151 u8 iInterface; // Index of String Descriptor Describing this interface
networker 0:d6bff1c2dab1 152 } InterfaceDescriptor;
networker 0:d6bff1c2dab1 153
networker 0:d6bff1c2dab1 154 typedef struct
networker 0:d6bff1c2dab1 155 {
networker 0:d6bff1c2dab1 156 u8 bLength;
networker 0:d6bff1c2dab1 157 u8 bDescriptorType;
networker 0:d6bff1c2dab1 158 u8 bEndpointAddress; // Bits 0:3 endpoint, Bits 7 Direction 0 = Out, 1 = In (Ignored for Control Endpoints)
networker 0:d6bff1c2dab1 159 u8 bmAttributes; // Bits 0:1 00 = Control, 01 = Isochronous, 10 = Bulk, 11 = Interrupt
networker 0:d6bff1c2dab1 160 u16 wMaxPacketSize;
networker 0:d6bff1c2dab1 161 u8 bInterval; // Interval for polling endpoint data transfers.
networker 0:d6bff1c2dab1 162 } EndpointDescriptor;
networker 0:d6bff1c2dab1 163
networker 0:d6bff1c2dab1 164 typedef struct {
networker 0:d6bff1c2dab1 165 u8 bLength;
networker 0:d6bff1c2dab1 166 u8 bDescriptorType;
networker 0:d6bff1c2dab1 167 u16 bcdHID;
networker 0:d6bff1c2dab1 168 u8 bCountryCode;
networker 0:d6bff1c2dab1 169 u8 bNumDescriptors;
networker 0:d6bff1c2dab1 170 u8 bDescriptorType2;
networker 0:d6bff1c2dab1 171 u16 wDescriptorLength;
networker 0:d6bff1c2dab1 172 } HIDDescriptor;
networker 0:d6bff1c2dab1 173
networker 0:d6bff1c2dab1 174 //============================================================================
networker 0:d6bff1c2dab1 175 //============================================================================
networker 0:d6bff1c2dab1 176
networker 0:d6bff1c2dab1 177
networker 0:d6bff1c2dab1 178 void USBInit();
networker 0:d6bff1c2dab1 179 void USBLoop();
networker 0:d6bff1c2dab1 180 u8* USBGetBuffer(u32* len);
networker 0:d6bff1c2dab1 181
networker 0:d6bff1c2dab1 182 // Optional callback for transfers, called at interrupt time
networker 0:d6bff1c2dab1 183 typedef void (*USBCallback)(int device, int endpoint, int status, u8* data, int len, void* userData);
networker 0:d6bff1c2dab1 184
networker 0:d6bff1c2dab1 185 // Transfers
networker 0:d6bff1c2dab1 186 int USBControlTransfer(int device, int request_type, int request, int value, int index, u8* data, int length, USBCallback callback = 0, void* userData = 0);
networker 0:d6bff1c2dab1 187 int USBInterruptTransfer(int device, int ep, u8* data, int length, USBCallback callback = 0, void* userData = 0);
networker 0:d6bff1c2dab1 188 int USBBulkTransfer(int device, int ep, u8* data, int length, USBCallback callback = 0, void* userData = 0);
networker 0:d6bff1c2dab1 189
networker 0:d6bff1c2dab1 190 // Standard Device methods
networker 0:d6bff1c2dab1 191 int GetDescriptor(int device, int descType, int descIndex, u8* data, int length);
networker 0:d6bff1c2dab1 192 int GetString(int device, int index, char* dst, int length);
networker 0:d6bff1c2dab1 193 int SetAddress(int device, int new_addr);
networker 0:d6bff1c2dab1 194 int SetConfiguration(int device, int configNum);
networker 0:d6bff1c2dab1 195 int SetInterface(int device, int ifNum, int altNum);
networker 0:d6bff1c2dab1 196
networker 0:d6bff1c2dab1 197 // Implemented to notify app of the arrival of a device
networker 0:d6bff1c2dab1 198 void OnLoadDevice(int device, DeviceDescriptor* deviceDesc, InterfaceDescriptor* interfaceDesc);
networker 0:d6bff1c2dab1 199
networker 0:d6bff1c2dab1 200 #endif