Christian Burri / Mbed 2 deprecated autonomousRobotAndroid

This program is for an autonomous robot for the competition at the Hochschule Luzern. We are one of the 32 teams. <a href="http://cruisingcrepe.wordpress.com/">http://cruisingcrepe.wordpress.com/</a> The postition control is based on this Documentation: Control of Wheeled Mobile Robots: An Experimental Overview from Alessandro De Luca, Giuseppe Oriolo, Marilena Vendittelli. For more information see here: <a href="http://www.dis.uniroma1.it/~labrob/pub/papers/Ramsete01.pdf">http://www.dis.uniroma1.it/~labrob/pub/papers/Ramsete01.pdf</a>

Dependencies:   mbed

Fork of autonomousRobotAndroid by Christian Burri

MicroBridge/USBHost/USBHost.h@17:f0a973f17917, 2013-05-03 (annotated)

Committer:
chrigelburri
Date:
Fri May 03 06:30:46 2013 +0000
Revision:
17:f0a973f17917
bastel mit adb

Who changed what in which revision?

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