forked from espressif/arduino-esp32
BLE5 features to use with C3/S3 (#5085)
Added new BLE5 features to use on C3/S3 family: extended scan, extended/multi advertising New code is not fancy (no feedback from events), but i think it is functional. To get feedback from events i am suggesting to use custom GAP callback, which is already implemented in BLEDevice.
This commit is contained in:
chegewara
GitHub
@ -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
|
||||
@ -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);
|
||||
}
|
||||
@ -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);
|
||||
}
|
||||
127
libraries/BLE/examples/BLE5_periodic_sync/BLE5_periodic_sync.ino
Normal file
127
libraries/BLE/examples/BLE5_periodic_sync/BLE5_periodic_sync.ino
Normal file
@ -0,0 +1,127 @@
|
||||
/*
|
||||
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>
|
||||
|
||||
BLEScan *pBLEScan;
|
||||
static bool periodic_sync = false;
|
||||
|
||||
static esp_ble_gap_periodic_adv_sync_params_t periodic_adv_sync_params = {
|
||||
.filter_policy = 0,
|
||||
.sid = 0,
|
||||
.addr_type = BLE_ADDR_TYPE_RANDOM,
|
||||
.skip = 10,
|
||||
.sync_timeout = 1000, // timeout: 1000 * 10ms
|
||||
};
|
||||
|
||||
/**
|
||||
* @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 params)
|
||||
{
|
||||
uint8_t *adv_name = NULL;
|
||||
uint8_t adv_name_len = 0;
|
||||
adv_name = esp_ble_resolve_adv_data(params.adv_data, ESP_BLE_AD_TYPE_NAME_CMPL, &adv_name_len);
|
||||
if ((adv_name != NULL) && (memcmp(adv_name, "ESP_MULTI_ADV_2M", adv_name_len) == 0) && !periodic_sync)
|
||||
{
|
||||
periodic_sync = true;
|
||||
char adv_temp_name[60] = {'0'};
|
||||
memcpy(adv_temp_name, adv_name, adv_name_len);
|
||||
log_i("Start create sync with the peer device %s", adv_temp_name);
|
||||
periodic_adv_sync_params.sid = params.sid;
|
||||
// periodic_adv_sync_params.addr_type = params.addr_type;
|
||||
memcpy(periodic_adv_sync_params.addr, params.addr, sizeof(esp_bd_addr_t));
|
||||
esp_ble_gap_periodic_adv_create_sync(&periodic_adv_sync_params);
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
class MyPeriodicScan : public BLEPeriodicScanCallbacks
|
||||
{
|
||||
// void onCreateSync(esp_bt_status_t status){}
|
||||
// void onCancelSync(esp_bt_status_t status){}
|
||||
// void onTerminateSync(esp_bt_status_t status){}
|
||||
|
||||
void onStop(esp_bt_status_t status)
|
||||
{
|
||||
log_i("ESP_GAP_BLE_EXT_SCAN_STOP_COMPLETE_EVT");
|
||||
periodic_sync = false;
|
||||
pBLEScan->startExtScan(0, 0); // scan duration in n * 10ms, period - repeat after n seconds (period >= duration)
|
||||
}
|
||||
|
||||
void onLostSync(uint16_t sync_handle)
|
||||
{
|
||||
log_i("ESP_GAP_BLE_PERIODIC_ADV_SYNC_LOST_EVT");
|
||||
esp_ble_gap_stop_ext_scan();
|
||||
}
|
||||
|
||||
void onSync(esp_ble_periodic_adv_sync_estab_param_t params)
|
||||
{
|
||||
log_i("ESP_GAP_BLE_PERIODIC_ADV_SYNC_ESTAB_EVT, status %d", params.status);
|
||||
// esp_log_buffer_hex("sync addr", param->periodic_adv_sync_estab.adv_addr, 6);
|
||||
log_i("sync handle %d sid %d perioic adv interval %d adv phy %d", params.sync_handle,
|
||||
params.sid,
|
||||
params.period_adv_interval,
|
||||
params.adv_phy);
|
||||
}
|
||||
|
||||
void onReport(esp_ble_gap_periodic_adv_report_t params)
|
||||
{
|
||||
log_i("periodic adv report, sync handle %d data status %d data len %d rssi %d", params.sync_handle,
|
||||
params.data_status,
|
||||
params.data_length,
|
||||
params.rssi);
|
||||
}
|
||||
};
|
||||
|
||||
void setup()
|
||||
{
|
||||
Serial.begin(115200);
|
||||
Serial.println("Periodic scan...");
|
||||
|
||||
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
|
||||
pBLEScan->setPeriodicScanCallback(new MyPeriodicScan());
|
||||
delay(100); // it is just for simplicity this example, to let ble stack to set extended scan params
|
||||
pBLEScan->startExtScan(0, 0);
|
||||
|
||||
}
|
||||
|
||||
void loop()
|
||||
{
|
||||
delay(2000);
|
||||
}
|
||||
|
||||
#endif // CONFIG_BT_BLE_50_FEATURES_SUPPORTED
|
||||
Reference in New Issue
Block a user