ESPHome 2026.5.0b1
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}
71
73 esp_ble_ibeacon_t ibeacon_adv_data;
74 memcpy(&ibeacon_adv_data.ibeacon_head, &IBEACON_COMMON_HEAD, sizeof(esp_ble_ibeacon_head_t));
75 memcpy(&ibeacon_adv_data.ibeacon_vendor.proximity_uuid, this->uuid_.data(),
76 sizeof(ibeacon_adv_data.ibeacon_vendor.proximity_uuid));
77 ibeacon_adv_data.ibeacon_vendor.minor = byteswap(this->minor_);
78 ibeacon_adv_data.ibeacon_vendor.major = byteswap(this->major_);
79 ibeacon_adv_data.ibeacon_vendor.measured_power = static_cast<uint8_t>(this->measured_power_);
80
81 esp_err_t err;
82#ifndef CONFIG_ESP_HOSTED_ENABLE_BT_BLUEDROID
83 ESP_LOGD(TAG, "Setting BLE TX power");
84 err = esp_ble_tx_power_set(ESP_BLE_PWR_TYPE_ADV, this->tx_power_);
85 if (err != ESP_OK) {
86 ESP_LOGW(TAG, "esp_ble_tx_power_set failed: %s", esp_err_to_name(err));
87 }
88#endif
89 err = esp_ble_gap_config_adv_data_raw((uint8_t *) &ibeacon_adv_data, sizeof(ibeacon_adv_data));
90 if (err != ESP_OK) {
91 ESP_LOGE(TAG, "esp_ble_gap_config_adv_data_raw failed: %s", esp_err_to_name(err));
92 return;
93 }
94}
95
96void ESP32BLEBeacon::gap_event_handler(esp_gap_ble_cb_event_t event, esp_ble_gap_cb_param_t *param) {
97 if (!this->advertising_)
98 return;
99
100 esp_err_t err;
101 switch (event) {
102 case ESP_GAP_BLE_ADV_DATA_RAW_SET_COMPLETE_EVT: {
103 err = esp_ble_gap_start_advertising(&this->ble_adv_params_);
104 if (err != ESP_OK) {
105 ESP_LOGE(TAG, "esp_ble_gap_start_advertising failed: %s", esp_err_to_name(err));
106 }
107 break;
108 }
109 case ESP_GAP_BLE_ADV_START_COMPLETE_EVT: {
110 err = param->adv_start_cmpl.status;
111 if (err != ESP_BT_STATUS_SUCCESS) {
112 ESP_LOGE(TAG, "BLE adv start failed: %s", esp_err_to_name(err));
113 }
114 break;
115 }
116 case ESP_GAP_BLE_ADV_STOP_COMPLETE_EVT: {
117 err = param->adv_stop_cmpl.status;
118 if (err != ESP_BT_STATUS_SUCCESS) {
119 ESP_LOGE(TAG, "BLE adv stop failed: %s", esp_err_to_name(err));
120 } else {
121 ESP_LOGD(TAG, "BLE stopped advertising successfully");
122 }
123 // this->advertising_ = false;
124 break;
125 }
126 default:
127 break;
128 }
129}
130
131} // namespace esphome::esp32_ble_beacon
132
133#endif
void advertising_register_raw_advertisement_callback(std::function< void(bool)> &&callback)
Definition ble.cpp:126
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:718
constexpr float AFTER_BLUETOOTH
Definition component.h:47
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:1255
void byteswap()