mbed official / USBHost

USBHost library. NOTE: This library is only officially supported on the LPC1768 platform. For more information, please see the handbook page.

Dependencies:   FATFileSystem mbed-rtos

Dependents:   BTstack WallbotWii SD to Flash Data Transfer USBHost-MSD_HelloWorld ... more

Legacy Warning

This is an mbed 2 library. To learn more about mbed OS 5, visit the docs.

Pull requests against this repository are no longer supported. Please raise against mbed OS 5 as documented above.

USBHost/USBHost.h@40:7c3b59bb364e, 2017-08-17 (annotated)

Committer:
Anna Bridge
Date:
Thu Aug 17 18:12:22 2017 +0100
Revision:
40:7c3b59bb364e
Parent:
37:f1e388e7b752 
DISCO_L475VG_IOT01A: Add support of USBHost

Who changed what in which revision?

UserRevisionLine numberNew contents of line
samux 8:93da8ea2708b 1 /* mbed USBHost Library
samux 8:93da8ea2708b 2 * Copyright (c) 2006-2013 ARM Limited
samux 8:93da8ea2708b 3 *
samux 8:93da8ea2708b 4 * Licensed under the Apache License, Version 2.0 (the "License");
samux 8:93da8ea2708b 5 * you may not use this file except in compliance with the License.
samux 8:93da8ea2708b 6 * You may obtain a copy of the License at
samux 8:93da8ea2708b 7 *
samux 8:93da8ea2708b 8 * http://www.apache.org/licenses/LICENSE-2.0
samux 8:93da8ea2708b 9 *
samux 8:93da8ea2708b 10 * Unless required by applicable law or agreed to in writing, software
samux 8:93da8ea2708b 11 * distributed under the License is distributed on an "AS IS" BASIS,
samux 8:93da8ea2708b 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
samux 8:93da8ea2708b 13 * See the License for the specific language governing permissions and
samux 8:93da8ea2708b 14 * limitations under the License.
samux 8:93da8ea2708b 15 */
mbed_official 0:a554658735bf 16
mbed_official 0:a554658735bf 17 #ifndef USBHOST_H
mbed_official 0:a554658735bf 18 #define USBHOST_H
Kojto 37:f1e388e7b752 19 #ifdef TARGET_STM
Kojto 37:f1e388e7b752 20 #include "mbed.h"
Kojto 37:f1e388e7b752 21 #endif
mbed_official 0:a554658735bf 22 #include "USBHALHost.h"
mbed_official 0:a554658735bf 23 #include "USBDeviceConnected.h"
mbed_official 0:a554658735bf 24 #include "IUSBEnumerator.h"
mbed_official 0:a554658735bf 25 #include "USBHostConf.h"
mbed_official 0:a554658735bf 26 #include "rtos.h"
mbed_official 0:a554658735bf 27 #include "dbg.h"
mbed_official 0:a554658735bf 28 #include "USBHostHub.h"
mbed_official 0:a554658735bf 29
samux 8:93da8ea2708b 30 /**
samux 8:93da8ea2708b 31 * USBHost class
samux 8:93da8ea2708b 32 * This class is a singleton. All drivers have a reference on the static USBHost instance
samux 8:93da8ea2708b 33 */
mbed_official 0:a554658735bf 34 class USBHost : public USBHALHost {
mbed_official 0:a554658735bf 35 public:
mbed_official 0:a554658735bf 36 /**
mbed_official 0:a554658735bf 37 * Static method to create or retrieve the single USBHost instance
mbed_official 0:a554658735bf 38 */
mbed_official 0:a554658735bf 39 static USBHost * getHostInst();
mbed_official 24:868cbfe611a7 40
mbed_official 0:a554658735bf 41 /**
mbed_official 0:a554658735bf 42 * Control read: setup stage, data stage and status stage
mbed_official 0:a554658735bf 43 *
mbed_official 0:a554658735bf 44 * @param dev the control read will be done for this device
mbed_official 0:a554658735bf 45 * @param requestType request type
mbed_official 0:a554658735bf 46 * @param request request
mbed_official 0:a554658735bf 47 * @param value value
mbed_official 0:a554658735bf 48 * @param index index
mbed_official 0:a554658735bf 49 * @param buf pointer on a buffer where will be store the data received
mbed_official 0:a554658735bf 50 * @param len length of the transfer
mbed_official 0:a554658735bf 51 *
mbed_official 0:a554658735bf 52 * @returns status of the control read
mbed_official 0:a554658735bf 53 */
mbed_official 0:a554658735bf 54 USB_TYPE controlRead(USBDeviceConnected * dev, uint8_t requestType, uint8_t request, uint32_t value, uint32_t index, uint8_t * buf, uint32_t len);
mbed_official 0:a554658735bf 55
mbed_official 0:a554658735bf 56 /**
mbed_official 0:a554658735bf 57 * Control write: setup stage, data stage and status stage
mbed_official 0:a554658735bf 58 *
mbed_official 0:a554658735bf 59 * @param dev the control write will be done for this device
mbed_official 0:a554658735bf 60 * @param requestType request type
mbed_official 0:a554658735bf 61 * @param request request
mbed_official 0:a554658735bf 62 * @param value value
mbed_official 0:a554658735bf 63 * @param index index
mbed_official 0:a554658735bf 64 * @param buf pointer on a buffer which will be written
mbed_official 0:a554658735bf 65 * @param len length of the transfer
mbed_official 0:a554658735bf 66 *
mbed_official 0:a554658735bf 67 * @returns status of the control write
mbed_official 0:a554658735bf 68 */
mbed_official 0:a554658735bf 69 USB_TYPE controlWrite(USBDeviceConnected * dev, uint8_t requestType, uint8_t request, uint32_t value, uint32_t index, uint8_t * buf, uint32_t len);
mbed_official 0:a554658735bf 70
mbed_official 0:a554658735bf 71 /**
mbed_official 0:a554658735bf 72 * Bulk read
mbed_official 0:a554658735bf 73 *
mbed_official 0:a554658735bf 74 * @param dev the bulk transfer will be done for this device
mbed_official 0:a554658735bf 75 * @param ep USBEndpoint which will be used to read a packet
mbed_official 0:a554658735bf 76 * @param buf pointer on a buffer where will be store the data received
mbed_official 0:a554658735bf 77 * @param len length of the transfer
mbed_official 0:a554658735bf 78 * @param blocking if true, the read is blocking (wait for completion)
mbed_official 0:a554658735bf 79 *
mbed_official 0:a554658735bf 80 * @returns status of the bulk read
mbed_official 0:a554658735bf 81 */
mbed_official 0:a554658735bf 82 USB_TYPE bulkRead(USBDeviceConnected * dev, USBEndpoint * ep, uint8_t * buf, uint32_t len, bool blocking = true);
mbed_official 0:a554658735bf 83
mbed_official 0:a554658735bf 84 /**
mbed_official 0:a554658735bf 85 * Bulk write
mbed_official 0:a554658735bf 86 *
mbed_official 0:a554658735bf 87 * @param dev the bulk transfer will be done for this device
mbed_official 0:a554658735bf 88 * @param ep USBEndpoint which will be used to write a packet
mbed_official 0:a554658735bf 89 * @param buf pointer on a buffer which will be written
mbed_official 0:a554658735bf 90 * @param len length of the transfer
mbed_official 0:a554658735bf 91 * @param blocking if true, the write is blocking (wait for completion)
mbed_official 0:a554658735bf 92 *
mbed_official 0:a554658735bf 93 * @returns status of the bulk write
mbed_official 0:a554658735bf 94 */
mbed_official 0:a554658735bf 95 USB_TYPE bulkWrite(USBDeviceConnected * dev, USBEndpoint * ep, uint8_t * buf, uint32_t len, bool blocking = true);
mbed_official 0:a554658735bf 96
mbed_official 0:a554658735bf 97 /**
mbed_official 0:a554658735bf 98 * Interrupt read
mbed_official 0:a554658735bf 99 *
mbed_official 0:a554658735bf 100 * @param dev the bulk transfer will be done for this device
mbed_official 0:a554658735bf 101 * @param ep USBEndpoint which will be used to write a packet
mbed_official 0:a554658735bf 102 * @param buf pointer on a buffer which will be written
mbed_official 0:a554658735bf 103 * @param len length of the transfer
mbed_official 0:a554658735bf 104 * @param blocking if true, the read is blocking (wait for completion)
mbed_official 0:a554658735bf 105 *
mbed_official 0:a554658735bf 106 * @returns status of the interrupt read
mbed_official 0:a554658735bf 107 */
mbed_official 0:a554658735bf 108 USB_TYPE interruptRead(USBDeviceConnected * dev, USBEndpoint * ep, uint8_t * buf, uint32_t len, bool blocking = true);
mbed_official 0:a554658735bf 109
mbed_official 0:a554658735bf 110 /**
mbed_official 0:a554658735bf 111 * Interrupt write
mbed_official 0:a554658735bf 112 *
mbed_official 0:a554658735bf 113 * @param dev the bulk transfer will be done for this device
mbed_official 0:a554658735bf 114 * @param ep USBEndpoint which will be used to write a packet
mbed_official 0:a554658735bf 115 * @param buf pointer on a buffer which will be written
mbed_official 0:a554658735bf 116 * @param len length of the transfer
mbed_official 0:a554658735bf 117 * @param blocking if true, the write is blocking (wait for completion)
mbed_official 0:a554658735bf 118 *
mbed_official 0:a554658735bf 119 * @returns status of the interrupt write
mbed_official 0:a554658735bf 120 */
mbed_official 0:a554658735bf 121 USB_TYPE interruptWrite(USBDeviceConnected * dev, USBEndpoint * ep, uint8_t * buf, uint32_t len, bool blocking = true);
mbed_official 0:a554658735bf 122
mbed_official 0:a554658735bf 123 /**
mbed_official 0:a554658735bf 124 * Enumerate a device.
mbed_official 0:a554658735bf 125 *
mbed_official 0:a554658735bf 126 * @param dev device which will be enumerated
mbed_official 0:a554658735bf 127 *
mbed_official 0:a554658735bf 128 * @returns status of the enumeration
mbed_official 0:a554658735bf 129 */
mbed_official 0:a554658735bf 130 USB_TYPE enumerate(USBDeviceConnected * dev, IUSBEnumerator* pEnumerator);
mbed_official 0:a554658735bf 131
mbed_official 0:a554658735bf 132 /**
samux 8:93da8ea2708b 133 * reset a specific device
samux 8:93da8ea2708b 134 *
samux 8:93da8ea2708b 135 * @param dev device which will be resetted
samux 8:93da8ea2708b 136 */
samux 8:93da8ea2708b 137 USB_TYPE resetDevice(USBDeviceConnected * dev);
samux 9:7671b6a8c363 138
samux 8:93da8ea2708b 139 /**
mbed_official 0:a554658735bf 140 * Get a device
mbed_official 0:a554658735bf 141 *
mbed_official 0:a554658735bf 142 * @param index index of the device which will be returned
mbed_official 0:a554658735bf 143 *
mbed_official 0:a554658735bf 144 * @returns pointer on the "index" device
mbed_official 0:a554658735bf 145 */
mbed_official 0:a554658735bf 146 USBDeviceConnected * getDevice(uint8_t index);
mbed_official 0:a554658735bf 147
mbed_official 0:a554658735bf 148 /*
mbed_official 0:a554658735bf 149 * If there is a HID device connected, the host stores the length of the report descriptor.
mbed_official 0:a554658735bf 150 * This avoid to the driver to re-ask the configuration descriptor to request the report descriptor
mbed_official 0:a554658735bf 151 *
mbed_official 0:a554658735bf 152 * @returns length of the report descriptor
mbed_official 0:a554658735bf 153 */
mbed_official 0:a554658735bf 154 inline uint16_t getLengthReportDescr() {
mbed_official 0:a554658735bf 155 return lenReportDescr;
mbed_official 0:a554658735bf 156 };
mbed_official 0:a554658735bf 157
mbed_official 0:a554658735bf 158 /**
mbed_official 0:a554658735bf 159 * register a driver into the host associated with a callback function called when the device is disconnected
mbed_official 0:a554658735bf 160 *
mbed_official 0:a554658735bf 161 * @param dev device
samux 4:b320d68e98e7 162 * @param intf interface number
mbed_official 0:a554658735bf 163 * @param tptr pointer to the object to call the member function on
mbed_official 0:a554658735bf 164 * @param mptr pointer to the member function to be called
mbed_official 0:a554658735bf 165 */
mbed_official 0:a554658735bf 166 template<typename T>
mbed_official 0:a554658735bf 167 inline void registerDriver(USBDeviceConnected * dev, uint8_t intf, T* tptr, void (T::*mptr)(void)) {
mbed_official 0:a554658735bf 168 int index = findDevice(dev);
mbed_official 0:a554658735bf 169 if ((index != -1) && (mptr != NULL) && (tptr != NULL)) {
samux 4:b320d68e98e7 170 USB_DBG("register driver for dev: %p on intf: %d", dev, intf);
samux 4:b320d68e98e7 171 deviceAttachedDriver[index][intf] = true;
mbed_official 0:a554658735bf 172 dev->onDisconnect(intf, tptr, mptr);
mbed_official 0:a554658735bf 173 }
mbed_official 0:a554658735bf 174 }
mbed_official 0:a554658735bf 175
mbed_official 0:a554658735bf 176 /**
mbed_official 0:a554658735bf 177 * register a driver into the host associated with a callback function called when the device is disconnected
mbed_official 0:a554658735bf 178 *
mbed_official 0:a554658735bf 179 * @param dev device
samux 4:b320d68e98e7 180 * @param intf interface number
mbed_official 0:a554658735bf 181 * @param fn callback called when the specified device has been disconnected
mbed_official 0:a554658735bf 182 */
mbed_official 0:a554658735bf 183 inline void registerDriver(USBDeviceConnected * dev, uint8_t intf, void (*fn)(void)) {
mbed_official 0:a554658735bf 184 int index = findDevice(dev);
mbed_official 0:a554658735bf 185 if ((index != -1) && (fn != NULL)) {
samux 4:b320d68e98e7 186 USB_DBG("register driver for dev: %p on intf: %d", dev, intf);
samux 4:b320d68e98e7 187 deviceAttachedDriver[index][intf] = true;
mbed_official 0:a554658735bf 188 dev->onDisconnect(intf, fn);
mbed_official 0:a554658735bf 189 }
mbed_official 0:a554658735bf 190 }
mbed_official 24:868cbfe611a7 191
mbed_official 23:759ec18ee1a7 192 /**
mbed_official 23:759ec18ee1a7 193 * Instantiate to protect USB thread from accessing shared objects (USBConnectedDevices and Interfaces)
mbed_official 23:759ec18ee1a7 194 */
mbed_official 23:759ec18ee1a7 195 class Lock
mbed_official 23:759ec18ee1a7 196 {
mbed_official 23:759ec18ee1a7 197 public:
mbed_official 24:868cbfe611a7 198 Lock(USBHost* pHost);
mbed_official 24:868cbfe611a7 199 ~Lock();
mbed_official 23:759ec18ee1a7 200 private:
mbed_official 23:759ec18ee1a7 201 USBHost* m_pHost;
mbed_official 23:759ec18ee1a7 202 };
mbed_official 24:868cbfe611a7 203
samux 8:93da8ea2708b 204 friend class USBHostHub;
samux 8:93da8ea2708b 205
samux 8:93da8ea2708b 206 protected:
samux 8:93da8ea2708b 207
samux 8:93da8ea2708b 208 /**
samux 8:93da8ea2708b 209 * Virtual method called when a transfer has been completed
samux 8:93da8ea2708b 210 *
samux 8:93da8ea2708b 211 * @param addr list of the TDs which have been completed
samux 8:93da8ea2708b 212 */
samux 8:93da8ea2708b 213 virtual void transferCompleted(volatile uint32_t addr);
samux 9:7671b6a8c363 214
mbed_official 0:a554658735bf 215 /**
mbed_official 0:a554658735bf 216 * Virtual method called when a device has been connected
mbed_official 0:a554658735bf 217 *
mbed_official 0:a554658735bf 218 * @param hub hub number of the device
mbed_official 0:a554658735bf 219 * @param port port number of the device
mbed_official 0:a554658735bf 220 * @param lowSpeed 1 if low speed, 0 otherwise
mbed_official 0:a554658735bf 221 * @param hub_parent reference on the parent hub
mbed_official 0:a554658735bf 222 */
mbed_official 0:a554658735bf 223 virtual void deviceConnected(int hub, int port, bool lowSpeed, USBHostHub * hub_parent = NULL);
mbed_official 0:a554658735bf 224
mbed_official 0:a554658735bf 225 /**
mbed_official 0:a554658735bf 226 * Virtuel method called when a device has been disconnected
mbed_official 0:a554658735bf 227 *
mbed_official 0:a554658735bf 228 * @param hub hub number of the device
mbed_official 0:a554658735bf 229 * @param port port number of the device
mbed_official 0:a554658735bf 230 * @param addr list of the TDs which have been completed to dequeue freed TDs
mbed_official 0:a554658735bf 231 */
mbed_official 0:a554658735bf 232 virtual void deviceDisconnected(int hub, int port, USBHostHub * hub_parent, volatile uint32_t addr);
mbed_official 0:a554658735bf 233
mbed_official 0:a554658735bf 234
mbed_official 0:a554658735bf 235 private:
mbed_official 0:a554658735bf 236 // singleton class -> constructor is private
mbed_official 0:a554658735bf 237 USBHost();
mbed_official 0:a554658735bf 238 static USBHost * instHost;
mbed_official 0:a554658735bf 239 uint16_t lenReportDescr;
mbed_official 0:a554658735bf 240
mbed_official 0:a554658735bf 241 // endpoints
mbed_official 0:a554658735bf 242 void unqueueEndpoint(USBEndpoint * ep) ;
mbed_official 0:a554658735bf 243 USBEndpoint endpoints[MAX_ENDPOINT];
mbed_official 0:a554658735bf 244 USBEndpoint* volatile control;
mbed_official 0:a554658735bf 245
mbed_official 0:a554658735bf 246 USBEndpoint* volatile headControlEndpoint;
mbed_official 0:a554658735bf 247 USBEndpoint* volatile headBulkEndpoint;
mbed_official 0:a554658735bf 248 USBEndpoint* volatile headInterruptEndpoint;
mbed_official 0:a554658735bf 249
mbed_official 0:a554658735bf 250 USBEndpoint* volatile tailControlEndpoint;
mbed_official 0:a554658735bf 251 USBEndpoint* volatile tailBulkEndpoint;
mbed_official 0:a554658735bf 252 USBEndpoint* volatile tailInterruptEndpoint;
mbed_official 0:a554658735bf 253
mbed_official 0:a554658735bf 254 bool controlEndpointAllocated;
mbed_official 0:a554658735bf 255
mbed_official 0:a554658735bf 256 // devices connected
mbed_official 0:a554658735bf 257 USBDeviceConnected devices[MAX_DEVICE_CONNECTED];
samux 6:1571e517a91b 258 bool deviceInUse[MAX_DEVICE_CONNECTED];
samux 6:1571e517a91b 259 bool deviceAttachedDriver[MAX_DEVICE_CONNECTED][MAX_INTF];
samux 6:1571e517a91b 260 bool deviceReset[MAX_DEVICE_CONNECTED];
samux 6:1571e517a91b 261 bool deviceInited[MAX_DEVICE_CONNECTED];
mbed_official 24:868cbfe611a7 262
mbed_official 0:a554658735bf 263 #if MAX_HUB_NB
mbed_official 0:a554658735bf 264 USBHostHub hubs[MAX_HUB_NB];
mbed_official 0:a554658735bf 265 bool hub_in_use[MAX_HUB_NB];
mbed_official 0:a554658735bf 266 #endif
mbed_official 0:a554658735bf 267
mbed_official 0:a554658735bf 268 // to store a setup packet
mbed_official 0:a554658735bf 269 uint8_t setupPacket[8];
mbed_official 24:868cbfe611a7 270
mbed_official 0:a554658735bf 271 typedef struct {
mbed_official 0:a554658735bf 272 uint8_t event_id;
mbed_official 0:a554658735bf 273 void * td_addr;
mbed_official 0:a554658735bf 274 uint8_t hub;
mbed_official 0:a554658735bf 275 uint8_t port;
mbed_official 0:a554658735bf 276 uint8_t lowSpeed;
mbed_official 0:a554658735bf 277 uint8_t td_state;
mbed_official 0:a554658735bf 278 void * hub_parent;
mbed_official 0:a554658735bf 279 } message_t;
mbed_official 24:868cbfe611a7 280
mbed_official 0:a554658735bf 281 Thread usbThread;
mbed_official 0:a554658735bf 282 void usb_process();
samux 9:7671b6a8c363 283 Mail<message_t, 10> mail_usb_event;
mbed_official 0:a554658735bf 284 Mutex usb_mutex;
samux 9:7671b6a8c363 285 Mutex td_mutex;
mbed_official 24:868cbfe611a7 286
mbed_official 0:a554658735bf 287 // buffer for conf descriptor
mbed_official 16:ab8c9118524e 288 uint8_t data[415];
mbed_official 24:868cbfe611a7 289
mbed_official 0:a554658735bf 290 /**
mbed_official 0:a554658735bf 291 * Add a transfer on the TD linked list associated to an ED
mbed_official 0:a554658735bf 292 *
mbed_official 0:a554658735bf 293 * @param ed the transfer is associated to this ed
mbed_official 0:a554658735bf 294 * @param buf pointer on a buffer where will be read/write data to send or receive
mbed_official 0:a554658735bf 295 * @param len transfer length
mbed_official 0:a554658735bf 296 *
mbed_official 0:a554658735bf 297 * @return status of the transfer
mbed_official 0:a554658735bf 298 */
mbed_official 0:a554658735bf 299 USB_TYPE addTransfer(USBEndpoint * ed, uint8_t * buf, uint32_t len) ;
mbed_official 24:868cbfe611a7 300
mbed_official 0:a554658735bf 301 /**
mbed_official 0:a554658735bf 302 * Link the USBEndpoint to the linked list and attach an USBEndpoint this USBEndpoint to a device
mbed_official 0:a554658735bf 303 *
mbed_official 0:a554658735bf 304 * @param dev pointer on a USBDeviceConnected object
mbed_official 0:a554658735bf 305 * @param ep pointer on the USBEndpoint which will be added
mbed_official 0:a554658735bf 306 *
mbed_official 0:a554658735bf 307 * return true if successful
mbed_official 0:a554658735bf 308 */
mbed_official 0:a554658735bf 309 bool addEndpoint(USBDeviceConnected * dev, uint8_t intf_nb, USBEndpoint * ep) ;
mbed_official 0:a554658735bf 310
mbed_official 0:a554658735bf 311 /**
mbed_official 0:a554658735bf 312 * Create an USBEndpoint descriptor. Warning: the USBEndpoint is not linked.
mbed_official 0:a554658735bf 313 *
mbed_official 0:a554658735bf 314 * @param type USBEndpoint type (CONTROL_ENDPOINT, BULK_ENDPOINT, INTERRUPT_ENDPOINT)
mbed_official 0:a554658735bf 315 * @param dir USBEndpoint direction (no meaning for CONTROL_ENDPOINT)
mbed_official 0:a554658735bf 316 * @param size USBEndpoint max packet size
mbed_official 0:a554658735bf 317 * @param addr USBEndpoint address
mbed_official 0:a554658735bf 318 *
mbed_official 0:a554658735bf 319 * @returns pointer on the USBEndpoint created
mbed_official 0:a554658735bf 320 */
mbed_official 0:a554658735bf 321 USBEndpoint * newEndpoint(ENDPOINT_TYPE type, ENDPOINT_DIRECTION dir, uint32_t size, uint8_t addr) ;
mbed_official 24:868cbfe611a7 322
mbed_official 0:a554658735bf 323 /**
mbed_official 0:a554658735bf 324 * Request the device descriptor
mbed_official 0:a554658735bf 325 *
mbed_official 0:a554658735bf 326 * @param dev request the device descriptor on this device
mbed_official 0:a554658735bf 327 * @param buf buffer to store the device descriptor
mbed_official 0:a554658735bf 328 * @param max_len_buf maximum size of buf
mbed_official 0:a554658735bf 329 * @param len_dev_descr pointer to store the length of the packet transferred
mbed_official 0:a554658735bf 330 */
mbed_official 0:a554658735bf 331 USB_TYPE getDeviceDescriptor(USBDeviceConnected * dev, uint8_t * buf, uint16_t max_len_buf, uint16_t * len_dev_descr = NULL);
mbed_official 0:a554658735bf 332
mbed_official 0:a554658735bf 333 /**
mbed_official 0:a554658735bf 334 * Request the configuration descriptor
mbed_official 0:a554658735bf 335 *
mbed_official 0:a554658735bf 336 * @param dev request the configuration descriptor on this device
mbed_official 0:a554658735bf 337 * @param buf buffer to store the configuration descriptor
mbed_official 0:a554658735bf 338 * @param max_len_buf maximum size of buf
mbed_official 0:a554658735bf 339 * @param len_conf_descr pointer to store the length of the packet transferred
mbed_official 0:a554658735bf 340 */
mbed_official 0:a554658735bf 341 USB_TYPE getConfigurationDescriptor(USBDeviceConnected * dev, uint8_t * buf, uint16_t max_len_buf, uint16_t * len_conf_descr = NULL);
mbed_official 24:868cbfe611a7 342
mbed_official 0:a554658735bf 343 /**
mbed_official 0:a554658735bf 344 * Set the address of a specific device
mbed_official 0:a554658735bf 345 *
mbed_official 0:a554658735bf 346 * @param dev device to set the address
mbed_official 0:a554658735bf 347 * @param address address
mbed_official 0:a554658735bf 348 */
mbed_official 0:a554658735bf 349 USB_TYPE setAddress(USBDeviceConnected * dev, uint8_t address);
mbed_official 0:a554658735bf 350
mbed_official 0:a554658735bf 351 /**
mbed_official 0:a554658735bf 352 * Set the configuration of a device
mbed_official 0:a554658735bf 353 *
mbed_official 0:a554658735bf 354 * @param dev device on which the specified configuration will be activated
mbed_official 0:a554658735bf 355 * @param conf configuration number to activate (usually 1)
mbed_official 0:a554658735bf 356 */
mbed_official 0:a554658735bf 357 USB_TYPE setConfiguration(USBDeviceConnected * dev, uint8_t conf);
mbed_official 24:868cbfe611a7 358
samux 8:93da8ea2708b 359 /**
samux 8:93da8ea2708b 360 * Free a specific device
samux 8:93da8ea2708b 361 *
samux 8:93da8ea2708b 362 * @param dev device to be freed
samux 8:93da8ea2708b 363 */
samux 8:93da8ea2708b 364 void freeDevice(USBDeviceConnected * dev);
samux 9:7671b6a8c363 365
mbed_official 0:a554658735bf 366 USB_TYPE controlTransfer( USBDeviceConnected * dev,
mbed_official 0:a554658735bf 367 uint8_t requestType,
mbed_official 0:a554658735bf 368 uint8_t request,
mbed_official 0:a554658735bf 369 uint32_t value,
mbed_official 0:a554658735bf 370 uint32_t index,
mbed_official 0:a554658735bf 371 uint8_t * buf,
mbed_official 0:a554658735bf 372 uint32_t len,
mbed_official 0:a554658735bf 373 bool write);
mbed_official 0:a554658735bf 374
mbed_official 0:a554658735bf 375 USB_TYPE generalTransfer( USBDeviceConnected * dev,
mbed_official 0:a554658735bf 376 USBEndpoint * ep,
mbed_official 0:a554658735bf 377 uint8_t * buf,
mbed_official 0:a554658735bf 378 uint32_t len,
mbed_official 0:a554658735bf 379 bool blocking,
mbed_official 0:a554658735bf 380 ENDPOINT_TYPE type,
mbed_official 0:a554658735bf 381 bool write) ;
mbed_official 24:868cbfe611a7 382
mbed_official 0:a554658735bf 383 void fillControlBuf(uint8_t requestType, uint8_t request, uint16_t value, uint16_t index, int len) ;
mbed_official 0:a554658735bf 384 void parseConfDescr(USBDeviceConnected * dev, uint8_t * conf_descr, uint32_t len, IUSBEnumerator* pEnumerator) ;
mbed_official 0:a554658735bf 385 int findDevice(USBDeviceConnected * dev) ;
mbed_official 0:a554658735bf 386 int findDevice(uint8_t hub, uint8_t port, USBHostHub * hub_parent = NULL) ;
samux 4:b320d68e98e7 387 uint8_t numberDriverAttached(USBDeviceConnected * dev);
mbed_official 0:a554658735bf 388
mbed_official 0:a554658735bf 389 /////////////////////////
mbed_official 0:a554658735bf 390 /// FOR DEBUG
mbed_official 0:a554658735bf 391 /////////////////////////
mbed_official 0:a554658735bf 392 void printList(ENDPOINT_TYPE type);
mbed_official 0:a554658735bf 393
mbed_official 0:a554658735bf 394 };
mbed_official 0:a554658735bf 395
mbed_official 0:a554658735bf 396 #endif