概述

在嵌入式領(lǐng)域中，STM32WB 系列微控制器以其雙核架構(gòu)和強(qiáng)大的無線連接能力而著稱。特別是其藍(lán)牙5.0的功能使得這款微控制器非常適合那些需要低功耗和高性能無線連接的應(yīng)用。然而，在實際的應(yīng)用中，合理和有效地管理藍(lán)牙連接是非常關(guān)鍵的，尤其是當(dāng)設(shè)備需要斷開或重新建立連接時。
本文將針對STM32WB平臺，提供如何利用其HAL庫和Bluetooth stack來斷開藍(lán)牙連接的方法。我們將首先了解如何通過aci_hal_get_link_status函數(shù)獲取當(dāng)前的藍(lán)牙連接狀態(tài)，然后，我們將使用hci_disconnect函數(shù)來斷開這些連接。
最近在弄ST的課程，需要樣片的可以加群申請：615061293 。

硬件準(zhǔn)備

首先需要準(zhǔn)備一個開發(fā)板，這里我準(zhǔn)備的是WB55RG 的開發(fā)板：

視頻教學(xué)

[https://www.bilibili.com/video/BV1U14y16712

樣品申請

[https://www.wjx.top/vm/OhcKxJk.aspx#

源碼下載

[https://download.csdn.net/download/qq_24312945/88324454]

選擇芯片型號

配置時鐘源

HSE與LSE分別為外部高速時鐘和低速時鐘，在本文中使用外置的時鐘源，故都選擇Crystal/Ceramic Resonator選項，如下所示：

配置時鐘樹

RTC時鐘配置

RFWKP時鐘配置

查看開啟STM32_WPAN條件

可以看到，需要開啟RF、RTC、RCC、IPCC、HSEM。

配置HSEM

硬件信號量(HSEM)模塊用于管理多個進(jìn)程之間共享的訪問權(quán)限和資源同步。
開啟HSEM如下。

配置IPCC

通信控制器(IPCC)模塊的主要用于cpu之間的信號消息交換。
開啟如下所示。

配置RTC

啟動RF

開啟藍(lán)牙

配置為自定義模板。

命名設(shè)備名

配置BLE GATT

配置SVC

LED配置

查看原理圖可以得知PB0為藍(lán)色LED，PB1為綠色LED。

配置PB0、PB1為輸出IO。

設(shè)置工程信息

工程文件設(shè)置

參考文檔

https://wiki.st.com/stm32mcu/wiki/Connectivity:STM32WB_HeartRate
HCI_LE_CONNECTION_COMPLETE_SUBEVT_CODE事件可以判斷是否構(gòu)建完成。

SVCCTL_App_Notification

SVCCTL_App_Notification函數(shù)是一個藍(lán)牙事件處理器，用于響應(yīng)和處理STM32WB BLE堆棧中發(fā)生的各種事件。
事件處理的主要內(nèi)容：

1. 斷開連接事件 (HCI_DISCONNECTION_COMPLETE_EVT_CODE)
2. 元事件 (HCI_LE_META_EVT_CODE)
3. 這部分處理了幾個子事件，如HCI_LE_CONNECTION_UPDATE_COMPLETE_SUBEVT_CODE（連接更新完成）和HCI_LE_CONNECTION_COMPLETE_SUBEVT_CODE（新的連接建立完成）。
4. 廠商特定調(diào)試事件 (HCI_VENDOR_SPECIFIC_DEBUG_EVT_CODE)

"在HCI_LE_CONNECTION_COMPLETE_SUBEVT_CODE事件中，我們能夠判斷Bluetooth Low Energy（BLE）設(shè)備是否已成功建立了一個新的連接。相反，在HCI_DISCONNECTION_COMPLETE_EVT_CODE事件里，我們可以確認(rèn)是否一個已存在的連接已經(jīng)被斷開。這兩個事件為我們提供了監(jiān)控BLE連接狀態(tài)的重要手段，從而使我們能夠更好地管理設(shè)備的連接生命周期。"

在HCI_DISCONNECTION_COMPLETE_EVT_CODE中添加一個IO翻轉(zhuǎn)函數(shù)。

/* USER CODE BEGIN EVT_DISCONN_COMPLETE */
			HAL_GPIO_TogglePin(GPIOB,GPIO_PIN_1);
      /* USER CODE END EVT_DISCONN_COMPLETE */

在HCI_DISCONNECTION_COMPLETE_EVT_CODE中添加一個IO翻轉(zhuǎn)函數(shù)。

ACI_HAL_GET_LINK_STATUS

aci_hal_get_link_status函數(shù)描述中，它返回的Link_Status數(shù)組有8個元素，這意味著該設(shè)備可以管理最多8個Bluetooth Low Energy（BLE）連接。每一個元素代表一個可能的BLE連接的狀態(tài)。
因此，當(dāng)你想獲取每一個BLE連接的狀態(tài)并據(jù)此執(zhí)行某些操作（例如斷開連接）時，你需要循環(huán)遍歷這8個可能的連接。

在ble_hci_le.h中有該函數(shù)的說明，要使用這個函數(shù)獲取當(dāng)前連接的句柄并隨后斷開連接，可以這樣做：
聲明兩個數(shù)組來存儲函數(shù)返回的連接狀態(tài)和連接句柄。
調(diào)用aci_hal_get_link_status函數(shù)獲取這些值。
遍歷連接狀態(tài)數(shù)組，查找任何標(biāo)記為已連接的連接（例如，值為0x02或0x05）。
對于每個已連接的狀態(tài)，從連接句柄數(shù)組中取得相應(yīng)的連接句柄，并使用hci_disconnect函數(shù)來斷開連接。

在main.c中添加ble_hci_le.h文件。

/* USER CODE BEGIN Includes */

#include "ble_hci_le.h"
/* USER CODE END Includes */

在main.c中添加變量。

/* USER CODE BEGIN 0 */
uint8_t connect_flag=0;//連接成功標(biāo)志位
uint32_t connect_num=0;//斷開連接計數(shù)器

/* USER CODE END 0 */

在app_ble.c中引用connect_flag變量，可以在連接成功侯讓該標(biāo)志位為1。

/* USER CODE BEGIN Includes */
extern uint8_t connect_flag;//連接成功標(biāo)志位
/* USER CODE END Includes */

可以在HCI_LE_CONNECTION_UPDATE_COMPLETE_SUBEVT_CODE（連接更新完成）事件中添加標(biāo)志位定義，將connect_flag置位位1。

/* USER CODE BEGIN HCI_EVT_LE_CONN_COMPLETE */
					HAL_GPIO_TogglePin(GPIOB,GPIO_PIN_0);
					connect_flag=1;
          /* USER CODE END HCI_EVT_LE_CONN_COMPLETE */

在主程序中延時5S左右之后斷開連接，遍歷連接狀態(tài)數(shù)組，查找任何標(biāo)記為已連接的連接（例如，值為0x02或0x05）。
對于每個已連接的狀態(tài)，從連接句柄數(shù)組中取得相應(yīng)的連接句柄，并使用hci_disconnect函數(shù)來斷開連接。

/* Init code for STM32_WPAN */
  MX_APPE_Init();

  /* Infinite loop */
  /* USER CODE BEGIN WHILE */
  while (1)
  {
    /* USER CODE END WHILE */
    MX_APPE_Process();

    /* USER CODE BEGIN 3 */
		//檢查連接標(biāo)志，如果連接成功，則進(jìn)行處理
		if(connect_flag)
		{
			if(connect_num< 5000)
				connect_num++;
			else
			{
				connect_num=0;
				// 初始化連接句柄變量
				uint16_t Connection_Handle1=0;
				
				// 定義存儲連接狀態(tài)和連接句柄的數(shù)組
				uint8_t linkStatus[8];
				uint16_t linkHandles[8];
				tBleStatus status;
				// 獲取當(dāng)前的連接狀態(tài)
				status = aci_hal_get_link_status(linkStatus, linkHandles);
				// 檢查是否成功獲取連接狀態(tài)
				if (status == BLE_STATUS_SUCCESS) {
						// 遍歷所有可能的連接
						for (int i = 0; i < 8; i++) {
								// 判斷當(dāng)前連接是否處于Peripheral或Central角色
								if (linkStatus[i] == 0x02 || linkStatus[i] == 0x05) { 
										// 斷開與此連接句柄關(guān)聯(lián)的連接
										hci_disconnect(linkHandles[i], 0x13); // 使用適當(dāng)?shù)臄嚅_原因
								}
						}
					}
				// 重置連接標(biāo)志
				connect_flag=0;
			}
		}
		HAL_Delay(1);
		
  }
  /* USER CODE END 3 */

hci_disconnect

這是一個藍(lán)牙HCI (Host Controller Interface) 命令的函數(shù)實現(xiàn)，名為 hci_disconnect。HCI是藍(lán)牙規(guī)范中定義的一個接口，允許主機(jī)與藍(lán)牙控制器之間的通信。

在ble_hci_le.h中有該函數(shù)的說明，要使用這個函數(shù)終止現(xiàn)有的藍(lán)牙連接，可以這樣做：
對應(yīng)的參數(shù)有：
Connection_Handle：這是一個標(biāo)識符，指明要斷開的連接。其有效值范圍為 0x0000 到 0x0EFF。
Reason：這是一個表示終止連接原因的參數(shù)。以下是可能的原因及其值：
0x05: 認(rèn)證失敗 (Authentication Failure)
0x13: 遠(yuǎn)程用戶終止了連接 (Remote User Terminated Connection)
0x14: 由于資源不足，遠(yuǎn)程設(shè)備終止了連接 (Remote Device Terminated Connection due to Low Resources)
0x15: 由于關(guān)閉電源，遠(yuǎn)程設(shè)備終止了連接 (Remote Device Terminated Connection due to Power Off)
0x1A: 不支持的遠(yuǎn)程特性 (Unsupported Remote Feature)
0x3B: 不可接受的連接參數(shù) (Unacceptable Connection Parameters)
所以可以用0x13進(jìn)行藍(lán)牙斷開。

結(jié)果演示

通過手機(jī)和STM32WB建立連接，然后等待可以看見是否能正確獲取句柄。