主题
网关操作手册
快速开始
接口说明
| 编号 | 功能 | 数量 | 备注 |
|---|---|---|---|
| 1 | LED指示灯 | 9 | RUN、ALM、PWR、WIFI、4G、COM1/2/3/4指示LED |
| 2 | RS232/485 | 2 | |
| 3 | RS-485 | 2 | |
| 4 | 以太网 | 2 | 自适应 10M/100M 以太网 |
| 5 | USB 2.0 Type A | 1 | 最高支持 USB2.0 High-speed |
| 6 | 电源 | 1 | 9-28V直流电源 |
| 7 | 复位按键 | 1 | |
| 8 | WIFI天线 | 1 | 选配WIFI功能的型号会配置天线接口 |
| 9 | 4G天线 | 1 | 选配LTE功能的型号会配置天线接口 |
| 10 | SIM卡槽 | 1 | 选配LTE功能的型号会识别插入的SIM卡 |
| 12 | LORA天线 | 1 | 选配LORA功能的型号会配置天线接口 |
连接网关到电脑
网口1默认 IP 为 192.168.10.101，初始状态下可通过直连方式，将网口1连接到电脑网卡上。
同时修改电脑网卡的 IP 地址，使电脑与网关处于同一网段。
打开浏览器，输入 http://192.168.10.101/ 打开网关控制台管理界面，默认用户名：admin 默认密码：admin。
设置网关参数
登录成功后，选择左侧菜单栏中的【设置】菜单进入“设置”界面。
系统设置
系统设置的详细参数说明请参考《操作手册》。大部分情况下只需要设置“网关标识”和“物联网平台地址”。
“物联网平台地址”为用户部署的 TopStack 平台的访问地址，如 http://192.168.10.100:8000。
“网关标识”是在 TopStack 平台中添加的网关的标识，两者需要保持一致，用于 TopStack 物联网平台识别网关。
网络设置
选择【本地网络】可对网口地址进行修改，如下图所示：
软件升级
登录成功后，选择左侧菜单栏中的【设置】菜单进入“设置”界面。
切换到【升级】选项卡，上传程序更新文件进行升级。
NOTE
进行软件升级时，请在技术支持指导下进行，请勿上传其它文件。
控制台管理
打开浏览器，输入 http://192.168.10.101/ 打开网关控制台管理界面，默认用户名：admin 默认密码：admin。
IMPORTANT
实际使用时请将 192.168.10.101 替换为网关实际的 IP 地址。
数采（南向）
本章将介绍如何通过 TopLink 对接各种工业协议，实现对各类南向设备的数据采集。将通过演示 ModbusTCP 南向设备的添加和配置流程进行说明。
添加南向数采通道
在左侧导航栏中，点击【南向】菜单，进入“南向数采通道”管理界面。点击“➕”按钮添加【通道】，根据不同的通讯规约，设置相应的通道连接参数。
为方便对接入通道进行管理，可以创建通道分组。选中通道分组，可以修改其基本信息。选中通道，可以修改通道基本信息。
新建通道分组：
新建通道：
通道导入导出
为便于项目快速实施，控制台支持批量导入通道，单击右侧【导入通道】按钮，然后下载Excel模板，根据模板内容录入通道信息，完成Excel文件后再上传文件并导入：
通道禁用重启
选中通道后，对通道进行“禁用”和“重启”。
通道“禁用”后，将关闭通道并停止与设备的通讯。
通道“重启”后，将重新扫描点表，并重新与设备建立通讯。
点表
选中通道后，点击“点表”选项卡，进入该通道下的点位管理界面。
点表参数说明：
| 参数名称 | 必填 | 说明 |
|---|---|---|
| 设备标识 | 是 | 点位关联的设备 |
| 测点标识 | 是 | 点位关联的测点 |
| 仿真表达式 | 否 | 仿真模式下用于生成仿真数据 |
| 设备地址 | 否 | 设备通讯地址 |
| 点位地址 | 是 | 虚拟点表达式或点位寄存器地址 |
| 数值类型 | 是 | 点位的数值类型 |
| 存储周期 | 否 | 点位数据存储周期 |
| 扫描周期 | 否 | 采集频率 |
| 死区值 | 否 | 如果测点输出值变化量未超过死区值，则认为数据未变化 |
| 死区时间 | 否 | 当测点输出值数据保持不变时，如果超过了死区时间，侧强制更新 |
| 计算公式/取反 | 否 | 计算公式：用于浮点型或整数型测点，通过设置基值和系数，对采集值进行计算输出测点值。取反：用于布尔型测点，表示是否对采集值进行取反处理。 |
| 虚拟点位 | 否 | 是否是虚拟点位。 |
实时数据
选中通道后，点击“实时数据”选项卡，可查看该通道下采集到的的测点实时数据。可修改测点值，实现指令下发。可查看测点历史数据。
实时日志
选中通道后，点击“实时日志”选项卡，可查看当前通道的实时通讯日志、通讯报文。
仿真模式
选中通道后，可修改仿真模式选项，如果启用了“仿真模式”，通道将停止与设备进行通讯，不再采集设备数据，改为模拟生成仿真数据。
我们可以通过配置点表的【仿真表达式】来定义仿真数据的生成规则。
IMPORTANT
关于仿真模式的使用，请参考《数采实施手册》
虚拟点
在工控应用场景下，大部分数据点都是物理点位，包括开关量、模拟量等。软件提供了虚拟点位的支持，允许用户通过编写计算表达式，生成中间变量。
使用虚拟点位需要配置点位通讯参数中的两个字段：
- 将“虚拟点位”设置为“启用”状态。
- 在点位地址中输入计算表达式。
计算表达式中，所有的物理点位值都可以作为变量进行引用，变量名称为“点位标识”，所以点位标识的命名请确保使用英文字母、数字、下划线的组合。
示例：
- 基本表达式: 10 > 0
- 带变量参数: foo > 0
- 带算术运算符: (requests_made * requests_succeeded / 100) >= 90
- 字符串判断: http_response_body == "service is ok"
- 数值运算表达式: (mem_used / total_mem) * 100
IMPORTANT
关于虚拟点表达式的规则，请参考《数采实施手册》。
转发（北向）
北向接口，用于对接到云平台，实现云边协同。
在左侧导航栏中，点击【北向】菜单，进入北向接口配置界面。
MQTT
MQTT 是一种轻量级的消息传输协议，专为物联网设备和应用程序设计。它采用发布与订阅模型，允许设备和应用程序通过中间代理（Broker）进行通信。
MQTT 北向接口采用的是 TopLink-V3 协议，用户可以使用 MQTT 协议快速构建物联网应用程序，实现边缘侧和云端的快速通讯。
TopLink-V3 协议是针对物联网领域设计的一套数据交互协议规范，基于 MQTT 实现，数据格式是 JSON。用于设备端和物联网平台（TopStack）的双向通信，更便捷地实现和规范了设备端和物联网平台之间的业务数据交互。
接口配置
使用 MQTT 北向接口，需要配置连接到 MQTT Broker 的连接参数。
| 项目 | 说明 |
|---|---|
| 重连 | 重启MQTT链接 |
| 启用 | 是否开启MQTT |
| 服务器地址 | MQTT Broker服务器地址, 示例：tcp://mqtt.iotopo.com:1883，ssl://mqtt.iotopo.com:1883 |
| 用户名 | |
| 密码 | |
| 心跳间隔 | 单位秒 |
| SSL | 是否启用 SSL。 |
| CA证书 | 上传CA证书，启用 SSL 时必填。 |
| 客户端证书 | 客户端证书，启用 SSL 时必填。 |
| 客户端私钥 | 客户端私钥，启用 SSL 时必填。 |
OPC UA 服务器
TopLink 内置了 OPC UA 服务，该服务默认是关闭的，点击【启用】按钮，然后【保存】即可启动 OPC UA 服务。
WARNING
OPC UA 服务目前是实验性支持，如在生产环境下使用，请联系技术支持！
接入地址
接入地址格式如下：opc.tcp://IP:Port
如：opc.tcp://192.168.10.100:4840
认证模式
目前仅支持【匿名登录】。暂时不支持其它认证方式。
数据映射
南向接口中的所有非数组测点数据会自动映射到 OPC UA 服务的 DevicePoints 命名空间中。
WARNING
OPC UA 服务暂不支持数组类型的测点。
测点的 NodeID 格式如下：ns=1;s={deviceID}.{pointID}
示例：
| 设备标识 | 测点标识 | NodeID |
|---|---|---|
| dev1 | point1 | ns=1;s=dev1.point1 |
| dev1 | point2 | ns=1;s=dev1.point2 |
| dev2 | point1 | ns=1;s=dev2.point1 |
| dev2 | point2 | ns=1;s=dev2.point2 |
测点类型映射关系如下：
| 测点类型 | OPC UA 类型 |
|---|---|
| 整数型 | Int64 |
| 布尔型 | Boolean |
| 浮点型 | Double |
| 文本型 | String |