目录
- 实例1:静态开启广播数据
- 实例2:动态更改广播数据
- 实例3:创建可连接的广播
实例1:静态开启广播数据
新建一个hello world的工程模板。
- 在prj.conf中开启蓝牙
CONFIG_BT=y
这个宏,默认会开启广播支持 ( BT_BROADCASTER) ,使用softDevice控制器 ( BT_LL_CHOICE= BT_LL_SOFTDEVICE),发射功率为0dBm( BT_CTLR_TX_PWR = BT_CTLR_TX_PWR_0)。
- 设置设备名称
添加以下行prj.conf:
CONFIG_BT_DEVICE_NAME="Nordic_Beacon"
- 设置广播数据
/* STEP 4.1.1 - Declare the advertising packet */
static const struct bt_data ad[] = {/* STEP 4.1.2 - Set the advertising flags */BT_DATA_BYTES(BT_DATA_FLAGS, BT_LE_AD_NO_BREDR),/* STEP 4.1.3 - Set the advertising packet data */BT_DATA(BT_DATA_NAME_COMPLETE, DEVICE_NAME, DEVICE_NAME_LEN),};
- 设置扫描响应数据
/* STEP 4.2.2 - Declare the URL data to include in the scan response */
static unsigned char url_data[] = {0x17, '/', '/', 'b', 'a', 'i', 'd', 'u', '.','c', 'o', 'm'};/* STEP 4.2.1 - Declare the scan response packet */
static const struct bt_data sd[] = {/* 4.2.3 Include the URL data in the scan response packet*/BT_DATA(BT_DATA_URI, url_data, sizeof(url_data)),
};
- 使能蓝牙协议栈
err = bt_enable(NULL);if (err){LOG_ERR("Bluetooth init failed (err %d)\n", err);return -1;}
- 开启蓝牙广播
err = bt_le_adv_start(BT_LE_ADV_NCONN, ad, ARRAY_SIZE(ad), sd, ARRAY_SIZE(sd));if (err){LOG_ERR("Advertising failed to start (err %d)\n", err);return -1;}
运行和测试
开启广播就是这么简单就行。
完整的代码
实例2:动态更改广播数据
这个实例将重点关注广播参数、制造商特定数据以及动态更新广播数据。
广播参数的控制,广播参数放在bt_le_adv_param变量里面。由于此变量需要初始化内容太多,因此使用宏 BT_LE_ADV_PARAM()来帮助初始化
options:用于配置广告选项的特定宏。例如,选择在哪个频道(37、38、39)上投放广告。有 19 个选项可用,可在此处找到。
最小广告间隔:(N * 0.625 毫秒):小于或等于最大广告间隔。N 的允许范围是 32 到 16384,相当于 20 毫秒到 10.24 秒。API 具有用于广告间隔的预定义值。
最大广告间隔:(N * 0.625 毫秒):大于或等于最小广告间隔。N 的允许范围是 32 到 16384,相当于 20 毫秒到 10.24 秒。API 具有用于广告间隔的预定义值。
对等地址:如果使用定向广告则包含。否则,设置为 NULL。
代码实现如下
- 使用自带的LED和BUTTON库,在prj.conf加入如下。
# Button and LED library
CONFIG_DK_LIBRARY=y
2.在main.c加入头文件
#include <dk_buttons_and_leds.h>
3.定义广播参数
static struct bt_le_adv_param *adv_param =BT_LE_ADV_PARAM(BT_LE_ADV_OPT_NONE,800,801,NULL);
4.定义自定义数据
#define COMPANY_ID_CODE 0x0059
5.定义动态数据存放的变量,这里定义个结构体,方便管理
typedef struct adv_mfg_data {uint16_t company_code; /* Company Identifier Code. */uint16_t number_press; /* Number of times Button 1 is pressed*/
} adv_mfg_data_type;
初始化
static adv_mfg_data_type adv_mfg_data = {COMPANY_ID_CODE,0x00};
6.将自定义数据包含到广播包里面
static const struct bt_data ad[] = {BT_DATA_BYTES(BT_DATA_FLAGS, BT_LE_AD_NO_BREDR),BT_DATA(BT_DATA_NAME_COMPLETE, DEVICE_NAME, DEVICE_NAME_LEN),BT_DATA(BT_DATA_MANUFACTURER_DATA, (unsigned char *)&adv_mfg_data, sizeof(adv_mfg_data)), // 添加自定义数据
};
7.添加按钮初始化代码,和注册按钮回调函数
static void button_changed(uint32_t button_state, uint32_t has_changed)
{if (has_changed & button_state & USER_BUTTON) {adv_mfg_data.number_press += 1;bt_le_adv_update_data(ad, ARRAY_SIZE(ad),sd, ARRAY_SIZE(sd)); //这里是动态更新广播数据的地方}
}static int init_button(void)
{int err;err = dk_buttons_init(button_changed);if (err) {printk("Cannot init buttons (err: %d)\n", err);}return err;
}
8.在main函数调用按钮初始化
static void button_changed(uint32_t button_state, uint32_t has_changed)
{if (has_changed & button_state & USER_BUTTON) {adv_mfg_data.number_press += 1;bt_le_adv_update_data(ad, ARRAY_SIZE(ad),sd, ARRAY_SIZE(sd));}
}
在第7步,函数是动态更新广播数据
编译和测试
可以点击数据,选择显示数据的格式
完整代码
开启蓝牙后,建议将栈的空间加大到2048
CONFIG_SYSTEM_WORKQUEUE_STACK_SIZE=2048
CONFIG_MAIN_STACK_SIZE=2048
实例3:创建可连接的广播
- 配置蓝牙BLE的角色,配置为外设角色
CONFIG_BT_PERIPHERAL=y
- 修改蓝牙名称,这样可以方便区分
CONFIG_BT_DEVICE_NAME="Nordic_Peripheral"
3.修改广播的内容,主要是修改flag的内容,
static const struct bt_data ad[] = {BT_DATA_BYTES(BT_DATA_FLAGS, (BT_LE_AD_GENERAL |BT_LE_AD_NO_BREDR)),BT_DATA(BT_DATA_NAME_COMPLETE, DEVICE_NAME, DEVICE_NAME_LEN),
};
扫描响应包添加UUID,比如添加一个LBS的UUID
#include <zephyr/bluetooth/uuid.h>static const struct bt_data sd[] = {// BT_DATA(BT_DATA_URI, url_data, sizeof(url_data)),BT_DATA_BYTES(BT_DATA_UUID128_ALL,BT_UUID_128_ENCODE(0x00001523, 0x1212, 0xefde, 0x1523, 0x785feabcd123)),
};
4.设置随机静态地址。
#include <zephyr/bluetooth/addr.h>bt_addr_le_t addr;err = bt_addr_le_from_str("FF:EE:DD:CC:BB:AA", "random", &addr);if (err) {printk("Invalid BT address (err %d)\n", err);}err = bt_id_create(&addr, NULL);if (err < 0) {printk("Creating new ID failed (err %d)\n", err);}
修改广播参数为可连接
static struct bt_le_adv_param *adv_param = BT_LE_ADV_PARAM((BT_LE_ADV_OPT_CONNECTABLE|BT_LE_ADV_OPT_USE_IDENTITY), 800, /*Min Advertising Interval 500ms (800*0.625ms) */801, /*Max Advertising Interval 500.625ms (801*0.625ms)*/NULL); /* Set to NULL for undirected advertising*/
完整代码