Windows端用于开发低功耗蓝牙项目的DLL(二)

各位读者好，新版本的系统平台低功耗蓝牙开发接口库已发布，提供BLE设备的枚举、扫描、连接和检测，蓝牙服务和特征的枚举、读写、订阅，控制器版本查询等API函数。支持Windows、Android等系统。链接：http://www.wch.cn/downloads/WCHBleLib_MultiOS_ZIP.html

前言

上一篇文章中，介绍了适用于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 断开后台任务通讯

所有操作完成后，点击关闭即可断开所有通讯连接。