如何在透传数据流中增加必要的扩展业务_技术

上一章节介绍，实现了串口与MQTT服务器间的数据透明传输，本章节将在原有的基础上，增加 LED 控制业务，以此为例来介绍如何在透传数据流中增加必要的扩展业务。

简介

常见的串口服务器产品，在实现了数据透传业务的同时，会根据不同的应用场景扩展一些额外的辅助业务，如DI/DO、ADC采集等。

通过EsDA MPC-ZC1应用——串口服务器（一）章节，完成了串口MQTT服务器的核心业务，实现了串口与MQTT服务器间的数据透明传输。根据项目需求，本章节将在原有的基础上，增加 LED 控制业务。以此为例来介绍如何在透传数据流中增加必要的扩展业务。

业务扩展

一、数据解析 增加系统控制业务，需要在流图中，对数据流进行数据解析，解析出系统所支持的控制命令和参数。

1. 命令格式

扩展控制命令前，先制定出命令格式，本示例以较为简易的方式实现了命令和参数的组合，如下所示。 [command]@[parameter] 以 @ 作为分隔符，组合命令（command） 和 参数（parameter），均为字符串类型。 2. 节点介绍 实现自定义的数据解析功能，通常需要开发符合需求的节点，或是直接通过脚本节点来实现。当功能比较简单的时，建议直接使用脚本节点（fscript）来实现。 2.1 fscript fscript 节点，支持用户自定义编辑一段可执行脚本，可以很灵活的完成一些简单的定制化业务。 *关于 fscript 脚本教学可参考《FScript 脚本引擎》：

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

2.11 属性

名称（name）：节点名称，用于索引查找本节点；

显示名称（displayName）：用于画布上显示的名称；

加载时（IniTIalize）：节点加载时运行的脚本；

运行时（FuncTIon）：节点每次运行时的脚本；

销毁时（Finalize）：节点销毁时运行的脚。

fscript 节点支持输入3段脚本，分别在节点加载、运行、销毁时进行调用，其中加载、销毁阶段的脚本仅被调用一次。

2.2 log

log 节点可以将数据流中的数据打印到调试接口上，方便用户观察数据流中的数据。 2.2.1 属性

名称（name）：节点名称，用于索引查找本节点；

显示名称（displayName）：用于画布上显示的名称；

控制台（log_to_console）：输出到系统控制台；

客户端（log_to_client）：输出到AWFlow Designer客户端。

2.2.2 输入

payload：需要打印的数据；

payloadLength：数据长度，uint32_t类型；

payloadType：指示payload的数据类型。

3. 流图实践

3.1 添加 log 节点在原有的串口MQTT透传流图上，并入log节点，观察串口上报至MQTT服务的数据。

3.2 下载并在线运行

选择下载流图，并保持在线运行，这样可以通过AWFlow Designer 客户端接收到 log 节点的消息。

通过串口助手，发送数据。

可以通过 AWFlow Designer 的调试窗口观察到串口发送的数据。

3.3 添加命令解析脚本

在 log 和串口输入数据流中，添加 fscript 节点。仅在 FuncTIon 阶段输入命令解析脚本。脚本先将输入的数据 msg.payload 转换成字符串类型，再通过 one_of 函数，以 @ 分隔符，将字串分隔成2段，并分别赋值给 msg 的 cmd 和 arg 属性。

/* MQTT和串口节点输出为pointer类型，转换为string */
rbuf = rbuffer_create(msg.payload, msg.payloadLength)
s_payload = rbuffer_read_string(rbuf)

/* 以 @ 分隔符，获取第一段字符串作为命令 */
msg.cmd = one_of(s_payload, 0, "@")
/* 以 @ 分隔符，获取第二段字符串作为参数 */

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

至此，实现了从字符串中解析出命令和参数的功能。

二、系统控制

系统控制模块，负责响应解析模块解析出来的命令，根据获得的命令和参数，执行响应的业务。本小节，以LED控制作为系统控制业务，实际应用可根据项目需求进行扩展。 *本小节主要使用 fscript 来完成 LED 的控制业务，LED 节点的使用可参考 EsDA MPC-ZC1入门（二）—— LED控制。

1. LED控制业务

1.1 添加控制脚本在数据解析脚本节点与log节点之间，并入一个新的 fscript 节点，用于执行LED控制业务。

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

led_red@on / off，点亮/熄灭红灯；

blue_red@on / off，点亮/熄灭蓝灯；

green_red@on / off，点亮/熄灭绿灯。

通过控制命令 msg.cmd 来指定所需要控制LED设备，msg.arg 转换为LED控制参数。

/* LED 控制命令作为设备名称，如 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 {
    /* 终止数据流 */
    aborted = 1

}

1.2 添加LED节点继控制脚本之后，串接3个LED节点。分别绑定了 led_red、led_blue、led_green。