手写 BLE 广播设备:软件编码优化篇
一、前言
本篇会按照蓝牙协议文件对广播MAC地址,广播的地址类型,以及广播数据结构进行优化,并且会编写出方便读者修改广播地址,广播数据的相关API。
二、阅读说明
1、泰凌微芯片学习者,前期使用过该芯片。
2、能够知道怎么进行创建工程,下载代码。
3、有一块开发板,板上的芯片可以是8251,8253或者8258。
4、需使用手机APP软件nRF Connect或者蓝牙抓包工具52840 Sniffer加上协议分析软件Wireshark
三、正文
1、使用的SDK
2、my_private_adv.h头文件增加相关结构体
2.1、完整代码
#ifndef __MY_PRIVATE_ADV_H__
#define __MY_PRIVATE_ADV_H__
#define ACCESS_CODE 0xD6BE898E
#define RF_FREQ 37
#define RF_POWER RF_POWER_P10p46dBm
#define BT_DATA_FLAGS 0x01
#define BT_DATA_TYPE_NAME 0x09
#define BT_DATA_MANUFACTURER_DATA 0xff
/**
* @brief 广播数据类型枚举
*/
typedef enum advChannelPDUType_e {
LL_TYPE_ADV_IND = 0x00,
LL_TYPE_ADV_DIRECT_IND = 0x01,
LL_TYPE_ADV_NONCONN_IND = 0x02,
LL_TYPE_SCAN_REQ = 0x03,
LL_TYPE_SCAN_RSP = 0x04,
LL_TYPE_CONNECT_REQ = 0x05,
LL_TYPE_ADV_SCAN_IND = 0x06,
} advChannelPDUType_t;
/**
* @brief 广播数据头结构体
*/
typedef struct {
unsigned char type :4;
unsigned char rfu1 :2;
unsigned char txAddr :1;
unsigned char rxAddr :1;
}rf_adv_head_t;
/**
* @brief 广播数据结构体
*/
typedef struct{
unsigned long dma_len; //won't be a fixed number as previous, should adjust with the mouse package number
rf_adv_head_t header; //RA(1)_TA(1)_RFU(2)_TYPE(4)
unsigned char rf_len; //LEN(6)_RFU(2)
unsigned char advA[6]; //address
unsigned char data[31]; //0-31 byte
}my_rf_packet_adv_t;
/**
* @brief 计算数组元素数量
* @param array 数组
* @return 数组元素数量
*/
#define MY_ARRAY_SIZE(array) (sizeof(array) / sizeof((array)[0]))
/**
* @brief 广播数据结构体
* @param type 数据类型
* @param data_len 数据长度
* @param data 数据指针
*/
struct bt_data {
unsigned char type;
unsigned char data_len;
const unsigned char *data;
};
/**
* @brief 定义广播数据
* @param type 数据类型
* @param data 数据指针
* @param data_len 数据长度
* @return 广播数据结构体
*/
#define BT_DATA(_type, _data, _data_len) \
{ \
.type = (_type), \
.data_len = (_data_len), \
.data = (const unsigned char *)(_data), \
}
/**
* @brief 定义广播数据
* @param type 数据类型
* @param bytes 字节数组
* @return 广播数据结构体
*/
#define BT_DATA_BYTES(_type, _bytes...) \
BT_DATA(_type, ((unsigned char []) { _bytes }), \
sizeof((unsigned char []) { _bytes }))
void my_private_adv_init(void);
void my_private_adv_send(void);
#endif如上代码相比较上一篇,增加了注释,并且增加了好几个结构体,增加代码的详细描述如下小节。
2.2、计算数组元素数量的宏定义
/**
* @brief 计算数组元素数量
* @param array 数组
* @return 数组元素数量
*/
#define MY_ARRAY_SIZE(array) (sizeof(array) / sizeof((array)[0]))该函数用于计算数组的大小,使用方法很简单,传入数组的头指针就行,下面的代码是示例:
unsigned char device_name[]= {'t','e','s','t'};
unsigned char len = 0;
len = MY_ARRAY_SIZE(device_name);2.3、广播数据结构体
/**
* @brief 广播数据结构体
* @param type 数据类型
* @param data_len 数据长度
* @param data 数据指针
*/
struct bt_data {
unsigned char type;
unsigned char data_len;
const unsigned char *data;
};一个广播的组成是由一个类型,一个数据长度,一系列数据组成的,如下图描述:

备注:这个结构体里面定义的数据是需要传入数组的指针的,并不是实际的参数,这一点大家要注意。
2.4、定义广播数据的宏变量(针对广播数据放在数组的情况)
/**
* @brief 定义广播数据
* @param type 数据类型
* @param data 数据指针
* @param data_len 数据长度
* @return 广播数据结构体
*/
#define BT_DATA(_type, _data, _data_len) \
{ \
.type = (_type), \
.data_len = (_data_len), \
.data = (const unsigned char *)(_data), \
}该宏的目的是为了给广播结构数据赋一个初始值,举例说明如下:
unsigned char device_name[]= {'t','e','s','t'};
struct bt_data my_data = BT_DATA(1, device_name, sizeof(device_name));这样一来的话,我的my_data的数据就成功的通过一个宏来进行了变量的初始化,展开来看的话就是:
{
.type = (1),
.data_len = (sizeof(device_name)),
.data = (const unsigned char *)(device_name),
}用表格来描述的就是如下内容:
| type(类型) | data_len(数据长度) | data(数据指针) |
| 1 | sizeof(device_name) | device_name |
2.5、定义广播数据的宏变量(针对广播数据需要输入固定数字的情况)
/**
* @brief 定义广播数据
* @param type 数据类型
* @param bytes 字节数组
* @return 广播数据结构体
*/
#define BT_DATA_BYTES(_type, _bytes...) \
BT_DATA(_type, ((unsigned char []) { _bytes }), \
sizeof((unsigned char []) { _bytes }))该宏的作用是用于输入某些固定数据的情况,该宏只需要传入两个参数,一个类型,另外一个是不定长的数据,其中不需要输入数据的长度,该宏会自己进行计算,举例如下:
struct bt_data my_data = BT_DATA_BYTES(1, 0x11,0x22,0x33);将传入的数据进行首次展开后如下:
struct bt_data my_data = BT_DATA(
1,
((unsigned char []){0x11,0x22,0x33}),
sizeof((unsigned char []){0x11,0x22,0x33})
);之后进行二次展开如下:
struct bt_data my_data = {
.type = 1,
.data_len = 3,
.data = (const unsigned char *)((unsigned char []){0x11,0x22,0x33}),
};3、my_private_adv.c源文件优化
3.1、广播结构的优化
/**
* @brief 广播名称
*/
unsigned char device_name[]= {'t','e','s','t'};
/**
* @brief 广播数据结构体
*/
static my_rf_packet_adv_t ble_tx_packet = {
.dma_len = sizeof (my_rf_packet_adv_t) - 4, // dma_len
.header.type = LL_TYPE_ADV_NONCONN_IND, // type
.header.txAddr = 1, // random address
.rf_len = sizeof (my_rf_packet_adv_t) - 6, // rf_len
.advA = {0x11, 0x22, 0x33, 0x44, 0x55, 0xC6}, // advA
.data = {0},
};
/**
* @brief 广播数据
*/
static struct bt_data ad[] = {
BT_DATA_BYTES(BT_DATA_FLAGS, 0x06),
BT_DATA(BT_DATA_TYPE_NAME, device_name, sizeof(device_name)),
BT_DATA_BYTES(BT_DATA_MANUFACTURER_DATA, 0x01,0x02,0x03,0x04,0x05,0x06),
};如上代码所示,是对广播数据内容的一系列优化,其中优化的详细内容见下面几个小节。
3.1.1、广播名的优化
原先的:

优化后:

由上面的图片对比,可见优化后的结构更加的清爽,原先的广播名是在整个初始化广播结构 里面的,现如今,将广播名单独拿出来,不放入初始化广播结构当中。
3.1.2、广播初始化结构的优化
优化前:

优化后:

由上面的图片对比,可见优化后的结构比较清晰和清爽,不会看着比较杂乱
3.1.2、广播地址的优化
优化前:

优化后:

由上图可见,增加一个txAddr的初始化,并且将广播地址的最后一个字节的高4bits更改了,为什么呢?
原因是txAddr为0,则代表的是公共地址。但设置为公共地址的话,那么根据蓝牙协议文件的描述,mac地址的高3个字节是固定的地址,代表的是公司的ID号,低3个字节可以是随机字节,这里我们并知道公司的ID号是多少,所以干脆直接使用随机地址,当然你也可以采用泰凌的ID,泰凌的ID是0xA4C138。
如果要设置为随机地址的话,那么txAddr就需要为1,并且mac地址的最高的2个bit有特殊的要求,随机地址有四类,如下图所示,我采用的是静态地址。


3.2、编写广播地址更改函数
/**
* @brief 设置广播地址
* @param advA 广播地址
*/
void my_private_adv_set_advA(unsigned char *advA)
{
memcpy(ble_tx_packet.advA, advA, 6);
}调用该函数可以更改当前的广播地址
3.3、编写广播数据填充函数
/**
* @brief 设置广播数据
* @param data 广播数据指针
* @param num 数据数量
*/
void my_private_adv_set_data(const struct bt_data *data, int num)
{
int pos = 0;
unsigned char len = 0;
// 清空数据区
memset(ble_tx_packet.data, 0, 31);
// 把多条广播数据打包成标准 BLE 格式
for(int i=0; i<num; i++){
len = data[i].data_len + 1;
ble_tx_packet.data[pos++] = len;
ble_tx_packet.data[pos++] = data[i].type;
memcpy(&ble_tx_packet.data[pos], data[i].data, data[i].data_len);
pos += data[i].data_len;
}
// 更新长度
ble_tx_packet.rf_len = pos + 6;
ble_tx_packet.dma_len = pos + 8;
}该函数的目的用于填充广播数据段
3.4、RF射频配置和初始化广播