Merge branch 'feat/add_v5.0.0.0_version' into 'master'

xcguang · xcguang · commit 921b95591386 · 2025-11-25T10:20:01.000+08:00
feat: Added new v5.0.0.0 version

See merge request application/esp-at!1947
diff --git a/README.md b/README.md
@@ -28,8 +28,8 @@ The following table shows ESP-AT support status of Espressif SoCs.
 |ESP32-C2 | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v3.3.0.0) | [![alt text][supported]](https://github.com/espressif/esp-at/tree/release/v3.4.0.0) | [![alt text][supported]](https://github.com/espressif/esp-at/tree/release/v4.0.0.0) | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v4.1.1.0) | ![alt text][no-plan] | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
 |ESP32-C6 | [![alt text][supported]](https://github.com/espressif/esp-at/tree/release/v3.3.0.0) | [![alt text][supported]](https://github.com/espressif/esp-at/tree/release/v3.4.0.0) | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v4.0.0.0) | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v4.1.1.0) | ![alt text][no-plan] | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
 |ESP32-S2 | |  [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v3.4.0.0) | | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v4.1.1.0) | ![alt text][no-plan] | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
-|ESP32-C5 | | | | | ![alt text][pre-release] | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
-|ESP32-C61 | | | | | ![alt text][pre-release] | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
+|ESP32-C5 | | | | | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v5.0.0.0) | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
+|ESP32-C61 | | | | | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v5.0.0.0) | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
 
 - ![alt text][released]: Released versions. You can click ![alt text][released] to go to the corresponding release page and download the AT firmware.
 - ![alt text][supported]: Supported versions. You can click ![alt text][supported] to go to the corresponding branch and develop your own AT firmware.
diff --git a/README_CN.md b/README_CN.md
@@ -28,8 +28,8 @@ esp-at 作为由 Espressif Systems (@[espressif](https://github.com/espressif/))
 |ESP32-C2 | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v3.3.0.0) | [![alt text][supported]](https://github.com/espressif/esp-at/tree/release/v3.4.0.0) | [![alt text][supported]](https://github.com/espressif/esp-at/tree/release/v4.0.0.0) | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v4.1.1.0) | ![alt text][no-plan] | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
 |ESP32-C6 | [![alt text][supported]](https://github.com/espressif/esp-at/tree/release/v3.3.0.0) | [![alt text][supported]](https://github.com/espressif/esp-at/tree/release/v3.4.0.0) | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v4.0.0.0) | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v4.1.1.0) | ![alt text][no-plan] | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
 |ESP32-S2 | |  [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v3.4.0.0) | | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v4.1.1.0) | ![alt text][no-plan] | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
-|ESP32-C5 | | | | | ![alt text][pre-release] | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
-|ESP32-C61 | | | | | ![alt text][pre-release] | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
+|ESP32-C5 | | | | | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v5.0.0.0) | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
+|ESP32-C61 | | | | | [![alt text][released]](https://github.com/espressif/esp-at/releases/tag/v5.0.0.0) | [![alt text][supported]](https://github.com/espressif/esp-at/tree/master) |
 
 - ![alt text][released]：已发布的版本，您可以点击 ![alt text][released] 前往对应的发布页下载 AT 固件。
 - ![alt text][supported]：已支持的版本，您可以点击 ![alt text][supported] 前往对应的分支开发您自己的 AT 固件。
diff --git a/components/at/lib/VERSION b/components/at/lib/VERSION
@@ -1,7 +1,7 @@
 ESP32:   3258eee
 ESP32C3: 3258eee
 ESP32C2: 3258eee
-ESP32C5: f603c6a
+ESP32C5: 3aa9659
 ESP32C6: 3258eee
-ESP32C61:f603c6a
+ESP32C61:3aa9659
 ESP32S2: 3258eee
diff --git a/components/at/lib/libesp32c5_at_core.a b/components/at/lib/libesp32c5_at_core.a
diff --git a/components/at/lib/libesp32c5_at_core_silence.a b/components/at/lib/libesp32c5_at_core_silence.a
diff --git a/components/at/lib/libesp32c61_at_core.a b/components/at/lib/libesp32c61_at_core.a
diff --git a/components/at/lib/libesp32c61_at_core_silence.a b/components/at/lib/libesp32c61_at_core_silence.a
diff --git a/docs/_static/js/at_versions.js b/docs/_static/js/at_versions.js
@@ -6,6 +6,9 @@ var DOCUMENTATION_VERSIONS = {
         // latest
         { name: "latest", has_targets: true, supported_targets: [ "esp32", "esp32c2", "esp32c3", "esp32c5", "esp32c6", "esp32c61", "esp32s2"] },
 
+        // v5.0.0.0
+        { name: "release-v5.0.0.0", has_targets: true, supported_targets: [ "esp32", "esp32c2", "esp32c3", "esp32c5", "esp32c6", "esp32c61", "esp32s2" ] },
+
         // v4.1.0.0
         { name: "release-v4.1.0.0", has_targets: true, supported_targets: [ "esp32", "esp32c2", "esp32c3", "esp32c6", "esp32s2" ] },
 
diff --git a/docs/en/AT_Binary_Lists/esp_at_binaries.rst b/docs/en/AT_Binary_Lists/esp_at_binaries.rst
@@ -184,7 +184,14 @@ Before using the AT firmware below, please read the :doc:`../disclaimer` careful
   ESP32-C5-4MB Series
   ^^^^^^^^^^^^^^^^^^^
 
-  The first version of ESP-AT firmware is planned to be released in November 2025.
+  .. hint::
+    Please contact `Espressif Sales <https://www.espressif.com/en/contact-us/sales-questions>`_ or sales@espressif.com for AT firmware suitable for the {IDF_TARGET_NAME} series chips.
+
+    If you contact us via email, please include "Request {IDF_TARGET_NAME} AT Firmware Download Link" in the subject line, and provide the following information in the email body: your company name, the Espressif product you are using, project name, application scenario, project start date, expected mass production date, project status, annual estimated purchase quantity, and the required AT firmware version.
+
+  Released version:
+
+  - v5.0.0.0 (Recommended)
 
 .. only:: esp32c6
 
@@ -197,10 +204,17 @@ Before using the AT firmware below, please read the :doc:`../disclaimer` careful
 
 .. only:: esp32c61
 
-  ESP32-C6-4MB Series
-  ^^^^^^^^^^^^^^^^^^^
+  ESP32-C61-4MB Series
+  ^^^^^^^^^^^^^^^^^^^^
+
+  .. hint::
+    Please contact `Espressif Sales <https://www.espressif.com/en/contact-us/sales-questions>`_ or sales@espressif.com for AT firmware suitable for the {IDF_TARGET_NAME} series chips.
+
+    If you contact us via email, please include "Request {IDF_TARGET_NAME} AT Firmware Download Link" in the subject line, and provide the following information in the email body: your company name, the Espressif product you are using, project name, application scenario, project start date, expected mass production date, project status, annual estimated purchase quantity, and the required AT firmware version.
+
+  Released version:
 
-  The first version of ESP-AT firmware is planned to be released in November 2025.
+  - v5.0.0.0 (Recommended)
 
 .. only:: esp32s2
 
diff --git a/docs/en/AT_Command_Set/Basic_AT_Commands.rst b/docs/en/AT_Command_Set/Basic_AT_Commands.rst
@@ -1791,6 +1791,11 @@ Note
 - Since the RF TX Power is actually divided into several levels, and each level has its own value range, the ``wifi_power`` value queried by the ``esp_wifi_get_max_tx_power`` may differ from the value set by ``esp_wifi_set_max_tx_power`` and is no larger than the set value.
 - It is recommended to set the two parameters <ble_scan_power> and <ble_conn_power> to the same value as the <ble_adv_power> parameter. Otherwise, they will be automatically adjusted to the value of <ble_adv_power>.
 
+.. only:: esp32c61
+
+  .. attention::
+    The BLE transmit power must be configured immediately after initialization. If scanning has been enabled even once, any subsequent attempts to set the transmit power will fail.
+
 .. _cmd-RFCAL:
 
 :ref:`AT <Basic-AT>`: RF Full Calibration
diff --git a/docs/en/AT_Command_Set/Wi-Fi_AT_Commands.rst b/docs/en/AT_Command_Set/Wi-Fi_AT_Commands.rst
@@ -197,6 +197,13 @@ Note
 
     For more details, please refer to the `RF Coexistence <https://docs.espressif.com/projects/esp-idf/en/latest/{IDF_TARGET_PATH_NAME}/api-guides/coexist.html>`_ documentation.
 
+.. only:: esp32c5 or esp32c61
+
+  .. attention::
+    When {IDF_TARGET_NAME} is reconnecting to the AP, the AT+CWMODE command to switch the Wi-Fi mode (1->3 or 3->1) may fail.
+
+    Workaround: Send :ref:`AT+CWQAP <cmd-QAP>` to stop the reconnection first, and then send AT+CWMODE.
+
 Example
 ^^^^^^^^
 
diff --git a/docs/en/Get_Started/Technology_selection.rst b/docs/en/Get_Started/Technology_selection.rst
@@ -48,11 +48,11 @@ The table below lists the Espressif chips that are currently supported or planne
     -
   * - ESP32-C5
     - **5G Wi-Fi** + **Wi-Fi 6** + BLE 5.0
-    - To be released
+    - `v5.0.0.0 <https://github.com/espressif/esp-at/releases/tag/v5.0.0.0>`_
     -
   * - ESP32-C61
     - **Wi-Fi 6** + BLE 5.0
-    - To be released
+    - `v5.0.0.0 <https://github.com/espressif/esp-at/releases/tag/v5.0.0.0>`_
     -
   * - ESP32-C3
     - Wi-Fi 4 + BLE 5.0
diff --git a/docs/en/versions.rst b/docs/en/versions.rst
@@ -73,6 +73,13 @@ Each ESP-IDF major and minor release version has an associated support period. A
      - IDF Version
      - IDF EOL Date
      - AT New Version Plan
+   * - **v5.0.0.0** (2025.11.24)
+     -
+       * ESP32-C5
+       * ESP32-C61
+     - ~v5.5.2 (`cc569cbd <https://github.com/espressif/esp-idf/commit/cc569cbd>`_)
+     - 2028.1.21
+     - 2027.8.21 - 2027.10.21
    * - **v4.1.1.0** (2025.7.31)
      -
        * ESP32
diff --git a/docs/zh_CN/AT_Binary_Lists/esp_at_binaries.rst b/docs/zh_CN/AT_Binary_Lists/esp_at_binaries.rst
@@ -184,7 +184,14 @@
   ESP32-C5-4MB 系列
   ^^^^^^^^^^^^^^^^^^^^^^
 
-  计划在 2025 年 11 月发布首版 ESP-AT 固件。
+  .. hint::
+    请联系 `乐鑫商务 <https://www.espressif.com.cn/zh-hans/contact-us/sales-questions>`_ 或 sales@espressif.com 获取适用于 {IDF_TARGET_NAME} 系列芯片的 AT 固件。
+
+    若通过邮件联系，请在邮件主题注明“请求 {IDF_TARGET_NAME} AT 固件下载链接”，并在邮件正文中提供如下信息：贵司名称、使用的乐鑫产品、项目名称、应用场景、项目启动日期、预计量产日期、项目状态、年预计采购数量、需要的 AT 固件版本。
+
+  已发布的版本：
+
+  - v5.0.0.0（推荐）
 
 .. only:: esp32c6
 
@@ -200,7 +207,14 @@
   ESP32-C61-4MB 系列
   ^^^^^^^^^^^^^^^^^^^^^^
 
-  计划在 2025 年 11 月发布首版 ESP-AT 固件。
+  .. hint::
+    请联系 `乐鑫商务 <https://www.espressif.com.cn/zh-hans/contact-us/sales-questions>`_ 或 sales@espressif.com 获取适用于 {IDF_TARGET_NAME} 系列芯片的 AT 固件。
+
+    若通过邮件联系，请在邮件主题注明“请求 {IDF_TARGET_NAME} AT 固件下载链接”，并在邮件正文中提供如下信息：贵司名称、使用的乐鑫产品、项目名称、应用场景、项目启动日期、预计量产日期、项目状态、年预计采购数量、需要的 AT 固件版本。
+
+  已发布的版本：
+
+  - v5.0.0.0（推荐）
 
 .. only:: esp32s2
 
diff --git a/docs/zh_CN/AT_Command_Set/Basic_AT_Commands.rst b/docs/zh_CN/AT_Command_Set/Basic_AT_Commands.rst
@@ -1791,6 +1791,11 @@
 - 由于 RF TX Power 分为不同的等级，而每个等级都有与之对应的取值范围，所以通过 ``esp_wifi_get_max_tx_power`` 查询到的 ``wifi_power`` 的值可能与 ``esp_wifi_set_max_tx_power`` 设定的值存在差异，但不会比该值大。
 - 建议将 <ble_scan_power> 和 <ble_conn_power> 两个参数值设置为与 <ble_adv_power> 参数相同的值，否则，这两个参数将会被自动设置为与 <ble_adv_power> 相同的值。
 
+.. only:: esp32c61
+
+  .. attention::
+    - Bluetooth LE TX Power 必须在 Bluetooth LE 初始化后立即配置。如果扫描功能曾经被启用过一次，之后任意设置 Bluetooth LE TX Power 的命令将会失败。
+
 .. _cmd-RFCAL:
 
 :ref:`AT <Basic-AT>`：RF 全面校准
diff --git a/docs/zh_CN/AT_Command_Set/Wi-Fi_AT_Commands.rst b/docs/zh_CN/AT_Command_Set/Wi-Fi_AT_Commands.rst
@@ -197,6 +197,13 @@ Wi-Fi AT 命令集
 
     如您想了解更多细节，请阅读 `RF 共存 <https://docs.espressif.com/projects/esp-idf/zh_CN/latest/{IDF_TARGET_PATH_NAME}/api-guides/coexist.html>`_ 文档。
 
+.. only:: esp32c5 or esp32c61
+
+  .. attention::
+    当 {IDF_TARGET_NAME} 正在重新连接到 AP 时，切换 Wi-Fi 模式（1->3 或 3->1）的 AT+CWMODE 命令可能会失败。
+
+    解决方法：先发送 :ref:`AT+CWQAP <cmd-QAP>` 停止重连，然后再发送 AT+CWMODE。
+
 示例
 ^^^^
 
diff --git a/docs/zh_CN/Get_Started/Technology_selection.rst b/docs/zh_CN/Get_Started/Technology_selection.rst
@@ -48,11 +48,11 @@ AT 软件方案是乐鑫针对不同芯片提供的 AT 固件，可以帮助您
     -
   * - ESP32-C5
     - **5G Wi-Fi** + **Wi-Fi 6** + BLE 5.0
-    - 待发布
+    - `v5.0.0.0 <https://github.com/espressif/esp-at/releases/tag/v5.0.0.0>`_
     -
   * - ESP32-C61
     - **Wi-Fi 6** + BLE 5.0
-    - 待发布
+    - `v5.0.0.0 <https://github.com/espressif/esp-at/releases/tag/v5.0.0.0>`_
     -
   * - ESP32-C3
     - Wi-Fi 4 + BLE 5.0
diff --git a/docs/zh_CN/versions.rst b/docs/zh_CN/versions.rst
@@ -73,6 +73,14 @@ ESP-AT 的每个主要版本和次要版本都有相应的支持期限。支持
      - IDF 版本
      - IDF 支持期限截止
      - AT 新版本迭代计划
+   * - **v5.0.0.0** (2025.11.24)
+     -
+       * ESP32-C5
+       * ESP32-C61
+     - ~v5.5.2 (`cc569cbd <https://github.com/espressif/esp-idf/commit/cc569cbd>`_)
+     - 2028.1.21
+     - 2027.8.21 - 2027.10.21
+
    * - **v4.1.1.0** (2025.7.31)
      -
        * ESP32
diff --git a/module_config/module_esp32c5-sdio/sdkconfig.defaults b/module_config/module_esp32c5-sdio/sdkconfig.defaults
@@ -143,7 +143,7 @@ CONFIG_AT_BLUFI_COMMAND_SUPPORT=y
 
 # Application manager
 CONFIG_APP_PROJECT_VER_FROM_CONFIG=y
-CONFIG_APP_PROJECT_VER="v4.2.0.0-dev"
+CONFIG_APP_PROJECT_VER="v5.0.0.0"
 
 # Wear Levelling
 CONFIG_WL_SECTOR_SIZE_512=y
diff --git a/module_config/module_esp32c5-sdio/sdkconfig_silence.defaults b/module_config/module_esp32c5-sdio/sdkconfig_silence.defaults
@@ -146,7 +146,7 @@ CONFIG_AT_BLUFI_COMMAND_SUPPORT=y
 
 # Application manager
 CONFIG_APP_PROJECT_VER_FROM_CONFIG=y
-CONFIG_APP_PROJECT_VER="v4.2.0.0-dev"
+CONFIG_APP_PROJECT_VER="v5.0.0.0"
 
 # Wear Levelling
 CONFIG_WL_SECTOR_SIZE_512=y
diff --git a/module_config/module_esp32c5-spi/sdkconfig.defaults b/module_config/module_esp32c5-spi/sdkconfig.defaults
@@ -145,7 +145,7 @@ CONFIG_AT_BLUFI_COMMAND_SUPPORT=y
 
 # Application manager
 CONFIG_APP_PROJECT_VER_FROM_CONFIG=y
-CONFIG_APP_PROJECT_VER="v4.2.0.0-dev"
+CONFIG_APP_PROJECT_VER="v5.0.0.0"
 
 # Wear Levelling
 CONFIG_WL_SECTOR_SIZE_512=y
diff --git a/module_config/module_esp32c5-spi/sdkconfig_silence.defaults b/module_config/module_esp32c5-spi/sdkconfig_silence.defaults
@@ -149,7 +149,7 @@ CONFIG_AT_SIGNALING_COMMAND_SUPPORT=n
 
 # Application manager
 CONFIG_APP_PROJECT_VER_FROM_CONFIG=y
-CONFIG_APP_PROJECT_VER="v4.2.0.0-dev"
+CONFIG_APP_PROJECT_VER="v5.0.0.0"
 
 # Wear Levelling
 CONFIG_WL_SECTOR_SIZE_512=y
diff --git a/module_config/module_esp32c5_default/sdkconfig.defaults b/module_config/module_esp32c5_default/sdkconfig.defaults
@@ -142,7 +142,7 @@ CONFIG_AT_SIGNALING_COMMAND_SUPPORT=n
 
 # Application manager
 CONFIG_APP_PROJECT_VER_FROM_CONFIG=y
-CONFIG_APP_PROJECT_VER="v4.2.0.0-dev"
+CONFIG_APP_PROJECT_VER="v5.0.0.0"
 
 # Wear Levelling
 CONFIG_WL_SECTOR_SIZE_512=y
diff --git a/module_config/module_esp32c5_default/sdkconfig_silence.defaults b/module_config/module_esp32c5_default/sdkconfig_silence.defaults
@@ -145,7 +145,7 @@ CONFIG_AT_SIGNALING_COMMAND_SUPPORT=n
 
 # Application manager
 CONFIG_APP_PROJECT_VER_FROM_CONFIG=y
-CONFIG_APP_PROJECT_VER="v4.2.0.0-dev"
+CONFIG_APP_PROJECT_VER="v5.0.0.0"
 
 # Wear Levelling
 CONFIG_WL_SECTOR_SIZE_512=y
diff --git a/module_config/module_esp32c61_default/sdkconfig.defaults b/module_config/module_esp32c61_default/sdkconfig.defaults
@@ -155,7 +155,7 @@ CONFIG_AT_SOCKET_MAX_CONN_NUM=5
 
 # Application manager
 CONFIG_APP_PROJECT_VER_FROM_CONFIG=y
-CONFIG_APP_PROJECT_VER="v4.2.0.0-dev"
+CONFIG_APP_PROJECT_VER="v5.0.0.0"
 
 # Wear Levelling
 CONFIG_WL_SECTOR_SIZE_512=y
diff --git a/module_config/module_esp32c61_default/sdkconfig_silence.defaults b/module_config/module_esp32c61_default/sdkconfig_silence.defaults
@@ -158,7 +158,7 @@ CONFIG_AT_SOCKET_MAX_CONN_NUM=5
 
 # Application manager
 CONFIG_APP_PROJECT_VER_FROM_CONFIG=y
-CONFIG_APP_PROJECT_VER="v4.2.0.0-dev"
+CONFIG_APP_PROJECT_VER="v5.0.0.0"
 
 # Wear Levelling
 CONFIG_WL_SECTOR_SIZE_512=y
