灰度卡动态数据操作说明 2.0（Modbus/网络/文件数据源）

本文档由麒麟电子整理发布，介绍灰度控制卡动态数据功能的完整操作说明。

动态数据操作说明

动态数据功能主要是为了解决一些简易二次开发场景问题，比如灯杆水位监测，停车场系统、火警报警系统等。动态数据涵盖三个板块，Modbus数据源和网络数据源以及文件数据源。

前期准备

需要的软件和固件版本：
软件版本≥7.11.18.0；
固件版本≥7.11.18.0/2.12.8.0。

Modbus数据源

RS485和RS232接线说明
C、D系列SENSOR和GPS
GND对应设备 SENSOR/GPS 接口的 GND；
TX_A对应设备 SENSOR/GPS 接口的 TX_A；
RX_B对应设备 SENSOR/GPS 接口的 RX_B；
5V对应设备 SENSOR/GPS 接口的5V。
[attachimg][/attachimg]

C、D系列裸板接口示意图
AXL
GND对应设备 SENSOR 接口的 GND；
TX_A对应设备 SENSOR 接口的 TX_A；
RX_B对应设备 SENSOR 接口的 RX_B；
5V对应设备 SENSOR 接口的5V。
[attachimg][/attachimg]

AXL接口示意图
H6、H8、B8L
GND对应设备 RS485/RS232 接口的 GND；
TX_A对应设备 RS485/RS232 接口的 TX_A；
RX_B对应设备 RS485/RS232 接口的 RX_B；
5V对应设备 RS485/RS232 接口的5V。
[attachimg][/attachimg]

H6、H8接口示意图
[attachimg][/attachimg]

B8L接口示意图
注意事项：常规版本的C、D以及AXL系列SENSOR/GPS接口不支持RS485/RS232,需要加焊RS485/RS232芯片，或者购买本公司带485转换芯片的配线。

Modbus设置
基本设置
（1）HDPlayer控制菜单-其他设置中打开动态数据；
（2）选择设备；
（3）添加Modbus数据源；
（4）选择Modbus数据模式（支持ASCII/RTU/TCP），设置数据更新间隔。设备ID（设备地址）、设备波特率/IP地址、端口号为固定值可根据采集设备的规格书进行填写。
[attachimg][/attachimg]

参数设置
（1）字段名：默认Para1，可自定义；
（2）功能：01线圈状态（0x）、02输入状态（1x）、03保持寄存器（4x）、04输入寄存器（3x），根据采集设备的寄存器参数选择对应的功能；
（3）寄存器地址(十进制）：参考采集设备的寄存器说明；
（4）类型：支持高8位、低8位、有符短整型16位、无符短整型16位、整形32位、浮点型32位；
（5）顺序：支持四种标准字节顺序格式：
ABCD - 标准大端序
寄存器顺序：先高16位，后低16位
字节顺序：大端序
示例：数据 0x12345678 → 寄存器 [0x1234, 0x5678]
BADC - 大端字节交换
寄存器顺序：先低16位，后高16位
字节顺序：大端序
示例：数据 0x12345678 → 寄存器 [0x3412, 0x7856]
CDAB - 小端序
寄存器顺序：先高16位，后低16位
字节顺序：小端序
示例：数据 0x12345678 → 寄存器 [0x5678, 0x1234]
DCBA - 小端字节交换
寄存器顺序：先低16位，后高16位
字节顺序：小端序
示例：数据 0x12345678 → 寄存器 [0x7856, 0x3412]
Modbus设备在传输多字节数据（如浮点数、32位整数）时，字节的排列顺序至关重要，请根据连接的设备要求选择合适的字节序设置；
（6）操作项：删除字段或添加条件和显示替换；
示例：
[attachimg][/attachimg]

某传感器的寄存器地址，需要获取温度值。
根据温度的PLC或组态地址为40002：40表示功能要选择4x，001表示寄存器地址（十进制）需要输入002，类型选择有符号短整型；
实际值10倍：表示传感器读到的值是实际的值10倍，需要在LED显示正确的值，需要进行运算。Modbus参数设置如下图：
[attachimg][/attachimg]

运算设置：
[attachimg][/attachimg]

网络数据

网络数据源设置
（1）HDPlayer控制菜单-其他设置中打开动态数据；
（2）选择设备；
（3）添加网络数据源；
（4）选择数据类型：GET/POST；
（5）数据更新时间间隔；
（6）添加URL地址，支持http、https协议；
（7）选择需要展示的字段；
（8）对字段列表进行设置。
[attachimg][/attachimg]

POST和GET的区别：GET用于从服务器安全获取资源，数据通过URL传递且可缓存；POST用于向服务器提交数据以修改资源，数据通过请求体传输且默认不缓存‌。POST类型支持4种类型的请求体：form-data、json、xml、raw。
[attachimg][/attachimg]

文件数据源

文件数据源设置
（1）HDPlayer控制菜单-其他设置中打开动态数据；
（2）选择设备；
（3）添加文件数据源；
（4）选择文件类型：本地/外部；
（5）数据更新时间间隔；
（6）选择文件；
（7）选择需要展示的字段；
（8）对字段列表进行设置。
[attachimg][/attachimg]

节目设置

常规节目设置
（1）HDPlayer节目页右击-添加动态数据；
（2）选择已经设置好的Modbus数据源/网络数据源/文件数据源；
（3）选择参数/字段。光标移到参数/字段的左边可添加前缀，移动到参数的右边可添加后缀如：计量单位、符号等；
（4）点击发送。
[attachimg][/attachimg]

运算
可对采集的数据进行加减乘除，以及相对复杂的数据进行拆分、合并、取余等操作，从而高效的应对复杂的运算公式。
[attachimg][/attachimg]

具体说明参照以下文档：
添加运算后选择表达式参数发送节目。
[attachimg][/attachimg]

条件显示替换和显示样式
条件显示替换
一旦数据符合预设条件，系统便会自动、实时地将样式或内容切换为指定方案，实现展示效果的智能化动态变更。
（1）HDPlayer节目页右击-添加动态数据；
（2）选择已经设置好的Modbus数据源/网络数据源；
（3）选择参数/字段；
（5）选择数据源；
（6）选择表达式类型；
（7）选择符号；
（8）设置比较值；
（9）设置显示样式；
（10）点击确定。
[attachimg][/attachimg]

[attachimg][/attachimg]

条件替换
（1）HDPlayer控制菜单-其他设置中打开动态数据；
（2）选择设备；
（3）添加Modbus数据源/网络数据源；
（4）添加参数/字段，打开显示；
（5）选择表达式类型；
（6）选择符号；
（7）设置比较值；
（8）设置显示样式；
（9）点击确定，HDPlayer主界面下发节目。
[attachimg][/attachimg]

节目播控
通过接入外部数据源（如天气、客流、销售数据等）来智能控制节目播放。它能根据预设条件自动触发最应景的内容，实现“内容随动”。例如，当温度升高时自动播放冷饮广告，确保营销的精准性与场景的智能化。
HDPlayer新建节目；
点击显示屏，勾选绑定建；
（3）选择数据源；
（4）选择字段；
（5）点击节目；
（6）设置触发条件；
（7）下发节目。
[attachimg][/attachimg]

[attachimg][/attachimg]

节目播控规则：
（1）当外部数据源符合节目触发条件时，则触发该节目的播放；
（2）当外部数据源不符合节目触发条件时，则播放未设置触发条件的节目；
（3）当多个节目符合触发条件时，播放顺序为从上到下依次进行循环播放。

动态数据表格
动态数据支持结构固定的数据（固定表格）和数据量动态变化（动态行表格）。
（1）HDPlayer控制菜单-其他设置中打开动态数据；
（2）选择设备，添加网络数据源，；
（3）选择矩阵类型数据；
（4）创建动态数据节目；
（5）打开表格功能；
（6）表格类型选择动态行/列，设置单个表格宽度；
（7）设置基本的表头；
（8）选择矩阵类型的字段；
（9）下发节目。
[attachimg][/attachimg]

[attachimg][/attachimg]

[attachimg][/attachimg]

动态数据表格规则：
（1）固定表格、动态行表格、动态列表格规则：
固定表格：行、列固定，不会根据数据进行变化，横向填充数据；
动态行表格：根据绑定数据源，动态显示表格行数，横向填充数据；
动态列表格：根据绑定数据源，动态显示表格列数，纵向填充数据；
（2）动态表格只能绑定矩阵类型字段；
（3）一个动态数据插件只能存在一个表格。