Merge branch 'docs/update_bluetooth_power_save_readme_v5.0' into 'release/v5.0'

Docs: update bluetooth power save readme(v5.0)

See merge request espressif/esp-idf!24845

docs/en/api-reference/system/sleep_modes.rst

@@ -33,6 +33,8 @@ Once wakeup sources are configured, the application can enter sleep mode using :
 
     In Deep-sleep and Light-sleep modes, the wireless peripherals are powered down. Before entering Light-sleep modes, the application must disable Wi-Fi and Bluetooth using the appropriate calls (i.e., :cpp:func:`esp_bluedroid_disable`, :cpp:func:`esp_bt_controller_disable`, :cpp:func:`esp_wifi_stop`). In both Deep-sleep and Light-sleep modes, Wi-Fi and Bluetooth connection cannot be maintained.
 
+    If Wi-Fi/Bluetooth connections need to be maintained, enable Wi-Fi/Bluetooth Modem-sleep mode and automatic Light-sleep feature (see :doc:`Power Management APIs <power_management>`). This will allow the system to wake up from sleep automatically when required by the Wi-Fi/Bluetooth driver, thereby maintaining the connection.
+
 .. only:: not SOC_BT_SUPPORTED
 
     Wi-Fi and Sleep Modes
@@ -40,7 +42,7 @@ Once wakeup sources are configured, the application can enter sleep mode using :
 
     In Deep-sleep and Light-sleep modes, the wireless peripherals are powered down. Before entering Deep-sleep or Light-sleep modes, applications must disable Wi-Fi using the appropriate calls (:cpp:func:`esp_wifi_stop`). Wi-Fi connections will not be maintained in Deep-sleep or Light-sleep mode, even if these functions are not called.
 
-If Wi-Fi connections need to be maintained, enable Wi-Fi Modem-sleep mode and automatic Light-sleep feature (see :doc:`Power Management APIs <power_management>`). This will allow the system to wake up from sleep automatically when required by the Wi-Fi driver, thereby maintaining a connection to the AP.
+    If Wi-Fi connections need to be maintained, enable Wi-Fi Modem-sleep mode and automatic Light-sleep feature (see :doc:`Power Management APIs <power_management>`). This will allow the system to wake up from sleep automatically when required by the Wi-Fi driver, thereby maintaining a connection to the AP.
 
 Wakeup Sources
 --------------
@@ -271,7 +273,11 @@ Application Example
 -------------------
 
 - :example:`protocols/sntp`: the implementation of basic functionality of Deep-sleep, where ESP module is periodically waken up to retrieve time from NTP server.
-- :example:`wifi/power_save`: the implementation of modem sleep example.
+- :example:`wifi/power_save`: the implementation of Wi-Fi Modem-sleep example.
+
+.. only:: SOC_BT_SUPPORTED
+
+    - :example:`bluetooth/nimble/power_save`: the implementation of Bluetooth Modem-sleep example.
 
 .. only:: SOC_ULP_SUPPORTED
 

docs/zh_CN/api-reference/system/sleep_modes.rst

@@ -33,6 +33,8 @@ Light-sleep 和 Deep-sleep 模式有多种唤醒源。这些唤醒源也可以
 
     在 Light-sleep 和 Deep-sleep 模式下，无线外设会被断电。因此，在进入这两种睡眠模式前，应用程序必须调用恰当的函数（:cpp:func:`esp_bluedroid_disable`、:cpp:func:`esp_bt_controller_disable` 或 :cpp:func:`esp_wifi_stop`）来禁用 Wi-Fi 和 Bluetooth。在 Light-sleep 或 Deep-sleep 模式下，即使不调用这些函数也无法连接 Wi-Fi 和 Bluetooth。
 
+    如需保持 Wi-Fi 和 Bluetooth 连接，请启用 Wi-Fi 和 Bluetooth Modem-sleep 模式和自动 Light-sleep 模式（请参阅 :doc:`电源管理 API <power_management>`）。在这两种模式下，Wi-Fi 和 Bluetooth 驱动程序发出请求时，系统将自动从睡眠中被唤醒，从而保持连接。
+
 .. only:: not SOC_BT_SUPPORTED
 
     睡眠模式下的 Wi-Fi 功能
@@ -40,7 +42,7 @@ Light-sleep 和 Deep-sleep 模式有多种唤醒源。这些唤醒源也可以
 
     在 Light-sleep 和 Deep-sleep 模式下，无线外设会被断电。因此，在进入 Light-sleep 模式前，应用程序必须调用恰当的函数 (:cpp:func:`esp_wifi_stop`) 来禁用 Wi-Fi。在 Light-sleep 和 Deep-sleep 模式下均无法保持 Wi-Fi 的连接。
 
-如需保持 Wi-Fi 连接，请启用 Wi-Fi Modem-sleep 模式和自动 Light-sleep 模式（请参阅 :doc:`电源管理 API <power_management>`）。在这两种模式下，Wi-Fi 驱动程序发出请求时，系统将自动从睡眠中被唤醒，从而保持与 AP 的连接。
+    如需保持 Wi-Fi 连接，请启用 Wi-Fi Modem-sleep 模式和自动 Light-sleep 模式（请参阅 :doc:`电源管理 API <power_management>`）。在这两种模式下，Wi-Fi 驱动程序发出请求时，系统将自动从睡眠中被唤醒，从而保持与 AP 的连接。
 
 唤醒源
 ---------
@@ -258,7 +260,11 @@ UART 输出处理
 -------------------
 
 - :example:`protocols/sntp`：如何实现 Deep-sleep 模式的基本功能，周期性唤醒 ESP 模块，以从 NTP 服务器获取时间。
-- :example:`wifi/power_save`：如何实现 Modem-sleep 模式。
+- :example:`wifi/power_save`：如何实现 Wi-Fi Modem-sleep 模式。
+
+.. only:: SOC_BT_SUPPORTED
+
+    - :example:`bluetooth/nimble/power_save`：如何实现 Bluetooth Modem-sleep 模式。
 
 .. only:: SOC_ULP_SUPPORTED
 

examples/bluetooth/nimble/power_save/README.md

@@ -8,8 +8,9 @@ This example is based on the [bleprph](../bleprph) example to show how to use th
 
 If the modem sleep mode is enabled, bluetooth will switch periodically between active and sleep.
 In sleep state, RF, PHY and BB are turned off in order to reduce power consumption.
+For more information about sleep modes, please refer to [Sleep Modes](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/system/sleep_modes.html).
 
-This example contains five build configurations. For each configuration, a few configuration options are set:
+This example contains some build configurations. For each configuration, a few configuration options are set:
 - `sdkconfig.defaults.esp32`: ESP32 uses 32kHz XTAL as low power clock in light sleep enabled.
 - `sdkconfig.defaults.esp32c3`: ESP32C3 uses 32kHz XTAL as low power clock in light sleep enabled.
 - `sdkconfig.40m.esp32c3`: ESP32C3 uses main XTAL as low power clock in light sleep enabled.