esp-idf/examples/bluetooth/nimble/power_save
2024-04-02 12:16:56 +08:00
..
main fix(ble): fix ci ble powe save test addresss error 2024-03-25 15:59:26 +08:00
CMakeLists.txt feat(examples): add local components via idf_component.yml 2023-09-19 10:38:24 +02:00
README.md change(ble): support ble light sleep using ext 32k xtal on C2 2024-04-02 12:16:56 +08:00
sdkconfig.26m.esp32c2 change(ble): support ble light sleep using ext 32k xtal on C2 2024-04-02 12:16:56 +08:00
sdkconfig.32m.esp32h2 change(ble): npl count is zero if nimble host is not used 2024-01-19 16:14:55 +08:00
sdkconfig.40m.esp32c3 bt: Added an example of Bluetooth using light sleep 2023-05-04 14:41:31 +08:00
sdkconfig.40m.esp32c6 change(ble): npl count is zero if nimble host is not used 2024-01-19 16:14:55 +08:00
sdkconfig.40m.esp32s3 bt: Added an example of Bluetooth using light sleep 2023-05-04 14:41:31 +08:00
sdkconfig.ci fix(ble): fix ci ble powe save test addresss error 2024-03-25 15:59:26 +08:00
sdkconfig.ci.esp32c2_xtal26m fix(ble): fix ci ble powe save test addresss error 2024-03-25 15:59:26 +08:00
sdkconfig.defaults bt: Added an example of Bluetooth using light sleep 2023-05-04 14:41:31 +08:00
sdkconfig.defaults.esp32 bt: Added an example of Bluetooth using light sleep 2023-05-04 14:41:31 +08:00
sdkconfig.defaults.esp32c2 change(ble): support ble light sleep using ext 32k xtal on C2 2024-04-02 12:16:56 +08:00
sdkconfig.defaults.esp32c3 fix(ble): Fixed the issue of being unable to enter light sleep 2024-01-22 10:45:27 +08:00
sdkconfig.defaults.esp32c6 change(ble): npl count is zero if nimble host is not used 2024-01-19 16:14:55 +08:00
sdkconfig.defaults.esp32h2 change(ble): npl count is zero if nimble host is not used 2024-01-19 16:14:55 +08:00
sdkconfig.defaults.esp32s3 fix(ble): Fixed the issue of being unable to enter light sleep 2024-01-22 10:45:27 +08:00

Supported Targets ESP32 ESP32-C2 ESP32-C3 ESP32-C6 ESP32-H2 ESP32-S3

Bluetooth Power Save Example

This example is based on the bleprph example to show how to use the bluetooth power save mode.

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.

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.
  • sdkconfig.defaults.esp32c6: ESP32C6 uses 32kHz XTAL as low power clock in light sleep enabled.
  • sdkconfig.40m.esp32c6: ESP32C6 uses main XTAL as low power clock in light sleep enabled.
  • sdkconfig.defaults.esp32s3: ESP32S3 uses 32kHz XTAL as low power clock in light sleep enabled.
  • sdkconfig.40m.esp32s3: ESP32S3 uses main XTAL as low power clock in light sleep enabled.
  • sdkconfig.defaults.esp32h2: ESP32H2 uses 32kHz XTAL as low power clock in light sleep enabled.
  • sdkconfig.32m.esp32h2: ESP32H2 uses main XTAL as low power clock in light sleep enabled.
  • sdkconfig.defaults.esp32c2: ESP32C2 uses 32kHz XTAL as low power clock in light sleep enabled.
  • sdkconfig.26m.esp32c2: ESP32C2 uses main XTAL as low power clock in light sleep enabled.

How to use example

Hardware Required

This example should be able to run on any commonly available ESP32/ESP32-C3/ESP32-S3/ESP32-H2/ESP32-C6 development board.

Configure the project

idf.py menuconfig
  1. Configure RTC clock source:
    • Component config > Hardware Settings > RTC Clock Config > RTC clock source
  2. Enable power management:
    • Component config > Power Management > [*] Support for power management
  3. Configure FreeRTOS:
    • Component config > FreeRTOS > Kernel
      • (1000) configTICK_RATE_HZ
      • [*] configUSE_TICKLESS_IDLE
      • (3) configEXPECTED_IDLE_TIME_BEFORE_SLEEP

For Chip ESP32/ESP32-C3/ESP32-S3

  1. Enable power down MAC and baseband:
    • Component config > PHY > [*] Power down MAC and baseband of Wi-Fi and Bluetooth when PHY is disabled
  2. Enable bluetooth modem sleep:
    • Component config > Bluetooth > Controller Options > MODEM SLEEP Options
      • [*] Bluetooth modem sleep
      • [*] Bluetooth Modem sleep Mode 1
  3. Configure bluetooth low power clock:
    • Component config > Bluetooth > Controller Options > MODEM SLEEP Options > Bluetooth modem sleep > Bluetooth Modem sleep Mode 1 > Bluetooth low power clock
  4. Enable power up main XTAL during light sleep:
    • Component config > Bluetooth > Controller Options > MODEM SLEEP Options > [*] power up main XTAL during light sleep

For Chip ESP32-C6/ESP32-H2/ESP32-C2

  1. Enable bluetooth modem sleep:
    • Component config > Bluetooth > Controller Options
      • [*] Enable BLE sleep
  2. Configure bluetooth low power clock:
    • Component config > Bluetooth > Controller Options > BLE low power clock source
    • Use RTC clock source as low power clock source during light sleep:
      • (X) Use system RTC slow clock source
  3. Power down flash during light sleep:
    • Component config > Hardware Settings > Sleep Config
      • [*] Power down flash in light sleep when there is no SPIRAM

Build and Flash

idf.py -D SDKCONFIG_DEFAULTS="sdkconfig.defaults;sdkconfig.40m.esp32c3" set-target ESP32C3 build
  • -D SDKCONFIG_DEFAULTS select configuration file to be used for creating app sdkconfig.
  • set-target Set the chip target to build.

To flash the project and see the output, run:

idf.py -p PORT flash monitor

(Replace PORT with the name of the serial port to use.)

(To exit the serial monitor, type Ctrl-].)

See the Getting Started Guide for full steps to configure and use ESP-IDF to build projects.

Example Output

When you run this example, the prints the following at the very beginning:

I (333) cpu_start: Starting scheduler.
I (347) pm: Frequency switching config: CPU_MAX: 160, APB_MAX: 80, APB_MIN: 40, Light sleep: ENABLED
I (351) sleep: Enable automatic switching of GPIO sleep configuration
I (358) BTDM_INIT: BT controller compile version [f2e5d81]
I (365) BTDM_INIT: Bluetooth will use main XTAL as Bluetooth sleep clock.
I (372) phy_init: phy_version 912,d001756,Jun  2 2022,16:28:07
I (411) system_api: Base MAC address is not set
I (412) system_api: read default base MAC address from EFUSE
I (412) BTDM_INIT: Bluetooth MAC: 7c:df:a1:61:b6:f6

I (419) NimBLE_BLE_PRPH: BLE Host Task Started
I (424) uart: queue free spaces: 8
I (432) NimBLE: GAP procedure initiated: stop advertising.

I (435) NimBLE: Device Address:
I (437) NimBLE: 7c:df:a1:61:b6:f6
I (441) NimBLE:

I (446) NimBLE: GAP procedure initiated: advertise;
I (450) NimBLE: disc_mode=2
I (453) NimBLE:  adv_channel_map=0 own_addr_type=0 adv_filter_policy=0 adv_itvl_min=0 adv_itvl_max=0
I (463) NimBLE:

Typical current consumption with management enabled

max current modem sleep light sleep (main XTAL) light sleep (32KHz XTAL)
ESP32 231 mA 14.1 mA X 1.9 mA
ESP32C3 262 mA 12 mA 2.3 mA 140 uA
ESP32S3 240 mA 17.9 mA 3.3 mA 230 uA
ESP32C6 240 mA 22 mA 3.3 mA 34 uA
ESP32H2 82 mA 16.0 mA 4.0 mA 24 uA
ESP32C2 130 mA 18.0 mA 2.5 mA 169 uA

X: This feature is currently not supported.

Example Breakdown

  • ESP32 does not support the use of main XTAL in light sleep mode, so an external 32kHz crystal is required.
  • ESP32C2 support XTAL frequency of 26MHz and 40MHz, the XTAL frequency is set to 26MHz in default.
  • ESP32C2 support external 32kHz crystal by connecting the crystal to the chip through pin0