shared/tinyusb: Add USB device qualifier descriptor.

USB 2.0 requires high-speed capable devices to provide
a Device Qualifier descriptor.

Signed-off-by: iabdalkader <i.abdalkader@gmail.com>

Author: iabdalkader

extmod/machine_usb_device.c

@@ -58,6 +58,7 @@ static mp_obj_t usb_device_make_new(const mp_obj_type_t *type, size_t n_args, si
         o->desc_dev = mp_const_none;
         o->desc_cfg = mp_const_none;
         o->desc_strs = mp_const_none;
+        o->desc_qual = mp_const_none;
         o->open_itf_cb = mp_const_none;
         o->reset_cb = mp_const_none;
         o->control_xfer_cb = mp_const_none;

shared/tinyusb/mp_usbd.h

@@ -98,6 +98,9 @@ void mp_usbd_hex_str(char *out_str, const uint8_t *bytes, size_t bytes_len);
 // Built-in USB device and configuration descriptor values
 extern const tusb_desc_device_t mp_usbd_builtin_desc_dev;
 extern const uint8_t mp_usbd_builtin_desc_cfg[MP_USBD_BUILTIN_DESC_CFG_LEN];
+#if (CFG_TUD_MAX_SPEED == OPT_MODE_HIGH_SPEED)
+extern const tusb_desc_device_qualifier_t mp_usbd_builtin_desc_qual;
+#endif
 
 void mp_usbd_task_callback(mp_sched_node_t *node);
 
@@ -130,6 +133,7 @@ typedef struct {
     mp_obj_t desc_dev; // Device descriptor bytes
     mp_obj_t desc_cfg; // Configuration descriptor bytes
     mp_obj_t desc_strs; // List/dict/similar to look up string descriptors by index
+    mp_obj_t desc_qual; // Device qualifier descriptor for high-speed devices.
 
     // Runtime device driver callback functions
     mp_obj_t open_itf_cb;

shared/tinyusb/mp_usbd_descriptor.c

@@ -53,6 +53,21 @@ const tusb_desc_device_t mp_usbd_builtin_desc_dev = {
     .bNumConfigurations = 1,
 };
 
+#if (CFG_TUD_MAX_SPEED == OPT_MODE_HIGH_SPEED)
+// Device qualifier descriptor for high-speed devices.
+const tusb_desc_device_qualifier_t mp_usbd_builtin_desc_qual = {
+    .bLength = sizeof(tusb_desc_device_qualifier_t),
+    .bDescriptorType = TUSB_DESC_DEVICE_QUALIFIER,
+    .bcdUSB = 0x0200,
+    .bDeviceClass = TUSB_CLASS_MISC,
+    .bDeviceSubClass = MISC_SUBCLASS_COMMON,
+    .bDeviceProtocol = MISC_PROTOCOL_IAD,
+    .bMaxPacketSize0 = CFG_TUD_ENDPOINT0_SIZE,
+    .bNumConfigurations = 0x01,
+    .bReserved = 0x00,
+};
+#endif
+
 const uint8_t mp_usbd_builtin_desc_cfg[MP_USBD_BUILTIN_DESC_CFG_LEN] = {
     TUD_CONFIG_DESCRIPTOR(1, USBD_ITF_BUILTIN_MAX, USBD_STR_0, MP_USBD_BUILTIN_DESC_CFG_LEN,
         0, USBD_MAX_POWER_MA),
@@ -149,6 +164,12 @@ const uint8_t *tud_descriptor_configuration_cb(uint8_t index) {
     return mp_usbd_builtin_desc_cfg;
 }
 
+#if (CFG_TUD_MAX_SPEED == OPT_MODE_HIGH_SPEED)
+uint8_t const *tud_descriptor_device_qualifier_cb(void) {
+    return (uint8_t const *) &mp_usbd_builtin_desc_qual;
+}
+#endif
+
 #else
 
 // If runtime device support is enabled, descriptor callbacks are implemented in usbd.c

shared/tinyusb/mp_usbd_runtime.c

@@ -126,6 +126,17 @@ const uint8_t *tud_descriptor_configuration_cb(uint8_t index) {
     return result ? result : &mp_usbd_builtin_desc_cfg;
 }
 
+#if (CFG_TUD_MAX_SPEED == OPT_MODE_HIGH_SPEED)
+uint8_t const *tud_descriptor_device_qualifier_cb(void) {
+    mp_obj_usb_device_t *usbd = MP_OBJ_TO_PTR(MP_STATE_VM(usbd));
+    const void *result = NULL;
+    if (usbd) {
+        result = usbd_get_buffer_in_cb(usbd->desc_qual, MP_BUFFER_READ);
+    }
+    return result ? result : &mp_usbd_builtin_desc_qual;
+}
+#endif
+
 const char *mp_usbd_runtime_string_cb(uint8_t index) {
     mp_obj_usb_device_t *usbd = MP_OBJ_TO_PTR(MP_STATE_VM(usbd));
     nlr_buf_t nlr;