espressif_tinyusb/src/host/usbh.c

677 lines
23 KiB
C
Raw Normal View History

/*
* The MIT License (MIT)
*
2019-05-14 06:48:05 +02:00
* Copyright (c) 2019 Ha Thach (tinyusb.org)
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*
* This file is part of the TinyUSB stack.
*/
2018-03-12 16:45:35 +01:00
#include "common/tusb_common.h"
#if TUSB_OPT_HOST_ENABLED
2018-12-05 12:58:30 +01:00
#ifndef CFG_TUH_TASK_QUEUE_SZ
#define CFG_TUH_TASK_QUEUE_SZ 16
2018-03-01 05:17:11 +01:00
#endif
//--------------------------------------------------------------------+
// INCLUDE
//--------------------------------------------------------------------+
#include "tusb.h"
#include "hub.h"
#include "usbh_hcd.h"
//--------------------------------------------------------------------+
// MACRO CONSTANT TYPEDEF
//--------------------------------------------------------------------+
static host_class_driver_t const usbh_class_drivers[] =
{
2018-12-09 23:07:22 +01:00
#if CFG_TUH_CDC
{
2018-12-10 17:15:53 +01:00
.class_code = TUSB_CLASS_CDC,
.init = cdch_init,
.open = cdch_open,
.isr = cdch_isr,
.close = cdch_close
},
#endif
2018-12-09 23:07:22 +01:00
#if CFG_TUH_MSC
{
2018-12-10 17:15:53 +01:00
.class_code = TUSB_CLASS_MSC,
.init = msch_init,
.open = msch_open,
.isr = msch_isr,
.close = msch_close
},
#endif
2018-12-09 23:07:22 +01:00
#if HOST_CLASS_HID
{
2018-12-10 17:15:53 +01:00
.class_code = TUSB_CLASS_HID,
.init = hidh_init,
.open = hidh_open_subtask,
.isr = hidh_isr,
.close = hidh_close
},
#endif
#if CFG_TUH_HUB
2018-12-09 23:07:22 +01:00
{
2018-12-10 17:15:53 +01:00
.class_code = TUSB_CLASS_HUB,
.init = hub_init,
.open = hub_open,
.isr = hub_isr,
.close = hub_close
},
#endif
#if CFG_TUH_VENDOR
2018-12-09 23:07:22 +01:00
{
2018-12-10 17:15:53 +01:00
.class_code = TUSB_CLASS_VENDOR_SPECIFIC,
.init = cush_init,
.open = cush_open_subtask,
.isr = cush_isr,
.close = cush_close
}
#endif
};
2019-11-21 18:32:49 +01:00
enum { USBH_CLASS_DRIVER_COUNT = TU_ARRAY_SIZE(usbh_class_drivers) };
//--------------------------------------------------------------------+
// INTERNAL OBJECT & FUNCTION DECLARATION
//--------------------------------------------------------------------+
// including zero-address
CFG_TUSB_MEM_SECTION usbh_device_t _usbh_devices[CFG_TUSB_HOST_DEVICE_MAX+1];
2018-12-05 12:58:30 +01:00
// Event queue
// role device/host is used by OS NONE for mutex (disable usb isr) only
OSAL_QUEUE_DEF(OPT_MODE_HOST, _usbh_qdef, CFG_TUH_TASK_QUEUE_SZ, hcd_event_t);
2018-12-05 12:58:30 +01:00
static osal_queue_t _usbh_q;
CFG_TUSB_MEM_SECTION TU_ATTR_ALIGNED(4) static uint8_t _usbh_ctrl_buf[CFG_TUSB_HOST_ENUM_BUFFER_SIZE];
//------------- Reporter Task Data -------------//
//------------- Helper Function Prototypes -------------//
2018-12-14 07:08:21 +01:00
static inline uint8_t get_new_address(void);
static inline uint8_t get_configure_number_for_device(tusb_desc_device_t* dev_desc);
2018-12-09 23:15:49 +01:00
static void mark_interface_endpoint(uint8_t ep2drv[8][2], uint8_t const* p_desc, uint16_t desc_len, uint8_t driver_id);
//--------------------------------------------------------------------+
// PUBLIC API (Parameter Verification is required)
//--------------------------------------------------------------------+
2015-05-01 14:16:56 +02:00
tusb_device_state_t tuh_device_get_state (uint8_t const dev_addr)
{
TU_ASSERT( dev_addr <= CFG_TUSB_HOST_DEVICE_MAX, TUSB_DEVICE_STATE_UNPLUG);
2018-12-06 18:47:16 +01:00
return (tusb_device_state_t) _usbh_devices[dev_addr].state;
}
//--------------------------------------------------------------------+
// CLASS-USBD API (don't require to verify parameters)
//--------------------------------------------------------------------+
2018-12-05 15:12:10 +01:00
bool usbh_init(void)
{
2018-12-06 18:47:16 +01:00
tu_memclr(_usbh_devices, sizeof(usbh_device_t)*(CFG_TUSB_HOST_DEVICE_MAX+1));
//------------- Enumeration & Reporter Task init -------------//
2018-12-05 12:58:30 +01:00
_usbh_q = osal_queue_create( &_usbh_qdef );
2018-12-05 15:12:10 +01:00
TU_ASSERT(_usbh_q != NULL);
2018-02-28 08:59:38 +01:00
//------------- Semaphore, Mutex for Control Pipe -------------//
2018-04-10 09:31:11 +02:00
for(uint8_t i=0; i<CFG_TUSB_HOST_DEVICE_MAX+1; i++) // including address zero
{
2018-12-09 23:07:22 +01:00
usbh_device_t * const dev = &_usbh_devices[i];
2018-12-09 23:07:22 +01:00
dev->control.sem_hdl = osal_semaphore_create(&dev->control.sem_def);
TU_ASSERT(dev->control.sem_hdl != NULL);
2018-12-09 23:07:22 +01:00
dev->control.mutex_hdl = osal_mutex_create(&dev->control.mutex_def);
TU_ASSERT(dev->control.mutex_hdl != NULL);
2018-12-09 23:15:49 +01:00
memset(dev->itf2drv, 0xff, sizeof(dev->itf2drv)); // invalid mapping
memset(dev->ep2drv , 0xff, sizeof(dev->ep2drv )); // invalid mapping
}
2018-12-09 23:07:22 +01:00
// Class drivers init
for (uint8_t drv_id = 0; drv_id < USBH_CLASS_DRIVER_COUNT; drv_id++) usbh_class_drivers[drv_id].init();
2018-12-07 17:28:51 +01:00
TU_ASSERT(hcd_init());
2018-12-05 15:12:10 +01:00
hcd_int_enable(TUH_OPT_RHPORT);
2018-12-05 12:58:30 +01:00
2018-12-05 15:12:10 +01:00
return true;
}
//------------- USBH control transfer -------------//
bool usbh_control_xfer (uint8_t dev_addr, tusb_control_request_t* request, uint8_t* data)
{
2018-12-06 18:47:16 +01:00
usbh_device_t* dev = &_usbh_devices[dev_addr];
const uint8_t rhport = dev->rhport;
TU_ASSERT(osal_mutex_lock(dev->control.mutex_hdl, OSAL_TIMEOUT_NORMAL));
dev->control.request = *request;
dev->control.pipe_status = 0;
// Setup Stage
hcd_setup_send(rhport, dev_addr, (uint8_t*) &dev->control.request);
TU_VERIFY(osal_semaphore_wait(dev->control.sem_hdl, OSAL_TIMEOUT_NORMAL));
// Data stage : first data toggle is always 1
if ( request->wLength )
{
hcd_edpt_xfer(rhport, dev_addr, tu_edpt_addr(0, request->bmRequestType_bit.direction), data, request->wLength);
TU_VERIFY(osal_semaphore_wait(dev->control.sem_hdl, OSAL_TIMEOUT_NORMAL));
}
// Status : data toggle is always 1
hcd_edpt_xfer(rhport, dev_addr, tu_edpt_addr(0, 1-request->bmRequestType_bit.direction), NULL, 0);
TU_VERIFY(osal_semaphore_wait(dev->control.sem_hdl, OSAL_TIMEOUT_NORMAL));
osal_mutex_unlock(dev->control.mutex_hdl);
if ( XFER_RESULT_STALLED == dev->control.pipe_status ) return false;
if ( XFER_RESULT_FAILED == dev->control.pipe_status ) return false;
return true;
}
tusb_error_t usbh_pipe_control_open(uint8_t dev_addr, uint8_t max_packet_size)
{
2018-12-06 18:47:16 +01:00
osal_semaphore_reset( _usbh_devices[dev_addr].control.sem_hdl );
2018-12-05 15:12:10 +01:00
//osal_mutex_reset( usbh_devices[dev_addr].control.mutex_hdl );
tusb_desc_endpoint_t ep0_desc =
{
.bLength = sizeof(tusb_desc_endpoint_t),
.bDescriptorType = TUSB_DESC_ENDPOINT,
.bEndpointAddress = 0,
.bmAttributes = { .xfer = TUSB_XFER_CONTROL },
.wMaxPacketSize = { .size = max_packet_size },
.bInterval = 0
};
2018-12-11 07:12:21 +01:00
hcd_edpt_open(_usbh_devices[dev_addr].rhport, dev_addr, &ep0_desc);
return TUSB_ERROR_NONE;
}
//--------------------------------------------------------------------+
// USBH-HCD ISR/Callback API
//--------------------------------------------------------------------+
// interrupt caused by a TD (with IOC=1) in pipe of class class_code
void hcd_event_xfer_complete(uint8_t dev_addr, uint8_t ep_addr, xfer_result_t event, uint32_t xferred_bytes)
{
2018-12-09 23:40:02 +01:00
usbh_device_t* dev = &_usbh_devices[ dev_addr ];
2018-12-09 23:07:22 +01:00
if (0 == tu_edpt_number(ep_addr))
{
2018-12-09 23:07:22 +01:00
dev->control.pipe_status = event;
// usbh_devices[ pipe_hdl.dev_addr ].control.xferred_bytes = xferred_bytes; not yet neccessary
2018-12-09 23:07:22 +01:00
osal_semaphore_post( dev->control.sem_hdl, true );
}
else
{
uint8_t drv_id = dev->ep2drv[tu_edpt_number(ep_addr)][tu_edpt_dir(ep_addr)];
2018-12-09 23:15:49 +01:00
TU_ASSERT(drv_id < USBH_CLASS_DRIVER_COUNT, );
2018-12-09 23:07:22 +01:00
if (usbh_class_drivers[drv_id].isr)
{
2018-12-09 23:55:02 +01:00
usbh_class_drivers[drv_id].isr(dev_addr, ep_addr, event, xferred_bytes);
2018-12-09 23:07:22 +01:00
}
else
{
2018-12-10 14:16:26 +01:00
TU_BREAKPOINT(); // something wrong, no one claims the isr's source
2018-12-09 23:07:22 +01:00
}
}
}
2018-12-08 14:51:48 +01:00
void hcd_event_device_attach(uint8_t rhport)
{
hcd_event_t event =
{
2018-12-08 14:51:48 +01:00
.rhport = rhport,
.event_id = HCD_EVENT_DEVICE_ATTACH
};
event.attach.hub_addr = 0;
event.attach.hub_port = 0;
hcd_event_handler(&event, true);
}
void hcd_event_handler(hcd_event_t const* event, bool in_isr)
{
switch (event->event_id)
{
default:
osal_queue_send(_usbh_q, event, in_isr);
break;
}
}
2018-12-08 14:51:48 +01:00
void hcd_event_device_remove(uint8_t hostid)
{
hcd_event_t event =
{
.rhport = hostid,
.event_id = HCD_EVENT_DEVICE_REMOVE
};
event.attach.hub_addr = 0;
event.attach.hub_port = 0;
hcd_event_handler(&event, true);
}
// a device unplugged on hostid, hub_addr, hub_port
// return true if found and unmounted device, false if cannot find
2018-12-11 04:50:05 +01:00
static void usbh_device_unplugged(uint8_t rhport, uint8_t hub_addr, uint8_t hub_port)
{
//------------- find the all devices (star-network) under port that is unplugged -------------//
2018-04-10 09:31:11 +02:00
for (uint8_t dev_addr = 0; dev_addr <= CFG_TUSB_HOST_DEVICE_MAX; dev_addr ++)
{
2018-12-09 23:07:22 +01:00
usbh_device_t* dev = &_usbh_devices[dev_addr];
// TODO Hub multiple level
2018-12-11 04:50:05 +01:00
if (dev->rhport == rhport &&
2018-12-09 23:07:22 +01:00
(hub_addr == 0 || dev->hub_addr == hub_addr) && // hub_addr == 0 & hub_port == 0 means roothub
(hub_port == 0 || dev->hub_port == hub_port) &&
dev->state != TUSB_DEVICE_STATE_UNPLUG)
{
2018-12-10 13:25:57 +01:00
// Invoke callback before close driver
if (tuh_umount_cb) tuh_umount_cb(dev_addr);
2018-12-09 23:07:22 +01:00
// Close class driver
for (uint8_t drv_id = 0; drv_id < USBH_CLASS_DRIVER_COUNT; drv_id++) usbh_class_drivers[drv_id].close(dev_addr);
2018-12-09 23:15:49 +01:00
memset(dev->itf2drv, 0xff, sizeof(dev->itf2drv)); // invalid mapping
memset(dev->ep2drv , 0xff, sizeof(dev->ep2drv )); // invalid mapping
hcd_device_close(rhport, dev_addr);
2018-12-11 04:50:05 +01:00
dev->state = TUSB_DEVICE_STATE_UNPLUG;
}
}
}
//--------------------------------------------------------------------+
// ENUMERATION TASK
//--------------------------------------------------------------------+
2018-12-06 18:47:16 +01:00
bool enum_task(hcd_event_t* event)
{
enum {
#if 1
// FIXME ohci LPC1769 xpresso + debugging to have 1st control xfer to work, some kind of timing or ohci driver issue !!!
POWER_STABLE_DELAY = 100,
RESET_DELAY = 500
#else
POWER_STABLE_DELAY = 500,
RESET_DELAY = 200, // USB specs say only 50ms but many devices require much longer
#endif
};
// for OSAL_NONE local variable won't retain value after blocking service sem_wait/queue_recv
static uint8_t configure_selected = 1; // TODO move
2018-12-06 18:47:16 +01:00
usbh_device_t* dev0 = &_usbh_devices[0];
tusb_control_request_t request;
2018-12-06 16:50:19 +01:00
dev0->rhport = event->rhport; // TODO refractor integrate to device_pool
dev0->hub_addr = event->attach.hub_addr;
dev0->hub_port = event->attach.hub_port;
2018-12-06 16:50:19 +01:00
dev0->state = TUSB_DEVICE_STATE_UNPLUG;
//------------- connected/disconnected directly with roothub -------------//
2018-12-06 16:50:19 +01:00
if ( dev0->hub_addr == 0)
{
if( hcd_port_connect_status(dev0->rhport) )
2018-12-05 14:39:52 +01:00
{
// connection event
osal_task_delay(POWER_STABLE_DELAY); // wait until device is stable. Increase this if the first 8 bytes is failed to get
2018-12-05 14:39:52 +01:00
// exit if device unplugged while delaying
if ( !hcd_port_connect_status(dev0->rhport) ) return true;
hcd_port_reset( dev0->rhport ); // port must be reset to have correct speed operation
osal_task_delay(RESET_DELAY);
dev0->speed = hcd_port_speed_get( dev0->rhport );
}
else
{
// disconnection event
usbh_device_unplugged(dev0->rhport, 0, 0);
return true; // restart task
}
}
#if CFG_TUH_HUB
//------------- connected/disconnected via hub -------------//
else
{
//------------- Get Port Status -------------//
request = (tusb_control_request_t ) {
.bmRequestType_bit = { .recipient = TUSB_REQ_RCPT_OTHER, .type = TUSB_REQ_TYPE_CLASS, .direction = TUSB_DIR_IN },
.bRequest = HUB_REQUEST_GET_STATUS,
.wValue = 0,
.wIndex = dev0->hub_port,
.wLength = 4
};
// TODO hub refractor
TU_VERIFY_HDLR( usbh_control_xfer( dev0->hub_addr, &request, _usbh_ctrl_buf ), hub_status_pipe_queue( dev0->hub_addr) );
// Acknowledge Port Connection Change
2018-12-06 16:50:19 +01:00
hub_port_clear_feature_subtask(dev0->hub_addr, dev0->hub_port, HUB_FEATURE_PORT_CONNECTION_CHANGE);
hub_port_status_response_t * p_port_status;
2018-12-06 18:47:16 +01:00
p_port_status = ((hub_port_status_response_t *) _usbh_ctrl_buf);
2018-12-06 16:47:49 +01:00
if ( ! p_port_status->status_change.connect_status ) return true; // only handle connection change
if ( ! p_port_status->status_current.connect_status )
2018-12-06 16:47:49 +01:00
{
// Disconnection event
usbh_device_unplugged(dev0->rhport, dev0->hub_addr, dev0->hub_port);
2018-12-06 16:50:19 +01:00
(void) hub_status_pipe_queue( dev0->hub_addr ); // done with hub, waiting for next data on status pipe
2018-12-06 16:47:49 +01:00
return true; // restart task
}
else
2018-12-06 16:47:49 +01:00
{
// Connection Event
2018-12-06 16:50:19 +01:00
TU_VERIFY_HDLR(hub_port_reset_subtask(dev0->hub_addr, dev0->hub_port),
hub_status_pipe_queue( dev0->hub_addr) ); // TODO hub refractor
2018-12-06 16:50:19 +01:00
dev0->speed = hub_port_get_speed();
// Acknowledge Port Reset Change
2018-12-06 16:50:19 +01:00
hub_port_clear_feature_subtask(dev0->hub_addr, dev0->hub_port, HUB_FEATURE_PORT_RESET_CHANGE);
}
}
#endif
2018-12-05 14:39:52 +01:00
TU_ASSERT_ERR( usbh_pipe_control_open(0, 8) );
//------------- Get first 8 bytes of device descriptor to get Control Endpoint Size -------------//
request = (tusb_control_request_t ) {
.bmRequestType_bit = { .recipient = TUSB_REQ_RCPT_DEVICE, .type = TUSB_REQ_TYPE_STANDARD, .direction = TUSB_DIR_IN },
.bRequest = TUSB_REQ_GET_DESCRIPTOR,
.wValue = TUSB_DESC_DEVICE << 8,
.wIndex = 0,
.wLength = 8
};
bool is_ok = usbh_control_xfer(0, &request, _usbh_ctrl_buf);
//------------- Reset device again before Set Address -------------//
2018-12-06 16:50:19 +01:00
if (dev0->hub_addr == 0)
2018-12-05 14:39:52 +01:00
{
// connected directly to roothub
2018-12-06 16:47:49 +01:00
TU_ASSERT(is_ok); // TODO some slow device is observed to fail the very fist controller xfer, can try more times
hcd_port_reset( dev0->rhport ); // reset port after 8 byte descriptor
osal_task_delay(RESET_DELAY);
}
#if CFG_TUH_HUB
else
2018-12-06 16:47:49 +01:00
{
// connected via a hub
2018-12-06 16:50:19 +01:00
TU_VERIFY_HDLR(is_ok, hub_status_pipe_queue( dev0->hub_addr) ); // TODO hub refractor
2018-12-06 16:50:19 +01:00
if ( hub_port_reset_subtask(dev0->hub_addr, dev0->hub_port) )
2018-12-06 16:47:49 +01:00
{
// Acknowledge Port Reset Change if Reset Successful
2018-12-06 16:50:19 +01:00
hub_port_clear_feature_subtask(dev0->hub_addr, dev0->hub_port, HUB_FEATURE_PORT_RESET_CHANGE);
}
2018-12-06 16:50:19 +01:00
(void) hub_status_pipe_queue( dev0->hub_addr ); // done with hub, waiting for next data on status pipe
}
#endif
//------------- Set new address -------------//
2018-12-06 18:47:16 +01:00
uint8_t const new_addr = get_new_address();
2018-12-05 14:39:52 +01:00
TU_ASSERT(new_addr <= CFG_TUSB_HOST_DEVICE_MAX); // TODO notify application we reach max devices
request = (tusb_control_request_t ) {
.bmRequestType_bit = { .recipient = TUSB_REQ_RCPT_DEVICE, .type = TUSB_REQ_TYPE_STANDARD, .direction = TUSB_DIR_OUT },
.bRequest = TUSB_REQ_SET_ADDRESS,
.wValue = new_addr,
.wIndex = 0,
.wLength = 0
};
TU_ASSERT(usbh_control_xfer(0, &request, NULL));
//------------- update port info & close control pipe of addr0 -------------//
2018-12-06 18:47:16 +01:00
usbh_device_t* new_dev = &_usbh_devices[new_addr];
new_dev->rhport = dev0->rhport;
2018-12-06 18:47:16 +01:00
new_dev->hub_addr = dev0->hub_addr;
new_dev->hub_port = dev0->hub_port;
new_dev->speed = dev0->speed;
hcd_device_close(dev0->rhport, 0); // close device 0
2018-12-06 16:50:19 +01:00
dev0->state = TUSB_DEVICE_STATE_UNPLUG;
// open control pipe for new address
2018-12-06 18:47:16 +01:00
TU_ASSERT_ERR ( usbh_pipe_control_open(new_addr, ((tusb_desc_device_t*) _usbh_ctrl_buf)->bMaxPacketSize0 ) );
//------------- Get full device descriptor -------------//
request = (tusb_control_request_t ) {
.bmRequestType_bit = { .recipient = TUSB_REQ_RCPT_DEVICE, .type = TUSB_REQ_TYPE_STANDARD, .direction = TUSB_DIR_IN },
.bRequest = TUSB_REQ_GET_DESCRIPTOR,
.wValue = TUSB_DESC_DEVICE << 8,
.wIndex = 0,
.wLength = 18
};
TU_ASSERT(usbh_control_xfer(new_addr, &request, _usbh_ctrl_buf));
// update device info TODO alignment issue
2018-12-06 18:47:16 +01:00
new_dev->vendor_id = ((tusb_desc_device_t*) _usbh_ctrl_buf)->idVendor;
new_dev->product_id = ((tusb_desc_device_t*) _usbh_ctrl_buf)->idProduct;
new_dev->configure_count = ((tusb_desc_device_t*) _usbh_ctrl_buf)->bNumConfigurations;
2018-12-06 18:47:16 +01:00
configure_selected = get_configure_number_for_device((tusb_desc_device_t*) _usbh_ctrl_buf);
TU_ASSERT(configure_selected <= new_dev->configure_count); // TODO notify application when invalid configuration
//------------- Get 9 bytes of configuration descriptor -------------//
request = (tusb_control_request_t ) {
.bmRequestType_bit = { .recipient = TUSB_REQ_RCPT_DEVICE, .type = TUSB_REQ_TYPE_STANDARD, .direction = TUSB_DIR_IN },
.bRequest = TUSB_REQ_GET_DESCRIPTOR,
.wValue = (TUSB_DESC_CONFIGURATION << 8) | (configure_selected - 1),
.wIndex = 0,
.wLength = 9
};
TU_ASSERT( usbh_control_xfer(new_addr, &request, _usbh_ctrl_buf));
// TODO not enough buffer to hold configuration descriptor
TU_ASSERT( CFG_TUSB_HOST_ENUM_BUFFER_SIZE >= ((tusb_desc_configuration_t*)_usbh_ctrl_buf)->wTotalLength );
//------------- Get full configuration descriptor -------------//
request.wLength = ((tusb_desc_configuration_t*)_usbh_ctrl_buf)->wTotalLength; // full length
TU_ASSERT( usbh_control_xfer( new_addr, &request, _usbh_ctrl_buf ) );
// update configuration info
2018-12-06 18:47:16 +01:00
new_dev->interface_count = ((tusb_desc_configuration_t*) _usbh_ctrl_buf)->bNumInterfaces;
//------------- Set Configure -------------//
request = (tusb_control_request_t ) {
.bmRequestType_bit = { .recipient = TUSB_REQ_RCPT_DEVICE, .type = TUSB_REQ_TYPE_STANDARD, .direction = TUSB_DIR_OUT },
.bRequest = TUSB_REQ_SET_CONFIGURATION,
.wValue = configure_selected,
.wIndex = 0,
.wLength = 0
};
TU_ASSERT(usbh_control_xfer( new_addr, &request, NULL ));
2018-12-06 18:47:16 +01:00
new_dev->state = TUSB_DEVICE_STATE_CONFIGURED;
//------------- TODO Get String Descriptors -------------//
//------------- parse configuration & install drivers -------------//
2018-12-09 23:07:22 +01:00
uint8_t const* p_desc = _usbh_ctrl_buf + sizeof(tusb_desc_configuration_t);
// parse each interfaces
2018-12-06 18:47:16 +01:00
while( p_desc < _usbh_ctrl_buf + ((tusb_desc_configuration_t*)_usbh_ctrl_buf)->wTotalLength )
{
// skip until we see interface descriptor
if ( TUSB_DESC_INTERFACE != tu_desc_type(p_desc) )
{
p_desc = tu_desc_next(p_desc); // skip the descriptor, increase by the descriptor's length
}else
{
2018-12-09 23:07:22 +01:00
tusb_desc_interface_t* desc_itf = (tusb_desc_interface_t*) p_desc;
2018-12-09 23:07:22 +01:00
// Check if class is supported
uint8_t drv_id;
for (drv_id = 0; drv_id < USBH_CLASS_DRIVER_COUNT; drv_id++)
{
if ( usbh_class_drivers[drv_id].class_code == desc_itf->bInterfaceClass ) break;
}
if( drv_id >= USBH_CLASS_DRIVER_COUNT )
{
// skip unsupported class
p_desc = tu_desc_next(p_desc);
2018-12-09 23:07:22 +01:00
}
else
2018-12-06 18:47:16 +01:00
{
2018-12-09 23:07:22 +01:00
// Interface number must not be used already TODO alternate interface
2018-12-09 23:15:49 +01:00
TU_ASSERT( new_dev->itf2drv[desc_itf->bInterfaceNumber] == 0xff );
2018-12-09 23:07:22 +01:00
new_dev->itf2drv[desc_itf->bInterfaceNumber] = drv_id;
2018-12-09 23:07:22 +01:00
if (desc_itf->bInterfaceClass == TUSB_CLASS_HUB && new_dev->hub_addr != 0)
{
2018-12-09 23:07:22 +01:00
// TODO Attach hub to Hub is not currently supported
// skip this interface
p_desc = tu_desc_next(p_desc);
2018-12-09 23:07:22 +01:00
}
else
{
2018-12-09 23:07:22 +01:00
uint16_t itf_len = 0;
2018-12-10 16:19:01 +01:00
if ( usbh_class_drivers[drv_id].open(new_dev->rhport, new_addr, desc_itf, &itf_len) )
2018-12-09 23:07:22 +01:00
{
mark_interface_endpoint(new_dev->ep2drv, p_desc, itf_len, drv_id);
}
TU_ASSERT( itf_len >= sizeof(tusb_desc_interface_t) );
p_desc += itf_len;
}
}
}
}
2018-12-10 13:25:57 +01:00
if (tuh_mount_cb) tuh_mount_cb(new_addr);
return true;
2018-12-05 12:58:30 +01:00
}
/* USB Host Driver task
* This top level thread manages all host controller event and delegates events to class-specific drivers.
* This should be called periodically within the mainloop or rtos thread.
*
@code
int main(void)
{
application_init();
tusb_init();
while(1) // the mainloop
{
application_code();
tuh_task(); // tinyusb host task
}
}
@endcode
*/
void tuh_task(void)
2018-12-06 18:47:16 +01:00
{
// Skip if stack is not initialized
if ( !tusb_inited() ) return;
// Loop until there is no more events in the queue
2018-12-06 18:47:16 +01:00
while (1)
{
hcd_event_t event;
if ( !osal_queue_receive(_usbh_q, &event) ) return;
2018-12-06 18:47:16 +01:00
switch (event.event_id)
{
case HCD_EVENT_DEVICE_ATTACH:
case HCD_EVENT_DEVICE_REMOVE:
2018-12-06 18:47:16 +01:00
enum_task(&event);
break;
default: break;
2018-12-06 18:47:16 +01:00
}
}
}
2018-12-05 12:58:30 +01:00
//--------------------------------------------------------------------+
// INTERNAL HELPER
//--------------------------------------------------------------------+
static inline uint8_t get_new_address(void)
{
2018-12-12 06:36:40 +01:00
for (uint8_t addr=1; addr <= CFG_TUSB_HOST_DEVICE_MAX; addr++)
{
2018-12-12 06:36:40 +01:00
if (_usbh_devices[addr].state == TUSB_DEVICE_STATE_UNPLUG) return addr;
}
return CFG_TUSB_HOST_DEVICE_MAX+1;
}
2018-03-23 06:32:40 +01:00
static inline uint8_t get_configure_number_for_device(tusb_desc_device_t* dev_desc)
{
uint8_t config_num = 1;
// invoke callback to ask user which configuration to select
2015-05-01 14:16:56 +02:00
if (tuh_device_attached_cb)
{
2018-08-23 15:09:28 +02:00
config_num = tu_min8(1, tuh_device_attached_cb(dev_desc) );
}
return config_num;
}
2018-12-09 23:07:22 +01:00
// Helper marking endpoint of interface belongs to class driver
// TODO merge with usbd
2018-12-09 23:15:49 +01:00
static void mark_interface_endpoint(uint8_t ep2drv[8][2], uint8_t const* p_desc, uint16_t desc_len, uint8_t driver_id)
2018-12-09 23:07:22 +01:00
{
uint16_t len = 0;
while( len < desc_len )
{
if ( TUSB_DESC_ENDPOINT == tu_desc_type(p_desc) )
2018-12-09 23:07:22 +01:00
{
uint8_t const ep_addr = ((tusb_desc_endpoint_t const*) p_desc)->bEndpointAddress;
ep2drv[ tu_edpt_number(ep_addr) ][ tu_edpt_dir(ep_addr) ] = driver_id;
2018-12-09 23:07:22 +01:00
}
len += tu_desc_len(p_desc);
p_desc = tu_desc_next(p_desc);
2018-12-09 23:07:22 +01:00
}
}
#endif