【Z站推荐】EsDA MPC-ZC1 应用——串口服务器（二）_诺佳网—

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

简介

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

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

业务扩展

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

1. 命令格式

扩展控制命令前，先制定出命令格式，本示例以较为简易的方式实现了命令和参数的组合，如下所示。[command]@[parameter]以@作为分隔符，组合命令（command）和参数（parameter），均为字符串类型。2. 节点介绍实现自定义的数据解析功能，通常需要开发符合需求的节点，或是直接通过脚本节点来实现。当功能比较简单的时，建议直接使用脚本节点（fscript）来实现。2.1 fscriptfscript 节点，支持用户自定义编辑一段可执行脚本，可以很灵活的完成一些简单的定制化业务。*关于 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节点的使用可参考EsDAMPC-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
}elseif(msg.arg=="off"){
/*熄灭LED*/
output.payload=0
}else{
/*终止数据流*/
aborted=1

}

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