前言：蓝牙通讯功能简介：

本次继续使用上一期设计的STM32WBA62CIU6开发板，实现基于蓝牙（BLE）的无线通讯功能。STM32WBA62CIU6内置2.4GHz射频收发器，支持Bluetooth LE 5.4协议，接收灵敏度为-96 dBm（BLE 1Mbps），可编程发射功率最高可达+10 dBm，并且芯片内部集成了巴伦，配合外部32MHz晶振和一根天线即可正常工作，非常适合低功耗蓝牙应用开发。

实现蓝牙通讯的基本思路是：先用STM32CubeMX完成时钟、射频和BLE协议栈的图形化配置并生成工程，然后在应用层实现广播、GATT服务和数据收发，最后使用手机APP连接开发板进行实测。整个开发过程中不需要关心BLE协议栈的内部实现，重点在应用层的逻辑。

一：使用开发工具

STM32CubeMX：图形化配置工具，用来配置时钟、外设和BLE协议栈中间件，并生成基础的工程代码，方便快速开发。

STM32CubeWBA：STM32WBA系列的固件包，包含HAL库和BLE协议栈（STM32_WPAN中间件），并提供p2pServer、BLE_Custom等参考例程，本次的蓝牙应用可以在此基础上修改。

Keil MDK：编程工具，用来编写和编译应用层代码（也可以使用STM32CubeIDE或IAR）。

STM32CubeProgrammer：烧录程序代码，本次通过板载DAP调试器完成下载。

手机APP（ST BLE Toolbox）：充当GATT客户端，用来扫描、连接开发板并收发数据，实测时使用。

串口终端：查看开发板通过串口输出的调试日志。

开发板集成了一个DAP调试器，只需要一根Type-C线就可以完成供电、下载与调试，开发板的串口1与DAP虚拟串口相连，方便查看调试数据。

蓝牙部分：STM32WBA62CIU6的射频收发器工作在2.4GHz频段，芯片内部集成了巴伦和匹配电路，外部只需要32MHz晶振提供射频参考时钟，再连接一根天线（板载PCB天线或外接天线座）即可工作。

需要注意，天线周围要尽量保证净空，不要铺铜或放置金属器件，否则会影响蓝牙的发射功率和接收灵敏度。

三：配置底层驱动

这里以STM32CubeMX的配置流程进行介绍：

3.1　时钟与射频配置：

在RCC配置中使能外部高速晶振（HSE 32MHz），BLE射频部分以该晶振为参考时钟。时钟精度直接影响射频指标，所以要用外部晶振，而不是内部RC振荡器。

3.2　添加BLE协议栈：

在Middleware中选择STM32_WPAN，并勾选Bluetooth LE，此时CubeMX会生成BLE协议栈相关代码。BLE外设作为GATT服务器，手机APP作为GATT客户端。

按应用需要配置服务和特征值，可以参考官方LAT1309文档中SerialPortService的设计：

3.3　串口调试配置：

配置USART1作为日志输出口，方便在调试时通过串口终端观察BLE事件和数据。

3.4　生成工程：

配置完成后生成工程，选择对应的IDE工具链，CubeMX会自动生成main.c、app_ble.c、p2p_server_app.c等文件，BLE应用代码主要在app_ble.c中。

四：代码编写：

以下代码仅为思路示意，具体函数名和参数以STM32CubeWBA实际生成的工程代码为准。

4.1　BLE初始化流程：

BLE的初始化在app_ble.c中完成，主要流程为：初始化BLE协议栈、服务控制器初始化（注册GATT服务）、配置并启动广播。

/* BLE初始化示意（参考STM32CubeWBA的p2pServer例程） */
void APP_BLE_Init(void)
{
    /* 1. 初始化BLE协议栈（HCI、GATT、GAP等底层） */
    APP_BLE_Stack_Init();

    /* 2. 服务控制器初始化，注册GATT服务与特征值 */
    SVCCTL_Init();
}

4.2　广播配置：

初始化完成后，需要配置广播数据并启动广播，这样手机才能扫描到开发板。

/* 配置并启动广播（示意） */
aci_gap_set_discoverable(...);   /* 设置可发现模式，开始广播 */
aci_gap_update_adv_data(...);    /* 更新广播数据：设备名、UUID等 */

4.3　GATT服务与数据收发：

手机连接开发板后，通过特征值进行读写。当手机向RX特征值写入数据时，会触发写请求回调，我们在回调中处理数据，例如通过串口打印或者控制外设。

/* 写请求回调（示意，位于p2p_server_app.c） */
static void Write_Request_Handler(uint32_t service_handle,
                                  uint16_t char_handle,
                                  uint8_t *data, uint16_t length)
{
    /* 将手机发来的数据通过串口打印出来 */
    HAL_UART_Transmit(&huart1, data, length, 100);
}

/* 通过TX特征值通知手机（示意，接口名以固件包为准） */
aci_gatt_srv_notify(...);

整体数据通路为：手机写入RX特征值 → 回调函数处理 → 串口/外设；串口/传感器数据 → TX特征值通知 → 手机显示。

五：实际测试蓝牙通讯：

编译并烧录程序后，按照下面的步骤进行测试：

打开手机上的ST BLE Toolbox，扫描附近的蓝牙设备，可以看到开发板广播的设备名。

点击连接开发板，在服务列表中可以看到配置的GATT服务和特征值。

向RX特征值写入数据，观察串口终端打印出相同的数据，说明手机到开发板的通路正常。

订阅TX特征值的通知，让开发板主动发送数据，观察手机端收到数据，说明开发板到手机的通路正常。

测试时要重点确认广播是否可见、连接是否稳定以及双向数据收发是否正常。

调试过程中有几点体会：一是射频部分对外部晶振的精度和天线净空比较敏感，如果发现信号弱或者连接不稳定，可以优先检查这两个地方；二是BLE协议栈会占用一部分Flash和RAM资源，配置工程时要注意芯片容量；三是做低功耗应用时，还要结合芯片的睡眠模式，配置好唤醒源和广播策略。

最后，感谢得捷和EEPW论坛举办的本次活动，让我对STM32WBA62CIU6的蓝牙开发有了更深入的了解，也积累了不少无线通讯的开发经验。