esp_system: usb_console support for ESP32-S3

Closes #8879
Closes #8738

components/esp_system/include/esp_private/usb_console.h

@@ -50,14 +50,46 @@ esp_err_t esp_usb_console_init(void);
  */
 ssize_t esp_usb_console_write_buf(const char* buf, size_t size);
 
+/**
+ * @brief Wait until all buffered USB CDC output is written
+ *
+ * @return ssize_t  Number of bytes written, or -1 if the driver is not initialized
+ */
 ssize_t esp_usb_console_flush(void);
 
+/**
+ * @brief Read data from USB CDC
+ *
+ * May read less data than requested.
+ *
+ * @param buf  Buffer to read data into
+ * @param buf_size  Size of the buffer
+ * @return ssize_t  Number of bytes written into the buffer, or -1 if the driver is not initialized
+ */
 ssize_t esp_usb_console_read_buf(char* buf, size_t buf_size);
 
+/**
+ * @brief Get the number of bytes available for reading from USB CDC
+ *
+ * @return ssize_t Number of bytes available, or -1 if the driver is not initialized
+ */
 ssize_t esp_usb_console_available_for_read(void);
 
+/**
+ * @brief Check if data can be written into USB CDC
+ *
+ * @return true if data can be written now without blocking
+ */
 bool esp_usb_console_write_available(void);
 
+/**
+ * @brief Set RX/TX callback functions to be called from ISR
+ *
+ * @param rx_cb  RX callback function
+ * @param tx_cb  TX callback function
+ * @param arg  callback-specific context pointer
+ * @return ESP_OK if the callbacks were set, ESP_ERR_INVALID_STATE if the driver is not initialized
+ */
 esp_err_t esp_usb_console_set_cb(esp_usb_console_cb_t rx_cb, esp_usb_console_cb_t tx_cb, void* arg);
 
 #ifdef __cplusplus

components/esp_system/port/CMakeLists.txt

@@ -7,6 +7,10 @@ endif()
 target_include_directories(${COMPONENT_LIB} PRIVATE ${INCLUDE_FILES} include/private)
 
 set(srcs "cpu_start.c" "panic_handler.c" "brownout.c")
+if(CONFIG_ESP_CONSOLE_USB_CDC)
+    list(APPEND srcs "usb_console.c")
+endif()
+
 add_prefix(srcs "${CMAKE_CURRENT_LIST_DIR}/" ${srcs})
 
 target_sources(${COMPONENT_LIB} PRIVATE ${srcs})

components/esp_system/port/soc/esp32s2/CMakeLists.txt

@@ -22,9 +22,6 @@ endif()
 add_prefix(srcs "${CMAKE_CURRENT_LIST_DIR}/" ${srcs})
 
 target_sources(${COMPONENT_LIB} PRIVATE ${srcs})
-if(CONFIG_ESP_CONSOLE_USB_CDC)
-    target_sources(${COMPONENT_LIB} PRIVATE "${CMAKE_CURRENT_LIST_DIR}/usb_console.c")
-endif()
 
 #ld_include_highint_hdl is added as an undefined symbol because otherwise the
 #linker will ignore highint_hdl.S as it has no other files depending on any

components/esp_system/port/soc/esp32s3/CMakeLists.txt

@@ -23,9 +23,6 @@ endif()
 add_prefix(srcs "${CMAKE_CURRENT_LIST_DIR}/" ${srcs})
 
 target_sources(${COMPONENT_LIB} PRIVATE ${srcs})
-if(CONFIG_ESP_CONSOLE_USB_CDC)
-    target_sources(${COMPONENT_LIB} PRIVATE "${CMAKE_CURRENT_LIST_DIR}/usb_console.c")
-endif()
 
 #ld_include_highint_hdl is added as an undefined symbol because otherwise the
 #linker will ignore panic_highint_hdl.S as it has no other files depending on any