各位讀者好，新版本的系統平臺低功耗藍牙開發介面庫已發布，提供BLE設備的列舉、掃描、連接和檢測，藍牙服務和特征的列舉、讀寫、訂閱，控制器版本查詢等API函式，支持Windows、Android等系統，鏈接：WCHBleLib_MultiOS.ZIP - 南京沁恒微電子股份有限公司
前言
上一篇文章中，介紹了適用于Win10系統對BLE開發的win32元件，并對庫函式進行了細致的講解，也簡單說明了下該開發庫的使用方法，
這一章，則具體說明了在BLE開發中對該庫的具體使用方法，如何使用這些庫函式，如何處理預定義的回呼函式，
WCH_B LE_DLL開發庫和例程下載
1. 上層應用中回呼函式的定義
1.1 異步操作正常完成的回呼函式
typedef void (CALLBACK* Notify_AppService)(ULONG uAction_Service, PCHAR tmpStr, INT iExtraInfo);當前BLE操作，已經正常完成時，該回呼函式會被呼叫，桌面應用程式可以定義一個結構相同的回呼函式，用來獲取BLE操作完成后的回傳資訊，
e.g.
VOID CALLBACK NotifyAppservice(ULONG uAction_service, PCHAR tmpstr, INT iExtraInfo);第一個引數uAction_service表示當前已完成的BLE操作序號；
第二個引數tmpstr表示操作完成后的字串回傳資訊；
第三個引數iExtraInfo只有在獲取BLE設備特征所支持的功能時才會用到，表示具體的功能值，
p.s.具體引數意義可參照第一篇博客中的頭檔案代碼片段，
1.2 掃描附近BLE設備時的回呼函式
typedef void (CALLBACK* Notify_DeviceWatcher)(PCHAR deviceName, PCHAR deviceID);當執行了掃描BLE設備的操作時，每當掃描到任意設備，或是設備的連接狀態發生變化時，該回呼函式都會被呼叫，
e.g.
VOID CALLBACK NotifyDeviceWatcher(PCHAR deviceName, PCHAR deviceID)
{
//...
// 當deviceName為removed_Device時，表示對應deviceID的BLE設備無法連接，需要剔除
if (deviceName == L"removed_Device")
{
int iCount = m_CtrlList.GetItemCount();
for (int i = 0; i < iCount; i++)
{
CString tmpStr = m_CtrlList.GetItemText(i, 1);
if (tmpStr == deviceID)
{
m_CtrlList.DeleteItem(i);
break;
}
}
}
// 把掃描到的deviceID保存
else
{
m_CtrlList.InsertItem(listCount, deviceName);
m_CtrlList.SetItemText(listCount, 1, deviceID):
m_CtrlList.EnsureVisible(listCount++, FALSE);
}
完整代碼可參考鏈接中的MFC例程，
1.3 BLE操作例外時呼叫的回呼函式
typedef void (CALLBACK* Notify_ErrorStatus)(PCHAR errorString);當前BLE操作出現例外時，該回呼函式會被呼叫，并通過字串引數傳遞例外資訊，
e.g.
VOID CALLBACK NotifyErrorStatus(PCHAR errorString)1.4 BLE讀取特征值操作和Notify時的回呼函式
typedef void (CALLBACK* Notify_ReadBytes)(PUCHAR readBytes, INT iLength);當前執行的是BLE讀取特征值操作或是開啟了Notify訂閱時，每當讀取到特征值時，會呼叫該回呼函式，
e.g.
VOID CALLBACK NotifyReadBytes(PUCHAR readBytes, INT iLength);第一個引數readBytes表示讀取到的Hex值；
第二個引數iLength表示讀取到的位元組長度，
2. MFC例程使用說明
為方便用戶使用該庫進行開發，我們做了一個MFC的例程用來示范，軟體詳細使用說明如下：
2.1 建立后臺任務通訊
先按照第一篇博客配置好BLE開發需要的所有設定后，打開MFC例程如上圖所示，首先點擊新建連接按鈕，與UWP任務建立連接，
2.2 掃描附近BLE設備
連接建立成功后，點擊開始掃描按鈕，開始掃描附近的所有BLE設備，待串列中出現待連接BLE設備時，單擊選中它，然后進入下一步，
2.3 發送BLE設備資訊
選中BLE設備時，點擊傳ID把指定的BLE設備資訊傳給后臺處理程式，準備連接，
2.4 建立BLE設備連接
然后開始建立與BLE設備的連接，點擊開始連接設備，
2.5 獲取服務
連接成功后，點擊嘗試獲取服務，可獲取該設備的所有服務，顯示在串列中，
2.6 獲取特征
選中一個服務后，點擊嘗試獲取特征,可獲取該服務的所有特征，顯示在串列中，
2.7 獲取特征支持的操作
選中一個特征后，點擊嘗試獲取操作后，可列舉出該特征所支持的所有功能，
2.8 讀，寫， Notify
根據支持的不同功能，可分別進行讀，寫，開啟Notify的功能，以下是讀功能的示例，點擊READ，可讀出特征值：
2.9 斷開藍牙連接
操作完成后，點擊斷開藍牙連接可斷開與BLE設備的通訊，
2.10 斷開后臺任務通訊
所有操作完成后，點擊關閉即可斷開所有通訊連接，
轉載請註明出處，本文鏈接：https://www.uj5u.com/caozuo/500273.html
標籤：Windows
上一篇：立創EDA使用筆記
下一篇：MySQL基礎