STM32 串口:蓝牙透传与数据包解析
串口能收发不定长数据以后(见DMA 与不定长接收),接上一个蓝牙透传模块,就能用电脑或手机无线控制单片机。程序这边几乎不用改,换的只是串口另一头连着什么。真正要多写的是数据包解析:收到一串字节以后,怎么判断它完整、没出错,再从里面取出指令。
速查
蓝牙透传模块做了什么
蓝牙分经典蓝牙和低功耗蓝牙(BLE)。耳机这种一直在传数据的设备用经典蓝牙,手环这种隔一阵同步一次的用 BLE。通信分主机和从机,一般单片机这边是从机,手机、电脑是主机:从机先广播自己,主机扫描到以后发起连接,连上了再按约定的协议收发。
BLE 本身的协议栈不简单,广播、GATT、Service、Characteristic 一大堆概念。透传模块把这些都包在了里面,对单片机来说只剩一个串口:
单片机 USART3 TX ──→ 模块 RX ──→ 蓝牙发给主机
单片机 USART3 RX ←── 模块 TX ←── 主机发来的数据
“透传”的意思是原样转发,单片机发给模块什么,主机就收到什么,反过来也一样。所以对程序来说,接蓝牙模块和接 USB 转串口没有区别,只是换了一个串口、换了波特率。BT24 默认是 9600,CubeMX 里要跟着改。
程序:先做回显
和 USART2 时的写法一样,只是句柄换成 huart3、DMA 通道换成 hdma_usart3_rx:
/* USER CODE BEGIN PV */
uint8_t receiveData[50];
/* USER CODE END PV */
/* USER CODE BEGIN 2 */
HAL_UARTEx_ReceiveToIdle_DMA(&huart3, receiveData, sizeof(receiveData));
__HAL_DMA_DISABLE_IT(&hdma_usart3_rx, DMA_IT_HT);
/* USER CODE END 2 */
void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)
{
if (huart == &huart3)
{
HAL_UART_Transmit_DMA(&huart3, receiveData, Size);
HAL_UARTEx_ReceiveToIdle_DMA(&huart3, receiveData, sizeof(receiveData));
__HAL_DMA_DISABLE_IT(&hdma_usart3_rx, DMA_IT_HT);
}
}
电脑上用波特律动串口助手(serial.baud-dance.com)连:左上角从“串口”切到“蓝牙”,扫描到 BT24 后配对。一直扫不到时,按一下模块上的复位键再试。连上以后就和普通串口助手一样用,发什么回什么,说明链路通了。手机上可以用模块厂商的蓝牙调试 App,选透传模式、搜索 BLE 设备连上 BT24。
数据包格式
用蓝牙控制三色灯,约定这样一种十六进制格式:
几个例子:
红灯亮: AA 05 01 FF AF
红灯灭: AA 05 01 00 B0
红灯灭,绿灯亮: AA 07 01 00 02 FF B3
拆开看第三条:
AA 07 01 00 02 FF B3
[0] [1] [2][3] [4][5] [6]
包头 长度 第1组 第2组 校验和
校验和的算法:AA + 07 + 01 + 00 + 02 + FF = 0x1B3,取最低一个字节就是 B3。接收方用同样的方法再算一遍,和包里带的校验和比较。相等说明传输中大概率没出错;不相等就一定有字节传错了,这一包直接丢掉,或者让对方重发。
手算校验和很麻烦,可以用系统计算器的程序员模式。波特律动串口助手也能在发送时自动算校验和并加在末尾,选好校验算法就行。
解析代码
按包的结构一层一层检查,全部通过才去动灯:
void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size)
{
if (huart == &huart3)
{
HAL_UART_Transmit_DMA(&huart3, receiveData, Size);
if (receiveData[0] == 0xAA) { // 包头
if (receiveData[1] == Size) { // 长度和实际收到的一致
uint8_t sum = 0;
for (int i = 0; i < Size - 1; i++) { // 校验和本身不加
sum += receiveData[i];
}
if (sum == receiveData[Size - 1]) { // 校验和
for (int i = 2; i < Size - 1; i += 2) { // 两个字节一组
GPIO_PinState State = GPIO_PIN_SET;
if (receiveData[i + 1] == 0x00) {
State = GPIO_PIN_RESET;
}
if (receiveData[i] == 0x01) {
HAL_GPIO_WritePin(LED_RED_GPIO_Port, LED_RED_Pin, State);
} else if (receiveData[i] == 0x02) {
HAL_GPIO_WritePin(LED_GREEN_GPIO_Port, LED_GREEN_Pin, State);
} else if (receiveData[i] == 0x03) {
HAL_GPIO_WritePin(LED_BLUE_GPIO_Port, LED_BLUE_Pin, State);
}
}
}
}
}
HAL_UARTEx_ReceiveToIdle_DMA(&huart3, receiveData, sizeof(receiveData));
__HAL_DMA_DISABLE_IT(&hdma_usart3_rx, DMA_IT_HT);
}
}
uint8_t sum 是故意的:一个字节最大 255,加超了自动从 0 重新开始,结果正好就是“只取最低一个字节”,不用再写 & 0xFF。
不管这一包合不合法,最后都要重新开启接收,所以那两句放在所有 if 外面。
踩坑
十六进制数加了引号
if (receiveData[i] == '0X01') // 错
if (receiveData[i] == 0x01) // 对
前面用字符控制灯时写的是 'R'、'0',引号写顺手了。单引号里只该放一个字符,'0X01' 塞了四个,C 会把它当成一个“多字符常量”,值是一个很大的 int,uint8_t 永远等不到它,所有 if 都不成立,什么也不执行。编译器对这种写法会报 multi-character character constant 警告,只是不报错,所以警告也要看。
校验和把自己也加进去了
for (int i = 0; i < Size; i++) // 错:最后一个字节是校验和本身
for (int i = 0; i < Size - 1; i++) // 对
循环的范围和步长
指令从下标 2 开始、两字节一组、到校验和前面结束,所以是 i = 2; i < Size - 1; i += 2。循环体里灯编号是 receiveData[i],开关是 receiveData[i + 1]。从旧代码复制过来时,else if 里还留着 receiveData[0],而 [0] 永远是包头 AA。
串口助手要切到 HEX 发送
助手默认按 ASCII 发送,这时输入 AA 发出去的是两个字符 'A'、'A'(41 41),不是一个字节 AA。要把“发送:ASCII”切成“发送:HEX”,字节之间用空格隔开。
在板子上验证
通过蓝牙发 AA 05 01 FF AF,助手里收到了原样的回显,链路是通的。用 ST-Link 读芯片 RAM,receiveData 里存的正是 AA 05 01 FF,校验也能通过。
还没解决的问题
解析是直接写在回调里的,也就是在中断里做。指令少、间隔长的时候没问题,但如果数据包来得快、包和包之间间隔很小,或者一包被拆成两次收到,就会出问题:上一包还没处理完,下一包已经开始覆盖 receiveData;一包拆成两半时,两半都会因为长度对不上被丢掉。更稳妥的做法是在回调里只把收到的字节存进一个环形缓冲区,然后在主循环里从缓冲区里找包头、凑齐一整包再解析,同时处理粘包和丢数据的情况。