docs: tinyusb documentation

components/soc/soc/esp32s2/include/soc/soc_caps.h

@@ -9,3 +9,4 @@
 #define SOC_CPU_CORES_NUM 1
 #define SOC_SUPPORTS_SECURE_DL_MODE 1
 #define SOC_RISCV_COPROC_SUPPORTED 1
+#define SOC_USB_SUPPORTED 1

components/tinyusb/additions/include/tinyusb.h

@@ -71,9 +71,9 @@ extern "C" {
  * @brief Configuration structure of the tinyUSB core
  */
 typedef struct {
-    tusb_desc_device_t *descriptor;
-    char **string_descriptor;
-    bool external_phy;
+    tusb_desc_device_t *descriptor; /*!< Pointer to a device descriptor */
+    char **string_descriptor;       /*!< Pointer to an array of string descriptors */
+    bool external_phy;              /*!< Should USB use an external PHY */
 } tinyusb_config_t;
 
 esp_err_t tinyusb_driver_install(const tinyusb_config_t *config);

components/tinyusb/additions/include/tusb_cdc_acm.h

@@ -40,22 +40,22 @@ typedef enum{
  * @brief Data provided to the input of the `callback_rx_wanted_char` callback
  */
 typedef struct {
-    char wanted_char;
+    char wanted_char; /*!< Wanted character */
 } cdcacm_event_rx_wanted_char_data_t;
 
 /**
  * @brief Data provided to the input of the `callback_line_state_changed` callback
  */
 typedef struct {
-    bool dtr;
-    bool rts;
+    bool dtr; /*!< Data Terminal Ready (DTR) line state */
+    bool rts; /*!< Request To Send (RTS) line state */
 } cdcacm_event_line_state_changed_data_t;
 
 /**
  * @brief Data provided to the input of the `line_coding_changed` callback
  */
 typedef struct {
-    cdc_line_coding_t const *p_line_coding;
+    cdc_line_coding_t const *p_line_coding; /*!< New line coding value */
 } cdcacm_event_line_coding_changed_data_t;
 
 /**
@@ -72,7 +72,7 @@ typedef enum {
  * @brief Describes an event passing to the input of a callbacks
  */
 typedef struct {
-    cdcacm_event_type_t type;
+    cdcacm_event_type_t type; /*!< Event type */
     union {
         cdcacm_event_rx_wanted_char_data_t rx_wanted_char_data;
         cdcacm_event_line_state_changed_data_t line_state_changed_data;

components/tinyusb/additions/include/tusb_tasks.h

@@ -33,7 +33,7 @@ extern "C" {
 esp_err_t tusb_run_task(void);
 
 /**
- * @brief Stops a FreeRTOS task with @ref tusb_device_task
+ * @brief Stops a FreeRTOS task
  *
  * @return ESP_OK or ESP_FAIL
  */