帮助中心

3.功能指南

3.2配置

3.2.1配置向导

【说明】：快速创建采集服务、采集通道、采集测点、上传服务、上传测点。
注：上传服务无需创建通道。

创建采集服务：
【说明】：采集服务是DASS的主要功能之一，主要用于完成各种现场设备实时数据的对接。通过在DASS内进行采集服务配置，实现盒子与设备间通信，并将采集数据存储至openPlant。
【操作】：

点击<创建采集>按钮。

填写服务基本信息：

**选择应用**：选择服务所用的驱动，如列表内无所需驱动，需先在应用商城下载与盒子版本一致的采集驱动，离线导入到应用管理后方可使用。示例：GB_Modbus_Poll_TCP；
**服务名称**：服务名唯一。示例：test；
**描述：**可添加自定义服务描述（不能为空）。
填写完点击<下一步>

填写服务基本通信配置

根据个人需求填写配置，具体的配置请查看驱动说明书。填写完点击<创建>即可。

创建采集通道
【说明】：1. 旧版的采集驱动在完成服务的创建后，系统会默认创建名为”DEC“通道，可跳过创建采集通道这一步骤，直接创建测点。
2. 新版的采集驱动在完成服务的创建后，需手动创建通道。如下操作所示。
【操作】：

采集服务创建后会跳转到添加通道的页面，填写通道信息：
服务名称：在创建采集服务时已填写，此处无需再填；
通道名称：必填项，填写格式为：字母、数字、下划线，示例：td1；

填写配置信息。不同驱动版本的配置不同，根据个人需求填写即可，具体的驱动配置请查看其说明书。填写后，点击<创建>。

页面显示出采集服务名称、通道名称。
点击<新建测点>按钮，即可新建测点；
点击<完成>按钮，则完成通道的创建；
点击<创建另外一个通道>按钮，即可在当前服务下创建新的一个通道；
点击<创建上传服务>按钮，即可创建新的上传服务；

创建采集测点

选择一个需添加测点的通道，点击 <新建测点> 按钮。

填写测点属性
注：以下为必配测点属性，其余属性见附录《测点属性说明表》
点名：测点名称，节点下唯一。支持英文、数字、下划线、英文中划线。示例：dm1；
ID：系统自动分配，无需填写；
数据类型：数据存储到 openplant 的类型；
地址信息（AD）：格式见 Modbus 地址说明。示例：1.3.0；
采集点类型（SR）：采集驱动解析使用的数据类型。
填写后，点击<创建>，在<数据采集>的<采集服务>中存在名为 < test >的服务，服务下有名为< td1 >的通道，单击< td1 >,则可查看到采集测点创建成功。

创建上传服务：
【说明】：上传服务是DASS的主要功能之一，用于提供北向的数据服务和协议转换服务。设备实时数据由采集服务采集后，会在openPlant内保存一定时间（根据盒子型号不同）。通过在DASS内进行上传服务配置，将测点信息上传至中心数据库/其他客户端数据库。
【操作】：

点击<创建上传>按钮。

填写服务基本信息：

选择应用：选择服务所用的驱动，示例：OP2_MQTT_MagusIOT；
服务名称：服务名唯一。示例：magus；
**描述：**可添加自定义服务描述（不能为空）。
填写完点击<下一步>

根据个人需求填写配置，具体的配置请查看驱动说明书。填写完点击<创建>即可。

页面显示出上传服务名称。
点击【新建测点】按钮，即可新建测点；
点击【完成】按钮，则完成上传服务的创建；

创建上传测点

选择一个需添加测点的通道，点击<新建测点>按钮。

可以按服务、按通道、按测点新建测点。示例：按通道。
【操作】：点击<按服务>按钮，选择在名为 test 的采集服务，选取后会在右侧<已选择项>中显示，最后点击<确定>按钮即可在<数据上传>中的<采集服务>里，存在名为 magus 的上传服务，点击< magus >看见上传测点创建成功。

3.2.2数据采集

【说明】：数据采集是 DASS 软件的核心功能之一，用来配置从现场采集和上传到指定服务器或应用的数据。采集与上传代表数据的流入和流出盒子两个方向，两种服务的操作步骤基本一致。

采集服务管理
采集通道管理
采集测点管理

采集服务管理

新建采集服务
查询采集服务
编辑采集服务
删除采集服务
下载日志
历史回补
清洗测点
启停控制
重启服务

新建采集服务
【说明】：用于新建采集服务。
【操作】：点击<数据采集>下的<采集服务>菜单，再点击新建采集服务的图标即可。后续步骤与3.2.1配置向导中创建采集服务一致，可参考上文。

查询采集服务
【说明】：用于查询采集服务。
【操作】：在搜索框内输入节点名称即可。

编辑采集服务
【说明】：用于修改服务配置。
【操作】：选择并点击列表中的一个服务，点击<更多>下拉框选择<编辑>即可修改服务配置。

删除采集服务
【说明】：删除当前采集服务及其下测点数据，不可恢复，删除服务，服务对应的节点也会删除。
【操作】：选择并点击列表中的一个服务，点击<更多>下拉框选择<删除>并二次确认点击<确定>即可。

下载日志
【说明】：按时间选取所需下载的日志文件。
【操作】：选择并点击列表中的一个服务，点击<更多>下拉框中的<下载日志>，选择要下载的日志点击<下载>即可。

历史回补
【说明】：用于将指定时间段内的历史数据全部重新发送，会消耗较大流量，请酌情使用。
采集服务中，在驱动支持的前提下，以下数据可自选时间段进行回补：

当DASS和设备连接前，被采集设备保存了一段时间的历史数据。
由于通讯异常，导致DASS中保存的历史数据少于设备实际保存的历史数据。

上传服务中，在驱动支持的前提下，以下数据可自选时间段进行回补：

连接上传服务器前，保存在DASS中的历史数据。
由于通讯异常未成功上传的历史数据，一并发送到上传服务器。

【操作】：选择并点击列表中的一个服务，点击<更多>下拉框中的<历史回补>，选择回补的时间段，点击<确认>即可。

清洗测点
【说明】：用于清理该服务下所有测点的脏数据，包括缓存、无效、重复的数据，提高DASS系统的空间利用率。
【操作】：选择并点击列表中的一个服务，点击<更多>下拉框选择<清洗测点>，弹框中点击<确定>即可。

启停控制
【说明】用于控制服务启停。

启用：启用服务，与设备建立连接，正常请求测点数据。
停止：服务中止，与设备连接断开，测点无数据。

停止服务
【操作】选择列表中的服务名，点击<停止服务>，在弹框中点击<确定>即可。

启动服务
【操作】选择列表中的服务名，点击<开启服务>，在弹框中点击<确定>即可。

重启服务
【说明】：用于控制服务启停。
【操作】：选择列表中的服务名，点击<重启服务>，在弹框中点击<确定>即可。

采集通道管理

查询通道
新建通道
删除通道
编辑通道
克隆通道
挂起/启用通道

查询通道
【说明】：用于查询采集服务中的通道。
【操作】：在输入框中输入节点名称即可查询。

新建通道
【操作】：选择并点击列表中的一个服务，点击<添加通道>按钮。后续步骤与3.2.1配置向导中创建采集通道一致，可参考上文。

删除通道
【操作】：选择需要删除的通道，点击<删除>，在弹框中点击<确定>即可。

编辑通道
【操作】：

选择需要编辑的通道，点击<编辑>即可。

由于通道名称不可修改，点击<下一步>编辑通道配置并保存即可。

克隆通道
【操作】：

选择需要编辑的通道，点击<更多>，在下拉框中选择<克隆>。

填写克隆的通道信息。
服务名称：在创建采集服务时已填写，此处无需再填；
通道名称：必填项，填写格式为：字母、数字、下划线，示例：td2copy；
填写完点击<下一步>。

填写配置信息。不同驱动版本的配置不同，根据个人需求填写即可，具体的驱动配置请查看其说明书。
填写完点击<确认克隆>即可。

挂起通道
【说明】：挂起通道表示通道暂时无法执行通信操作。
【操作】：选择需要挂起的通道，点击<挂起通道>按钮。

启用通道
【说明】：启用通道表示通道可以执行通信操作。
【操作】：选择需要启用的通道，点击<启用通道>按钮。

采集测点管理

查询测点
新建测点
删除测点
编辑测点
导入测点
导出测点
下载测点模板
清空采集测点

查询测点
【操作】：选择并点击列表中的一个通道，在输入框中输入点名或描述，点击<查询>按钮即可。

新建测点
【操作】：选择并点击列表中的一个通道，点击<新建测点>按钮即可。后续步骤与3.2.1配置向导中创建采集测点一致，可参考上文。

删除测点
【操作】：选择并点击列表中的一个通道，再选择该通道下要删除的测点，点击<删除>按钮，在弹框中点击<确定>即可。

编辑测点
【操作】：

选择并点击列表中的一个通道，再选择该通道下要编辑的测点，点击<编辑>按钮。

修改测点信息，点击<保存>即可

导入测点
【说明】：当已通过模板或导出功能获得测点文件时（xlsx），可在此处进行上传。
【操作】：点击<导入测点>，选择文件（选取相应的xlsx文件），点击<上传>按钮即可。

导出测点
【说明】：导出该服务内的所有测点，可用于测点迁移/备份。
【操作】：点击<导出测点>，即可获取测点文件（服务名.xlsx），按需编辑后上传导入至其他服务。

下载测点模板
【说明】：由于单个添加测点效率较低，DASS支持通过xlsx文件批量创建测点。
【操作】：点击<模板下载>，即可获取测点文件（服务名.xlsx），按需编辑后上传导入至其他服务。

清空采集测点
【说明】：清理该服务下所有测点信息。当希望保持服务配置且重配测点时使用。
【操作】：点击<清空测点>，在弹框提示中点击<确定>即开始删除所有测点信息。

3.2.3数据上传

【说明】：数据上传包含两个部分，分别是：上传服务和缓存镜像。

3.2.3.1上传服务

【说明】：数据上传是 DASS 软件的核心功能之一，用来配置从现场采集和上传到指定服务器或应用的数据。采集与上传代表数据的流入和流出盒子两个方向，两种服务的操作步骤基本一致。

上传服务管理
上传测点管理

上传服务管理

新建上传服务
查询上传服务
编辑上传服务
删除上传服务
下载日志
历史回补
清洗测点
启停控制
重启服务

新建上传服务
【说明】：用于新建采集服务。
【操作】：点击<数据上传>下的<上传服务>菜单，再点击新建上传服务的图标即可。后续步骤与3.2.1配置向导中创建上传服务一致，可参考上文。

查询上传服务
【说明】：用于查询上传服务。
【操作】：在搜索框内输入节点名称即可。

编辑上传服务
【说明】：用于修改服务配置。
【操作】：选择并点击列表中的一个服务，点击<更多>下拉框选择<编辑>即可修改服务配置。

删除上传服务
【说明】：删除当前上传服务及其下测点数据，不可恢复，删除服务，服务对应的节点也会删除。
【操作】：选择并点击列表中的一个服务，点击<更多>下拉框选择<删除>并二次确认点击<确定>即可。

当DASS和设备连接前，被采集设备保存了一段时间的历史数据。
由于通讯异常，导致DASS中保存的历史数据少于设备实际保存的历史数据。

上传服务中，在驱动支持的前提下，以下数据可自选时间段进行回补：

连接上传服务器前，保存在DASS中的历史数据。
由于通讯异常未成功上传的历史数据，一并发送到上传服务器。

【操作】：选择并点击列表中的一个服务，点击<更多>下拉框中的<历史回补>，选择回补的时间段，点击<确认>即可。

清空测点
【说明】：清空该服务下所有测点信息。当希望保持服务配置且重配测点时使用。
【操作】：选择并点击列表中的一个服务，点击<更多>下拉框选择<清空测点>，弹框中点击<确定>即可。

启停控制
【说明】用于控制服务启停。

启用：启用服务，与设备建立连接，正常请求测点数据。
停止：服务中止，与设备连接断开，测点无数据。

停止服务
【操作】选择列表中的服务名，点击<停止服务>，在弹框中点击<确定>即可。

启动服务
【操作】选择列表中的服务名，点击<开启服务>，在弹框中点击<确定>即可。

重启服务
【说明】：用于控制服务启停。
【操作】：选择列表中的服务名，点击<重启服务>，在弹框中点击<确定>即可。

上传测点管理

查询测点
新建测点
删除测点
编辑测点
导入测点
导出测点
下载测点模板
清空上传测点

查询测点
【操作】：选择并点击列表中的一个服务，在输入框中输入点名或描述，点击<查询>按钮即可。

新建测点
【操作】：选择并点击列表中的一个服务，点击<新建测点>按钮即可。后续步骤与3.2.1配置向导中创建上传测点一致，可参考上文。

删除测点
【操作】：选择并点击列表中的一个服务，再选择该服务下要删除的测点，点击<删除>按钮，在弹框中点击<确定>即可。

编辑测点
【操作】：

选择并点击列表中的一个服务，再选择该服务下要编辑的测点，点击<编辑>按钮。

修改测点信息，点击<保存>即可

清空采集测点
【说明】：清理该服务下所有测点信息。当希望保持服务配置且重配测点时使用。
【操作】：选择并点击列表中的一个服务，再选择该服务下要清空的测点，点击<清空测点>，在弹框提示中点击<确定>即开始删除所有测点信息。

3.2.3.2缓存镜像

【说明】：此功能提供两个麦杰实时库间的测点同步服务。通过配置镜像，可以快速将数据库 A 中指定库/节点/测点同步至数据库 B，同步信息包含静态点表信息和动态实时值。典型应用场景为 DASS 内置边缘实时库数据同步到中心数据库。

新建镜像
镜像应用
编辑镜像
删除镜像
新增节点
编辑节点
删除节点
帮助

新建镜像
【操作】：

点击【新建镜像】。

填写镜像信息。填写完，点击<检测目标实时库>，页面提示<操作成功>后，才可点击<确定>按钮。

镜像名称 ：自定义，示例：user。
目的 IP：目标数据库 IP，默认 127.0.0.1
目的端口：目标数据库端口，默认 8200
用户名：sis
密码：openplant
同步依据：分为点名同步和ID同步。

点名同步	若目标端无该PN的测点，则创建新测点（ID自动分配）。若目标端已存在该PN，则将该点覆盖。
ID同步	在目标数据库下创建和源端同ID、同点名的数据点。若目标端已存在该ID，则将该点覆盖。

返回页面即可看见，缓存镜像完成且连接状态为<已连接>。可对其进行编辑或删除。

镜像应用
【说明】：每次编辑配置后，都需点击<应用>按钮来生成镜像文件和重启openPlant。
【操作】：

点击<应用>按钮。在弹框提示中点击<确定>。

点击<数据预览>，检查镜像文件是否正确，若预览信息和镜像配置相同，则应用成功；若预览内缺少相应信息，则应用失败。此时，再次点击<应用>并检查预览。若始终无法应用成功，请联系工程师。

编辑镜像
【说明】：编辑镜像配置。
【操作】：

点击<编辑>按钮。

2.编辑内容，示例更改镜像名称，更改后点击<检测目标实时库>，待页面上方弹框提示<操作成功>后，点击<确定>，返回页面查看到信息已更新，且连接状态显示<已连接>即可。

删除镜像
【说明】：根据个人需求删除镜像。
【操作】：

点击<删除>按钮，并在弹框提示中点击<确定>。

点击<应用>按钮，并重启数据库，删除完成。

新增节点
【说明】：添加新的节点，扩大数据的规模和范围，满足用户不断增长的需求。
【操作】：

点击<新增节点>按钮。

填写配置信息。配置方式、源节点、目的节点、计算点数据来源，其中配置方式有3种，分别是：节点对节点、库对库、测点对测点；填写完，点击<保存>按钮即可。

编辑节点
【操作】：

在节点列表中，选择要编辑的节点，点击<编辑>按钮。

修改节点信息，修改完成后，点击<保存>按钮即可。

删除节点
【操作】：

在节点列表中，选择要删除的节点，点击<删除>按钮。

在删除提示框中点击<确定>即可。

3.2.4应用管理

【说明】：驱动应用是向设备发起数据请求、获取并解析报文、实现数据在通讯协议间转换的软件，不同驱动应用支持不同种类的设备通信。DASS 内包括采集驱动和上传驱动两类，统一在本模块进行增删查管理。

查询
离线导入
删除

查询
【说明】：通过应用类型、应用名称、描述筛选驱动。
应用类型：采集驱动、上传驱动、边缘应用；
应用名称、描述：关键词查询。
示例：应用类型选择上传驱动，应用名称、描述输入框内输入"mqtt"，点击<查询>，展示出 1 条符合条件的驱动。

离线导入
【说明】：为节约系统资源占用或保护驱动，出厂状态下盒子只预设部分常见驱动。更多驱动可访问应用市场获取。
【操作】：

访问应用市场查找所需驱动；
点击进入详情页选取平台。
选择一个所需版本，点击<下载>。
返回应用管理页面，点击<离线导入>、<浏览文件>选择下载的驱动文件，点击<上传>即可。

删除
【说明】：删除方式为单个删除；
【操作】：单击驱动信息最后一列的<删除>按钮，弹框提示，二次确认后，点击<确定>按钮即可。

3.2.5系统服务

【说明】：系统服务列表内展示了所有被magusdog守护的程序，用户可以在此查看所有服务的详细信息，同时部分服务提供配置修改功能。列表中的服务可以进行启停、守护控制。若缺少所需服务，可获取并上传官方服务包。

常用系统服务
服务操作说明

常用系统服务

服务名称	说明
dasserver	驱动管理和边缘终端通用管理服务（不可配置）
openplant	负责所有数据点的存储，包括DASS初始化测点、采集上传测点、计算点、
watchdog_management	硬件看门狗。负责在硬件因故停止时执行重启。
magusdog	服务看门狗。系统服务列表内的所有服务都在magusdog守护进程中，由magusdug负责在服务异常停止时进行重启。
ntp_client	负责盒子本地校时。默认使用阿里云NTP服务进行对时，若在局域网应用场景下需自行搭建NTP服务器并填写配置信息。（windows版无该服务，校时依赖windows系统自带的对时功能）
edge_controlsystem	Box控制代理。创建采集-控制服务时，需开启此服务。
gpio_management	用于管理串口工作模式切换。
monitor_edge	Dass性能检测，监测信息存储在W3.monitor节点下。
network_management	拨号网络管理系统服务。用于管理蜂窝网络拨号功能，使用4G上网时必须上传该服务并启用。
Proxy	代理服务，允许用户通过该服务对盒子进行非直接的操作。
EdgeHms	Magusbox硬件管理服务。涉及网络安全模块的编辑配置需开启该服务

服务操作说明
【说明】：对系统服务可执行的操作包括添加服务、修改配置、删除服务、服务启停、守护启停、下载日志。

启停控制
编辑服务
删除服务
下载日志
添加服务

启停控制
【说明】：用于控制服务启停。
启用：启用服务，与设备建立连接，正常请求测点数据。
停止：服务中止，与设备连接断开，测点无数据。
【操作】：点击<停止>、<启动>按钮即可。

编辑服务
【说明】：用于修改服务配置。
【操作】：点击<编辑>即可修改服务配置。

删除服务
【说明】：删除当前采集/上传服务及其下测点数据，不可恢复。
【操作】：点击<删除>并二次确认即可。

下载日志
【说明】：用于获取相应采集/上传服务的日志文件。
【操作】：

点击<下载日志>；

选取所需下载的日志文件，点击<下载>即可。

添加服务
【说明】：系统服务有两种：一种是公司内部的服务，在<应用管理>中<离线导入>即可。另一种是外部服务，在<系统服务>中添加。

添加公司内部服务：
【操作】：

在应用市场下载系统服务包
点击<应用管理>，<离线导入>中上传服务包。

上传完毕后会弹框提示重启系统服务，点击<确定>。

返回<系统服务>即可看见服务添加成功。

添加外部服务：
【操作】：

点击<创建服务>。

填写服务信息：
服务名称
**路径名：**系统服务所在位置的路径名
**描述：**对服务的说明
**版本号：**系统服务的版本号
**延时启动时间：**单位：s
填写完，点击<保存>，在服务列表中看见服务存在，则添加完成。

3.2.6边缘计算

计算点
数据一览
计算模型

3.2.5.1计算点

【说明】：openPlant®实时数据库提供标准的数据二次计算引擎，实现对测点数据的简单二次加工运算，用户可以在此处查看所有计算点的详细信息。支持的计算函数见附录《计算点说明》。

添加计算点
导出计算点
编辑计算点
查询计算点
删除计算点

添加计算点
【说明】：添加计算点支持两种方式：创建和导入。
【操作】： 创建：

点击<创建>按钮；

弹出计算点配置框，填写属性。填写后点击<保存>，查看计算点状态、最后更新值、更新时间，正常变化即可。
注： (1) 以下为计算点生效的必备属性，其余参考附录《测点属性说明表》。
(2) 点名、ID、数据类型创建后不可更改

**点名：**计算点名需保持唯一。
ID：由系统自动分配。
**数据类型：**默认模拟量(AX)。详见附录《数据类型说明》。
点的来源：CALC(1)：计算点来源，计算服务仅识别该类型测点。
计算类型：
每秒计算(1)：每秒进行计算。
变化计算(0)：表达式中所包含的参数发生变化时才进行计算。
计算公式：

计算引擎支持
常用语法符号




openPlant函数
Lua标准库和函数库
水和水蒸气函数

常用语法示例
常量
减法示例
加法示例
乘除法示例
if else语句
if elseif 语句
for语句
判断超时
当开关点W3.A.B为0时，计算点W3.A.C返回0;当开关点W3.A.B为1时，判断W3.A.A是否正在报警。如果报警，则计算点C返回1，如果不报警，计算点C返回0;
将”W3.CALC.A”点数据，取前8位写入测点 “W3.CALC.B”

批量导入：
【说明】：添加计算点支持两种方式：创建和导入。
【操作】：

点击模板下载。

填写计算点模板。如下说明常用配置项，其余可参考附录《测定属性表》。

ID：建议不填写由系统自动分配。手动配置需大于 1024 且唯一。
点名：需保持唯一。
别名：另一种名称，可根据个人需求填写。
点的类型：详见附录《数据类型说明》。
量纲(EU)：模拟量测点的工程单位，如KG。
描述：对导入计算点的描述，根据个人需求填写。
计算公式：可参考单点新建及附录。
计算类型：变化计算：表达式中所包含的参数发生变化时才进行计算。每秒计算：每秒进行计算。

点击<导入>、<浏览文件>选择要导入到的文件，最后点击<上传>按钮。显示导入结果：成功，且计算点状态、最后更新值、更新时间，正常变化即可。

导出计算点
【说明】：当前系统中的计算点以xlsx文件形式导出。
【操作】：

点击<导出>按钮。

打开导出的文件即可看见计算点详情。

编辑计算点
【说明】：计算点创建后，点名、ID、数据类型不可更改。其余属性均可修改。参考附录《测点属性说明书》。
【操作】：

选择需编辑的计算点，点击<编辑>，修改后点击<保存>即可。

查看列表，查看修改过的数值无误，则编辑成功。

查询计算点
【说明】：提供2个输入框的查询服务：ID和点名、描述。注：ID 全局唯一。不支持模糊查询，需输入准确 ID。
示例：ID输入框输入：1110，点名、描述输入框输入：J，点击查询，显示1条结果。

删除计算点
【说明】：删除自己不需要的计算点。
【操作】：选取需要删除的计算点，单击<删除>按钮，点击提示框内<确认>按钮即可删除测点。返回计算点页面，可以看见删除成功。

3.2.5.2数据一览

【说明】：用户可以在此处查看 DASS 内所有测点的详细信息。支持查询功能，可通过：节点、ID、点名或描述查询。
点名：节点内点名唯一。
ID ：ID 全局唯一。不支持模糊查询，需输入准确 ID。
描述：测点描述信息。
节点：（W3：后台历史站）
DATAPOINT：采集/上传服务的默认节点
SYS：系统节点
CALC：计算点节点
示例：在节点处选择TEST_1，点击<查询>按钮即可。

3.2.5.3计算模型

【说明】：计算模型可用于编写算法，仅支持lua脚本，系统据计算模型的执行周期、运行耗时自动分组，使算法达到最优的效果并最大限度减少资源浪费。在系统运行时，模型组之间的计算任务是并行执行的，计算模型之间的计算任务是串行执行的，且每个计算模型的运算优先级，系统按照优先级顺序依次执行各个计算模型，以确保重要计算模型优先处理，提高了系统的性能和计算效率，保证了计算模型的准确性和时效性，能够更好地满足用户的需求，提供可靠、高效的计算和优化功能。