Bluetooth LE & Bluetooth

[中文]

When porting example gatt_server, an error occurred indicating head file does not exist. What could be the reasons?

When porting example gatt_server, an error occurred as fatal error: esp_gap_ble_api.h: No such file or directory, but this file is already included in the head file.

  • Check sdkconfig to see whether sdkconfig.defaults is ported from the example or not. By default, Bluetooth® is disabled in SDK and needs to be enabled manually.

  • If you are using cmake, the link configurations in the CMakeLists.txt file should be copied from the example too.

Does ESP32 support Bluetooth 5.0?

No, the ESP32 hardware only supports Bluetooth LE 4.2.

ESP32 has passed Bluetooth LE 5.0 certification, but does not support the new functions of Bluetooth LE 5.0. If you need to use the features of Bluetooth LE 5.0, please choose other ESP32 series chips.

After the Bluetooth® LE starts advertising, why some mobile phones cannot successfully scan them?

  • Please check whether your mobile phone supports Bluetooth LE function. Some mobile phones, such as iPhones, display Classic Bluetooth only in “Settings” -> “Bluetooth” (by default), and the Bluetooth LE advertisement will be filtered out.

  • It is recommended to use a dedicated Bluetooth LE application to debug the Bluetooth LE function. For example, LightBlue application can be used on iPhone.

  • Please check whether the advertising packet conforms to the specified format. Mobile phones tend to filter out packets that do not conform to the specified format and display only the correct ones.

Can I process OTA through Bluetooth LE on ESP32?

Yes, please refer to the instance BLE_OTA.

What is the throughput of ESP32 Bluetooth® LE?

  • The throughput of ESP32 Bluetooth LE depends on various factors such as environmental interference, connection interval, MTU size, and the performance of peer devices.

  • The maximum throughput of Bluetooth LE communication between ESP32 boards can reach up to 700 Kbps, which is about 90 KB/s. For details, please refer to example ble_throughput in ESP-IDF.

Does ESP32 support Bluetooth® 4.2 DLE (Data Length Extension)？

Yes. Bluetooth® 4.2 DLE is supported in all versions of ESP-IDF, and can be implemented by calling corresponding APIs directly. Please refer to esp_ble_gap_set_pkt_data_len.

How can I get ESP32 Bluetooth® Compatibility Test Report?

Please contact sales@espressif.com.

What is the transmit power of ESP32 Bluetooth LE?

The ESP32 Bluetooth LE has 8 transmit power levels, corresponding to -12 ~ 9 dBm of transmit power, with a 3 dBm interval. The controller software limits the transmit power and selects the power level according to the corresponding power level declared by the product.

Could ESP32 realize bridging between Wi-Fi and Bluetooth® LE?

Yes, this function is developed on the application layer. You can retrieve data through Bluetooth LE and send them out via Wi-Fi. For detailed information, please refer to Wi-Fi and Bluetooth LE Coexist demo.

What is the operating current of ESP32 Bluetooth® LE?

Current

MAX (mA)

Min (mA)

Average (mA)

Advertising: Adv Interval = 40 ms

142.1

32

42.67

Scanning: Scan Interval = 160 ms, Window = 20 ms

142.1

32

44.4

Connection(Slave): Connection Interval = 20 ms, latency = 0

142.1

32

42.75

Connection(Slave): Connection Interval = 80 ms, latency = 0

142.1

32

35.33

What kinds of Bluetooth® LE profiles does ESP32 support?

Currently, ESP32 Bluetooth LE fully supports some basic profiles, such as GATT/SMP/GAP, as well as some self-defined profiles. The ones that have already been implemented include Bluetooth LE HID (receiving side), Bluetooth LE SPP-Like, Battery, DIS, BluFi (Bluetooth Network Configuration-transmitting side), and so on.

What is the maximum transmission rate for ESP32 Bluetooth® LE?

The transmission rate of ESP32 Bluetooth LE can reach 700 Kbps when it is tested in a shielded box.

How does ESP32 Bluetooth® LE enter Light-sleep mode?

On the hardware level, a 32 kHz external crystal should be added, or the Light-sleep mode will not take effect.

On the software level (SDK4.0 and later versions), the following configurations should be enabled in menuconfig:

  • Power Management:| menuconfig > Component config > Power management > [*] Support for power management

  • Tickless Idle:| menuconfig > Component config > FreeRTOS > [*] Tickless idle support (3) Minimum number of ticks to enter sleep mode for (NEW)

Note

Tickless idle needs to be enabled to allow automatic light-sleep mode. FreeRTOS will enter Light-sleep mode if no tasks need to run for 3 ticks (by default), that is 30 ms if tick rate is 100 Hz. Configure the FreeRTOS tick rate to be higher if you want to allow shorter duration of light-sleep mode, for example: menuconfig > ``Component config > FreeRTOS > (1000) Tick rate (Hz).

  • Configure external 32.768 kHz crystal as RTC clock source :| menuconfig > Component config > ESP32-specific > RTC clock source (External 32 kHz crystal)[*] Additional current for external 32 kHz crystal

Note

The “additional current” option is a workaround for a hardware issue on ESP32 that the crystal can fail in oscillating. Please enable this option when you use external 32 kHz crystal. This hardware issue will be resolved in the next chip revision.

  • Enable Bluetooth modem sleep with external 32.768kHz crystal as low power clock :| menuconfig > Component config > Bluetooth > Bluetooth controller > MODEM SLEEP Options > [*] Bluetooth modem sleep

Are there any documentation references for ESP32 BluFi networking?

For BluFi networking, please refer to ESP32 Blufi. For BluFi networking examples, please refer to Blufi.

How many Bluetooth LE clients can be connected to ESP32?

The Bluetooth LE server supports up to nine client connections, please check the configuration of parameter ble_max_conn for applications. For stable connection, three clients should be good.

How can I get the MAC address of Bluetooth® devices for ESP32?

You can get the MAC address configured by Bluetooth via API esp_bt_dev_get_address(void);, also the system pre-defined MAC address types via API esp_err_t esp_read_mac(uint8_t* mac,esp_mac_type_ttype);.

Is it possible to use Wi-Fi Smartconfig and Bluetooth® LE Mesh for ESP32 simultaneously?

It is not recommended to use them simultaneously.

  • The Smartconfig will need to receive the networking data, thus occupying the antenna all the time. If it is used together with Bluetooth LE Mesh, there will be an extremely high rate of failure.

  • The Bluetooth LE Mesh can be used together with BluFi. So it is recommended to use BluFi for networking.

How can I modify the transmit power of Bluetooth® LE for ESP32 series chips？

For ESP32/ESP32-S3/ESP32-C3, the Bluetooth transmit power can be configured via function esp_ble_tx_power_set(). For details, please refer to esp_bt.h. For ESP32-C6/ESP32-C2/ESP32-H2, you can set the transmit power by calling the esp_ble_tx_power_set_enhanced() API.

How is the networking compatibility of ESP32 Bluetooth® LE? Is it open-sourced?

  • ESP32 Bluetooth networking, BluFi networking for short, has a good compatibility as Bluetooth LE and is compatible with many mainstream mobile phones such as Apple, HUAWEI, Mi, OPPO, MEIZU, OnePlus, ZTE and etc.

  • Currently, the BluFi protocol and phone application code is open-sourced.

How is the security of ESP32 Bluetooth® LE/Bluetooth® Secure Simple Pairing (SSP) compared to legacy pairing?

  • Secure Simple Pairing (SSP) is more secure than legacy pairing.

  • The legacy pairing uses symmetric encryption algorithm, while Secure Simple Pairing (SSP) uses asymmetric cryptography algorithm.

How can I confirm the MTU size of ESP32 Bluetooth® LE?

  • By default, the MTU size of ESP32 Bluetooth LE is 23 bytes, and can be configured to reach 517 bytes.

  • For phones, the MTU size can be self-defined. Then, the end device with a smaller MTU will be chosen for communication.

Does ESP32 Bluetooth® LE support Client-Server mode, in which gatt server and gatt client can coexist?

What are the risks if there are over six devices connected to ESP32 Bluetooth® LE?

  • Usually it depends on the specific application scenario. In general, the ESP32 Bluetooth LE can communicate stably with three devices connected.

  • There is no exact number for maximum Bluetooth LE connections. When there are multiple devices connected to Bluetooth LE simultaneously, the RF is time-multiplexed, thus requiring the designer to ensure that each device is not overly occupied, causing other devices to timeout and disconnected.

  • The connection parameters include: connection interval, connection window, latency and timeout. It is ok for devices to not respond within the latency, but if the responding time exceeds timeout threshold, the device will be disconnected.

  • If the interval is configured to 100 and window to 5, the Bluetooth LE will be able to connect to more devices with Wi-Fi disconnected. However, If Wi-Fi is connected and the value of interval is too small, only a few devices can be connected.

  • When the Bluetooth LE supports multiple devices connected simultaneously, there will be bigger possibility for RF solt management to generate error. So when there are multiple connections for Bluetooth LE, it is necessary to debug for different scenarios.

When using ESP32 device as the server of Bluetooth® LE, how many client devices can be connected?

  • The ESP32 Bluetooth LE supports up to nine client devices for connection. It is recommended to hold this number within three.

  • Please make configurations via menuconfig > Component config > Bluetooth > Bluetooth controller > BLE MAX Connections.

When I use the “BluFi” example to configure network for ESP32, the Wi-Fi cannot be connected during the distribution process via the EspBluFi application since a wrong Wi-Fi has been configured. Then the device is restarted after sending a SCAN command from the application. What is the reason?

  • The “BluFi” example stipulates that Wi-Fi “SCAN” commands cannot be sent when Wi-Fi is connected.

  • To solve this issue, you can add ESP_ERROR_CHECK(esp_wifi_disconnect()); to the first line of the ESP_BLUFI_EVENT_GET_WIFI_LIST:{}; function under the blufi_example_main.c file.

When I set name for the bluetooth of an ESP32 device using Chinese characters, messy code shows instead. What is the reason？

  • This is because the Chinese encoding format of the editor is not UTF-8 at this time, and the encoding format of the editor needs to be changed to UTF-8.

When I upload sub-packages to the Bluetooth channel using ESP32, the maximum transmission data length of a packet is 253 (MTU is set to 263). This results in slower transmission when a large number of data packets are transmitted for multi-packet reading. Is there a BluFi extension protocol that can support the transmission of a larger length of data in one packet, or are there other solutions to increase the transmission rate?

  • The transmission is slow When a large number of data packets on the Bluetooth channel are transmitted for multi-packet reading. You can improve the transmission speed by adjusting the Bluetooth connection parameters.

  • The BLE packet length setting depends on the ESP_GATT_MAX_MTU_SIZE setting, please refer to the Description.

  • The configured MTU size will affect the data transmission rate. The effective MTU length needs to be changed by MTU exchange to change the default MTU size. The MTU size used in the final MTU exchange is used as the MTU size for the communication between the two devices. You can check the value of the MTU after exchange, such as the follows:

case ESP_GATTS_MTU_EVT:
        ESP_LOGI(GATTS_TAG, "ESP_GATTS_MTU_EVT, MTU%d", param->mtu.mtu);

How many stable connections can be reached for ESP32-C3’s Bluetooth® LE?

Depending on the connection parameters, no more than eight are allowed. For better multi-connection performance, please choose ESP32-C6 series.

How can I adjust the BLE advertising interval?

  • The advertising interval is decided by adv_int_min and adv_int_max parameters in BLE advertising struct, which configures the minimum and maximum advertising interval respectively.

  • The advertising interval ranges from 0x0020 to 0x4000 and the default value is 0x0800. The interval time is the value * 0.625 ms, i.e., 20 ms to 10.24 sec.

  • If the values of adv_int_min and adv_int_max are different, the advertising interval is within the range of the two values. If the values are the same, the interval will be this fixed value.

How much memory does ESP32 Bluetooth occupy?

  • Controller:

    • BLE single mode: 40 KB

    • BR/EDR single mode: 65 KB

    • Dual mode: 120 KB

  • Main equipment:

    • BLE GATT Client (Gatt Client demo): 24 KB (.bss+.data) + 23 KB (heap) = 47 KB

    • BLE GATT Server (GATT Server demo): 23 KB (.bss+.data) + 23 KB (heap) = 46 KB

    • BLE GATT Client & GATT Server: 24 KB (.bss+.data) + 24 KB (heap) = 48 KB

    • SMP: 5 KB

    • Classic Bluetooth (Classic Bluetooth A2DP_SINK demo, including SMP/SDP/A2DP/AVRCP): 48 KB (.bss+.data) + 24 KB (heap) = 72 KB (an additional 13 KB is added when the example is running)

Note

The above heap (Heap) all include the task stack (Task Stack), because the task stack is allocated from the heap and considered as a heap.

  • Optimized PSRAM version:

In ESP-IDF v3.0 and later versions, if you open the PSRAM related options of the Bluetooth menu in menuconfig, and put part of the .bss/.data section and heap of Bluedroid (Host) into PSRAM, almost 50 KB memory space can be saved.

When I use the “gattc_gatts_coex.c” example on ESP32 to test BLE multi-connection, it can only connect to four devices even after I set the BLE Max connections in menuconfig to five. What is the reason?

  • Please set the BT/BLE MAX ACL CONNECTION in menuconfig to five.

Does ESP32-C3 BLE support master and slave mode at the same time? What is the number of connections in master mode and slave mode?

IDF: release/v4.3, master

  • ESP32-C3 supports master and slave mode at the same time, which share 8 connections. For example, if ESP32-C3 connects to 4 slave devices, it can be connected by 8 - 4 = 4 master devices.

  • In addition, when ESP32-C3 is used as a slave, it can be connected by 8 master devices; when used as a master, it can connect to 8 slave devices.

How does BLE capture packets?

  • There are many available tools, such as:

    • TI Packet sniffer

    • NRF Packet sniffer

When I use an ESP32 development board to test several versions of bluefi example under ESP-IDF for networking, the following error kept printing. What is the reason?

E (117198) BT_L2CAP: l2ble_update_att_acl_pkt_num not found p_tcb
W (117198) BT_BTC: btc_blufi_send_encap wait to send blufi custom data

  • When this error occurs, please modify the esp_ble_get_cur_sendable_packets_num(blufi_env.conn_id) to esp_ble_get_sendable_packets_num() in the components/bt/host/bluedroid/btc/profile/esp/blufi/blufi_prf.c file.

  • This bug has been fixed in all branches, you can update ESP-IDF to the latest release version.

When I use ESP32, can Light-sleep mode be enabled for Bluetooth and can Bluetooth be kept connected in Light-sleep mode?

How can I modify the Bluetooth device name of ESP32?

  • The structure to be modified is as follows:

    static uint8_t raw_adv_data[] = {

        /* flags*/

        0x02, 0x01, 0x06,

        Tx power*/

        0x02, 0x0a, 0xeb,

        /* service uuid*/

        0x03, 0x03, 0xFF, 0x00,

        /* device name*/

        0x0f, 0x09,'E','S','P','_','G','A','T','T','S','_','D','E ','M','O'

};

  • The above /* device name*/ is the modified item. Among them, 0x0f is the total length of the field type plus specific content, and 0x09 indicates that this type refers to the device name. Subsequent’E’,’S’,’P’,’_’,’G’,’A’,’T’,’T’,’S’,’_’,’D’,’E’, ‘M’,’O’ are the ASCII code of the broadcast device name.

What is the maximum supported broadcast length of BLE 5.0 broadcast after it is set to legacy mode?

  • The maximum supported length is 31-byte.

How can I set a BLE broadcast package as unconnectable package?

CHIP: ESP32

  • please reffer to the gatt_server demo，and set adv_type as ADV_TYPE_NONCONN_IND.

    static esp_ble_adv_params_t adv_params = {
  .adv_int_min        = 0x20,
  .adv_int_max        = 0x40,
  .adv_type           = ADV_TYPE_NONCONN_IND,
  .own_addr_type      = BLE_ADDR_TYPE_PUBLIC,
  //.peer_addr            =
  //.peer_addr_type       =
  .channel_map        = ADV_CHNL_ALL,
  .adv_filter_policy = ADV_FILTER_ALLOW_SCAN_ANY_CON_ANY,
  }

How many devices can be connected at the most as suggested by the White List of ESP32 Bluetooth LE?

  • The maximum supported number is 12.

Can ESP32 Bluetooth LE use PSRAM?

To enable Bluetooth LE to use PSRAM, please go to Component config > Bluetooth > Bluedroid Options and enable BT/BLE will first malloc the memory from the PSRAM。

When using ESP32-C3 BLE Scan, can I set it to only scan the Long Range devices?

Is there a limit to the name length of ESP32 as a Bluetooth device?

  • The names should be no longer than 248 bytes. However, in practice, the name length is also limited by the length of Bluetooth advertising packets. For the description of configurations, please refer to CONFIG_BT_MAX_DEVICE_NAME_LEN.

How do I set the ESP32 BLE Scan to the permanent scan without generating a timeout?

How can I get RSSI of BLE devices through ESP32?

  • You can use the esp_ble_gap_read_rssi() function to get RSSI of connected BLE devices.

  • If you want to get RSSI of all scanned BLE devices around, please use the ble_scan_result_evt_param structure in the ESP_GAP_BLE_SCAN_RESULT_EVT event to enable the printing of RSSI.

How can I increase the transmission distance of BLE5.0? How can I set BLE5.0 to long-range mode?

  • In practice, the transmission distance of BLE5.0 is about 200 m. It is recommended to refer to the actual test distance. ESP32-S3 supports the features of BLE5.0, and supports long-range communication through Coded PHY (125 Kbps and 500 Kbps) and broadcast extension.

  • You can realize long-range communication by using 125 Kbps Coded PHY and increasing the transmit power (tx_power). Refer to the following settings:

    esp_ble_gap_ext_adv_params_t ext_adv_params_coded = {
  .type = ESP_BLE_GAP_SET_EXT_ADV_PROP_SCANNABLE,
  .interval_min = 0x50,
  .interval_max = 0x50,
  .channel_map = ADV_CHNL_ALL,
  .filter_policy = ADV_FILTER_ALLOW_SCAN_ANY_CON_ANY,
  .primary_phy = ESP_BLE_GAP_PHY_CODED,
  .max_skip = 0,
  .secondary_phy = ESP_BLE_GAP_PHY_CODED,
  .sid = 0,
  .scan_req_notif = false,
  .own_addr_type = BLE_ADDR_TYPE_RANDOM,
  .tx_power = 18,
};

  • For the BLE5.0 examples, please refer to ble_50 examples in ESP-IDF.

I have changed the name of the Bluetooth device with esp_ble_gap_set_device_name() in ESP32-C3. It works for Android devices and the customized device name can be shown. However, it does not work on IOS devices. The device name is still the default Bluetooth name. How can I make it work on Apple devices as well?

  • In this case, you need to use raw data to create BLE advertising packets. First, enable the CONFIG_SET_RAW_ADV_DATA option in menuconfig (idf.py menuconfig > Example 'GATT SERVER' Config > Use raw data for advertising packets and scan response data), and then customize Broadcast packet structure in the gatt server example.

  • Please use nRF Connect APP to test. We have tested and it works on the nRF connect APP. This issue is related to IOS APPs.

I want to use two ESP32 development boards to test the Bluetooth connection. How can I set the specified key to automatically connect them with gatt_security_client and gatt_security_server examples?

After setting gatt_security_server to ESP_IO_CAP_OUT mode and setting gatt_security_client to ESP_IO_CAP_OUT mode, I deliberately set the wrong passkey. However, the two development boards can still be connected. What is the reason?

  • When the server is set to ESP_IO_CAP_OUT mode, gatt_security_client should be set to ESP_IO_CAP_IN mode.

  • To avoid such a situation, please add the following code into the case ESP_GAP_BLE_PASSKEY_REQ_EVT event on the gatt_security_client side:

    esp_ble_passkey_reply(param->ble_security.ble_req.bd_addr, true, 123457);

Does ESP32-C3/ESP32-C6/ESP32-S3 support Bluetooth AOA/AOD?

ESP32-C3/ESP32-C6/ESP32-S3 do not support Bluetooth AOA/AOD.

What is the maximum length of data in a BLE advertising packet supported by ESP32-C3 with the BLE5.0 feature?

Does ESP32 have any API to check whether BLE advertising has started or stopped?

  • For bluedroid stack, there is no such API currently.

  • For Nimble stack (and using non-extended advertising of BLE 4.2), you can use the ble_gap_adv_active API.

Does ESP32 support multiple clients connecting at the same time when used as a BLE server? How to realize it?

  • ESP32 can be used as a BLE server supporting multiple BLE clients to access simultaneously. Meanwhile, it can also be used as a BLE client connecting to multiple BLE servers simultaneously.

  • When used as a BLE server, you can simply enable advertising again after a client connects. Take gatt_server_service_table as an example, after receiving the ESP_GATTS_CONNECT_EVT event, please call esp_ble_gap_start_advertising() to enable advertising.

  • When used as a BLE client, please refer to gattc_multi_connect.

How to set the continuous scanning time for BLE5.0?

How to set up the GATT service with a 128-bit UUID based on the GATT Server example?

You can refer to the following code:

static const uint8_t pctool_service_uuid[16] = {
    0x00, 0x03, 0xcd, 0xd0, 0x00, 0x00, 0x10, 0x00, 0x80, 0x00, 0x00, 0x80, 0x5f, 0x9b, 0x01, 0x31
};
static const uint8_t pctool_write_uuid[16] = {
    0x00, 0x03, 0xcd, 0xd2, 0x00, 0x00, 0x10, 0x00, 0x80, 0x00, 0x00, 0x80, 0x5f, 0x9b, 0x01, 0x31
};
/* Full Database Description - Used to add attributes into the database */
static const esp_gatts_attr_db_t gatt_db[HRS_IDX_NB] =
{
    // Service Declaration
    [IDX_SVC]        =
    {
{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)&primary_service_uuid, ESP_GATT_PERM_READ,
      sizeof(pctool_service_uuid), sizeof(pctool_service_uuid), (uint8_t *)&pctool_service_uuid}
},
    /* Characteristic Declaration */
    [IDX_CHAR_A]     =
    {
{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_16, (uint8_t *)&character_declaration_uuid, ESP_GATT_PERM_READ,
      CHAR_DECLARATION_SIZE, CHAR_DECLARATION_SIZE, (uint8_t *)&char_prop_read_write_notify}
},
    /* Characteristic Value */
    [IDX_CHAR_VAL_A] =
    {
{ESP_GATT_AUTO_RSP}, {ESP_UUID_LEN_128, (uint8_t *)&pctool_write_uuid, ESP_GATT_PERM_READ | ESP_GATT_PERM_WRITE,
      GATTS_DEMO_CHAR_VAL_LEN_MAX, sizeof(char_value), (uint8_t *)char_value}
},
}

When testing based on the GATT Server example, is it possible to delete the default 1800 and 1801 service attributes?

  • The 1800 and 1801 service attributes are two standard GATT service attributes in the BLE protocol, which cannot be deleted or disabled. They are part of the BLE protocol specifications, providing basic device information and general access capabilities, and maintaining compatibility with the standard BLE protocol.

  • 0x1800 refers to generic access, defining the general attributes of the device, while 0x1801 refers to generic attribute, a simple GATT service used to provide basic information about the device.

Is there an explanation for the BLE error codes in the ESP-IDF SDK?

  • The BLE error codes in the ESP-IDF SDK refer to the BLE standard protocol. The corresponding error code descriptions can be found in LIST OF BLE ERROR CODES.

The error below occurred when setting the Bluetooth mode to Component config > Bluetooth > Controller Options > Bluetooth controller mode (BR/EDR/BLE/DUALMODE) dual mode based on the BLE SPP Server example. What could be the reason for this?

E (2906) GATTS_SPP_DEMO: spp_gatt_init enable controller failed: ESP_ERR_INVALID_ARG

Is there an example of implementing a Bluetooth LE Eddystone beacon based on ESP32?

Is there an official Bluetooth LE OTA example?

  • Yes, see esp-iot-solution/examples/bluetooth/ble_ota.

  • In addition, the source code of the Bluetooth LE OTA APP for the Android and IOS versions is now public on GitHub. See Android source code and IOS source code. You need to manually put the bin file to be upgraded into a specific APP path. The README of the corresponding GitHub project provides instructions on where to put the file.

For the ble_ota example in the esp-iot-solution repo, the default Bluetooth protocol stack is Bluedroid. The Android EspBleOTA APP cannot detect the device name ESP&C919, while the IOS EspBleOTA APP can. Why?

  • For the ble_ota example, the default Bluetooth protocol stack is Bluedroid, and Bluetooth LE 5.0 features are enabled by default. The configuration path is: menuconfig > Component config > Bluetooth > Bluedroid Options > Enable BLE 5.0 features. However, the current Android EspBleOTA APP does not support scanning Bluetooth LE 5.0 devices, so the device name cannot be scanned by this Android APP.

  • Bluetooth 4.0 and 5.0 protocols in the Android system use two APIs to realize the Bluetooth scanning functionality, while the two protocols in the IOS system apply the same API. Thus, the IOS APP can scan the device.

  • Some compatible adjustments should be made to scan devices with the Android APP. However, we do not have such development plans currently. If you want to scan the device with the Android APP, please turn off Bluetooth LE 5.0 features.

  • Additionally, when the protocol stack is set to Nimble, the Android APP can scan the device name nimble-ble-ota. This is because when using Nimble, the Bluetooth LE 5.0 extended broadcast is turned off by default. This can be configured in menuconfig > Example Configuration > Enable Extended Adv.

Does the NimBLE on ESP32-C3 support the Coded PHY mode?

Yes, but only in the ESP-IDF v5.0 and above versions. You can refer to the esp-idf/examples/bluetooth/nimble/ble_phy example, which supports switching between 1 Mbps PHY, 2 Mbps PHY, and Coded PHY (125 Kbps and 500 Kbps).

Does ESP32-S3 support simultaneous broadcastingscanningconnecting under both 125 Kbps Coded PHY and 1 Mbps PHY?

How to resolve the error A stack overflow in stack BTC_TASK has been detected printed during Bluetooth operation?

This is due to a stack overflow in the Bluetooth controller task. You can increase the stack size in menuconfig: idf.py menuconfig –> Component config –> Bluetooth –> Bluedriod options –> (3072)Bluetooth event(callback to application) task stack size.

Can ESP-IDF enable both BLE4.2 and BLE5.0 at the same time?

Currently, both BLE4.2 and BLE5.0 can be enabled simultaneously in menuconfig, but the APIs for BLE4.2 and BLE5.0 are different and can not be used interchangeably. Therefore, in the future, it will be modified to only allow either BLE4.2 or BLE5.0 to be enabled, and it will not be possible to enable both at the same time.

When the ESP32 device acts as a BLE server, how does the slave initiate MTU negotiation?

According to the BLE protocol, MTU negotiation must be initiated by the client, the server can not initiate it. Therefore, the slave can act as a client to initiate MTU negotiation.


Suggestion on this document?

 Provide feedback