【已验证】基于STM32和HAL库的大夏龙雀BT311-10C02S蓝牙模块驱动
最近买了一个大夏龙雀家的蓝牙模块DX-BT311-10C02S，这个蓝牙是一款基于BLE 5.4规范的串口透传模块，支持AT指令配置、主从模式切换，非常适合与单片机搭配实现无线数据传输。
如果是第一次买还是很便宜的，他家的模块有一说一是真的不错
本文将分享如何使用STM32F103C6T6（HAL库）驱动该模块，完成基础功能验证。
一、模块简介
DX-BT311-10C02S具有以下特点（拷贝手册的）：
支持BLE 5.4协议，主从模式可切换
默认串口参数：9600bps/8/n/1
提供UART接口，支持AT指令配置
默认从模式，UUID：SERVICE UUID: 0xFFE0，NOTIFY/WRITE UUID: 0xFFE1，WRITE UUID: 0xFFE2
支持数据透传，连接后自动进入透传模式
具有LINK-STATUS引脚，高电平表示蓝牙已连接
手册中AT指令格式说明：
所有指令以
AT开头，以\r\n结尾响应以
+开头，成功时以OK结束，失败返回ERROR=<code>例如修改名称：发送
AT+NAME1234，返回+NAME=1234后跟OK
二、硬件连接
| STM32F103C6T6 | DX-BT311模块 |
|---|---|
| PB10 (USART3_TX) | RX |
| PB11 (USART3_RX) | TX |
| 3.3V | VCC |
| GND | GND |
| PA0（可选） | LINK-STATUS |
三、驱动设计思路
为了高效处理不定长数据，我们采用DMA + 空闲中断 + 环形缓冲区的方案：
DMA接收：开启USART3的DMA循环接收，无需CPU干预。
空闲中断：当模块发送一帧数据（以空闲状态结束）时，触发中断，在中断中将DMA缓冲区数据拷贝到环形缓冲区。
环形缓冲区：用于暂存接收数据，供主循环取用。
AT命令同步：发送AT命令后，清空环形缓冲区，然后循环调用行读取函数，直到收到“OK”或“ERROR”或超时。这样既能与透传数据隔离，又避免阻塞。
关键点：
接收统一由环形缓冲区管理，AT命令和透传数据共用缓冲区，但通过状态标志区分。
连接状态通过PA0引脚轮询检测，并提供回调。
支持GBK编码，方便设置中文蓝牙名称。
四、关键代码实现
4.1 初始化与DMA启动
void bt311_init(UART_HandleTypeDef *huart, DMA_HandleTypeDef *hdma_rx) { g_bt311.huart = huart; g_bt311.hdma_rx = hdma_rx; ring_buffer_clear(); // 启动DMA空闲中断接收 HAL_UARTEx_ReceiveToIdle_DMA(huart, g_bt311.rx_dma_buf, BT311_RX_DMA_BUF_SIZE); }4.2 空闲中断回调
void HAL_UARTEx_RxEventCallback(UART_HandleTypeDef *huart, uint16_t Size) { if (huart != g_bt311.huart) return; for (uint16_t i = 0; i < Size; i++) { // 存入环形缓冲区 uint16_t next_head = (g_bt311.rx_ring_head + 1) % BT311_RX_RING_SIZE; if (next_head != g_bt311.rx_ring_tail) { g_bt311.rx_ring_buf[g_bt311.rx_ring_head] = g_bt311.rx_dma_buf[i]; g_bt311.rx_ring_head = next_head; } } g_bt311.rx_ready = 1; HAL_UARTEx_ReceiveToIdle_DMA(huart, g_bt311.rx_dma_buf, BT311_RX_DMA_BUF_SIZE); }4.3 AT命令发送与同步
bool bt311_send_cmd(const char *cmd, char *response, uint16_t resp_size, uint32_t timeout_ms) { // 发送命令（添加\r\n） char full_cmd[128]; snprintf(full_cmd, sizeof(full_cmd), "%s\r\n", cmd); HAL_UART_Transmit(g_bt311.huart, (uint8_t*)full_cmd, strlen(full_cmd), 100); // 清空环形缓冲区 ring_buffer_clear(); uint32_t start = HAL_GetTick(); char line[128]; while (HAL_GetTick() - start < timeout_ms) { if (ring_buffer_read_line(line, sizeof(line))) { if (strstr(line, "OK") != NULL) return true; if (strstr(line, "ERROR") != NULL) return false; } bt311_process(); // 处理环形缓冲区（从DMA搬运） HAL_Delay(1); } return false; }4.4 主循环处理
void bt311_process(void) { // 处理透传数据（用户回调） if (g_bt311.rx_ready && g_bt311.user_rx_callback) { // 从环形缓冲区取数据，调用回调 // ... } // 处理连接状态变化 if (g_bt311.link_status_port) { uint8_t cur = HAL_GPIO_ReadPin(...); if (cur != g_bt311.link_status) { g_bt311.link_status = cur; if (g_bt311.link_status_callback) g_bt311.link_status_callback(cur); } } }4.5 测试函数
提供全功能测试函数，自动完成初始化、AT测试、版本查询、MAC读取、名称设置、连接状态检测、数据收发打印，方便快速验证。
void bt311_run_full_test(UART_HandleTypeDef *huart, DMA_HandleTypeDef *hdma_rx) { bt311_init(huart, hdma_rx); bt311_register_rx_callback(print_received_data); bt311_set_link_status_pin(GPIOA, GPIO_PIN_0); bt311_register_link_callback(print_link_status); // 执行AT测试 if (bt311_test()) printf("AT OK\r\n"); char version[32]; bt311_get_version(version); char mac[18]; bt311_get_mac(mac); bt311_set_name("HealthMonitor"); bt311_reset(); while (1) { bt311_process(); // 连接后每5秒发送模拟数据 if (bt311_get_link_status()) { static uint32_t last = 0; if (HAL_GetTick() - last > 5000) { bt311_send_data((uint8_t*)"HR:75,SPO2:98\r\n", 14); last = HAL_GetTick(); } } HAL_Delay(10); } }五、测试验证
在STM32F103C6T6上运行后，串口调试助手输出：
手机连接后，发送的数据被正确打印，同时模块每隔5秒自动发送模拟心率血氧数据。连接状态引脚PA0电平变化触发回调，工作稳定。
六、总结
本文介绍了DX-BT311-10C02S蓝牙模块的驱动设计思路与关键实现。通过DMA+空闲中断+环形缓冲区的组合，实现了高效、非阻塞的数据接收，并统一处理AT命令响应与透传数据。该驱动已成功应用于健康监测项目，可方便地扩展其他传感器。代码结构清晰，移植方便，可作为STM32与BLE模块通信的参考模板。
七、参考代码
通过网盘分享的文件：HealthMonitor_BT.zip
链接: https://pan.baidu.com/s/1y88ASSL0hksTsjAsc1txFw?pwd=d37u 提取码: d37u
--来自百度网盘超级会员v8的分享