ST / USBDEVICE

USBDevice for STM support

Dependents:   Nucleo_Usb_JoyMouse Nucleo_usbmouse ELEC350_1-referral-2018-usb-hid USBJoystick_HelloWorld2_wip ... more

This library contains all mbed usb device library (mbed-os\features\unsupported\USBDevice).

USBDevice/USBHAL.h@4:50ec00aa4515, 2017-03-28 (annotated)

Committer:
frq08711@LMECWL0871.LME.ST.COM
Date:
Tue Mar 28 11:00:57 2017 +0200
Branch:
master
Revision:
4:50ec00aa4515
Parent:
3:d9c7334e2183 
update for 5.4.2

Who changed what in which revision?

UserRevisionLine numberNew contents of line
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 1 /* Copyright (c) 2010-2011 mbed.org, MIT License
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 2 *
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 3 * Permission is hereby granted, free of charge, to any person obtaining a copy of this software
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 4 * and associated documentation files (the "Software"), to deal in the Software without
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 5 * restriction, including without limitation the rights to use, copy, modify, merge, publish,
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 6 * distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 7 * Software is furnished to do so, subject to the following conditions:
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 8 *
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 9 * The above copyright notice and this permission notice shall be included in all copies or
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 10 * substantial portions of the Software.
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 11 *
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 12 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 13 * BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 14 * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 15 * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 16 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 17 */
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 18
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 19 #ifndef USBBUSINTERFACE_H
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 20 #define USBBUSINTERFACE_H
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 21
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 22 #include "mbed.h"
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 23 #include "USBEndpoints.h"
frq08711@LMECWL0871.LME.ST.COM 4:50ec00aa4515 24 #include "mbed_toolchain.h"
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 25
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 26 //#ifdef __GNUC__
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 27 //#define __packed __attribute__ ((__packed__))
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 28 //#endif
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 29
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 30 class USBHAL {
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 31 public:
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 32 /* Configuration */
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 33 USBHAL();
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 34 ~USBHAL();
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 35 void connect(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 36 void disconnect(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 37 void configureDevice(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 38 void unconfigureDevice(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 39 void setAddress(uint8_t address);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 40 void remoteWakeup(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 41
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 42 /* Endpoint 0 */
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 43 void EP0setup(uint8_t *buffer);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 44 void EP0read(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 45 void EP0readStage(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 46 uint32_t EP0getReadResult(uint8_t *buffer);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 47 void EP0write(uint8_t *buffer, uint32_t size);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 48 void EP0getWriteResult(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 49 void EP0stall(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 50
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 51 /* Other endpoints */
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 52 EP_STATUS endpointRead(uint8_t endpoint, uint32_t maximumSize);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 53 EP_STATUS endpointReadResult(uint8_t endpoint, uint8_t *data, uint32_t *bytesRead);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 54 EP_STATUS endpointWrite(uint8_t endpoint, uint8_t *data, uint32_t size);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 55 EP_STATUS endpointWriteResult(uint8_t endpoint);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 56 void stallEndpoint(uint8_t endpoint);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 57 void unstallEndpoint(uint8_t endpoint);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 58 bool realiseEndpoint(uint8_t endpoint, uint32_t maxPacket, uint32_t options);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 59 bool getEndpointStallState(unsigned char endpoint);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 60 uint32_t endpointReadcore(uint8_t endpoint, uint8_t *buffer);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 61
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 62 protected:
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 63 virtual void busReset(void){};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 64 virtual void EP0setupCallback(void){};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 65 virtual void EP0out(void){};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 66 virtual void EP0in(void){};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 67 virtual void connectStateChanged(unsigned int connected){};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 68 virtual void suspendStateChanged(unsigned int suspended){};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 69 virtual void SOF(int frameNumber){};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 70
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 71 #if defined(TARGET_NUMAKER_PFM_NUC472) || defined(TARGET_NUMAKER_PFM_M453)
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 72 // NUC472/M453 USB doesn't support configuration of the same EP number for IN/OUT simultaneously.
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 73 virtual bool EP1_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 74 virtual bool EP2_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 75 virtual bool EP3_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 76 virtual bool EP4_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 77 virtual bool EP5_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 78 virtual bool EP6_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 79 #if ! (defined(TARGET_NUMAKER_PFM_M453))
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 80 virtual bool EP7_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 81 virtual bool EP8_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 82 virtual bool EP9_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 83 virtual bool EP10_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 84 virtual bool EP11_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 85 virtual bool EP12_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 86 #endif
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 87 #else
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 88 virtual bool EP1_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 89 virtual bool EP1_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 90 virtual bool EP2_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 91 virtual bool EP2_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 92 virtual bool EP3_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 93 virtual bool EP3_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 94 #if !defined(TARGET_STM32F4)
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 95 virtual bool EP4_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 96 virtual bool EP4_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 97 #if !(defined(TARGET_LPC11UXX) || defined(TARGET_LPC11U6X) || defined(TARGET_LPC1347) || defined(TARGET_LPC1549))
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 98 virtual bool EP5_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 99 virtual bool EP5_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 100 virtual bool EP6_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 101 virtual bool EP6_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 102 virtual bool EP7_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 103 virtual bool EP7_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 104 virtual bool EP8_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 105 virtual bool EP8_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 106 virtual bool EP9_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 107 virtual bool EP9_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 108 virtual bool EP10_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 109 virtual bool EP10_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 110 virtual bool EP11_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 111 virtual bool EP11_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 112 virtual bool EP12_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 113 virtual bool EP12_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 114 virtual bool EP13_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 115 virtual bool EP13_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 116 virtual bool EP14_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 117 virtual bool EP14_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 118 virtual bool EP15_OUT_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 119 virtual bool EP15_IN_callback(){return false;};
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 120 #endif
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 121 #endif
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 122 #endif
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 123
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 124 private:
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 125 void usbisr(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 126 static void _usbisr(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 127 static USBHAL * instance;
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 128
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 129 #if defined(TARGET_LPC11UXX) || defined(TARGET_LPC11U6X) || defined(TARGET_LPC1347) || defined(TARGET_LPC1549)
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 130 bool (USBHAL::*epCallback[10 - 2])(void);
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 131 #elif (defined(TARGET_STM32F4) && !defined(USB_STM_HAL)) || defined(TARGET_NUMAKER_PFM_M453)
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 132 bool (USBHAL::*epCallback[8 - 2])(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 133 #elif defined(TARGET_STM32F4) || defined(TARGET_STM32F3) || defined (TARGET_STM32F2)|| defined(TARGET_STM32L4) || defined(TARGET_STM32F7)
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 134 PCD_HandleTypeDef hpcd;
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 135 #elif defined(TARGET_NUMAKER_PFM_NUC472)
frq08711@LMECWL0871.LME.ST.COM 3:d9c7334e2183 136 bool (USBHAL::*epCallback[14 - 2])(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 137 #else
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 138 bool (USBHAL::*epCallback[32 - 2])(void);
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 139 #endif
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 140
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 141
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 142 };
frq08711@LMECWL0871.LME.ST.COM 1:2a3ae13b45ef 143 #endif