2.1 創建BLE工程添加并配置外設

請在搭建工程之前，下載安裝最新的STM32CubeMX和STM32CubeWB

2.1.1 在STM32CubeMX中點擊“File”/“New Project”在彈出對話框中輸入“STM32WB55RG”創建一個新工程

2.1.2 工程配置如下圖所示，配置工程名字、保存路徑、選擇編譯工具、調整堆棧大小和選擇需要的STM32CubeWB的庫文件（缺省為已安裝的最新版本）。

2.1.3 系統配置：調試口

2.1.4 外設配置：添加外部高速晶振（HSE）和低速晶振（LSE）

2.1.5 外設配置：調試打印串口USART，手動將USART1引腳重映射到PB6/PB7

使能USART1的TX的DMA功能和USART1的全局中斷

2.1.6 外設配置：使能HESM，它完全由BLE stack管理

2.1.7 外設配置：使能RF，它完全由BLE stack管理。

2.1.8 外設配置：使能IPCC，它完全由BLE stack管理。只需同時使能它的RX/TX中斷即可。

2.1.9 外設配置：使能RTC，同時選擇WakeUp為“Internal WakeUp”和WakeUp中斷。

2.1.10 外設配置：配置時鐘

2.1.11 外設配置：NVIC的配置

2.2.1 協議棧配置：使能BLE協議棧

2.2.2 協議棧配置：禁止“Custom P2P Server”并使能“Custom Template”自定義GATT通用模板

2.2.3 協議棧配置：新建一個GATT服務，其名稱為“My_Data_Server"

2.2.4 協議棧配置：GATT服務基本配置

2.2.5 協議棧配置：配置GATT讀&寫 服務特征及屬性值

2.2.6 協議棧配置：配置GATT寫 服務特征及屬性值

2.2.7 協議棧配置：配置GATT讀 服務特征及屬性值

2.2.8 協議棧配置：配置GATT通知 服務特征及屬性值

2.2.9 協議棧配置：配置GATT廣播參數配置

2.2.10 協議棧配置：BLE配對參數設置

2.2.11 協議棧配置：BLE協議棧調試及打印配置（需依次序配置）

2.3 生成工程代碼并初步測試

2.3.1 點擊“GENERATE CODE”生成工程代碼

2.3.2 在生成的代碼中添加BLE Trace&Debug初始化代碼

2.3.3 在“main.c”文件中取消“MX_UART_Init（void）”的“static”屬性

2.3.4 在“app_entry.c”文件中增加“Debug”模塊的初始化代碼“APPD_Init（）”。

2.3.5 下載代碼到STM32WB55-NUCLEO中運行。此時，在手機的藍牙列表中，已經能成功地搜索添加的BLE設備。說明Debug和BLE協議棧已經成功運行。

為了便于對后續添加代碼的理解，我們先將Central（手機）與STM32WB進行BLE通信的數據交互概括如下。所以需要將用戶代碼添加到Custom_STM_Event_Handler()、Custom_STM_App_Notification()中。

BLE應用代碼添加：定義用戶數據緩存。

在“custom_app.c”文件中定義4個用戶緩存區數組。

BLE事件驅動代碼添加：

在“custom_stm.c”文件中的“Custom_STM_Event_Handle r(void*Event)”中依次為WRITE_READ_DATA_BUF、WRITE_DATA_BUF、NOTIFY_DATA_BUF特征和屬性添加stack層的事件驅動代碼，以使BLE數據從stack層傳遞到app層。

添加特征1 Events：WRITE_READ_DATA_BUF（即User_Write_Read_Data[]對應的寫&讀操作句柄）請求驅動代碼。

上圖對應的代碼文本如下所示：

上圖對應的代碼文本如下圖所示：

添加特征2 Events驅動：WRITE_DATA_BUF（即User_Write_Data []對應的寫操作句柄）代碼。

上圖對應的代碼文本如下圖所示：

添加特征3 Events驅動：READ_DATA_BUF（即User_Read_Data[]對應的寫操作句柄）代碼

升級ST-LINK固件以保證與STM32CubeProgrammer驅動是匹配的

查看當前FUS版本，并將FUS升級到最新版本

如果當前FUS版本是0.5.3，FUS固件使用“stm32wb5x_FUS_fw_for_fus_0_5_3.bin”，否則FUS固件使用“stm32wb5x_FUS_fw.bin”，強烈建議閱讀BLE協議棧及FUS升級詳細說明“STM32Cube_FW_WB_V1.13.3Projects STM32WB_Copro_Wireless_BinariesSTM32WB5xRelease_Notes.html”。

升級（安裝）BLE協議棧，根據MCU型號選擇相應的固件和下載地址

3.2 測試平臺搭建及驗證

3.2.1 在Android安卓應用市場下載安裝“BLE調試助手”

3.2.2 可發現設備“MY_STM32WB”，并點擊“CONNECT”后可以發現application特征和屬性訪問服務，如下圖所示。

3.2.3 設置BLE最大單包傳輸長度為256字節，否則L2CAP層傳輸超過23字節將自動分包。

3.2.4 手機app寫數據訪問（User_Write_Read_Data[64]）測試

3.2.5 手機App讀數據訪問（User_Write_Read_Data[64]）測試

3.2.6 手機App寫User_Write_Data[64]測試

3.2.7 手機App讀User_Read_Data[64]測試。

3.2.8 通知數據訪問（User_Notify_Data[64])測試

至此，整個驗證和測試過程完成。