【EsDA應(yīng)用】藍(lán)牙客戶端節(jié)點(diǎn)詳解

藍(lán)牙作為一種近距離無(wú)線通信技術(shù)，被廣泛使用在汽車(chē)，智能家居和醫(yī)療等領(lǐng)域中。本文主要介紹如何通過(guò)EsDA開(kāi)發(fā)套件，快速實(shí)現(xiàn)藍(lán)牙客戶端的訂閱以及讀寫(xiě)等操作。

??簡(jiǎn)介

藍(lán)牙是一種近距離無(wú)線通信技術(shù)，可以免費(fèi)運(yùn)行在2.4G頻段，所以通常廣泛使用在物聯(lián)網(wǎng)，移動(dòng)終端和智能家居等行業(yè)中。我們EsDA大家族里面自然也有對(duì)藍(lán)牙功能的實(shí)現(xiàn)，且只需要很短的時(shí)間就可實(shí)現(xiàn)藍(lán)牙通信，功能好用簡(jiǎn)單又便捷。

本文主要基于MPC-ZC1的開(kāi)發(fā)板，以及可將節(jié)點(diǎn)進(jìn)行拖拽連接的圖形化設(shè)計(jì)工具AWFlow Designer，著重對(duì)UIS8910DM平臺(tái)的板載藍(lán)牙的配套節(jié)點(diǎn)以及示例進(jìn)行講解。藍(lán)牙節(jié)點(diǎn)一共分為配置節(jié)點(diǎn)類型ble_server，ble_client2個(gè)，客戶端節(jié)點(diǎn)類型ble_client_in，ble_client_out，ble_client_subscribe3個(gè)以及服務(wù)端節(jié)點(diǎn)類型ble_server_adv，ble_server_service2個(gè)；因本文篇幅的原因所以主要圍繞著客戶端節(jié)點(diǎn)的使用，以下進(jìn)行詳細(xì)介紹。

??節(jié)點(diǎn)簡(jiǎn)介

• 掃描類型：?啟動(dòng)掃描時(shí)需要的掃描類型配置：

• 掃描窗口的時(shí)間：掃描窗口時(shí)間的配置；
• 掃描間隔的時(shí)間：掃描間隔時(shí)間的配置；

• 掃描過(guò)濾策略：掃描過(guò)濾策略的配置：

• 目標(biāo)服務(wù)端設(shè)備名稱：目標(biāo)服務(wù)端設(shè)備本地名稱；

• SMP配對(duì)模式與參數(shù):

• 掃描超時(shí)時(shí)間：表示持續(xù)掃描，直到與指定服務(wù)端建立連接。如果值不為0，則開(kāi)啟掃描后使能掃描定時(shí)器，超時(shí)后如果仍未與指定服務(wù)端建立連接，則掃描停止。單位ms

2. 客戶端節(jié)點(diǎn)

2.1 ble_client_in節(jié)點(diǎn)

2.1.1 屬性

• BLE客戶端配置：綁定一個(gè)ble_client藍(lán)牙客戶端的配置節(jié)點(diǎn)；
• 服務(wù)UUID：需要讀的服務(wù)UUID。若服務(wù)UUID為自定義的16字節(jié)如00?00 ff 11 00?00 10?00 80?00?00 80 5f 9b 34 fb，則傳入第3、4兩個(gè)字節(jié)0xff11；

• 特征值UUID：需要讀的特征值UUID。若特征值UUID為自定義的16字節(jié)如00?00 ff 01 00?00 10?00 80?00?00 80 5f 9b 34 fb，則傳入第3、4兩個(gè)字節(jié)0xff01。

• payload：可以使用“timer”節(jié)點(diǎn)作為前級(jí)節(jié)點(diǎn)，定時(shí)讀取數(shù)據(jù)。

• characteristic_uuid：將讀取到的指定特征值的UUID輸出；
• payload：將讀取到的指定特征值的數(shù)組指針輸出。類型為uint8_t類型的指針；
• payloadLength：將讀取到的指定特征值的數(shù)據(jù)長(zhǎng)度輸出；
• desc_num：將讀取到的指定特征值的描述符個(gè)數(shù)輸出。如果存在多個(gè)描述符，則存在多個(gè)名稱為“desc_uuid_%d”、“desc_value_%d”和“desc_value_length_%d”的屬性，其中%d指代當(dāng)前是第幾個(gè)描述符；
• 舉例：該特征存在2個(gè)描述符，則存在以下名稱的屬性：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：第一個(gè)描述符的UUID，若為第二個(gè)描述符的UUID也可表示為desc_uuid_1。以此類推；
• desc_value_0：第一個(gè)描述符的值指針，若為第二個(gè)描述符的值也可表示為desc_value_1。以此類推；
• desc_value_length_0：第一個(gè)描述符的值的數(shù)據(jù)長(zhǎng)度，若為第二個(gè)描述符的值的數(shù)據(jù)長(zhǎng)度也可表示為desc_value_length_1。以此類推。

2.2 ble_client_out節(jié)點(diǎn)

• BLE客戶端配置：綁定一個(gè)ble_client藍(lán)牙客戶端的配置節(jié)點(diǎn)；
• 服務(wù)UUID：需要讀的服務(wù)UUID。若服務(wù)UUID為自定義的16字節(jié)如00?00 ff 11 00?00 10?00 80?00?00 80 5f 9b 34 fb，則傳入第3、4兩個(gè)字節(jié)0xff11；
• 特征值UUID：需要讀的特征值UUID。若特征值UUID為自定義的16字節(jié)如00?00 ff 01 00?00 10?00 80?00?00 80 5f 9b 34 fb，則傳入第3、4兩個(gè)字節(jié)0xff01。

2.2.2 輸入

• payload：需要寫(xiě)入的數(shù)據(jù)，字符串類型。可以使用fscript節(jié)點(diǎn)對(duì)payload進(jìn)行設(shè)置

• payloadLength：需要寫(xiě)入的數(shù)據(jù)長(zhǎng)度。

2.3.1 屬性

• BLE客戶端配置：綁定一個(gè)ble_client藍(lán)牙客戶端的配置節(jié)點(diǎn)；
• 服務(wù)UUID：需要讀的服務(wù)UUID。若服務(wù)UUID為自定義的16字節(jié)如00?00 ff 11 00?00 10?00 80?00?00 80 5f 9b 34 fb，則傳入第3、4兩個(gè)字節(jié)0xff11；
• 特征值UUID：需要讀的特征值UUID。若特征值UUID為自定義的16字節(jié)如00?00 ff 01 00?00 10?00 80?00?00 80 5f 9b 34 fb，則傳入第3、4兩個(gè)字節(jié)0xff01；
• 訂閱模式：值為0表示禁能通知和指示，值為1表示使能通知，值為2表示使能指示。

• payload：訂閱的特征值的數(shù)據(jù)內(nèi)容；
• payloadLength：訂閱的特征值的數(shù)據(jù)長(zhǎng)度；
• characteristic_uuid：訂閱的特征值的UUID。

??示例講解

如下圖所示，準(zhǔn)備一塊MPC-ZC1開(kāi)發(fā)板，并按照下圖所示連接好硬件。用于下載流圖的USB Type-C口另外一端接到PC機(jī)上。

2. 軟件準(zhǔn)備

目前MPC-ZC1開(kāi)發(fā)板作為客戶端，對(duì)BLE調(diào)試寶(手機(jī)app)服務(wù)端(外圍模式)提供的服務(wù)進(jìn)行訂閱、讀寫(xiě)等操作，依下圖所示可根據(jù)用戶需求隨意設(shè)置服務(wù)UUID、特征值UUID、特征數(shù)據(jù)以及通知數(shù)據(jù)，最后點(diǎn)擊開(kāi)啟廣播，服務(wù)端BLE調(diào)試寶的配置就設(shè)置完成了。

雙擊ble_client_in節(jié)點(diǎn)的后繼fscript節(jié)點(diǎn)，主要內(nèi)容是對(duì)讀取的特征值UUID進(jìn)行輸出以及將服務(wù)端指定的服務(wù)UUID及特征值UUID下的特征內(nèi)容進(jìn)行輸出。

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)

??技術(shù)交流群