Skip to content

手写 BLE 广播设备:软件编码优化篇 ​

一、前言

本篇会按照蓝牙协议文件对广播MAC地址,广播的地址类型,以及广播数据结构进行优化,并且会编写出方便读者修改广播地址,广播数据的相关API。

二、阅读说明

1、泰凌微芯片学习者,前期使用过该芯片。

2、能够知道怎么进行创建工程,下载代码。

3、有一块开发板,板上的芯片可以是8251,8253或者8258。

4、需使用手机APP软件nRF Connect或者蓝牙抓包工具52840 Sniffer加上协议分析软件Wireshark

三、正文

1、使用的SDK

手写 BLE 广播设备:软件编码篇

2、my_private_adv.h头文件增加相关结构体

2.1、完整代码

cpp
#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、计算数组元素数量的宏定义

php
/**
 * @brief 计算数组元素数量
 * @param array 数组
 * @return 数组元素数量
 */
#define MY_ARRAY_SIZE(array) (sizeof(array) / sizeof((array)[0]))

该函数用于计算数组的大小,使用方法很简单,传入数组的头指针就行,下面的代码是示例:

cpp
unsigned char device_name[]= {'t','e','s','t'};
unsigned char len = 0;
len = MY_ARRAY_SIZE(device_name);

2.3、广播数据结构体

cpp
/**
 * @brief 广播数据结构体
 * @param type 数据类型
 * @param data_len 数据长度
 * @param data 数据指针
 */
struct bt_data {
    unsigned char type;
    unsigned char data_len;
    const unsigned char *data;
};

一个广播的组成是由一个类型,一个数据长度,一系列数据组成的,如下图描述:

备注:这个结构体里面定义的数据是需要传入数组的指针的,并不是实际的参数,这一点大家要注意。

2.4、定义广播数据的宏变量(针对广播数据放在数组的情况)

php
/**
 * @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), \
}

该宏的目的是为了给广播结构数据赋一个初始值,举例说明如下:

objectivec
unsigned char device_name[]= {'t','e','s','t'};
struct bt_data my_data = BT_DATA(1, device_name, sizeof(device_name));

这样一来的话,我的my_data的数据就成功的通过一个宏来进行了变量的初始化,展开来看的话就是:

objectivec
{
 .type = (1),
 .data_len = (sizeof(device_name)),
 .data = (const unsigned char *)(device_name),
}

用表格来描述的就是如下内容:

type(类型)data_len(数据长度)data(数据指针)
1sizeof(device_name)device_name

2.5、定义广播数据的宏变量(针对广播数据需要输入固定数字的情况)

python
/**
 * @brief 定义广播数据
 * @param type 数据类型
 * @param bytes 字节数组
 * @return 广播数据结构体
 */
#define BT_DATA_BYTES(_type, _bytes...) \
 BT_DATA(_type, ((unsigned char []) { _bytes }), \
 sizeof((unsigned char []) { _bytes }))

该宏的作用是用于输入某些固定数据的情况,该宏只需要传入两个参数,一个类型,另外一个是不定长的数据,其中不需要输入数据的长度,该宏会自己进行计算,举例如下:

apache
struct bt_data my_data = BT_DATA_BYTES(1, 0x11,0x22,0x33);

将传入的数据进行首次展开后如下:

objectivec
struct bt_data my_data = BT_DATA(
    1, 
    ((unsigned char []){0x11,0x22,0x33}), 
    sizeof((unsigned char []){0x11,0x22,0x33})
);

之后进行二次展开如下:

cpp
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、广播结构的优化

cpp
/**
 * @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、编写广播地址更改函数

cpp
/**
 * @brief 设置广播地址
 * @param advA 广播地址
 */
void my_private_adv_set_advA(unsigned char *advA)
{
    memcpy(ble_tx_packet.advA, advA, 6);
}

调用该函数可以更改当前的广播地址

3.3、编写广播数据填充函数

cpp
/**
 * @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射频配置和初始化广播

付费阅读提示

本文为付费订阅文章,以上为免费试读部分。

阅读完整内容,请前往微信公众号「汤勇聊无线」购买阅读:

👉 阅读全文(公众号付费)