【EsDA应用】蓝牙客户端节点详解

蓝牙作为一种近距离无线通信技术，被广泛使用在汽车，智能家居和医疗等领域中。本文主要介绍如何通过EsDA开发套件，快速实现蓝牙客户端的订阅以及读写等操作。  简介

蓝牙是一种近距离无线通信技术，可以免费运行在2.4G频段，所以通常广泛使用在物联网，移动终端和智能家居等行业中。我们EsDA大家族里面自然也有对蓝牙功能的实现，且只需要很短的时间就可实现蓝牙通信，功能好用简单又便捷。

本文主要基于MPC-ZC1的开发板，以及可将节点进行拖拽连接的图形化设计工具AWFlow Designer，着重对UIS8910DM平台的板载蓝牙的配套节点以及示例进行讲解。蓝牙节点一共分为配置节点类型ble_server，ble_client2个，客户端节点类型ble_client_in，ble_client_out，ble_client_subscribe3个以及服务端节点类型ble_server_adv，ble_server_service2个；因本文篇幅的原因所以主要围绕着客户端节点的使用，以下进行详细介绍。

 节点简介1. 配置节点1.1 ble_client节点1.1.1 属性

扫描类型： 启动扫描时需要的扫描类型配置：

值为0表示被动扫描（仅仅接收广播，不会发送扫描请求）；

值为1时表示主动扫描（发送扫描请求数据给广播的服务端，服务端收到后会返回扫描响应数据）。

• 扫描窗口的时间：扫描窗口时间的配置；
• 扫描间隔的时间：扫描间隔时间的配置；

注意：扫描窗口时间必须小于扫描间隔时间。

扫描过滤策略：扫描过滤策略的配置：

1表示只处理地址在白名单中的数据包，以及发给自己的可连接定向广播；

2表示处理所有非定向广播和可解析私有地址以及发给自己的可连接定向广播；

3表示处理地址在白名单中和可解析私有地址以及发给自己的可连接定向广播。

• 目标服务端设备名称：目标服务端设备本地名称；

SMP配对模式与参数:

SMP配对模式	参数	安全等级排名
SECURE_CONNECTION_PASSKEY	KEYBOARD_DISP	最高
SECURE_CONNECTION_JUSTWORK	NOIN_NOOUT	次之
LEGACY_PASSKEY	KEYBOARD_DISP	第三
LEGACY_JUSTWORK	NOIN_NOOUT	最低

• 扫描超时时间：表示持续扫描，直到与指定服务端建立连接。如果值不为0，则开启扫描后使能扫描定时器，超时后如果仍未与指定服务端建立连接，则扫描停止。单位ms

配置节点无输入输出

2. 客户端节点

2.1 ble_client_in节点

2.1.1 属性

• BLE客户端配置：绑定一个ble_client蓝牙客户端的配置节点；
• 服务UUID：需要读的服务UUID。若服务UUID为自定义的16字节如00 00 ff 11 00 00 10 00 80 00 00 80 5f 9b 34 fb，则传入第3、4两个字节0xff11；

特征值UUID：需要读的特征值UUID。若特征值UUID为自定义的16字节如00 00 ff 01 00 00 10 00 80 00 00 80 5f 9b 34 fb，则传入第3、4两个字节0xff01。

2.1.2 输入

• payload：可以使用“timer”节点作为前级节点，定时读取数据。

2.1.3 输出

• characteristic_uuid：将读取到的指定特征值的UUID输出；
• payload：将读取到的指定特征值的数组指针输出。类型为uint8_t类型的指针；
• payloadLength：将读取到的指定特征值的数据长度输出；
• desc_num：将读取到的指定特征值的描述符个数输出。如果存在多个描述符，则存在多个名称为“desc_uuid_%d”、“desc_value_%d”和“desc_value_length_%d”的属性，其中%d指代当前是第几个描述符；
• 举例：该特征存在2个描述符，则存在以下名称的属性：desc_uuid_0，desc_value_0，desc_value_length_0和desc_uuid_1，desc_value_1，desc_value_length_1，desc_uuid_0；
• desc_uuid_0：第一个描述符的UUID，若为第二个描述符的UUID也可表示为desc_uuid_1。以此类推；
• desc_value_0：第一个描述符的值指针，若为第二个描述符的值也可表示为desc_value_1。以此类推；
• desc_value_length_0：第一个描述符的值的数据长度，若为第二个描述符的值的数据长度也可表示为desc_value_length_1。以此类推。

2.2 ble_client_out节点

2.2.1 属性

• BLE客户端配置：绑定一个ble_client蓝牙客户端的配置节点；
• 服务UUID：需要读的服务UUID。若服务UUID为自定义的16字节如00 00 ff 11 00 00 10 00 80 00 00 80 5f 9b 34 fb，则传入第3、4两个字节0xff11；
• 特征值UUID：需要读的特征值UUID。若特征值UUID为自定义的16字节如00 00 ff 01 00 00 10 00 80 00 00 80 5f 9b 34 fb，则传入第3、4两个字节0xff01。

2.2.2 输入

payload：需要写入的数据，字符串类型。可以使用fscript节点对payload进行设置

payloadLength：需要写入的数据长度。

sink类型节点没有输出功能

2.3 ble_client_subscribe节点

2.3.1 属性

• BLE客户端配置：绑定一个ble_client蓝牙客户端的配置节点；
• 服务UUID：需要读的服务UUID。若服务UUID为自定义的16字节如00 00 ff 11 00 00 10 00 80 00 00 80 5f 9b 34 fb，则传入第3、4两个字节0xff11；
• 特征值UUID：需要读的特征值UUID。若特征值UUID为自定义的16字节如00 00 ff 01 00 00 10 00 80 00 00 80 5f 9b 34 fb，则传入第3、4两个字节0xff01；
• 订阅模式：值为0表示禁能通知和指示，值为1表示使能通知，值为2表示使能指示。

pump类型节点无输入数据

2.3.2 输出

• payload：订阅的特征值的数据内容；
• payloadLength：订阅的特征值的数据长度；
• characteristic_uuid：订阅的特征值的UUID。

 示例讲解1. 硬件准备

如下图所示，准备一块MPC-ZC1开发板，并按照下图所示连接好硬件。用于下载流图的USB Type-C口另外一端接到PC机上。

2. 软件准备

目前MPC-ZC1开发板作为客户端，对BLE调试宝(手机app)服务端(外围模式)提供的服务进行订阅、读写等操作，依下图所示可根据用户需求随意设置服务UUID、特征值UUID、特征数据以及通知数据，最后点击开启广播，服务端BLE调试宝的配置就设置完成了。

随之修改手机本地蓝牙(服务端设备)名称，后期此名称用来配置ble_client节点的属性参数目标服务端设备名称。

3. EsDA业务开发本示例主要是将MPC-ZC1开发板作为蓝牙客户端，对BLE调试宝(蓝牙服务端)指定服务下指定的特征值数据进行读写以及订阅的操作，具体实现如下图。本例程只对服务端提供的一个服务的特征值进行了订阅和读写操作，根据实际需求，可支持对多个指定服务下的指定特征值进行读写和订阅的操作。

3.1 添加节点并绘制流图添加timer，ble_client_in，ble_client_out，ble_client_subscribe，fscript节点如下图所示。

3.2 配置节点

周期性的去读取蓝牙服务端指定服务下指定的特征值的特征数据。

双击ble_client_in节点的前驱timer节点，打开属性面板设置定时周期(ms)，MPC-ZC1开发板周期性的去读取BLE调试宝指定服务下指定的特征值数据。修改完后点击右上角的完成即可保存属性配置。

双击ble_client_in节点中的BLE客户端配置，本属性配置在一份流图上只需要配置一次即可，后面ble_client_out以及ble_client_subscribe节点的属性BLE客户端配置都会链接到同一个ble_server，不需再次重复配置所以后面不再赘述。这里可以只修改属性值：目标服务端设备名称，需注意的是此处的参数与服务端提供的信息需一致。修改完后点击右上角的更新即可保存属性配置。双击ble_client_in节点，修改需要读取指定的服务UUID和特征值UUID。修改完后点击右上角的完成即可保存属性配置。

双击ble_client_in节点的后继fscript节点，主要内容是对读取的特征值UUID进行输出以及将服务端指定的服务UUID及特征值UUID下的特征内容进行输出。

•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  

print("payloadLength is"+msg.payloadLength)print("characteristic_uuid is" + msg.characteristic_uuid);
rb = rbuffer_create(msg.payload, msg.payloadLength)print("length: "+ msg.payloadLength)
f = "recv ble server data is"for(var i=0; i1) { d = rbuffer_read_uint8(rb); f = join(",",f,d);}
msg.payload = fprint("data "+msg.payload)

周期性的去写入蓝牙服务端指定服务下指定的特征值的特征数据。

双击ble_client_out节点的前驱*2的timer节点，打开属性面板设置定时周期(ms)，MPC-ZC1开发板周期性的去写入BLE调试宝指定服务下指定的特征值数据。修改完后点击右上角的完成即可保存属性配置。

因ble_client_out节点作为sink类型节点，所以fscript节点即为他的前驱节点。双击fscript，主要功能实现是设置ble_client_out节点的输入数据：payload（要写入的数据），payloadLength(需要写入的数据长度)。

•  
•  

msg.payload = "123456789"set(msg.payloadLength, u8("9"))

双击ble_client_out节点，配置需要写入数据的服务UUID和特征值UUID。修改完后点击右上角的完成即可保存属性配置。

对蓝牙服务端指定服务下指定的特征值的订阅数据进行订阅操作。

双击ble_client_subscribe节点，配置需要订阅的服务UUID，特征值UUID以及订阅模式。修改完后点击右上角的完成即可保存属性配置。双击ble_client_subscribe的后继节点fscript，主要功能是将接收到的订阅数据进行输出打印。

•  
•  
•  
•  
•  
•  
•  
•  
•  
•  
•  

rb = rbuffer_create(msg.payload, msg.payloadLength)print("length: "+ msg.payloadLength)
f = "recv subscribe data is"for(var i=0; i1) { d = rbuffer_read_uint8(rb); f = join(",",f,d);}
msg.payload = fprint("data "+msg.payload)

3.3 下载验证MPC-ZC1开发板调试口打印信息如下：BLE调试宝操作日志显示如下：由操作日志可以看到，MPC-ZC1和手机蓝牙建立连接成功、MPC-ZC1读取特征值，开启通知、接收MPC-ZC1写入新的特征值数据、接收通知。至此示例实验已完成。