如何在透傳數(shù)據(jù)流中增加必要的擴展業(yè)務(wù)

上一章節(jié)介紹，實現(xiàn)了串口與MQTT服務(wù)器間的數(shù)據(jù)透明傳輸，本章節(jié)將在原有的基礎(chǔ)上，增加 LED 控制業(yè)務(wù)，以此為例來介紹如何在透傳數(shù)據(jù)流中增加必要的擴展業(yè)務(wù)。

??簡介

常見的串口服務(wù)器產(chǎn)品，在實現(xiàn)了數(shù)據(jù)透傳業(yè)務(wù)的同時，會根據(jù)不同的應(yīng)用場景擴展一些額外的輔助業(yè)務(wù)，如DI/DO、ADC采集等。

通過EsDA?MPC-ZC1應(yīng)用——串口服務(wù)器（一）章節(jié)，完成了串口MQTT服務(wù)器的核心業(yè)務(wù)，實現(xiàn)了串口與MQTT服務(wù)器間的數(shù)據(jù)透明傳輸。根據(jù)項目需求，本章節(jié)將在原有的基礎(chǔ)上，增加 LED 控制業(yè)務(wù)。以此為例來介紹如何在透傳數(shù)據(jù)流中增加必要的擴展業(yè)務(wù)。 ?

??業(yè)務(wù)擴展

一、數(shù)據(jù)解析 增加系統(tǒng)控制業(yè)務(wù)，需要在流圖中，對數(shù)據(jù)流進行數(shù)據(jù)解析，解析出系統(tǒng)所支持的控制命令和參數(shù)。

1. 命令格式

擴展控制命令前，先制定出命令格式，本示例以較為簡易的方式實現(xiàn)了命令和參數(shù)的組合，如下所示。 [command]@[parameter] 以?@?作為分隔符，?組合命令（command）?和?參數(shù)（parameter），均為字符串類型。 2. 節(jié)點介紹 實現(xiàn)自定義的數(shù)據(jù)解析功能，通常需要開發(fā)符合需求的節(jié)點，或是直接通過腳本節(jié)點來實現(xiàn)。當功能比較簡單的時，建議直接使用腳本節(jié)點（fscript）來實現(xiàn)。 2.1 fscript fscript 節(jié)點，支持用戶自定義編輯一段可執(zhí)行腳本，可以很靈活的完成一些簡單的定制化業(yè)務(wù)。 *關(guān)于 fscript 腳本教學(xué)可參考《FScript 腳本引擎》：

https://awtk.zlg.cn/pro/docs/awtk_docs/FScript/fscript.html

2.11 屬性

名稱（name）：?節(jié)點名稱，用于索引查找本節(jié)點；

顯示名稱（displayName）：?用于畫布上顯示的名稱；

加載時（Initialize）：?節(jié)點加載時運行的腳本；

運行時（Function）：?節(jié)點每次運行時的腳本；

銷毀時（Finalize）：?節(jié)點銷毀時運行的腳。

fscript 節(jié)點支持輸入3段腳本，分別在節(jié)點加載、運行、銷毀時進行調(diào)用，其中加載、銷毀階段的腳本僅被調(diào)用一次。

2.2 log

log 節(jié)點可以將數(shù)據(jù)流中的數(shù)據(jù)打印到調(diào)試接口上，方便用戶觀察數(shù)據(jù)流中的數(shù)據(jù)。 2.2.1 屬性

名稱（name）：?節(jié)點名稱，用于索引查找本節(jié)點；

顯示名稱（displayName）：?用于畫布上顯示的名稱；

控制臺（log_to_console）：?輸出到系統(tǒng)控制臺；

客戶端（log_to_client）：?輸出到AWFlow Designer客戶端。

2.2.2 輸入

payload：?需要打印的數(shù)據(jù)；

payloadLength：?數(shù)據(jù)長度，uint32_t類型；

payloadType：?指示payload的數(shù)據(jù)類型。

3. 流圖實踐

3.1 添加?log?節(jié)點在原有的串口MQTT透傳流圖上，并入log節(jié)點，觀察串口上報至MQTT服務(wù)的數(shù)據(jù)。

3.2 下載并在線運行

選擇下載流圖，并保持在線運行，這樣可以通過AWFlow Designer 客戶端接收到 log 節(jié)點的消息。

通過串口助手，發(fā)送數(shù)據(jù)。

可以通過 AWFlow Designer 的調(diào)試窗口觀察到串口發(fā)送的數(shù)據(jù)。

3.3 添加命令解析腳本

在 log 和?串口輸入數(shù)據(jù)流中，添加 fscript 節(jié)點。僅在 Function 階段輸入命令解析腳本。腳本先將輸入的數(shù)據(jù) msg.payload 轉(zhuǎn)換成字符串類型，再通過 one_of 函數(shù)，以?@?分隔符，將字串分隔成2段，并分別賦值給 msg 的 cmd 和 arg 屬性。

/*?MQTT和串口節(jié)點輸出為pointer類型，轉(zhuǎn)換為string?*/
rbuf?=?rbuffer_create(msg.payload,?msg.payloadLength)
s_payload?=?rbuffer_read_string(rbuf)

/*?以?@?分隔符，獲取第一段字符串作為命令?*/
msg.cmd?=?one_of(s_payload,?0,?"@")
/*?以?@?分隔符，獲取第二段字符串作為參數(shù)?*/

msg.arg?=?one_of(s_payload,?1,?"@")

至此，實現(xiàn)了從字符串中解析出命令和參數(shù)的功能。

二、系統(tǒng)控制

系統(tǒng)控制模塊，負責響應(yīng)解析模塊解析出來的命令，根據(jù)獲得的命令和參數(shù)，執(zhí)行響應(yīng)的業(yè)務(wù)。本小節(jié)，以LED控制作為系統(tǒng)控制業(yè)務(wù)，實際應(yīng)用可根據(jù)項目需求進行擴展。 *本小節(jié)主要使用?fscript?來完成?LED?的控制業(yè)務(wù)，LED?節(jié)點的使用可參考?EsDA?MPC-ZC1入門（二）——?LED控制。

1. LED控制業(yè)務(wù)

1.1 添加控制腳本在數(shù)據(jù)解析腳本節(jié)點與log節(jié)點之間，并入一個新的 fscript 節(jié)點，用于執(zhí)行LED控制業(yè)務(wù)。

LED 支持3路LED的控制命令，如下所示：

led_red@on / off，點亮/熄滅紅燈；

blue_red@on / off，點亮/熄滅藍燈；

green_red@on / off，點亮/熄滅綠燈。

通過控制命令 msg.cmd 來指定所需要控制LED設(shè)備，msg.arg 轉(zhuǎn)換為LED控制參數(shù)。

/*?LED?控制命令作為設(shè)備名稱，如?led_red@on?*/
output.device_name?=?msg.cmd

if?(msg.arg?==?"on")?{
????/*?點亮LED?*/
????output.payload?=?1
}?else?if?(msg.arg?==?"off")?{
????/*?熄滅LED?*/
????output.payload?=?0
}?else?{
????/*?終止數(shù)據(jù)流?*/
????aborted?=?1

}

1.2 添加LED節(jié)點繼控制腳本之后，串接3個LED節(jié)點。分別綁定了 led_red、led_blue、led_green。