Merge branch 'feat/support_esp32s31_dfu' into 'master'

Feat/support esp32s31 dfu

See merge request espressif/esp-idf!49329

components/soc/esp32s31/include/soc/Kconfig.soc_caps.in

@@ -107,6 +107,10 @@ config SOC_USB_OTG_SUPPORTED
     bool
     default y
 
+config SOC_USB_DFU_SUPPORTED
+    bool
+    default y
+
 config SOC_TEMP_SENSOR_SUPPORTED
     bool
     default y

components/soc/esp32s31/include/soc/soc_caps.h

@@ -49,6 +49,7 @@
 #define SOC_PARLIO_LCD_SUPPORTED        1
 #define SOC_ASYNC_MEMCPY_SUPPORTED      1
 #define SOC_USB_OTG_SUPPORTED           1
+#define SOC_USB_DFU_SUPPORTED           1
 #define SOC_TEMP_SENSOR_SUPPORTED       1
 #define SOC_USB_SERIAL_JTAG_SUPPORTED   1
 // #define SOC_SUPPORTS_SECURE_DL_MODE     1      // TODO: [ESP32S31] IDF-14629

docs/en/api-guides/dfu.rst

@@ -29,7 +29,7 @@ Device Firmware Upgrade (DFU) is a mechanism for upgrading the firmware of {IDF_
 USB Connection
 --------------
 
-.. only:: esp32p4
+.. only:: esp32p4 or esp32s31
 
     {IDF_TARGET_NAME} routes the USB D+ and D- signals to their dedicated pins. For USB device functionality, these pins must be connected to the USB bus (e.g., via a Micro-B port, USB-C port, or directly to standard-A plug).
 
@@ -161,7 +161,7 @@ Common Errors and Known Issues
 
 - The reason for ``No DFU capable USB device available`` could be that the USB driver was not properly installed on Windows (see :ref:`api_guide_dfu_flash_win`), udev rule was not setup on Linux (see :ref:`api_guide_dfu_flash_udev`) or the device is not in bootloader mode.
 
-- Flashing with ``dfu-util`` on Windows fails on the first attempt with error ``Lost device after RESET?``. Please retry the flashing and it should succeed the next time.
+- Flashing with ``dfu-util`` on Windows or macOS may fail on the first attempt with error ``Lost device after RESET?``. ``idf.py dfu-flash`` retries once automatically. If flashing still fails, run ``idf.py dfu-flash`` again manually.
 
 
 .. only:: SOC_SUPPORTS_SECURE_DL_MODE

docs/zh_CN/api-guides/dfu.rst

@@ -29,7 +29,7 @@
 USB 连接
 --------------
 
-.. only:: esp32p4
+.. only:: esp32p4 or esp32s31
 
     {IDF_TARGET_NAME} 将 USB D+ 和 D- 信号连接到其专用引脚。为了实现 USB 设备功能，这些引脚必须连接到 USB 总线，如，通过 Micro-B 接口、USB-C 接口进行连接，或直接连接到标准 A 型插头。
 
@@ -161,7 +161,7 @@ Zadig 工具可能会检测到 {IDF_TARGET_NAME} 的多个 USB 接口。请 **
 
 - 出现 ``No DFU capable USB device available`` 错误的原因可能是在 Windows 上没有正确安装 USB 驱动程序（请参考 :ref:`api_guide_dfu_flash_win`），或是未在 Linux 上设置 Udev 规则（请参考 :ref:`api_guide_dfu_flash_udev`），或是设备未处于引导加载程序模式。
 
-- 在 Windows 上使用 ``dfu-util`` 第一次烧录失败，并出现 ``Lost device after RESET?`` 错误信息。出现此问题时，请重新烧录一次，再次烧录应该会成功。
+- 在 Windows 或 macOS 上使用 ``dfu-util`` 第一次烧录可能失败，并出现 ``Lost device after RESET?`` 错误信息。``idf.py dfu-flash`` 会自动重试一次。如果仍然失败，请手动再次运行 ``idf.py dfu-flash``。
 
 
 .. only:: SOC_SUPPORTS_SECURE_DL_MODE

tools/cmake/dfu.cmake

@@ -25,10 +25,10 @@ function(__add_dfu_targets)
         return()
     elseif("${target}" STREQUAL "esp32h4")
         return()
-    elseif("${target}" STREQUAL "esp32s31")
-        return()
     elseif("${target}" STREQUAL "esp32p4")
         set(dfu_pid "12")
+    elseif("${target}" STREQUAL "esp32s31")
+        set(dfu_pid "20")
     elseif("${target}" STREQUAL "linux")
         return()
     else()

tools/cmake/run_dfu_util.cmake

@@ -23,6 +23,13 @@ endif()
 message("Command list: ${CMD}")
 execute_process(COMMAND ${CMD} RESULT_VARIABLE result)
 
+# dfu-util may fail on the first attempt while switching from runtime to DFU mode,
+# e.g. with "Lost device after RESET?" on Windows/macOS. Retry once.
+if(${result} AND NOT ${ESP_DFU_LIST})
+    message(WARNING "${TOOL} failed, retrying once...")
+    execute_process(COMMAND ${CMD} RESULT_VARIABLE result)
+endif()
+
 if(${result})
     message(FATAL_ERROR "${TOOL} failed")
 endif()

tools/cmakev2/dfu.cmake

@@ -65,6 +65,8 @@ function(idf_create_dfu binary)
         set(dfu_pid "9")
     elseif("${target}" STREQUAL "esp32p4")
         set(dfu_pid "12")
+    elseif("${target}" STREQUAL "esp32s31")
+        set(dfu_pid "20")
     else()
         # DFU not supported on this target
         idf_msg("DFU not supported on ${target}, skipping DFU target creation")