概述

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

硬件準備

首先需要準備一個開發板，這里我準備的是WB55RG 的開發板：

視頻教學

[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)模塊用于管理多個進程之間共享的訪問權限和資源同步。
開啟HSEM如下。

配置IPCC

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

配置RTC

啟動RF

開啟藍牙

配置為自定義模板。

命名設備名

配置BLE GATT

配置SVC

LED配置

查看原理圖可以得知PB0為藍色LED，PB1為綠色LED。

配置PB0、PB1為輸出IO。

設置工程信息

工程文件設置

參考文檔

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

SVCCTL_App_Notification

SVCCTL_App_Notification函數是一個藍牙事件處理器，用于響應和處理STM32WB BLE堆棧中發生的各種事件。
事件處理的主要內容：

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. 廠商特定調試事件 (HCI_VENDOR_SPECIFIC_DEBUG_EVT_CODE)

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

在HCI_DISCONNECTION_COMPLETE_EVT_CODE中添加一個IO翻轉函數。

/* 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翻轉函數。

ACI_HAL_GET_LINK_STATUS

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

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

在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;//連接成功標志位
uint32_t connect_num=0;//斷開連接計數器

/* USER CODE END 0 */

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

/* USER CODE BEGIN Includes */
extern uint8_t connect_flag;//連接成功標志位
/* USER CODE END Includes */

可以在HCI_LE_CONNECTION_UPDATE_COMPLETE_SUBEVT_CODE（連接更新完成）事件中添加標志位定義，將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左右之后斷開連接，遍歷連接狀態數組，查找任何標記為已連接的連接（例如，值為0x02或0x05）。
對于每個已連接的狀態，從連接句柄數組中取得相應的連接句柄，并使用hci_disconnect函數來斷開連接。

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

hci_disconnect

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

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

結果演示

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