25 #if !defined(_usb_h_) || defined(USBCORE_H)
26 #error "Never include UsbCore.h directly; include Usb.h instead"
35 #ifdef BOARD_BLACK_WIDDOW
37 #elif defined(CORE_TEENSY) && (defined(__AVR_AT90USB646__) || defined(__AVR_AT90USB1286__))
43 #elif defined(BOARD_MEGA_ADK)
45 #elif defined(ARDUINO_AVR_BALANDUINO)
47 #elif defined(__ARDUINO_X86__) && PLATFORM_ID == 0x06
49 #elif defined(ESP8266)
53 #elif defined(MIGHTYCORE)
55 #elif (defined(__AVR_ATmega644P__) || defined(__AVR_ATmega1284P__))
62 #define bmREQ_GET_DESCR USB_SETUP_DEVICE_TO_HOST|USB_SETUP_TYPE_STANDARD|USB_SETUP_RECIPIENT_DEVICE //get descriptor request type
63 #define bmREQ_SET USB_SETUP_HOST_TO_DEVICE|USB_SETUP_TYPE_STANDARD|USB_SETUP_RECIPIENT_DEVICE //set request type for all but 'set feature' and 'set interface'
64 #define bmREQ_CL_GET_INTF USB_SETUP_DEVICE_TO_HOST|USB_SETUP_TYPE_CLASS|USB_SETUP_RECIPIENT_INTERFACE //get interface request type
71 #define USB_CLASS_USE_CLASS_INFO 0x00 // Use Class Info in the Interface Descriptors
72 #define USB_CLASS_AUDIO 0x01 // Audio
73 #define USB_CLASS_COM_AND_CDC_CTRL 0x02 // Communications and CDC Control
74 #define USB_CLASS_HID 0x03 // HID
75 #define USB_CLASS_PHYSICAL 0x05 // Physical
76 #define USB_CLASS_IMAGE 0x06 // Image
77 #define USB_CLASS_PRINTER 0x07 // Printer
78 #define USB_CLASS_MASS_STORAGE 0x08 // Mass Storage
79 #define USB_CLASS_HUB 0x09 // Hub
80 #define USB_CLASS_CDC_DATA 0x0a // CDC-Data
81 #define USB_CLASS_SMART_CARD 0x0b // Smart-Card
82 #define USB_CLASS_CONTENT_SECURITY 0x0d // Content Security
83 #define USB_CLASS_VIDEO 0x0e // Video
84 #define USB_CLASS_PERSONAL_HEALTH 0x0f // Personal Healthcare
85 #define USB_CLASS_DIAGNOSTIC_DEVICE 0xdc // Diagnostic Device
86 #define USB_CLASS_WIRELESS_CTRL 0xe0 // Wireless Controller
87 #define USB_CLASS_MISC 0xef // Miscellaneous
88 #define USB_CLASS_APP_SPECIFIC 0xfe // Application Specific
89 #define USB_CLASS_VENDOR_SPECIFIC 0xff // Vendor Specific
92 #define USB_DEV_CONFIG_ERROR_DEVICE_NOT_SUPPORTED 0xD1
93 #define USB_DEV_CONFIG_ERROR_DEVICE_INIT_INCOMPLETE 0xD2
94 #define USB_ERROR_UNABLE_TO_REGISTER_DEVICE_CLASS 0xD3
95 #define USB_ERROR_OUT_OF_ADDRESS_SPACE_IN_POOL 0xD4
96 #define USB_ERROR_HUB_ADDRESS_OVERFLOW 0xD5
97 #define USB_ERROR_ADDRESS_NOT_FOUND_IN_POOL 0xD6
98 #define USB_ERROR_EPINFO_IS_NULL 0xD7
99 #define USB_ERROR_INVALID_ARGUMENT 0xD8
100 #define USB_ERROR_CLASS_INSTANCE_ALREADY_IN_USE 0xD9
101 #define USB_ERROR_INVALID_MAX_PKT_SIZE 0xDA
102 #define USB_ERROR_EP_NOT_FOUND_IN_TBL 0xDB
103 #define USB_ERROR_CONFIG_REQUIRES_ADDITIONAL_RESET 0xE0
104 #define USB_ERROR_FailGetDevDescr 0xE1
105 #define USB_ERROR_FailSetDevTblEntry 0xE2
106 #define USB_ERROR_FailGetConfDescr 0xE3
107 #define USB_ERROR_TRANSFER_TIMEOUT 0xFF
109 #define USB_XFER_TIMEOUT 5000 // (5000) USB transfer timeout in milliseconds, per section 9.2.6.1 of USB 2.0 spec
111 #define USB_RETRY_LIMIT 3 // 3 retry limit for a transfer
112 #define USB_SETTLE_DELAY 200 // settle delay in milliseconds
114 #define USB_NUMDEVICES 16 //number of USB devices
116 #define HUB_PORT_RESET_DELAY 20 // hub port reset delay 10 ms recomended, can be up to 20 ms
119 #define USB_STATE_MASK 0xf0
121 #define USB_STATE_DETACHED 0x10
122 #define USB_DETACHED_SUBSTATE_INITIALIZE 0x11
123 #define USB_DETACHED_SUBSTATE_WAIT_FOR_DEVICE 0x12
124 #define USB_DETACHED_SUBSTATE_ILLEGAL 0x13
125 #define USB_ATTACHED_SUBSTATE_SETTLE 0x20
126 #define USB_ATTACHED_SUBSTATE_RESET_DEVICE 0x30
127 #define USB_ATTACHED_SUBSTATE_WAIT_RESET_COMPLETE 0x40
128 #define USB_ATTACHED_SUBSTATE_WAIT_SOF 0x50
129 #define USB_ATTACHED_SUBSTATE_WAIT_RESET 0x51
130 #define USB_ATTACHED_SUBSTATE_GET_DEVICE_DESCRIPTOR_SIZE 0x60
131 #define USB_STATE_ADDRESSING 0x70
132 #define USB_STATE_CONFIGURING 0x80
133 #define USB_STATE_RUNNING 0x90
134 #define USB_STATE_ERROR 0xa0
139 virtual uint8_t
Init(uint8_t parent __attribute__((unused)), uint8_t port __attribute__((unused)),
bool lowspeed __attribute__((unused))) {
143 virtual uint8_t
ConfigureDevice(uint8_t parent __attribute__((unused)), uint8_t port __attribute__((unused)),
bool lowspeed __attribute__((unused))) {
163 virtual bool VIDPIDOK(uint16_t vid __attribute__((unused)), uint16_t pid __attribute__((unused))) {
167 virtual bool DEVCLASSOK(uint8_t klass __attribute__((unused))) {
187 } __attribute__((packed));
197 } __attribute__((packed));
209 virtual void Parse(
const uint16_t len,
const uint8_t *pbuf,
const uint16_t &offset) = 0;
252 uint8_t
getDevDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t* dataptr);
253 uint8_t
getConfDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t conf, uint8_t* dataptr);
257 uint8_t
getStrDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t index, uint16_t langid, uint8_t* dataptr);
258 uint8_t
setAddr(uint8_t oldaddr, uint8_t ep, uint8_t newaddr);
259 uint8_t
setConf(uint8_t addr, uint8_t ep, uint8_t conf_value);
261 uint8_t
ctrlData(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t* dataptr,
bool direction);
262 uint8_t
ctrlStatus(uint8_t ep,
bool direction, uint16_t nak_limit);
263 uint8_t
inTransfer(uint8_t addr, uint8_t ep, uint16_t *nbytesptr, uint8_t* data, uint8_t bInterval = 0);
264 uint8_t
outTransfer(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t* data);
265 uint8_t
dispatchPkt(uint8_t token, uint8_t ep, uint16_t nak_limit);
270 uint8_t
Configuring(uint8_t parent, uint8_t port,
bool lowspeed);
273 uint8_t
ctrlReq(uint8_t addr, uint8_t ep, uint8_t bmReqType, uint8_t bRequest, uint8_t wValLo, uint8_t wValHi,
274 uint16_t wInd, uint16_t total, uint16_t nbytes, uint8_t* dataptr,
USBReadParser *p);
278 uint8_t SetAddress(uint8_t addr, uint8_t ep,
EpInfo **ppep, uint16_t *nak_limit);
279 uint8_t OutTransfer(
EpInfo *pep, uint16_t nak_limit, uint16_t nbytes, uint8_t *data);
280 uint8_t InTransfer(
EpInfo *pep, uint16_t nak_limit, uint16_t *nbytesptr, uint8_t *data, uint8_t bInterval = 0);
281 uint8_t AttemptConfig(uint8_t driver, uint8_t parent, uint8_t port,
bool lowspeed);
284 #if 0 //defined(USB_METHODS_INLINE)
287 inline uint8_t
USB::getDevDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t* dataptr) {
292 inline uint8_t
USB::getConfDescr(uint8_t addr, uint8_t ep, uint16_t nbytes, uint8_t conf, uint8_t* dataptr) {
297 inline uint8_t
USB::getStrDescr(uint8_t addr, uint8_t ep, uint16_t nuint8_ts, uint8_t index, uint16_t langid, uint8_t* dataptr) {
302 inline uint8_t
USB::setAddr(uint8_t oldaddr, uint8_t ep, uint8_t newaddr) {
307 inline uint8_t
USB::setConf(uint8_t addr, uint8_t ep, uint8_t conf_value) {
311 #endif // defined(USB_METHODS_INLINE)