STM32 串口:蓝牙透传与数据包解析

串口能收发不定长数据以后(见DMA 与不定长接收),接上一个蓝牙透传模块,就能用电脑或手机无线控制单片机。程序这边几乎不用改,换的只是串口另一头连着什么。真正要多写的是数据包解析:收到一串字节以后,怎么判断它完整、没出错,再从里面取出指令。

速查

项目 内容
模块 BT24 蓝牙串口透传模块
接线 5V 接 5V,GND 接 GND,TX 和 RX 交叉接
串口 USART3(PB10 TX,PB11 RX),异步模式,波特率 9600
CubeMX USART3 开 NVIC 中断,加 RX、TX 两个 DMA 通道
接收 HAL_UARTEx_ReceiveToIdle_DMA + 关 DMA 过半中断,和 USART2 时完全一样,句柄换成 huart3
包格式 AA 包头 + 整包长度 + 若干组“灯 开关” + 校验和

蓝牙透传模块做了什么

蓝牙分经典蓝牙和低功耗蓝牙(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 包头,标记一包数据从这里开始
长度 整个包的字节数,包头和校验和都算在内
灯编号 01 红、02 绿、03 蓝
开关 FF 亮、00 灭
…… 可以跟多组“灯编号 开关”
校验和 前面所有字节相加,只取最低一个字节

几个例子:

红灯亮:          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;一包拆成两半时,两半都会因为长度对不上被丢掉。更稳妥的做法是在回调里只把收到的字节存进一个环形缓冲区,然后在主循环里从缓冲区里找包头、凑齐一整包再解析,同时处理粘包和丢数据的情况。