ESPHome 2026.10.0-dev
Loading...
Searching...
No Matches
esp32_ble_beacon.cpp
Go to the documentation of this file.
1#include "esp32_ble_beacon.h"
2#include "esphome/core/log.h"
3
4#ifdef USE_ESP32
5
6#ifndef CONFIG_ESP_HOSTED_ENABLE_BT_BLUEDROID
7#include <esp_bt.h>
8#endif
9#include <esp_bt_main.h>
10#include <esp_gap_ble_api.h>
11#include <freertos/FreeRTOS.h>
12#include <freertos/task.h>
13#include <nvs_flash.h>
14#include <cstring>
15
16#include "esphome/core/hal.h"
18
20
21static const char *const TAG = "esp32_ble_beacon";
22
23static const esp_ble_ibeacon_head_t IBEACON_COMMON_HEAD = {
24 .flags = {0x02, 0x01, 0x06}, .length = 0x1A, .type = 0xFF, .company_id = {0x4C, 0x00}, .beacon_type = {0x02, 0x15}};
25
27 ESP_LOGCONFIG(TAG, "ESP32 BLE Beacon:");
28 char uuid[37];
29 char *bpos = uuid;
30 for (int8_t ii = 0; ii < 16; ++ii) {
31 *bpos++ = format_hex_pretty_char(this->uuid_[ii] >> 4);
32 *bpos++ = format_hex_pretty_char(this->uuid_[ii] & 0x0F);
33 if (ii == 3 || ii == 5 || ii == 7 || ii == 9) {
34 *bpos++ = '-';
35 }
36 }
37 *bpos = '\0';
38#ifndef CONFIG_ESP_HOSTED_ENABLE_BT_BLUEDROID
39 ESP_LOGCONFIG(TAG,
40 " UUID: %s, Major: %u, Minor: %u, Min Interval: %ums, Max Interval: %ums, Measured Power: %d"
41 ", TX Power: %ddBm",
42 uuid, this->major_, this->minor_, this->min_interval_, this->max_interval_, this->measured_power_,
43 (this->tx_power_ * 3) - 12);
44#else
45 ESP_LOGCONFIG(TAG, " UUID: %s, Major: %u, Minor: %u, Min Interval: %ums, Max Interval: %ums, Measured Power: %d",
46 uuid, this->major_, this->minor_, this->min_interval_, this->max_interval_, this->measured_power_);
47#endif
48}
49
51
53 this->ble_adv_params_ = {
54 .adv_int_min = static_cast<uint16_t>(this->min_interval_ / 0.625f),
55 .adv_int_max = static_cast<uint16_t>(this->max_interval_ / 0.625f),
56 .adv_type = ADV_TYPE_NONCONN_IND,
57 .own_addr_type = BLE_ADDR_TYPE_PUBLIC,
58 .peer_addr = {0x00, 0x00, 0x00, 0x00, 0x00, 0x00},
59 .peer_addr_type = BLE_ADDR_TYPE_PUBLIC,
60 .channel_map = ADV_CHNL_ALL,
61 .adv_filter_policy = ADV_FILTER_ALLOW_SCAN_ANY_CON_ANY,
62 };
63
65 this->advertising_ = advertise;
66 if (advertise) {
67 this->on_advertise_();
68 }
69 });
70 // A beacon always needs the device to advertise, and never releases the request
72}
73
75 esp_ble_ibeacon_t ibeacon_adv_data;
76 memcpy(&ibeacon_adv_data.ibeacon_head, &IBEACON_COMMON_HEAD, sizeof(esp_ble_ibeacon_head_t));
77 memcpy(&ibeacon_adv_data.ibeacon_vendor.proximity_uuid, this->uuid_.data(),
78 sizeof(ibeacon_adv_data.ibeacon_vendor.proximity_uuid));
79 ibeacon_adv_data.ibeacon_vendor.minor = byteswap(this->minor_);
80 ibeacon_adv_data.ibeacon_vendor.major = byteswap(this->major_);
81 ibeacon_adv_data.ibeacon_vendor.measured_power = static_cast<uint8_t>(this->measured_power_);
82
83 esp_err_t err;
84#ifndef CONFIG_ESP_HOSTED_ENABLE_BT_BLUEDROID
85 ESP_LOGD(TAG, "Setting BLE TX power");
86 err = esp_ble_tx_power_set(ESP_BLE_PWR_TYPE_ADV, this->tx_power_);
87 if (err != ESP_OK) {
88 ESP_LOGW(TAG, "esp_ble_tx_power_set failed: %s", esp_err_to_name(err));
89 }
90#endif
91 err = esp_ble_gap_config_adv_data_raw((uint8_t *) &ibeacon_adv_data, sizeof(ibeacon_adv_data));
92 if (err != ESP_OK) {
93 ESP_LOGE(TAG, "esp_ble_gap_config_adv_data_raw failed: %s", esp_err_to_name(err));
94 return;
95 }
96}
97
98void ESP32BLEBeacon::gap_event_handler(esp_gap_ble_cb_event_t event, esp_ble_gap_cb_param_t *param) {
99 if (!this->advertising_)
100 return;
101
102 esp_err_t err;
103 switch (event) {
104 case ESP_GAP_BLE_ADV_DATA_RAW_SET_COMPLETE_EVT: {
105 err = esp_ble_gap_start_advertising(&this->ble_adv_params_);
106 if (err != ESP_OK) {
107 ESP_LOGE(TAG, "esp_ble_gap_start_advertising failed: %s", esp_err_to_name(err));
108 }
109 break;
110 }
111 case ESP_GAP_BLE_ADV_START_COMPLETE_EVT: {
112 err = param->adv_start_cmpl.status;
113 if (err != ESP_BT_STATUS_SUCCESS) {
114 ESP_LOGE(TAG, "BLE adv start failed: %s", esp_err_to_name(err));
115 }
116 break;
117 }
118 case ESP_GAP_BLE_ADV_STOP_COMPLETE_EVT: {
119 err = param->adv_stop_cmpl.status;
120 if (err != ESP_BT_STATUS_SUCCESS) {
121 ESP_LOGE(TAG, "BLE adv stop failed: %s", esp_err_to_name(err));
122 } else {
123 ESP_LOGD(TAG, "BLE stopped advertising successfully");
124 }
125 // this->advertising_ = false;
126 break;
127 }
128 default:
129 break;
130 }
131}
132
133} // namespace esphome::esp32_ble_beacon
134
135#endif
void advertising_start()
Request advertising on behalf of a component.
Definition ble.cpp:101
void advertising_register_raw_advertisement_callback(std::function< void(bool)> &&callback)
Definition ble.cpp:159
void gap_event_handler(esp_gap_ble_cb_event_t event, esp_ble_gap_cb_param_t *param)
struct { uint8_t flags[3]; uint8_t length; uint8_t type; uint8_t company_id[2]; uint8_t beacon_type[2];} __attribute__((packed)) esp_ble_ibeacon_head_t
struct { esp_ble_ibeacon_head_t ibeacon_head; esp_ble_ibeacon_vendor_t ibeacon_vendor;} __attribute__((packed)) esp_ble_ibeacon_t
ESP32BLE * global_ble
Definition ble.cpp:816
constexpr float AFTER_BLUETOOTH
Definition component.h:49
ESPHOME_ALWAYS_INLINE char format_hex_pretty_char(uint8_t v)
Convert a nibble (0-15) to uppercase hex char (used for pretty printing)
Definition helpers.h:1291
void byteswap()