2.快速入门

2.1软件安装与连接

2.1.1软件安装

Windows(x64)版 1、双击DASS windows(x64)安装包，选择D盘下安装路径，点击NEXT。

2、勾选设置项，点击NEXT。（默认均勾选即可）

• PowerBoot：开机自启动
• Creat a desktop shortcut：创建桌面快捷方式

3、弹出dasserver安装程序框，点击Install。

4、安装读条完后，弹出提示框以在本机安装dasserver程序已完成，点击Finish退出安装向导

5、将DASSERVER目录下的opapi.dll文件复制到C:/Windows/sysm32下

6、点击桌面图标启动DASS即可。

Linux版 1、获取安装工具installer和linux版安装包。 2、将工具installer解压。

3、将installer和linux安装包放在一个文件夹里，然后通过U盘方式拷进linux系统里。目录由用户自行确定，示例为导入/home/magus。

4、通过linux命令来执行dasserver安装 （1）给installer授予权限：chmod +x installer （2）在使用安装工具，后面添加参数，最后写上安装包： ./installer -pn dasserver2.1.0.20200515_4200.linux.tar.gz （3）输入以上命令后，程序自行安装。出现如下DASS字样则成功安装。

5、启动dasserver （1）进入dasserver程序包： cd /home/magus/dasserver （2）在dasserver下后加 ./dasserver 来启动dasserver

6、首次安装完成后，重启系统。

2.1.2连接登录

1、通电使设备正常工作，用网线连接PC和盒子LAN1（或LAN2）网口。 2、修改PC的IP使之与盒子处于同一网段。（不可与盒子网口IP重复） （1）打开网络控制面板，打开新增的以太网属性页面。

（2）打开“Internet协议版本4（TCP/IPv4）”的属性页面。
（3)点击“使用下面的IP地址”，根据所连LAN口设置IP。

3、访问地址：192.168.100.169:8085，进入DASS登陆页面。输入用户名密码登陆即可。(用户名admin密码sis)

2.1.3卸载程序

【说明】：卸载程序会关闭所有dasserver相关进程，并删除dasserver目录。 【操作】：使用-unload命令卸载dasserver目录下文件。示例：./unLoad_dass -unload。出现UNLOADOK字样则为卸载成功。

2.2接入物联网云平台

【说明】将DASS绑定到物联网云平台，使用户可以在云平台中创建采集服务和测点。物联网云平台的部署详情请查看其使用手册。

2.2.1 接入的软件配置

软件名称	版本
系统服务 edge_mqtt_hub	2.0.2
上传服务 OP2_MQTT_MagusIot	1.0.0
云平台终端协同 terminalCenter	3.4.0
DASS	2.5.5

2.2.2 绑定

1、获取Cloud Key

• 在云平台mqtt鉴权中找到未被使用的设备码，复制其所对应的Cloud Key。示例：复制的Cloud Key是default_43的内网ssl。

2、编辑DASS云边协同

• 将获取到的Cloud Key粘贴到云边协同的Cloud Key栏中，点击测试，显示绑定的设备码即可。

3.绑定

• 在云平台的终端管理中新建终端，选择终端的下拉框显示出需绑定的设备码。填写终端名、分组、描述，点击确定即可。

2.3案例-Modbus

2.3.1 Modbus采集服务

• 了解采集服务
• 了解Modbus协议
• 搭建Modbus Slave实验环境
• 创建Modbus TCP采集服务
• Modbus地址说明

了解采集服务 采集服务是DASS的主要功能之一，主要用于完成各种现场设备实时数据的对接。通过在DASS内进行采集服务配置，实现盒子与设备间通信，并将采集数据存储至openPlant。
了解Modbus协议
简介： Modbus是一种串行通信协议，是Modicon公司（现在的施耐德电气 Schneider Electric）于1979年为使用可编程逻辑控制器（PLC）通信而发表。Modbus已经成为工业领域通信协议的业界标准（De facto），并且现在是工业电子设备之间常用的连接方式。 Modbus允许约240设备连接在同一个网络上进行通信，举个例子，一个由测量温度和湿度的装置，并且将结果发送给计算机。在数据采集与监视控制系统（SCADA）中，Modbus通常用来连接监控计算机和远程终端控制系统（RTU）。
协议版本： Modbus协议目前存在用于串口、以太网以及其他支持互联网协议的网络的版本。大多数Modbus设备通信通过串口EIA-485物理层进行。 Modbus协议原型有不同的实现方式。对于串行连接，存在两个变种：Modbus ASCII和Modbus RTU。它们在数值数据表示、协议细节上略有不同。Modbus RTU是一种紧凑的，采用二进制表示数据的方式，Modbus ASCII是一种人类可读的，冗长的表示方式。RTU格式后续的命令/数据带有循环冗余校验的校验和，而ASCII格式采用纵向冗余校验的校验和。被配置为不同变种的节点间不可通信。对于通过TCP/IP连接，存在多个Modbus/TCP变种。这种方式不需要校验和计算。这三种通信协议，在数据模型、功能调用是相同的，只有封装方式不同。 Modbus有一个扩展版本Modbus Plus（Modbus+或者MB+），不过此协议是Modicon专有的，和Modbus不同。它需要一个专门的协处理器来处理类似HDLC的高速令牌旋转。它使用1Mbit/s的双绞线，并且每个节点都有转换隔离装置，是一种采用转换/边缘触发而不是电压/水平触发的装置。连接Modbus Plus到计算机需要特别的接口，通常是支持ISA（SA85），PCI或者PMCIA总线的板卡。
架构和通信： Modbus协议是一个master/slave架构（主从架构）的协议。一个节点为master节点（主站），其他使用Modbus协议参与通信的节点是slave节点（从站）。每一个slave设备有唯一的地址。在串行和MB+网络中，只有被指定为主节点的节点可以启动一个命令（在以太网上，任何一个设备都能发送一个Modbus命令，但是通常也只有一个主节点设备启动指令）。 一个ModBus命令包含了打算执行的设备的Modbus地址。所有设备都会收到命令，但只有指定位置的设备会执行及回应指令（地址0例外，指定地址0的指令是广播指令，所有收到指令的设备都会运行，不过不回应指令）。所有的Modbus命令包含了检查码，以确定到达的命令没有被破坏。基本的ModBus命令能指令一个RTU改变它的寄存器的某个值，控制或者读取一个I/O端口，以及指挥设备回送一个或者多个其寄存器中的数据。
搭建Modbus Slave实验环境 1、在本地电脑配置一个Modbus Slave服务。打开Modbus Slave，点击Connection：Connect创建一个新的连接。 2、进行通讯设置。 Connection选择Modbus TCP/IP，其它参数保持默认。点击OK创建。

• IP Address：本机IP地址，
• Port：Modbus Tcp默认端口502

3、返回Modbus Slave界面，无No connection显示，Modbus TCP创建成功。

4、从站创建成功后，双击地址弹出Edit Register设置框。设置完成后即可进入DASS创建采集服务。

• 可在Value框中直接输入所需数值
• 可勾选Auto increment进行自动数值模拟。

创建Modbus TCP采集服务
1、访问DASS页面，点击菜单栏第二项：数据采集，右击【采集服务】，点击创建服务。

2、填写采集服务基本信息

• 服务名称：服务名唯一。示例：modbus_test；
• 服务类型：选择创建服务类型，包括采集服务、上传服务2种。示例：采集服务；
• 选择驱动：选择服务所用的驱动，示例：GB_Modbus_Poll_TCP；
• 驱动信息：包括了驱动名称、驱动版本、发布时间和相关的驱动描述。
• 描述信息：可添加自定义服务描述（不能为空）。

3、填写服务基本通信配置

• Modbus 从站地址：从站IP:端口。示例：192.168.100.100:502；
• Modbus 数据的读取间隔：全点表的一次读取称为一次轮询，此间隔指每次轮询的间隔，单位为ms。示例：1000ms即1s。
• Modbus 开关量请求个数填充到 8 的倍数：有些现场设备请求的开关量个数要求必须为 8 的倍数，此选项根据现场情况设置，默认false；
• Modbus 模拟量每次请求的最大个数：一条请求所允许的最大寄存器个数，默认120；
• Modbus 开关量每次请求的最大个数：默认值为600，详情请参考Modbus说明书；
• Modbus 模拟量是否开启上下限运算：影响驱动解析的测点实时值范围。若开启则驱动解析时测点上下限（PH\PL)生效，若关闭则解析对数值范围无要求。默认false。

4、填写服务高级配置

• 测点添加模式：true-可新建测点；false-测点不可新建，仅支持导入。
• 程序日志级别：Info-基本信息打印，Debug-调试。默认info；
• 是否开启服务器控制功能：需搭配控制代理服务 使用，默认为false；
• 下发控制命令的服务器：控制代理所在的服务器 IP 地址:端口；
• 下发控制命令的服务器用户名：控制代理的用户名，默认即可；
• 下发控制命令的服务器密码：控制代理的密码，默认即可；
• 控制的节点名：需要控制的测点在中心端数据库所处的节点名；
• 提供 WEB 服务的地址：不同服务类型分配的端口号在不同的指定范围内，采集服务端口范围为5000_{7500；上传服务端口范围为7500}10000；

5、检查配置信息：基本通信配置、高级配置，确认无误后点击创建。

6、点击【新建测点】，完成测点属性设置。

• 点名（PN）：测点名称，节点下唯一。支持字母、数字、特殊字符#😡-_。示例：P-1。
• ID：系统自动分配，无需填写
• 数据类型（RT）：数据存储到openplant的类型
• 地址信息（AD）：格式见Modbus地址说明。示例：1.3.0
• 采集点类型（SR）：采集驱动解析使用的数据类型

7、完成测点添加。点击完成，一个完整的采集服务创建完成。

• 最后更新时间：毫秒时间戳，用于标识在具体时间发生的特定事件，能够表示一份数据在一个特定时间点已经存在的完整的可验证的数据。

8、检查采集服务运行和测点数值。 （1）检查服务运行正常，需满足以下条件：

• 采集服务下存在modbus_test服务，且状态为running，表示驱动正常工作；

   连接状态：实时库已连接，表示openPlant可正常读写； ​       测点状态：Good，且实时值和最后更新时间正常更新； ​       设备连接状态：未连接。连接状态显示的是采集设备与盒子的连接状态，有两种状态：已连接或未连接。
  

（2）验证测点实时值。比对Modbus Slave的模拟数据和DASS的最新值，一致即可。

Modbus地址说明

格式	示例
设备号.功能码.地址	1.3.0

功能码
十进制
01
02
03
04
05
06
15
16
22

功能码

Modbus寻址

地址类型	范围	数据类型	测点属性	功能代码
输出线圈	0.0 ~ 0.65535	bool	读/写	01、05、15
输入线圈	1.0 ~ 1.65535	bool	只读	02
内部寄存器	3.0 ~ 3.365535 3.0 ~ 3.365534 3.0 ~ 3.365532	INT8 FOLAT、INT16 LONG、DOUBLE	只读	04 04 04
保持寄存器	4.0 ~ 4.365535 4.0 ~ 4.365534 4.0 ~ 4.365532	INT8 FOLAT、INT16 LONG、DOUBLE	读/写	03、06、16 03、06、16 03、06、16

2.3.2 Modbus上传服务

• 了解上传服务
• 搭建Modbus Poll实验环境
• 创建Modbus TCP上传服务

了解上传服务
上传服务是DASS的主要功能之一，用于提供北向的数据服务和协议转换服务。设备实时数据由采集服务采集后，会在openPlant内保存一定时间（根据盒子型号不同）。通过在DASS内进行上传服务配置，将测点信息上传至中心数据库/其他客户端数据库。
搭建Modbus Poll实验环境
1、打开Modbus Poll，此时未No connection状态。点击Connectino：Connect，创建一个新的连接。

2、进行通讯设置。

• Connection：Modbus TCP/IP
• IP Address：192.168.100.169（盒子IP地址）
• Port为Modbus Tcp默认端口502
• 其它参数保持默认。点击OK创建。

创建Modbus上传服务 1、访问DASS页面，访问菜单栏第二项：数据采集，右击【上传服务】，点击创建服务。

2、填写上传服务基本信息：

• 服务名称：服务名唯一。示例：test；
• 服务类型：选择创建服务类型，包括采集服务、上传服务2种。示例：上传服务；
• 选择驱动：选择服务所用的驱动，示例：OP2_Modbus_Slave_TCP；
• 描述信息：可添加自定义服务描述（不能为空）。
  

3、填写上传服务基本通信配置：

• 采集间隔：数据本地读取间隔，默认1000毫秒。
• Modbus 服务地址：驱动监听端口，默认为502；
• Modbus 设备地址：该驱动从站站号，默认为 1；
• 是否开启服务器控制功能： 默认为false；
• 控制类型：默认为1；
  

4、高级配置：

• 测点添加模式：默认值为true。
• 程序日志级别：默认值为Info。
• 提供WEB服务的地址：不同服务类型分配的端口号在不同的指定范围内，采集服务端口范围为5000_{7500；上传服务端口范围为7500}10000。
  

5、检查所有配置信息，确认后点击下一步。

6、添加测点。上传的添加测点即选择DASS内已存在的测点，传输至指定数据库/系统。

7、选择节点和数据类型

• 选择节点：采集服务测点默认创建在W3.DATAPOINT下，如新建采集服务时新建了自定义节点，选择相应即可。
• 数据类型：勾选测点存储类型进行筛选
  

8、勾选符合条件的测点，点击右侧箭头，添加至已选列表

9、确认列表并导入。

• 若有误选测点，勾选后单击删除按钮，选中项退回至备选列表；
  
• 若列表无误，点击确定，已选列表内所有测点将添加至上传服务。

10、上传服务按照测点的ID提供相应的地址（AD）排序。用户如果需自定义地址顺序，可修改测点的地址信息，以TCP27_P14为例，示例修改为1.3.0，点击确认完成修改。

11、完成测点添加。点击完成，一个完整的上传服务创建完成。

• 最后更新时间：毫秒时间戳，用于标识在具体时间发生的特定事件，能够表示一份数据在一个特定时间点已经存在的完整的可验证的数据。
  

12、检查上传服务运行状况和测点数值。 （1）检查服务运行正常，需满足以下条件：

• 上传服务下存在test服务，且状态为running，表示驱动正常工作；
• 连接状态：实时库已连接，表示openPlant可正常读写；
• 测点状态：Good，且实时值和最后更新时间正常更新；
  

（2）验证测点实时值正确。比对Modbus Poll数据和DASS的最新值，一致即可。

2.3.3 Modbus反控服务

• 了解控制服务
• 搭建Modbus Slave控制实验环境
• 创建Modbus TCP采集控制服务
• 反控操作

了解控制服务
控制服务主要用于实现对现场设备的简单控制。通过在DASS内进行服务配置，实现盒子与设备间通信，通过修改测点测点属性值实现对设备的控制。
搭建Modbus Slave控制实验环境
1、在本地电脑配置一个Modbus Slave服务。打开Modbus Slave，点击Connection：Connect创建一个新的连接。

2、进行通讯设置。

• Connection：Modbus TCP/IP，其它参数保持默认。点击OK创建。
• IP Address:本机IP地址，
• Port:Modbus Tcp默认端口502
  

3、返回Modbus Slave界面，无No connection显示，Modbus TCP创建成功。

4、从站创建成功后，双击地址弹出Edit Register设置框.

• 可在Value框中输入指定数值
• 可勾选Auto increment进行自动数值模拟。
  

创建Modbus TCP控制服务
1、访问DASS页面，访问菜单栏第二项：数据采集，右击【采集服务】，点击创建服务。

2、填写采集服务基本信息：

• 服务名称：服务名唯一。示例：mb_contr；
• 服务类型：选择创建服务类型，包括采集服务、上传服务2种。示例：采集服务；
• 选择驱动：选择服务所用的驱动，示例：GB_Modbus_Poll_TCP；
• 描述信息：可添加自定义服务描述（不能为空）。
  

3、填写服务基本通信配置

• Modbus 从站地址：从站IP:端口。示例：192.168.100.100:502；
• Modbus 数据的读取间隔：全点表的一次读取称为一次轮询，此间隔指每次轮询的间隔，单位为ms。示例：1000ms即1s。
• Modbus 开关量请求个数填充到 8 的倍数：有些现场设备请求的开关量个数要求必须为 8 的倍数，此选项根据现场情况设置，默认false；
• Modbus 模拟量每次请求的最大个数：一条请求所允许的最大寄存器个数，默认120；
• Modbus 开关量每次请求的最大个数：默认值为600，详情请参考Modbus说明书；
• Modbus 模拟量是否开启上下限运算：影响驱动解析的测点实时值范围。若开启则驱动解析时测点上下限（PH\PL）生效，若关闭则解析对数值范围无要求。默认false。
  

4、填写服务高级配置

• 测点添加模式：true-可新建测点；false-测点不可新建，仅支持导入。
• 程序日志级别：Info-基本信息打印，Debug-调试。默认info；
• 是否开启服务器控制功能：需搭配控制代理服务 使用，默认为false；此处反控需要设为true
• 下发控制命令的服务器：控制代理所在的服务器 IP 地址:端口；
• 下发控制命令的服务器用户名：控制代理的用户名，默认即可；
• 下发控制命令的服务器密码：控制代理的密码，默认即可；
• 控制的节点名：需要控制的测点在中心端数据库所处的节点名；
• 提供 WEB 服务的地址：不同服务类型分配的端口号在不同的指定范围内，采集服务端口范围为5000_{7500；上传服务端口范围为7500}10000；
• 提供 GRPC 服务的地址：默认空白即可；
  

5、检查配置信息：基本通信配置、高级配置，确认无误后点击创建。

6、点击【新建测点】，完成测点属性设置。
点名（PN）：测点名称，节点下唯一。支持字母、数字、特殊字符#😡-_。示例：CESHI-1

• ID ：系统自动分配，无需填写
• 数据类型（RT）：数据存储到openplant的类型
• 地址信息（AD）：格式见Modbus地址说明。示例：1.3.0
• 采集点类型（SR）：采集驱动解析使用的数据类型
• 测点属性：默认为读，此时反控需要设置为读/写
  
  

7、完成测点添加。点击完成，一个完整的采集服务创建完成。

8、检查采集服务运行和测点数值。 （1）检查服务运行正常，需满足以下条件：

• 采集服务下存在mb_contr服务，且状态为running，表示驱动正常工作；
• 连接状态：实时库已连接，表示openPlant可正常读写；
• 测点状态：Good，且实时值和最后更新时间正常更新；
• 设备连接状态：已连接。连接状态显示的是采集设备与盒子的连接状态，有两种状态：已连接或未连接。
  

（2）验证测点实时值。比对ModbusSlave模拟数据和DASS的最新值，一致即可。

反控操作
1、使用cmd移动到controldemo.exe程序目录下

2、执行命令
示例：controldemo.exe -ip 192.168.100.169 -gn W3.DATAPOINT.CESHI1 -av 0 （ip:访问设备的ip；gn:修改测点的全点名；av:修改的值）提示控制成功即可。

3、查看DASS测点数据以及Modbus Slave数据，测点和Modbus Slave数据均已修改，控制生效

2.3.4 OPC-UA系统服务

1、打开UAExpert，点击加号AddServer。

2、填写配置名Cofiguration Name，如Test。点击Advanced选项卡，修改Endpoint Url的地址为//192.168.100.169:4840（根据实际情况而定，默认端口号为4840），点击OK。

3、右击创建的Cofiguration Name（如Test），点击Connect进行连接，左下展示数据库选项。


4、返回DASS页面，创建名为Simulate的采集服务并新建1个测点。


5、在系统服务页面（即上传服务包的页面）重启OPC-UA Server系统服务，否则UAExpert无法同步。

6、比对采集服务的测点和UAExpert的数据，一致即说明OPC-UA Server服务已正常启动。