【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个；因本文篇幅的原因所以主要围绕着客户端节点的使用，以下进行详细介绍。

  节点简介

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

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

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

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

• SMP配对模式与参数:

• 扫描超时时间：表示持续扫描，直到与指定服务端建立连接。如果值不为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。

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

• 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节点

• 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：需要写入的数据长度。

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表示使能指示。

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

  示例讲解

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

2. 软件准备

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

双击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)

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

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)

  技术交流群