BLE5 features to use with C3/S3

libraries/BLE/examples/BLE5_extended_scan/BLE5_extended_scan.ino

@@ -0,0 +1,69 @@
+/*
+   BLE5 extended scan example for esp32 C3 and S3
+   with this code it is simple to scan legacy (BLE4) compatible advertising,
+   and BLE5 extended advertising. New coded added in BLEScan is not changing old behavior,
+   which can be used with old esp32, but is adding functionality to use on C3/S3.
+   With this new API advertised device wont be stored in API, it is now user responsibility
+
+   author: chegewara
+*/
+#ifndef CONFIG_BT_BLE_50_FEATURES_SUPPORTED
+#warning "Not compatible hardware"
+#else
+#include <BLEDevice.h>
+#include <BLEUtils.h>
+#include <BLEScan.h>
+#include <BLEAdvertisedDevice.h>
+
+uint32_t scanTime = 100; //In 10ms (1000ms)
+BLEScan* pBLEScan;
+
+/**
+* @brief extend adv report parameters
+*/
+//typedef struct {
+//    esp_ble_gap_adv_type_t event_type;              /*!< extend advertising type */
+//    uint8_t addr_type;                              /*!< extend advertising address type */
+//    esp_bd_addr_t addr;                             /*!< extend advertising address */
+//    esp_ble_gap_pri_phy_t primary_phy;              /*!< extend advertising primary phy */
+//    esp_ble_gap_phy_t secondly_phy;                 /*!< extend advertising secondary phy */
+//    uint8_t sid;                                    /*!< extend advertising sid */
+//    uint8_t tx_power;                               /*!< extend advertising tx power */
+//    int8_t rssi;                                    /*!< extend advertising rssi */
+//    uint16_t per_adv_interval;                      /*!< periodic advertising interval */
+//    uint8_t dir_addr_type;                          /*!< direct address type */
+//    esp_bd_addr_t dir_addr;                         /*!< direct address */
+//    esp_ble_gap_ext_adv_data_status_t data_status;  /*!< data type */
+//    uint8_t adv_data_len;                           /*!< extend advertising data length */
+//    uint8_t adv_data[251];                          /*!< extend advertising data */
+//} esp_ble_gap_ext_adv_reprot_t;
+
+class MyBLEExtAdvertisingCallbacks: public BLEExtAdvertisingCallbacks {
+    void onResult(esp_ble_gap_ext_adv_reprot_t report) {
+      if(report.event_type & ESP_BLE_GAP_SET_EXT_ADV_PROP_LEGACY){
+        // here we can receive regular advertising data from BLE4.x devices
+        Serial.println("BLE4.2");
+      } else {
+        // here we will get extended advertising data that are advertised over data channel by BLE5 divices
+        Serial.printf("Ext advertise: data_le: %d, data_status: %d \n", report.adv_data_len, report.data_status);
+      }
+    }
+};
+
+void setup() {
+  Serial.begin(115200);
+  Serial.println("Scanning...");
+
+  BLEDevice::init("");
+  pBLEScan = BLEDevice::getScan(); //create new scan
+  pBLEScan->setExtendedScanCallback(new MyBLEExtAdvertisingCallbacks());
+  pBLEScan->setExtScanParams(); // use with pre-defined/default values, overloaded function allows to pass parameters
+  delay(1000); // it is just for simplicity this example, to let ble stack to set extended scan params
+  pBLEScan->startExtScan(scanTime, 3); // scan duration in n * 10ms, period - repeat after n seconds (period >= duration)
+}
+
+void loop() {
+  // put your main code here, to run repeatedly:
+  delay(2000);
+}
+#endif // CONFIG_BT_BLE_50_FEATURES_SUPPORTED

libraries/BLE/examples/BLE5_multi_advertising/BLE5_multi_advertising.ino

@@ -0,0 +1,142 @@
+/*
+   Simple BLE5 multi advertising example on esp32 C3/S3
+   only ESP_BLE_GAP_SET_EXT_ADV_PROP_LEGACY_IND is backward compatible
+   and can be scanned with BLE4.2 devices
+
+   author: chegewara
+*/
+
+#include <BLEDevice.h>
+#include <BLEAdvertising.h>
+
+esp_ble_gap_ext_adv_params_t ext_adv_params_1M = {
+    .type = ESP_BLE_GAP_SET_EXT_ADV_PROP_CONNECTABLE,
+    .interval_min = 0x30,
+    .interval_max = 0x30,
+    .channel_map = ADV_CHNL_ALL,
+    .own_addr_type = BLE_ADDR_TYPE_RANDOM,
+    .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_1M,
+    .sid = 0,
+    .scan_req_notif = false,
+};
+
+esp_ble_gap_ext_adv_params_t ext_adv_params_2M = {
+    .type = ESP_BLE_GAP_SET_EXT_ADV_PROP_SCANNABLE,
+    .interval_min = 0x40,
+    .interval_max = 0x40,
+    .channel_map = ADV_CHNL_ALL,
+    .own_addr_type = BLE_ADDR_TYPE_RANDOM,
+    .filter_policy = ADV_FILTER_ALLOW_SCAN_ANY_CON_ANY,
+    .primary_phy = ESP_BLE_GAP_PHY_1M,
+    .max_skip = 0,
+    .secondary_phy = ESP_BLE_GAP_PHY_2M,
+    .sid = 1,
+    .scan_req_notif = false,
+};
+
+esp_ble_gap_ext_adv_params_t legacy_adv_params = {
+    .type = ESP_BLE_GAP_SET_EXT_ADV_PROP_LEGACY_IND,
+    .interval_min = 0x45,
+    .interval_max = 0x45,
+    .channel_map = ADV_CHNL_ALL,
+    .own_addr_type = BLE_ADDR_TYPE_RANDOM,
+    .filter_policy = ADV_FILTER_ALLOW_SCAN_ANY_CON_ANY,
+    .primary_phy = ESP_BLE_GAP_PHY_1M,
+    .max_skip = 0,
+    .secondary_phy = ESP_BLE_GAP_PHY_1M,
+    .sid = 2,
+    .scan_req_notif = false,
+};
+
+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,
+    .own_addr_type = BLE_ADDR_TYPE_RANDOM,
+    .filter_policy = ADV_FILTER_ALLOW_SCAN_ANY_CON_ANY,
+    .primary_phy = ESP_BLE_GAP_PHY_1M,
+    .max_skip = 0,
+    .secondary_phy = ESP_BLE_GAP_PHY_CODED,
+    .sid = 3,
+    .scan_req_notif = false,
+};
+
+static uint8_t raw_adv_data_1m[] = {
+        0x02, 0x01, 0x06,
+        0x02, 0x0a, 0xeb,
+        0x12, 0x09, 'E', 'S', 'P', '_', 'M', 'U', 'L', 'T', 'I', '_', 'A',
+        'D', 'V', '_', '1', 'M', 0X0
+};
+
+static uint8_t raw_scan_rsp_data_2m[] = {
+        0x02, 0x01, 0x06,
+        0x02, 0x0a, 0xeb,
+        0x12, 0x09, 'E', 'S', 'P', '_', 'M', 'U', 'L', 'T', 'I', '_', 'A',
+        'D', 'V', '_', '2', 'M', 0X0
+};
+
+static uint8_t legacy_adv_data[] = {
+        0x02, 0x01, 0x06,
+        0x02, 0x0a, 0xeb,
+        0x15, 0x09, 'E', 'S', 'P', '_', 'M', 'U', 'L', 'T', 'I', '_', 'A',
+        'D', 'V', '_', 'C', 'O', 'D', 'E', 'D', 0X0
+};
+
+static uint8_t legacy_scan_rsp_data[] = {
+        0x02, 0x01, 0x06,
+        0x02, 0x0a, 0xeb,
+        0x16, 0x09, 'E', 'S', 'P', '_', 'M', 'U', 'L', 'T', 'I', '_', 'A',
+        'D', 'V', '_', 'L', 'E', 'G', 'A', 'C', 'Y', 0X0
+};
+
+static uint8_t raw_scan_rsp_data_coded[] = {
+        0x37, 0x09, 'V', 'E', 'R', 'Y', '_', 'L', 'O', 'N', 'G', '_', 'D', 'E', 'V', 'I', 'C', 'E', '_', 'N', 'A', 'M', 'E', '_',
+        'S', 'E', 'N', 'T', '_', 'U', 'S', 'I', 'N', 'G', '_', 'E', 'X', 'T', 'E', 'N', 'D', 'E', 'D', '_', 'A', 'D', 'V', 'E', 'R', 'T', 'I', 'S', 'I', 'N', 'G', 0X0
+};
+
+
+uint8_t addr_1m[6] = {0xc0, 0xde, 0x52, 0x00, 0x00, 0x01};
+uint8_t addr_2m[6] = {0xc0, 0xde, 0x52, 0x00, 0x00, 0x02};
+uint8_t addr_legacy[6] = {0xc0, 0xde, 0x52, 0x00, 0x00, 0x03};
+uint8_t addr_coded[6] = {0xc0, 0xde, 0x52, 0x00, 0x00, 0x04};
+
+BLEMultiAdvertising advert(4); // max number of advertisement data 
+
+void setup() {
+  Serial.begin(115200);
+  Serial.println("Multi-Advertising...");
+
+  BLEDevice::init("");
+
+  advert.setAdvertisingParams(0, &ext_adv_params_1M);
+  advert.setAdvertisingData(0, sizeof(raw_adv_data_1m), &raw_adv_data_1m[0]);
+  advert.setInstanceAddress(0, addr_1m);
+  advert.setDuration(0);
+
+  advert.setAdvertisingParams(1, &ext_adv_params_2M);
+  advert.setScanRspData(1, sizeof(raw_scan_rsp_data_2m), &raw_scan_rsp_data_2m[0]);
+  advert.setInstanceAddress(1, addr_2m);
+  advert.setDuration(1);
+
+  advert.setAdvertisingParams(2, &legacy_adv_params);
+  advert.setAdvertisingData(2, sizeof(legacy_adv_data), &legacy_adv_data[0]);
+  advert.setScanRspData(2, sizeof(legacy_scan_rsp_data), &legacy_scan_rsp_data[0]);
+  advert.setInstanceAddress(2, addr_legacy);
+  advert.setDuration(2);
+
+  advert.setAdvertisingParams(3, &ext_adv_params_coded);
+  advert.setDuration(3);
+  advert.setScanRspData(3, sizeof(raw_scan_rsp_data_coded), &raw_scan_rsp_data_coded[0]);
+  advert.setInstanceAddress(3, addr_coded);
+
+  delay(1000);
+  advert.start(4, 0);
+}
+
+void loop() {
+  delay(2000);
+}

libraries/BLE/examples/BLE5_periodic_advertising/BLE5_periodic_advertising.ino

@@ -0,0 +1,72 @@
+/*
+   Simple BLE5 multi advertising example on esp32 C3/S3
+   only ESP_BLE_GAP_SET_EXT_ADV_PROP_NONCONN_NONSCANNABLE_UNDIRECTED can be used for periodic advertising
+
+   author: chegewara
+*/
+
+#include <BLEDevice.h>
+#include <BLEAdvertising.h>
+
+
+esp_ble_gap_ext_adv_params_t ext_adv_params_2M = {
+    .type = ESP_BLE_GAP_SET_EXT_ADV_PROP_NONCONN_NONSCANNABLE_UNDIRECTED,
+    .interval_min = 0x40,
+    .interval_max = 0x40,
+    .channel_map = ADV_CHNL_ALL,
+    .own_addr_type = BLE_ADDR_TYPE_RANDOM,
+    .filter_policy = ADV_FILTER_ALLOW_SCAN_ANY_CON_ANY,
+    .primary_phy = ESP_BLE_GAP_PHY_1M,
+    .max_skip = 0,
+    .secondary_phy = ESP_BLE_GAP_PHY_2M,
+    .sid = 1,
+    .scan_req_notif = false,
+};
+
+static uint8_t raw_scan_rsp_data_2m[] = {
+        0x02, 0x01, 0x06,
+        0x02, 0x0a, 0xeb,
+        0x12, 0x09, 'E', 'S', 'P', '_', 'M', 'U', 'L', 'T', 'I', '_', 'A',
+        'D', 'V', '_', '2', 'M', 0X0
+};
+
+static esp_ble_gap_periodic_adv_params_t periodic_adv_params = {
+    .interval_min = 0x320, // 1000 ms interval
+    .interval_max = 0x640,
+    .properties = 0, // Do not include TX power
+};
+
+static uint8_t periodic_adv_raw_data[] = {
+        0x02, 0x01, 0x06,
+        0x02, 0x0a, 0xeb,
+        0x03, 0x03, 0xab, 0xcd,
+        0x11, 0x09, 'E', 'S', 'P', '_', 'P', 'E', 'R', 'I', 'O', 'D', 'I',
+        'C', '_', 'A', 'D', 'V'
+};
+
+
+uint8_t addr_2m[6] = {0xc0, 0xde, 0x52, 0x00, 0x00, 0x02};
+
+BLEMultiAdvertising advert(1); // max number of advertisement data 
+
+void setup() {
+  Serial.begin(115200);
+  Serial.println("Multi-Advertising...");
+
+  BLEDevice::init("");
+
+  advert.setAdvertisingParams(0, &ext_adv_params_2M);
+  advert.setAdvertisingData(0, sizeof(raw_scan_rsp_data_2m), &raw_scan_rsp_data_2m[0]);
+  advert.setInstanceAddress(0, addr_2m);
+  advert.setDuration(0, 0, 0);
+
+  delay(100);
+  advert.start();
+  advert.setPeriodicAdvertisingParams(0, &periodic_adv_params);
+  advert.setPeriodicAdvertisingData(0, sizeof(periodic_adv_raw_data), &periodic_adv_raw_data[0]);
+  advert.startPeriodicAdvertising(0);
+}
+
+void loop() {
+  delay(2000);
+}