开始使用 ↵
云端配置 ↵
项目管理¶
登录账号，在左侧点击[项目组态]，然后点击[项目管理]，然后点击[新增]按钮，新建一个项目。
新增项目¶
展开查看视频
填写项目名称，输入地理位置信息，点击[确定]，即可新建一个项目。
2.添加网关¶
打开网关列表页面¶
点击项目组态，然后点击网关列表，点击新增按钮。
新增¶
展开查看视频
所属项目选择刚刚新建的项目，然后填写网关编号和网关密码，网关编号和网关密码可以在网关周身贴的标签上查询到，SN即网关编号，PWD即网关密码，点击确定即可添加。
查询¶
查询基本信息¶
点击查询按钮，可以查看添加的网关记录。如下图：
提示
本页面是静态页面，如需实时刷新，请勾页面选右上角定时刷新选项。
-
有线上网
-
拨号上网
-
ICCID
-
拨号状态
点击信号值图标可以在弹出窗口查看拨号状态。
查询上线日志¶
点击运行监控，然后点击网关上线日志，可以查看已经添加过的网关的历史心跳记录；
并非每一条记录都会有完整的信息，这是正常的。
删除¶
勾选网关，点击删除按钮，即可删除这条网关记录；
仅仅删除记录，不会删除相应的网关配置、工程组态等信息。如下图：
详细说明¶
| 属性名 | 说明 |
|---|---|
| 网关编号 | 即网关的唯一编号SN |
| 网关密码 | 网关出厂自带的随机字符，点击网页上表头网关密码右侧的蓝色小锁即可查看网关密码 |
| 最后更新时间 | 网关最后一次和服务器交互的时间，通常3-6分钟更新一次，字体颜色变红说明网关离线 |
| 信号值 | 网关当前的4G网络信号值，20~30为良好，小于20为较差，小于10为极差；显示有线上网则说明通过网口连接网线的方式上网 |
| 网关备注 | 可以由用户自定义设置，长度16个汉字以内 |
| 所属项目 | 该网关所关联的项目 |
| 网关型号 | 指示该网关的硬件型号 |
| 网关硬件版本 | 指示该网关的硬件版本 |
| 网关软件版本 | 指示该网关的软件版本，也叫固件版本，可以自行选择发布的版本进行升级 |
| 已用变量点 | 指示当前网关配置了多少个测点 |
| ICCID | 网关内用于上网的SIM卡的ICCID |
| 创建时间 | 添加这个网关的时间 |
| 创建者 | 指示是哪个角色添加的这个网关 |
| 配置 | 对网关自身的一些属性进行配置，例如网关备注、IP地址等 |
| 组态 | 对网关的工程进行配置，通道、设备、测点等 |
| 调试 | 对网关进行串口调试或命令行调试 |
3.配置网关¶
配置¶
点击该条网关记录最右侧的配置按钮，即可配置该网关。
项目配置¶
此处可以修改网关绑定的项目，如下图：
基本配置¶
展开查看视频
此处可以查看网关的基本信息，也可以修改网关备注，我们把网关备注改为“版本测试”，然后点击设置即可修改，修改立即生效。
提示
将鼠标移到在线时长右侧···处，可以查看最近的重启时间以及重启原因。
网关时间¶
不可以直接配置网关时间，网关时间是自动同步的，只要网关时区配置正确，服务器会自动下发校时，校正网关时间，修改网关时区后需要重启网关；
也可以开启NTP自动对时，打开对时状态开关，配置对时周期以及对时服务器地址，即可使NTP对时生效；
通常无需开启此功能，服务器自带校时；如下图：
网络配置¶
展开查看视频
下图上半部分是对网关的IP地址、子网掩码等参数的配置，点击下半部分的[展开/收起]按钮，可以配置网关的路由，添加完毕后，需要点击设置按钮才会下发到网关，配置立即生效；
警告
多网口设备，不同网卡的IP不能配置为相同网段，否则会导致无法联网或者网络通讯异常！
例如NET1配置为192.168.1.100，NET2配置为192.168.1.200，这样是不允许的。
注意
网关上网优先级为 有线网络 > 4G拨号；
一次只能修改一个网卡的信息，修改完毕点击设置，即可下发到网关，立即生效；
如果修改完不点设置，那么切换网卡时，会丢失之前设置的内容。
| 属性名 | 说明 |
|---|---|
| 网卡 | NET1表示网关的第一个网卡，NET2表示第二个，以此类推 |
| 是否启用 | 默认启用；如果选择否，那么网关的该网口将用作DHCP服务器，以对外向其它设备提供网络 |
| IP获取方式 | 选择静态IP(推荐)，那么需要手动配置IP；选择DHCP(不推荐)，那么由路由器(或其它DHCP服务器)分配IP地址 |
| 默认网关 | 如果网关通过这个网卡上网，那么需要填写默认网关 |
| 是否设为默认路由 | 如果网关通过SIM卡4G上网，那么选择否；如果网关通过这个网卡上网，那么选择是；默认路由只能有一个，如果设置了多个，那么网卡NET索引较小的优先生效；如果修改了此项，会导致网关断线重连，约10秒 |
| IP地址 | 该网卡的IP地址，最多可以添加10个不同的IP地址 |
| 子网掩码 | 该网卡的子网掩码，填写完IP地址后自动填充 |
| 路由 | 为了兼容旧的软件版本的网关而保留的，此处留空不填即可，添加路由详见下方参数 |
| 目标 | 哪些范围的IP地址匹配本条路由，例如：192.168.100.0/24 |
| 下一跳 | 路由的下一个点，例如：192.168.0.1，意为192.168.100.xxx网段的数据从192.168.0.1走 |
代理配置¶
暂不开放配置。
无线配置¶
此处可以配置网络接入点(即APN)、用户名、密码等参数，用于拨号上网到专网或内网，
PING1、PING2、PING3等参数用于拨号成功后测试网络是否正常，网络类型可以手动指定运营商。
| 网络类型 | 说明 |
|---|---|
| auto | 建议选择此项，自动适配 |
| cdma | 中国电信2G |
| edge | 联通2G |
| wcdma | 联通3G |
| td-scdma | 移动3G |
| evdo | 电信3G |
| lte | 4G |
VPN配置¶
默认不支持此功能。
数据拷贝¶
展开查看视频
举例：有两个网关A和B的工程几乎完全相同，当完成A网关的工程后，可以使用数据拷贝功能，将A网关的所有数据拷贝的B网关上，如下图：
定时任务¶
可以配置任务进行定期执行、周期重复执行等，例如reboot操作，如下图：
警告
如果您不知道您在做什么，请勿设置该内容。
升级软件¶
展开查看视频
可以进行网关软件版本(也叫固件版本)的升级，升级完毕重启生效；
拨号上网时升级注意流量消耗(升级包大小约10MB)，即使是旧版本通常也无需升级，升级前建议查看完整更新日志或咨询管理员，如下图：
提示
固件允许降级，降级前请咨询管理员。
备份与恢复¶
可以把云端(指服务器)工程备份到本地(指您的电脑)，会得到一个压缩包(默认文件名为prj_xxxxxx.tar.gz)的下载链接；
也可以从本地恢复工程到云端，选择工程压缩包(通常文件名为ioserver_prj.tar.gz)上传。
提示
若部分浏览器出现无法下载的情况，请联系管理员。
休眠配置¶
在对设备的功耗有要求的情况下，可以开启休眠配置，使设备定时的进入休眠状态，达到休眠时长后，进入唤醒状态，达到唤醒时长后，再次进入休眠状态，如此循环；
休眠状态下设备功耗降低约30%~50%，休眠状态下设备无法进行任何操作，包括采集与转发等所有功能也全部暂停。
提示
仅少部分硬件设备支持此功能，本命令重启网关后生效。
警告
休眠时长设置范围 1分钟≤时长≤60分钟，不要设置的过大，会导致需要等待网关可操作的空窗期过久。
| 属性名 | 说明 |
|---|---|
| 是否启用 | 若为启用，则会根据配置定时的进入休眠状态 |
| 休眠模式 | 严格模式：总是按照配置严格进入休眠状态；共享模式：允许暂缓进入休眠状态，其它进程可以延长唤醒时长 |
| 休眠时长 | 处于休眠状态时，网关无法进行任何操作；建议配置≥3分钟 |
| 唤醒时长 | 处于唤醒状态时，网关可以进行正常工作；建议配置≥2分钟 |
4.配置网关的工程¶
组态¶
点击右侧的组态按钮，进入网关的工程配置界面。
网关的工程分为四个部分，采集服务、转发服务、中间测点、数据运算。
采集服务：用于采集其它智能设备的数据；
转发服务：用于将采集到的数据，通过其它协议，转发给第三方；
中间测点：用来存放一些靠lua脚本计算的测点；
数据运算：通过lua脚本，来对数据进行二次计算；
采集服务¶
新增采集通道¶
点击采集服务=>通道管理，点击新增按钮，新增一个采集通道，如下图：
| 属性名 | 说明 |
|---|---|
| 通道名称 | 可自定义，例如"COM1"，同一个网关下，通道名称不可重复，长度＜64，一个中文算3个长度 |
| 通道描述 | 可自定义，可空，长度＜64，一个中文算3个长度 |
| 通道地址 | 默认不动即可，通常无需修改 |
| 通道类型 | 指示该通道的类型是采集通道还是转发通道，不可修改 |
| 交互频率 | 指示网关采集智能设备的频率(网关会在一个交互频率时间内尽可能的采集完所有设备)，或网关上传数据到云端服务器的频率，单位毫秒 |
| 每帧间隔 | 指示网关和智能设备交互时，每两帧报文之间的等待时间，单位毫秒，通常保持默认即可 |
| 协议名称 | 指示这个通道所使用的协议 |
| 协议类型 | 指示该协议要基于串口通讯还是基于TCP/IP通讯(并非所有的协议都支持切换) |
根据所选的协议类型的不同，通道参数配置有两种，串口和TCP/IP，
串口的参数如下图：
| 属性名 | 说明 |
|---|---|
| 串口名称 | 选择COM1则对应A1、B1，以此类推 |
| 波特率 | 串口波特率 |
| 数据位 | 串口数据位 |
| 停止位 | 串口停止位 |
| 校验位 | 串口校验位 |
| 超时 | 串口超时时间，单位毫秒 |
| 保留0 | 留空 |
| 保留1 | 留空 |
TCP/IP的参数如下图：
| 属性名 | 说明 |
|---|---|
| 通讯方向 | 主动连接作为客户端Client发起，等待接入作为Server监听端口，不知道如何选择时，保持默认即可 |
| IP/域名 | 填写IP地址或域名均可 |
| 端口号 | 连接的目标端口号 |
| 超时 | 通讯超时，单位毫秒 |
| 保留0 | 留空 |
| 保留1 | 留空 |
| 保留2 | 留空 |
| 保留3 | 留空 |
规约特征配置¶
点击协议名称左侧的小齿轮，或者勾选通道，点击上方的规约特征配置，可以打开相应的规约特征配置，不同的规约，其特征均不同，规约特征与通道、协议(即规约)相关联。
新增采集设备¶
点击刚刚新建的通道右侧的子设备管理，如下图：
然后点击新增，新增一个设备，如下图：
提示
可以将配置好的点表导出为excel，在版本管理=>模板列表页面上传为模板，那么在新建设备时，即可勾选是否选择模板，然后选择已经配置过的点表作为模板。
| 属性名 | 说明 |
|---|---|
| 设备名称 | 可自定义，例如“设备1”，同一个网关下，设备名称不可重复，长度＜64，一个中文算3个长度 |
| 通讯地址 | 子设备的地址，长度＜64，一个中文算3个长度 |
| 公共地址 | 通常用不到，保持默认即可，长度＜64，一个中文算3个长度 |
| 兼容平台 | 通常用不到，保持默认即可 |
| 设备类型 | 通常用不到，保持默认即可 |
| 保留0 | 留空 |
| 保留1 | 留空 |
| 是否选择模板 | 打钩则启用模板的选择 |
| 选择模板 | 你可以选择系统模板，也可以上传自己的模板供选择 |
| 设备描述 | 可自定义，长度＜64，一个中文算3个长度 |
新增采集测点¶
点击刚刚新建的设备右侧的采集测点管理，然后点击新增，新增一个测点，如下图：
提示
每个采集测点都可以选择设备"通讯中断"功能码，用于指示该测点所在设备的数据采集状态，当该测点的系数为1(默认)时，其值=1意为当前通讯处于中断状态；当该测点的系数为0时，其值=1意为当前通讯处于正常状态。
基本属性¶
| 属性名 | 说明 |
|---|---|
| 子设备名称 | 指示这个测点将被添加到哪个设备下，通常保持默认即可 |
| 测点名称 | 可自定义，例如“测点0”，同一个网关下，采集测点的名称不可重复，转发测点的测点名称允许重复，长度＜64，一个中文算3个长度 |
| 物模型标识(测点描述) | 它是测点描述，在某些转发协议中，它也是物模型标识，长度＜64，一个中文算3个长度 |
| 测点类型 | 根据实际情况来选择模拟量(遥测量)和开关量(遥信量) |
| 读写属性 | 略 |
| 系数 | 测点显示出来的值 = 测点实际采集到的值 x 系数 + 偏移 |
| 偏移 | 测点显示出来的值 = 测点实际采集到的值 x 系数 + 偏移 |
| 功能码1 | 根据实际情况选择，详见驱动帮助 |
| 采集分组 | 在相同功能码的情况下，可设置采集分组进行手动组帧下发通讯报文，分组相同的测点会打包一起放在同一帧中进行数据采集通讯，通常无需配置，默认自动分组 |
| 地址 | 寄存器地址，也叫对象地址，根据实际情况填写，长度<88，一个中文算3个长度 |
| 数据类型 | 根据实际情况选择 |
| 数据格式 | 当某些通讯协议需要高低寄存器或字交换时需要用到，详见下表高低位顺序说明 |
| 是否上传 | 保持默认即可，会在某些转发协议中加载 |
| PV上传标识 | 只有选择了兼容平台才会出现，保持默认即可，会在某些转发协议中加载 |
| 公式计算 | 指示该测点进行系数和偏移计算时的运算顺序 |
| 限值使能 | 选择开，则开启限制最大最小值功能 |
| 限值最小值 | 当该变量值＜限值最小值，那么它的质量戳会变为坏，且保持上一次的值不变 |
| 限值最大值 | 当该变量值＞限值最大值，那么它的质量戳会变为坏，且保持上一次的值不变 |
高低位顺序说明：
| 属性值 | 说明 |
|---|---|
| 12 | 表示2个字节的寄存器高字节在前低字节在后 |
| 21 | 表示2个字节的寄存器低字节在前高字节在后 |
| 1234 | 表示2个字的寄存器，高字在前低字在后，字内高字节在前低字节在后 |
| 2143 | 表示2个字的寄存器，高字在前低字在后，字内低字节在前高字节在后 |
| 3412 | 表示2个字的寄存器，低字在前高字在后，字内高字节在前低字节在后 |
| 4321 | 表示2个字的寄存器，低字在前高字在后，字内低字节在前高字节在后 |
报警属性¶
报警属性根据所选则的测点类型的不同而不同，通常我们无需关注此部分内容，只有部分转发协议会用到，且都会在相应的驱动帮助里说明。
提示
本平台不存储报警数据。
以下是模拟量报警的参数：
以下是开关量报警的参数：
| 属性值 | 说明 |
|---|---|
| 开启报警记录 | 报警记录的总开关，不打开总开关，报警是不生效的 |
| 报警级别 | 根据实际情况选择，用不到的保持默认即可 |
| 报警限值 | 当测点实际值向上或向下突破了限值时，会触发报警 |
| 报警消息 | 当触发报警时，所要显示的消息内容 |
| 报警死区 | 减少反复报警的干扰，避免测点值在报警限值附近波动时反复触发报警 |
| 触发类型 | 开报警0->1报警，关报警1->0报警，变位报警1<->0报警 |
历史属性¶
通常我们无需关注此部分内容，只有部分转发协议会用到，且都会在相应的驱动帮助里说明。
提示
本平台不存储历史数据。
| 属性值 | 说明 |
|---|---|
| 启用历史存储 | 历史存储的总开关 |
| 存储方式 | 目前仅支持周期存储，自动压缩数据(不变不存) |
| 存储间隔 | 单位：秒 |
高级设置¶
| 属性值 | 说明 |
|---|---|
| 初始值 | 网关尚未开始和子设备通讯的时候，测点的初始值(不支持中文) |
| 辅助参数 | 留空(可能会在某些驱动中使用到，大多数时候为空)，长度<8，一个中文算3个长度 |
| 按位取值 | 寄存器读取后可按位解析，起始位和终止位相同时，表示解析1位数据，值为0或1 |
| 起始位 | 根据数据类型不同，最小0，最大31 |
| 终止位 | 根据数据类型不同，最小0，最大31 |
| 数值转换 | 当测点采集到的值等于"原始值" 时，测点显示出来的值会变成"转换后"的值 |
| 原始值 | 采集到的寄存器的初始值 |
| 转换后 | 采集到的原始值进行转换后的值，在一些通讯协议中报警或故障值解析时会用到 |
遥控遥调设置¶
| 属性值 | 说明 |
|---|---|
| 控制模式 | 遥控遥调的执行模式 |
| 遥调功能码 | 遥调命令的功能码 |
| 遥调寄存器 | 遥调的寄存器地址 |
| 数据类型 | 根据遥调数据的不同，选择不同的数据类型 |
| 遥调高低位顺序 | 当某些通讯协议需要高低寄存器或字交换时需要用到 |
| 定值组功能码 | |
| 控分功能码 | 遥控控分命令的功能码 |
| 控分寄存器 | 遥控控分命令的寄存器地址 |
| 控分选择值 | 遥控控分命令的选择执行值 |
| 控分执行值 | 遥控控分命令的直接执行值 |
| 控分撤销值 | 遥控控分命令的撤销值 |
| 控合功能码 | 遥控控合命令的功能码 |
| 控合寄存器 | 遥控控合命令的寄存器地址 |
| 控合选择值 | 遥控控合命令的选择执行值 |
| 控合执行值 | 遥控控合命令的直接执行值 |
| 控合撤销值 | 遥控控合命令的撤销值 |
转发服务¶
新增转发通道¶
点击转发服务=>转发通道管理，点击新增按钮，新增一个转发通道，如下图：
通道属性说明详见新增采集通道，此处不再赘述。
新增转发设备¶
点击刚刚新建的转发通道右侧的转发设备管理，如下图：
然后点击新增，新增一个转发设备，如下图：
也可以点击批量新增，勾选建好的采集设备，添加为转发设备，会自动添加对应采集设备下的采集测点为转发点，如下图：
新增转发测点¶
点击刚刚新建的转发设备右侧的转发测点管理，如下图：
提示
在上一步中使用批量新增设备功能的可以略过新增转发测点步骤。
然后点击新增，新增一个转发测点，如下图：
测点属性说明详见新增采集测点，此处不再赘述。
也可以点击批量新增按钮，然后点击测点名称右侧编辑框，勾选建好的采集测点，添加为转发测点，如下图：
注意
添加完转发测点后，务必按照所使用的协议要求，对转发功能码、寄存器地址、数据类型、数据格式等进行修改！
中间测点¶
新增中间测点¶
点击中间测点=>中间测点，点击新增按钮，如下图：
中间测点又叫计算点，他们是一样的，只不过中间测点归类在系统通道的系统设备下，计算点归类在采集通道的采集设备下，仅所在的地方不一样。其属性说明详见新增采集测点，此处不再赘述。
数据运算¶
LUA脚本运算¶
点击数据运算=>LUA脚本运算，然后点击新增按钮，如下图：
填写好脚本名称、脚本类型、执行周期等信息。
点击刚刚新建的脚本右侧的编辑脚本函数，即可对脚本进行编辑，相关说明详见Lua帮助的公开函数以及使用范例。
| 属性值 | 说明 |
|---|---|
| 脚本名称 | 可自定义 |
| 脚本描述 | 可自定义 |
| 脚本类型 | 按照设定的执行周期时间，周期性的循环执行 |
| 执行周期 | 单位：毫秒 |
模块化运算¶
点击数据运算=>模块化运算，然后点击新增按钮，如下图：
| 属性值 | 说明 |
|---|---|
| 积分变量(输入) | 要积分的测点(变量)，例如辐照度、功率等 |
| 积分使能 | 保持开启即可 |
| 采样间隔 | 积分目标值的采样间隔，默认500毫秒 |
| 积分时长 | 多长时间进行一次积分，时间单位自由选择 |
| 积分变量(输出) | 将积分的结果赋值给某个测点，推荐选择计算点 |
| 平均值(输出) | 将平均值的结果赋值给某个测点，推荐选择计算点 |
| 最大值(输出) | 将最大值的结果赋值给某个测点，推荐选择计算点 |
| 最小值(输出) | 将最小值的结果赋值给某个测点，推荐选择计算点 |
| 方差(输出) | 将方差的结果赋值给某个测点，推荐选择计算点 |
| 积分次数(输出) | 将积分次数赋值给某个测点，推荐选择计算点 |
5.工程下发¶
视频教程¶
展开查看视频
操作菜单¶
在网关的组态页面右上角，有操作菜单，除了离线工程下发外，其它所有的操作均需要网关在线才可以响应。如下图：
工程下发¶
所有的工程组态，均保存在云端服务器，需要在操作菜单点击工程下发按钮，才可将配置好的工程下发到网关中，不下发不生效。
点击取消按钮放弃本次操作；
点击重启应用按钮，下发工程并重启应用，此时网关会重新离线并再次上线，速度最快；
点击确定按钮下发工程并重启网关，此时网关会彻底重启，速度较慢；
点击稍后自行重启则只下发工程，不重启网关或应用，此时下发的工程尚未生效。
上传证书¶
有些驱动要求使用SSL/TLS加密认证的，那么可以点击上传证书按钮进行上传，首先选择证书要绑定的目标通道，然后选择本地证书文件进行上传。
证书的加密认证一般分为两种情况：
双向认证：需要服务器端提供三个证书文件，分别是ca文件、客户端证书文件、客户端秘钥文件，对应关系如下图；
单向认证：需要服务器端提供一个证书文件，即客户端证书文件，另外两个文件无需上传。
提示
证书文件的文件名称不需要相同，但是证书的类型必须是匹配的。
读取工程¶
点击读取工程按钮，稍等网关上传工程，随后点击下载按钮即可下载网关内的工程到本地电脑。
网关同步至云端¶
点击网关同步至云端按钮，稍等网关上传工程，即可将网关内的工程同步到云端服务器。
注意
此操作会覆盖原有的云端工程。
读取日志¶
点击读取日志按钮，稍等网关上传日志，随后点击下载按钮即可下载网关内的日志到本地电脑。
通道监测¶
勾选一个目标通道，然后点击通道监测按钮，即可在新打开的页面中监测该通道的报文。
重启应用¶
点击重启应用按钮，可以重启网关的应用，网关会先离线，随后再次上线。
重启网关¶
点击重启网关按钮，可以重启网关。
离线工程下发¶
点击离线工程下发按钮，可以在网关不在线时，生成一个下发任务，等网关下次上线后，服务器将自动把工程下发。
6.查看实时数据¶
视频教程¶
展开查看视频
打开监控页面¶
在网关列表页面，点击网关编号，即可跳转到实时数据监控页面；
也可以通过运行监控=>设备数据，然后搜索网关编号，来查看某一网关的实时数据。
页面说明¶
页眉处列出了几个筛选条件，另外点击导出]可以导出当前实时数据，点击组态可以跳转到工程组态页面；
左侧树列出了通道与设备，可以勾选某一设备，只查看该设备下的实时数据；
右侧的测点值即为测点当前的实时数据，其中质量显示为GOOD表示这个值有效，显示为BAD表示这个值无效，采集时间指示了当前数据最后一次成功采集到的时间。
注意
为了避免流量超支，本页面的数据持续刷新一段时间后会自动关闭实时刷新，此时需要手动勾选实时刷新选项或再次点击查询。
7.在线调试¶
打开调试窗口¶
在网关列表页面，点击右侧操作栏的网关调试按钮，即可打开调试窗口。
串口调试视频教程¶
展开查看视频
串口调试¶
串口名称选择要调试串口，配置好串口参数以及超时时间，然后点击打开串口按钮，即可开始串口调试。
注意
打开串口进行调试，会暂时中断目标串口的原来的数据采集工作，请确认对业务没有影响后再进行操作。
按需勾选CRC Modbus校验，如果勾选，那么会自动在报文结尾加上CRC校验码；
手动编辑报文，点击发送数据按钮，如果串口接线正确，就能看到有数据回复；
使用完毕请关闭串口。
命令行调试视频教程¶
展开查看视频
命令行调试¶
ping(网络测试)¶
选择ping(网络测试)命令，在参数编辑框填写要测试的域名或者IP地址，点击发送，即可进行ping测试。
提示
有些ip地址(或域名)是禁ping的，此时请使用端口探测功能。
Telnet(端口探测)¶
选择Telnet(端口探测)命令，格式为IP地址(或域名)+空格+端口号，如下图，尽管网关ping不通192.168.1.102(因为192.168.1.102打开了防火墙)，但是端口探测可以成功，这说明他们之间是可以互相通信的。
提示
即使端口打开成功，也有可能通讯不上，例如目标机器有IP白名单限制、有连接数限制、有用户名密码验证限制等。
ifconfig(查看IP地址)¶
选择ifconfig(查看IP地址)命令，不填任何参数表示获取所有网卡信息，填写目标网卡名称则只获取目标网卡信息。
提示
eth0对应NET1，依次类推。
route(查看路由表)¶
选择route(查看路由表)命令，此时会自动填充-n参数，点击发送即可获取当前路由表信息。
ls(查看文件列表)¶
选择ls(查看文件列表)命令，即可查看文件列表。
例如：升级固件包时，遇到网络问题，导致下载进度反馈超时且网关离线，此时可以稍等网关再次上线后，执行ls -l /data/download，可查看固件包(ioserver_bin.tar.gz)是否下载完成。
ps(查看进程列表)¶
选择ps(查看进程列表)命令，此时会自动填充-aux参数，即可查看进程列表，大多数情况下用不到此命令。
提示
若获取进程列表失败，删除默认参数-aux后再试。
tail(查看拨号日志)¶
选择tail(查看拨号日志)命令，参数100表示要查看的行数。
tail(查看采集日志)¶
选择tail(查看采集日志)命令，参数100表示要查看的行数。
tail(查看远程维护日志)¶
选择tail(查看远程维护日志)命令，参数100表示要查看的行数。
tail(查看重启操作日志)¶
选择tail(查看重启操作日志)命令，参数100表示要查看的行数。
uptime(查看时间信息)¶
选择uptime(查看时间信息)命令，可以查看网关当前的时间、已经运行的时间、以及系统的平均负载。
df(查看磁盘占用)¶
选择df(查看磁盘占用)命令，可以查看网关当前的磁盘占用。
set_model(修改网关型号)¶
选择set_model(修改网关型号)命令，可以修改网关当前显示的型号。
get_pro_ver(查看驱动版本号)¶
选择get_pro_ver(查看驱动版本号)命令，可以查看协议驱动当前的版本号,驱动名称之间可以用逗号隔开。
set_server(设置服务器)¶
选择set_server(设置服务器)命令，可以修改网关连接服务器的地址，填写自己服务器的域名。
注意
请联系我们工程师确认后再操作，否则会导致网关永久离线。
set_hardver(设置系统版本)¶
选择set_hardver(设置系统版本)命令，只可以设置单片机版本的网关的系统版本。
wget(更新驱动列表)¶
选择wget(更新驱动列表)命令，可以更新驱动版本。
rm protocols(释放磁盘空间)¶
选择rm protocols(释放磁盘空间)命令，可以通过删除驱动文件来解决磁盘空间不够的问题，执行本命令后，需要重新下发一次工程，会自动下发缺失的驱动。
cat(查看机器码)¶
选择cat(查看机器码)命令，部分驱动需要额外的授权，此时请执行查看机器码命令，将机器码发给我们工程师以获取相应的授权码文件。
通道监测¶
在工程组态页面，勾选一个目标通道，可以进行通道监测，见下图。
常用功能¶
左侧是通道列表，如果有多个通道，可以在此处直接切换通道进行监测；
点击停止监视按钮，可以停止监测，再次点击即可重新开始监测；
点击停止滚屏按钮，可以让报文停止滚动，否则总会滚动到最新一条；
点击清空列表按钮，可以清空本页报文；
点击复制全部内容按钮，可以复制本页所有报文信息。
扩展功能¶
只有部分IEC协议(例如IEC104)支持总召、对时、测试帧等功能；
只有部分串口协议支持更多操作菜单里恢复、停止、暂停、重启通道等功能。
监测级别¶
等级越高，报文以及信息越详细。
提示
只有部分常见协议会打印报文解析。
LUA脚本检查¶
在编写完LUA脚本后，点击在线检查按钮，可以检查脚本的语法是否正确；
点击下发至网关检查，可以进一步对脚本进行检查。
提示
下发至网关检查会在网关内运行当前lua脚本，请确保网关内工程为最新，且对业务没有影响后再试。
8.系统测点¶
系统测点点表¶
常规测点¶
| 测点名称 | 测点描述 | 数据类型 | 说明 |
|---|---|---|---|
| $Year | 年 | 单精度浮点 | |
| $Month | 月 | 单精度浮点 | |
| $Day | 日 | 单精度浮点 | |
| $Hour | 时 | 单精度浮点 | |
| $Minute | 分 | 单精度浮点 | |
| $Second | 秒 | 单精度浮点 | |
| $TotalTagCount | 变量总数 | 单精度浮点 | |
| $CurrentAlarmFlag | 当前是否存在报警 | 单精度浮点 | 无效，不再使用 |
| $Latitude | 纬度 | 单精度浮点 | |
| $Longitude | 经度 | 单精度浮点 | |
| $Elevation | 海拔 | 单精度浮点 | |
| $NumStatellite | 卫星数量 | 单精度浮点 | |
| $GPSQos | 定位质量 | 单精度浮点 | 0：GPS的定位无效，包括经度，纬度，海拔，卫星数量，GPS日期，GPS时间均无效；1 ：GPS数据有效 |
| $GPSDate | GPS日期 | 字符串 | |
| $GPSUtcTime | GPS的UTC时间 | 字符串 | 为UTC时间，单位s |
扩展测点¶
| 测点名称 | 测点描述 | 数据类型 | 说明 |
|---|---|---|---|
| $AI_V_1 | AI模拟信号输入1 | 单精度浮点 | |
| $AI_V_2 | AI模拟信号输入2 | 单精度浮点 | |
| $AI_V_3 | AI模拟信号输入3 | 单精度浮点 | |
| $AI_V_4 | AI模拟信号输入4 | 单精度浮点 | |
| $PT100_1 | PT100传感器值1 | 单精度浮点 | |
| $PT100_2 | PT100传感器值2 | 单精度浮点 | |
| $DI_1 | DI数字输入1 | 单精度浮点 | |
| $DI_2 | DI数字输入2 | 单精度浮点 | |
| $DI_3 | DI数字输入3 | 单精度浮点 | |
| $DI_4 | DI数字输入4 | 单精度浮点 | |
| $DI_5 | DI数字输入5 | 单精度浮点 | |
| $DI_6 | DI数字输入6 | 单精度浮点 | |
| $DI_7 | DI数字输入7 | 单精度浮点 | |
| $DI_8 | DI数字输入8 | 单精度浮点 | |
| $DO_1 | DO数字输出1 | 单精度浮点 | |
| $DO_2 | DO数字输出2 | 单精度浮点 | |
| $DO_3 | DO数字输出3 | 单精度浮点 | |
| $DO_4 | DO数字输出4 | 单精度浮点 | |
| $AO_1 | AO模拟输出1 | 单精度浮点 |
系统测点引用¶
系统测点不显示在通道中，需要读取系统测点的数据时，通过在任意采集通道建立采集功能码为"计算点"的测点，然后寄存器地址填写系统测点的测点名称即可(注意包含$符号)，测点的数据类型要匹配上表中的数据类型。如下面的工程要读取GPS信息，则如下配置：
提示
GPS测点信息需要GPS模块硬件支持，选配。
9.计算点与表达式¶
计算点¶
在采集通道中可以用计算点来做简单的运算，含：赋值运算、加、减、乘、除等，表达式计算的运算周期是其所属通道的交互频率属性值。
其中，如果计算点的类型是字符串，则只支持加法运算，会将多个测点的字符串值(字符串值中不允许出现运算符或&符,@符)进行拼接；
非字符串测点，最多支持4个测点参与运算，在计算点的地址上填写表达式即可，其中对系统测点的引用，直接使用系统测点的测点名称。对其它测点的引用有两种情况：
-
以测点名来引用，则测点名前增加“&”前缀。
-
以测点描述(物模型)来引用，则测点描述(物模型)前增加“@”前缀。
注意
用测点描述(物模型)来引用时，被引用的测点必须与目标测点在同一个设备下，且同一设备下测点描述(物模型)不可以重复。
使用范例见下一小节表达式。
表达式¶
表达式功能必须在功能码为"计算点"的测点上才能使用，若功能码无法选择为"计算点"则表示该协议不支持表达式功能；
网关软件版本<1.3.44时，使用表达式功能要求测点名称不能出现中文，例如"&支路1电流+&支路2电流"这样是错误的，可以更正为"&Ipv1+&Ipv2"；
网关软件版本≥1.3.44时，表达式里支持中文。
网关软件版本>1.3.56时，最多支持8个测点参与运算，且表达式长度必须少于87个字节。
系统测点¶
例：
参考上一章节系统测点引用中对系统测点的操作，使用了赋值运算。
字符串测点¶
例：
有2个测点，YC1的值为“test1”，YC2的值为“test2”；
欲拼接YC1和YC2的值，那么新建一个YC3，功能码选择计算点，数据类型选择字符串，地址中填“&YC1+&YC2”，则YC3的值为“test1test2”，
配置如下图：
非字符串测点¶
例：
有2个测点，输入功率P1为100，输出功率P2为90，欲计算工作效率；
那么新建一个测点P3，功能码选择计算点，然后在地址处填写“&P2/&P1”，其余参数默认即可，则P3的值为“0.9”，
配置如下图：
表达式例子¶
取反¶
提示
该功能在下位机版本≥1.3.44生效。
例：
有一个开关量点YX5(数据类型为位)，值为0或者1，欲对其取反，则新建一个计算点，地址填写not(&YX5)，则该计算点和YX5的结果相反；
提示
若该测点的数据类型不是位，那么地址填写not(&YX5>0)。
进制转换¶
例：
有一个模拟量点YC4，值为16进制的0x15(显示出来是15,和预期的21不符)，欲将其转换为10进制，则新建一个计算点，地址填写tonumber(&YC4,16)，则该计算点会将YC4的值转换为十进制的21。
10.权限管理¶
部门管理¶
点击权限管理，然后点击部门管理，点击新增按钮，即可创立一个新部门。
填写好名称、上级部门、排序等信息后即可添加完成。
角色管理¶
点击角色管理，点击新增按钮，即可创立一个新角色。
填写名称、菜单授权、数据授权等信息，点击确定即可保存。
用户管理¶
点击用户管理，即可看到当前账号的信息，此处添加的用户即为子账号，可以由其他人员登录。
提示
总账号能看到由子账号添加的网关，子账号无法看到由总账号添加的网关。
个性化管理¶
请联系管理员进行配置。
11.插件下载¶
视频教程¶
展开查看视频
软件版本升级¶
提示
只有软件版本为1.4+的版本才支持插件下载。
将软件版本升级为1.4.xx以上的版本，点击配置，然后点击升级软件。
插件列表¶
点击配置，然后点击安装插件。
选择要下载的插件，点击安装，安装完成后会自动重启，等待20-40秒。 安装完成后点击刷新，有显示网关版本即为安装成功。
Ended: 云端配置
本地配置 ↵
运行环境¶
-
系统要求
windows、MAC、Linux等，32位或64位均可；
注意
其中扩展的IEC算法功能模块仅支持windows 7系统(32位)及以上。
-
最小分辨率
1280*720；
-
JAVA环境
支持JDK(或JRE)1.8及以上版本，如果是windows版本，可以直接安装带运行环境的安装包，无需手动下载；
如果是linux或mac版本，也可以访问官方网站找到适合自己系统的运行环境下载(本软件32位或64位都支持)，
java官网：https://java.com/en/download/manual.jsp
Windows系统64位版本：
MAC或Linux系统64位版本：
功能介绍¶
-
管理工具
PBoxMgrTool，负责搜索局域网内的网关，对网关的IP/路由配置，工程下载/上传，串口/网络调试，日志查询，固件升级，时钟同步等。
-
配置工具
PBoxConfig，实现采集、转发、计算点的配置，负责通道、设备、测点、脚本的管理。
-
运行监控工具
PBoxClient，配置工具PBoxConfig配好的工程，保存后，可下载到网关，通过运行监控软件可实现数据的监控、显示、控制、通道报文监视等功能；
用于直观排查数据配置的正确性，算法计算的正确性等。
-
算法组态工具
PBoxIEC，负责算法的组态编程，搭建要自动计算的逻辑，搭建完成后可编译、仿真来确认算法是否正确，算法只有编译下载到网关才会生效。
注意
算法组态属于扩展功能模块，默认不包含此工具。
2.软件安装¶
安装包¶
安装包通常为压缩包，解压之后得到exe可执行文件，文件名格式通常为PBoxMgrTool(withJRE-IEC-x86)SetupV1.9.1-20210901.exe，其中，
withJRE表示安装包自带java环境，安装过程中会自动部署；
IEC表示安装包带扩展的IEC算法模块，默认不带；
x86表示此安装包为32位，如果是x64表示此安装包为64位；
V1.9.1表示此安装包的版本；
20210901表示此安装包发布的日期。
安装过程¶
双击打开安装包，过程中只需要关注软件的安装位置即可，按需改变安装位置，路径中不可以出现空格和中文，然后一直点击下一步、安装，等待安装java环境，这需要花费一定的时间；
安装完成后，即可在桌面找到三个快捷方式。
3.网关管理工具¶
软件界面¶
展开查看视频
上方是操作菜单栏以及常用操作按钮，下方是网关信息列表；若因为分辨率原因导致常用操作按钮显示不全的，也可以从操作菜单栏点击功能按钮。
注意
本软件只能打开一次，若出现弹窗提示"端口19000已被占用"的，请检查是否已经存在本进程。
| 属性名 | 说明 |
|---|---|
| 网关编号 | 即网关的唯一编号SN |
| 网关IP | 当前与电脑相连接的网卡的IP地址 |
| 网关密码 | 网关出厂自带的随机字符，双击单元格即可查看网关密码 |
| 机器型号 | 指示该网关的硬件型号 |
| 软件版本 | 指示该网关的软件版本，也叫固件版本，可以自行选择发布的版本进行升级 |
| 系统版本 | 指示该网关的系统(硬件)版本 |
| 信号强度 | 网关当前的4G网络信号值，20~30为良好，小于20为较差，小于10为极差；显示有线上网则说明通过网口连接网线的方式上网 |
| ICCID | 网关内用于上网的SIM卡的ICCID |
| 网关时钟 | 网关接收到刷新命令时响应的时间，非动态变化 |
| 网关备注 | 双击单元格可以自定义网关的备注名称，长度16个汉字以内 |
刷新与添加¶
展开查看视频
点击刷新按钮，可以自动搜索局域网内的网关；如果搜索不到，那么可以点击添加按钮，手动添加；
如果还是刷新不出网关，排查方法详见1.搜索不到网关。
注意!!!
能搜索到网关，不代表可以直接进行操作了，需要将电脑与网关相连的网卡的IP配置在同一网段，方可进行后续操作，详见3)是否处于同一网络?。
设置密码¶
展开查看视频
点击设置密码按钮，添加密码；
免输密码时长为输入密码后的一段时间内无需在输入密码。
IP配置¶
展开查看视频
选中一行，点击IP配置按钮，即可对该网关进行网卡IP配置，一次只能配置一个网卡，点击设置按钮方可生效，切换网卡，已修改未设置的配置将会丢失；
网关上网优先级为 有线网络 > 4G拨号。
警告
多网口设备，不同网卡的IP不能配置为相同网段，否则会导致无法联网或者网络通讯异常！
例如NET1配置为192.168.1.100，NET2配置为192.168.1.200，这样是不允许的。
| 属性名 | 说明 |
|---|---|
| 网卡 | NET1表示网关的第一个网卡，NET2表示第二个，以此类推 |
| 启用此网卡 | 默认启用；如果选择否，那么网关的该网口将用作DHCP服务器，以对外向其它设备提供网络 |
| IP获取方式 | 选择静态IP(推荐)，那么需要手动配置IP；选择DHCP(不推荐)，那么由路由器(或其它DHCP服务器)分配IP地址 |
| 网关 | 如果网关通过这个网卡上网，那么需要填写网关；此处的网关指路由器等设备的IP |
| 设为默认网关 | 如果网关通过SIM卡4G上网，那么不勾选；如果网关通过这个网卡上网，那么勾选；默认网关只能有一个，如果设置了多个，那么网卡NET索引较小的优先生效；如果修改了此项，会导致网关断线重连，约10秒 |
| DNS | 域名解析服务器，默认即可 |
| IP地址 | 该网卡的IP地址，最多可以添加10个不同的IP地址 |
| 子网掩码 | 该网卡的子网掩码，填写完IP地址后自动填充 |
| 目标 | 哪些范围的IP地址匹配本条路由，例如：192.168.100.0/24 |
| 下一跳 | 路由的下一个点，例如：192.168.0.1，意为192.168.100.xxx网段的数据从192.168.0.1走 |
重启网关¶
展开查看视频
选中一行，点击重启网关按钮，即可重启目标网关。
下装¶
展开查看视频
选中一行，点击下装按钮，默认的文件路径(ioserver_prj.tar.gz)为上次数据配置工具(PBoxConfig)编辑工程后保存的路径，通常无需进行手动选择；
点击开始下载，会将工程压缩包下载到目标网关，然后根据提示重启网关，下发的工程重启后生效。
提示
固件升级包(ioserver_bin-xxxxxx.tar.gz)也可以通过下装功能手动选择升级包，对智能网关进行升级，固件升级完毕必须重启网关。
重启应用¶
展开查看视频
选中一行，点击重启应用按钮，即可重启网关应用。
固件升级¶
展开查看视频
选中一行，点击固件升级按钮，选择要升级的版本，点击确定，可以对目标网关进行固件升级(软件升级)，升级完毕重启网关生效；
即使是旧版本通常也无需升级，升级前建议咨询管理员，使用此功能要求电脑必须能够上网，网关本身能否上网不作要求。
提示
固件允许降级，降级前请咨询管理员。
读取工程、读取日志¶
展开查看视频
选中一行，点击读取工程(读取日志)按钮，选择要保存的路径，点击确定，就能把网关内的工程(日志)读到本地，读取成功后，可以选择是否打开目标文件夹。
APN设置¶
此处可以配置网络接入点(即APN)、用户名、密码等参数，用于拨号上网到专网或内网，
PING1、PING2、PING3等参数用于拨号成功后测试网络是否正常，网络类型可以手动指定运营商。
| 网络类型 | 说明 |
|---|---|
| auto | 建议选择此项，自动适配 |
| cdma | 中国电信2G |
| edge | 联通2G |
| wcdma | 联通3G |
| td-scdma | 移动3G |
| evdo | 电信3G |
| lte | 4G |
移动网络状态¶
选中一行，点击移动网络状态按钮，可以查看目标网关的拨号详细信息。
NTP对时¶
选中一行，点击NTP对时按钮(或单击鼠标右键，从右键菜单进入)，可以设置对时服务器，让网关周期性的请求对时，对时周期设置为0意为不对时；
通常无需开启此功能，服务器自带校时；
如下图：
部分机器支持B码对时，此时可将服务器地址设置为B，对时周期设置为10(注意:此时对时周期为秒值，而非界面上显示的分钟值)，意为每10秒接收B码对时一次，可根据实际情况设置对时周期；
设置时如果报错，意为不支持设置B码对时。
WIFI配置¶
选中一行，点击WIFI配置按钮，可以配置网关的wifi状态、wifi名称、wifi密码等，点击设置按钮即可生效，wifi列表中蓝色字体的wifi名称表示当前连接的wifi。
点击扫描按钮可以扫描附近的wifi热点，wifi处于禁用状态时，不可以扫描wifi热点，需要先设置成启用；
当前wifi功能，支持 启用/禁用 的状态设置，和从未连接状态设置为已连接状态，暂不支持从已连接状态设置为未连接状态。
提示
仅部分型号支持wifi功能，wifi模块选配；
wifi信号值范围1~100，单位为%，越大信号越好。
白名单配置¶
选中一行，右键点击选择白名单配置，打开串口后点击白名单状态点击禁用；
刷新当前入网节点，选中节点，选择覆盖或者追加到白名单；
点击“查询”查询当前白名单；
点击添加，手动输入节点sn，确认无误后点击确定→设置，点击设置后会自动重启PLC；
“删除白名单”和“清空白名单”直接对机器进行操作；
注意
配置完成后必须关闭串口！！！
基本信息¶
选中一行，点击基本信息按钮，可以获取、刷新目标网关的基本信息。
删除¶
选中一行，点击删除按钮，可以暂时删除这条记录，点击刷新按钮仍旧可以再次刷新出来。
配置¶
点击此按钮可以打开数据配置工具。
监视¶
点击此按钮可以打开实时监控与调试工具。
网关调试¶
选中一行，点击网关调试按钮，可以对目标网关进行调试，调试分为串口调试和命令行调试。
串口调试¶
展开查看视频
串口名称选择要调试串口，配置好串口参数以及超时时间，然后点击打开串口按钮，即可开始串口调试。
展开查看视频
注意
打开串口进行调试，会暂时中断目标串口的原来的数据采集工作，请确认对业务没有影响后再进行操作。
按需勾选CRC Modbus校验，如果勾选，那么会自动在报文结尾加上CRC校验码；
手动编辑报文，点击发送数据按钮，如果串口接线正确，就能看到有数据回复；
使用完毕请关闭串口。
命令行调试¶
ping(网络测试)¶
选择ping(网络测试)命令，在参数编辑框填写要测试的域名或者IP地址，点击发送，即可进行ping测试。
提示
有些ip地址(或域名)是禁ping的，此时请使用端口探测功能。
Telnet(端口探测)¶
选择Telnet(端口探测)命令，格式为IP地址(或域名)+空格+端口号，如下图，尽管网关ping不通192.168.1.102(因为192.168.1.102打开了防火墙)，但是端口探测可以成功，这说明他们之间是可以互相通信的。
提示
即使端口打开成功，也有可能通讯不上，例如目标机器有IP白名单限制、有连接数限制、有用户名密码验证限制等。
ifconfig(查看IP地址)¶
选择ifconfig(查看IP地址)命令，不填任何参数表示获取所有网卡信息，填写目标网卡名称则只获取目标网卡信息。
提示
eth0对应NET1，依次类推。
route(查看路由表)¶
选择route(查看路由表)命令，此时会自动填充-n参数，点击发送即可获取当前路由表信息。
ls(查看文件列表)¶
选择ls(查看文件列表)命令，即可查看文件列表。
ps(查看进程列表)¶
选择ps(查看进程列表)命令，此时会自动填充-aux参数，即可查看进程列表，大多数情况下用不到此命令。
提示
若获取进程列表失败，删除默认参数-aux后再试。
tail(查看拨号日志)¶
选择tail(查看拨号日志)命令，参数100表示要查看的行数。
tail(查看采集日志)¶
选择tail(查看采集日志)命令，参数100表示要查看的行数。
tail(查看远程维护日志)¶
选择tail(查看远程维护日志)命令，参数100表示要查看的行数。
tail(查看重启操作日志)¶
选择tail(查看重启操作日志)命令，参数100表示要查看的行数。
uptime(查看时间信息)¶
选择uptime(查看时间信息)命令，可以查看网关当前的时间、已经运行的时间、以及系统的平均负载。
close SSH(关闭风险端口)¶
选择close SSH(关闭风险端口)命令，可以关闭SSH的22端口，在有些场景中，开放22端口会被视为一种危险行为；本命令重启后生效。
提示
下位机软件版本≤1.3.56时，关闭SSH将无法下发读取工程、无法监视实时数据，开启SSH后恢复；建议下位机软件版本升级到1.3.58及以上。
open SSH(打开风险端口)¶
选择open SSH(打开风险端口)命令，可以重新打开被关闭的SSH端口；本命令重启后生效。
safeModel(开启网安模式)¶
选择safeModel(开启网安模式)命令，可以关闭拨号功能和远程维护功能；
拨号功能会对外访问DNS域名服务器(例如114.114.114.114等，UDP协议，53端口)，远程维护功能会对外访问MQTT后台服务器(TCP协议，1883端口)，在有些安全等级较高的场景中，这两个动作会被视为危险行为。
normalModel(关闭网安模式)¶
选择normalModel(关闭网安模式)命令，可以开启拨号功能和远程维护功能；本命令重启网关生效。
rm protocols(释放磁盘空间)¶
选择rm protocols(释放磁盘空间)命令，可以通过删除驱动文件来解决磁盘空间不够的问题，执行本命令后，需要重新下发一次工程，会自动下发缺失的驱动。
cat(查看机器码)¶
选择cat(查看机器码)命令，部分驱动需要额外的授权，此时请执行查看机器码命令，将机器码发给我们工程师以获取相应的授权码文件。
网卡桥接¶
选中一行，点击IP配置按钮，然后选择网卡桥接即可切换到网卡桥接配置页面，对该网关进行网卡桥接配置，点击设置按钮方可生效；
警告
IP获取方式只能配置成静态IP，若配置成DHCP则该桥接配置不生效；
必须配置至少一个IP地址，桥接才能生效。
提示
不同型号的网关，可桥接的网卡数量是不一致的，界面中灰色的网卡是不允许桥接的网卡；
启用在选中后桥接才会生效，取消勾选该选项则桥接失效，恢复网络状态为IP配置的状态。
| 属性名 | 说明 |
|---|---|
| 网卡列表 | NET1表示网关的第一个网卡，NET2表示第二个，以此类推，需要选中至少一个网卡桥接才能生效 |
| 启用 | 默认启用；如果选择否，关闭桥接且恢复网络状态为IP配置中配置的状态 |
| IP获取方式 | 只能选择静态IP |
| 网关 | 如果网关通过这个网卡上网，那么需要填写网关；此处的网关指路由器等设备的IP |
| 设为默认网关 | 如果网关通过SIM卡4G上网，那么不勾选；如果网关通过这个网卡上网，那么勾选；默认网关只能有一个，如果设置了多个，那么网卡NET索引较小的优先生效；如果修改了此项，会导致网关断线重连，约10秒 |
| DNS | 域名解析服务器，默认即可 |
| IP地址 | 该网卡的IP地址，最多可以添加10个不同的IP地址 |
| 子网掩码 | 该网卡的子网掩码，填写完IP地址后自动填充 |
| 目标 | 哪些范围的IP地址匹配本条路由，例如：192.168.100.0/24 |
| 下一跳 | 路由的下一个点，例如：192.168.0.1，意为192.168.100.xxx网段的数据从192.168.0.1走 |
网卡主备冗余配置¶
选中一行，点击IP配置按钮，然后选择网卡桥接即可切换到网卡桥接配置页面，勾选主备模式，点击设置按钮方可生效；
警告
主备模式和网卡桥接只能选择一个，若都勾选，则主备模式生效。IP获取方式只能配置成静态IP，若配置成DHCP则该桥接配置不生效；
必须配置至少一个IP地址，主备模式才能生效；
网关系统版本以9结尾的才支持该功能。如V1.1.9。
提示
设置了主备模式之后，网关要在3分钟之内重启后才能生效，为了避免网络配置异常，超过3分钟不重启会恢复原配置；
主备模式无需选择网卡，系统会把所有的网卡都加入主备模式；
主备模式下的默认网关配置继承IP设置中的配置。
双机冗余¶
选中网关编号，单击右键弹出菜单，在菜单中点击双机冗余按钮，可以进行双机冗余配置，界面和属性说明如下：
| 属性名 | 说明 |
|---|---|
| 启用双机冗余功能 | 勾选则启用，不勾选不启用本功能 |
| 本机身份 | 若为主服务器，在双方均待机的情况下，本机优先主动工作 |
| 冗余服务器身份 | 和本机身份互斥；若为冗余(备用)服务器，则仅在主服务器离线时才主动工作 |
| 本机IP地址 | 本机用来做冗余通信的IP地址，该IP地址必须在IP配置中设置过，且所在网口必须启用 |
| 冗余服务器IP地址 | 用于冗余通信的对端IP地址 |
| 异常切换时长 | 默认300毫秒，意为持续300毫秒对端离线或其它异常时，本机进入工作状态 |
| 当前本机状态 | 展示当前本机的工作状态，采集/待机 |
| 当前对端状态 | 展示当前对端的工作状态，采集/待机/离线 |
| 当前本机时间 | 展示当前本机时间 |
| 获取 | 重新获取双机冗余配置，且刷新当前本机和对端的状态 |
常见网络拓扑如下图：
4.数据配置工具¶
软件界面¶
上方是操作菜单栏以及常用操作按钮，下方展示工程信息，下图为刚运行软件未打开工程的初始状态。
新建¶
首次使用，应该点击新建按钮，新建一个工程，通常无需改变存储位置，只需要根据实际的项目名称对工程进行备注即可，然后点击确定按钮，新建工程完成。
打开¶
打开工程分两种情况。
-
打开电脑本地的工程
点击打开按钮，选择本地数据源，点击浏览按钮，进入projects文件夹(以工程的实际存储位置为准)，选中要打开的工程文件夹，点击打开按钮，再点击确定按钮，即可打开工程。
-
打开网关中的工程
如果某一网关已经配置好了工程，那么可以直接读取出网关内部的工程并打开，此时需要选择远程数据源，填写网关对应的IP，点击浏览按钮，选择读取的工程要保存的位置，点击新建文件夹按钮，创建一个新的文件夹，并命名为Sqlite-测试工程(根据实际情况自定义命名)，选中刚刚新建的文件夹，点击打开按钮，然后点击确定按钮，稍等数秒，即可将网关内的工程读取上来并打开，若打开失败，请检查电脑和网关是否处于同一网络。
保存¶
所有对工程做过的操作，都是保存在内存中的，需要点击保存按钮，才会保存到本地，在配置过程中以及配置完成后，请点击保存按钮进行工程保存。
关闭¶
软件一次只能打开一个工程，如需打开其它工程，请先关闭当前的，然后再打开新的，点击关闭按钮前，请先保存；
如果需要打开多个工程，那么可以运行多个数据配置工具。
编辑脚本¶
点击编辑脚本按钮，在弹出窗口中点击新增，可以新增一个lua脚本，并配置脚本名称、备注、执行周期等参数(脚本类型与触发条件暂不支持编辑)；
点击编辑脚本函数按钮，可以编写lua脚本；建议在其它编辑器编写完成后，拷贝到此处；
上传证书¶
有些驱动要求使用SSL/TLS加密认证的，那么可以点击上传证书按钮进行上传，首先选择证书要绑定的目标通道，然后选择本地证书文件进行上传。
证书的加密认证一般分为两种情况：
双向认证：需要服务器端提供三个证书文件，分别是ca文件、客户端证书文件、客户端秘钥文件，对应关系如下图；
单向认证：需要服务器端提供一个证书文件，即客户端证书文件，另外两个文件无需上传。
提示
证书文件的文件名称不需要相同，但是证书的类型必须是匹配的。
下装¶
点击下装按钮，则会打开网关管理工具。
监视¶
点击监视按钮，则会打开实时监控与调试工具。
采集服务¶
添加采集通道¶
选中左侧树列表的根节点数据配置工具-任务树，点击添加按钮，即可添加1个通道，也可以输入数量后再添加，这样可以一次性添加多个通道；
新添加的通道，所有的参数都是默认的，请根据实际情况变更通道的属性。
| 属性名 | 说明 |
|---|---|
| 通道名称 | 可自定义，例如"COM1"，同一个网关下，通道名称不可重复 |
| 通道描述 | 可自定义，可空 |
| 通道地址 | 默认不动即可，通常无需修改 |
| 通道类型 | 指示该通道的类型是采集通道还是转发通道，按需修改 |
| 通道协议 | 指示这个通道所使用的协议 |
| 协议类型 | 指示该协议要基于串口通讯还是基于TCP/IP通讯(并非所有的协议都支持切换) |
| 交互频率 | 指示网关采集智能设备的频率(网关会在一个交互频率时间内尽可能的采集完所有设备)，或网关上传数据到云端服务器的频率，单位毫秒 |
| 每帧间隔 | 指示网关和智能设备交互时，每两帧报文之间的等待时间，单位毫秒，通常保持默认即可 |
根据所选的协议类型的不同，通道参数配置有两种，串口和TCP/IP，
串口的参数如下图：
| 属性名 | 说明 |
|---|---|
| 串口名称 | 选择COM1则对应A1、B1，以此类推 |
| 波特率 | 串口波特率 |
| 数据位 | 串口数据位 |
| 停止位 | 串口停止位 |
| 校验位 | 串口校验位 |
| 超时 | 串口超时时间，单位毫秒 |
| 保留0 | 留空 |
| 保留1 | 留空 |
TCP/IP的参数如下图：
| 属性名 | 说明 |
|---|---|
| 角色(通讯方向) | 主动连接作为客户端Client发起，等待接入作为Server监听端口，不知道如何选择时，保持默认即可 |
| IP/域名 | 填写IP地址或域名均可 |
| 端口号 | 连接的目标端口号 |
| 超时 | 通讯超时，单位毫秒 |
| 保留0 | 留空 |
| 保留1 | 留空 |
| 保留2 | 留空 |
| 保留3 | 留空 |
规约特征配置¶
选中一个通道，点击上方的规约按钮，可以打开相应的规约特征配置，不同的规约，其特征均不同，规约特征与通道、协议(即规约)相关联。
提示
规约按钮字体颜色变蓝，说明有配置了规约特征。
添加采集设备¶
在左侧树选中刚刚添加的通道，点击添加按钮，可以在这个通道下添加设备，也可以输入数量后再添加，这样可以一次性添加多个设备，如下图：
| 属性名 | 说明 |
|---|---|
| 设备名称 | 可自定义，例如“设备1”，同一个网关下，设备名称不可重复，长度＜64，一个中文算3个长度 |
| 设备描述 | 可自定义，长度＜64，一个中文算3个长度 |
| 设备通讯地址 | 子设备的地址，长度＜64，一个中文算3个长度 |
| 设备公共地址 | 通常用不到，保持默认即可，长度＜64，一个中文算3个长度 |
| 有效性 | 若为否，则不会加载该设备及其下测点 |
| 兼容平台 | 通常用不到，保持默认即可 |
| 设备类型 | 通常用不到，保持默认即可 |
| 保留0 | 留空 |
| 保留1 | 留空 |
添加采集测点¶
在左侧树选中刚刚添加的设备，然后点击添加按钮，添加一个测点，如下图：
提示
1、你可以根据测点的类型对其进行分类，例如遥测、遥信、遥脉、遥控、遥调等，也可以不分类，都放在遥测里，不管是否进行分类都没关系，只是为了展示方便，不会影响数据采集与转发；
2、每个采集测点都可以选择设备"通讯中断"功能码，用于指示该测点所在设备的数据采集状态，当该测点的系数为1(默认)时，其值=1意为当前通讯处于中断状态；当该测点的系数为0时，其值=1意为当前通讯处于正常状态。
基本属性¶
| 属性名 | 说明 |
|---|---|
| 名称 | 测点的名称，可自定义，例如“测点0”，同一个网关下，采集测点的名称不可重复，转发测点的测点名称允许重复，长度＜64，一个中文算3个长度 |
| 物模型标识(测点描述) | 它是测点描述，在某些转发协议中，它也是物模型标识，长度＜64，一个中文算3个长度 |
| 采集类型(功能码1) | 根据实际情况选择，详见驱动帮助 |
| 读写属性 | 略 |
| 系数 | 测点显示出来的值 = 测点实际采集到的值 x 系数 + 偏移 |
| 偏移 | 测点显示出来的值 = 测点实际采集到的值 x 系数 + 偏移 |
| 变量单位 | 仅做展示备注，无实际意义 |
| 测点分组 | 在相同功能码的情况下，可设置采集分组进行手动组帧下发通讯报文，分组相同的测点会打包一起放在同一帧中进行数据采集通讯，通常无需配置，默认自动分组 |
| 寄存器地址 | 寄存器地址，也叫对象地址，根据实际情况填写，长度＜88，一个中文算3个长度 |
| 数据类型 | 根据实际情况选择 |
| 高低位顺序(数据格式) | 当某些通讯协议需要高低寄存器或字交换时需要用到，详见下表高低位顺序说明 |
| 是否上传 | 保持默认即可，会在某些转发协议中加载 |
| 辅助参数 | 留空(可能会在某些驱动中使用到，大多数时候为空)，长度＜8，一个中文算3个长度 |
| PV上传标识 | 只有选择了兼容平台才会出现，保持默认即可，会在某些转发协议中加载 |
| 限值使能位 | 选择开，则开启限制最大最小值功能 |
| 限值最小值 | 当该变量值＜限值最小值，那么它的质量戳会变为坏，且保持上一次的值不变 |
| 限值最大值 | 当该变量值＞限值最大值，那么它的质量戳会变为坏，且保持上一次的值不变 |
| 公式计算 | 指示该测点进行系数和偏移计算时的运算顺序 |
高低位顺序说明：
| 属性值 | 说明 |
|---|---|
| 12 | 表示2个字节的寄存器高字节在前低字节在后 |
| 21 | 表示2个字节的寄存器低字节在前高字节在后 |
| 1234 | 表示2个字的寄存器，高字在前低字在后，字内高字节在前低字节在后 |
| 2143 | 表示2个字的寄存器，高字在前低字在后，字内低字节在前高字节在后 |
| 3412 | 表示2个字的寄存器，低字在前高字在后，字内高字节在前低字节在后 |
| 4321 | 表示2个字的寄存器，低字在前高字在后，字内低字节在前高字节在后 |
报警属性¶
报警属性根据所选则的测点类型(遥测、遥信等)的不同而不同，通常我们无需关注此部分内容，只有部分转发协议会用到，且都会在相应的驱动帮助里说明。
| 属性值 | 说明 |
|---|---|
| 报警使能 | 开启报警记录，报警记录的总开关，不打开总开关，报警是不生效的 |
| 是否开启x报警 | 选择开启，使对应报警生效 |
| 报警限值 | 当测点实际值向上或向下突破了限值时，会触发报警 |
| 报警消息 | 当触发报警时，所要显示的消息内容 |
| 报警死区 | 减少反复报警的干扰，避免测点值在报警限值附近波动时反复触发报警 |
| 开关报警类型 | 开报警0->1报警，关报警1->0报警，变位报警1<->0报警 |
| 报警等级 | 根据实际情况选择，用不到的保持默认即可 |
历史属性¶
通常我们无需关注此部分内容，只有部分转发协议会用到，且都会在相应的驱动帮助里说明。
提示
本平台不存储历史数据。
| 属性值 | 说明 |
|---|---|
| 存储使能 | 历史存储的总开关 |
| 存储类型 | 目前仅支持周期存储，自动压缩数据(不变不存) |
| 存储间隔 | 单位：秒 |
| 压缩精度 | 暂不支持 |
高级设置¶
| 属性值 | 说明 |
|---|---|
| 初始值 | 网关尚未开始和子设备通讯的时候，测点的初始值(不支持中文) |
| 数值转换 | 当测点采集到的值等于"原始值" 时，测点显示出来的值会变成"转换后"的值 |
| 原始值 | 采集到的寄存器的初始值 |
| 转换值 | 采集到的原始值进行转换后的值，在一些通讯协议中报警或故障值解析时会用到 |
| 按位取值 | 寄存器读取后可按位解析，起始位和终止位相同时，表示解析1位数据，值为0或1 |
| 取值起始位 | 根据数据类型不同，最小0，最大31 |
| 取值终止位 | 根据数据类型不同，最小0，最大31 |
转发服务¶
添加转发通道¶
选中左侧树列表的根节点数据配置工具-任务树，点击添加按钮，即可添加1个通道，也可以输入数量后再添加，这样可以一次性添加多个通道；
新添加的通道，所有的参数都是默认的，请根据实际情况变更通道的属性；默认添加的是采集通道，请手动改为转发通道；
通道属性说明详见新增采集通道，此处不再赘述。
添加转发设备¶
在左侧树选中刚刚添加的通道，点击添加按钮，可以在这个通道下添加设备，也可以输入数量后再添加，这样可以一次性添加多个设备，如下图：
也可以点击批量添加(转发)按钮，选择已有的采集设备进行添加，会自动添加对应采集设备下的采集测点为转发点，如下图：
添加转发测点¶
在左侧树选中刚刚添加的设备，点击添加按钮，在弹出窗口中选择已有的采集点进行添加，如下图：
测点属性说明详见新增采集测点，此处不再赘述。
注意
添加完转发测点后，务必按照所使用的协议要求，对转发功能码、寄存器地址、数据类型、数据格式等进行修改！
常用操作(重要)¶
复制、粘贴¶
选中一个通道，点击复制按钮，然后点击粘贴按钮，可以快速的将建好的通道进行克隆；
设备与测点也支持复制、粘贴操作。
提示
本工具支持和excel相互进行复制粘贴操作。
批量操作¶
选中一列数据，点击右键，可以进行递增、递减、相同、全是、全否等操作，递增、递减支持设置步长；
所有的属性都支持上述批量操作。
5.实时监控与调试工具¶
软件界面¶
上方是运行信息以及工程信息展示，左侧是通道、设备树节点，树节点前的圆点标识其当前状态(红色异常、黄色初始化中、绿色正常)，右侧为实时数据、通道监测、通道信息展示界面。
实时数据¶
查看¶
点击左侧树状图中的设备节点，可以切换展示该设备下的实时数据，变量值为当前测点采集到的数值，质量显示好意为值有效，显示坏意为通讯中断；
如果时间一列不再更新或显示空白，说明本软件和下位机通讯失败，请在左上角操作菜单中点击重新连接。
写值¶
双击测点的变量值单元格，可以直接写值，推荐使用此方法；
右键点击目标测点，可以调出写值菜单，说明如下：
| 属性名 | 说明 |
|---|---|
| 直接写值 | 将某一个值写入到目标测点中，且会下发至目标设备，大多数场合下推荐使用此功能 |
| 偏移写值 | 在当前值上加上/减去某一个值，且会下发至目标设备 |
| 随机写值 | 随机写入一个值，仅写入到内存中，不会下发至目标设备，点击取消人工置数即可取消 |
| 递增(递减) | 按照一定的频率进行递增递减，仅写入到内存中，不会下发至目标设备，点击取消人工置数即可取消 |
| 人工置数 | 将某一个值写入到目标测点中，仅写入到内存中，不会下发至目标设备，点击取消人工置数即可取消 |
| 遥控 | 只有部分IEC协议(例如IEC104)支持此功能，其它协议请使用直接写值功能 |
| 遥调 | 只有部分IEC协议(例如IEC104)支持此功能，其它协议请使用直接写值功能 |
通道监测¶
点击左侧树状图中的通道节点，会自动跳转到通道监测页面，点击开启监测按钮，则会对该通道的报文进行监测，点击关闭监测按钮，停止监测；
点击清空列表按钮，清空当前界面报文；
点击停止滚动按钮，那么当前页面会停止滚动到最新一条报文；
选中某条报文，点击复制按钮，可以复制报文到剪切板；
只有部分IEC协议(例如IEC104)支持总召、对时、测试帧等功能；
点击开始存盘按钮，选择报文保存的路径，可以将报文保存到本地。
通道信息¶
点击通道信息标签页，可以概览通道的协议、状态、接口等信息；
排查异常时，状态信息仅供参考，请结合通道监测功能做进一步判断。
6.特殊功能配置¶
提示
遥控遥调需要下位机软件版本>=1.3.44支持。
遥控遥调¶
说明¶
当使用modbusrtu采集(或modbustcp采集)、104转发时，由于modbus协议没有选择这一步骤，此时我们选中目标遥控测点，点击遥控遥调按钮，在弹出的对话框中可以配置选择执行或者直接执行，并且可以把遥调命令过来的值写到另一个指定的寄存器里去；遥控同理。
关联测点¶
说明¶
当使用modbusrtu采集时，可以设置遥控遥调使能点(计算点或真实点均可)，选中目标遥控测点，点击关联测点按钮，在弹出的对话框中输入使能点名称，并选择运算符、输入值，当右侧逻辑满足时，允许控制，否则不允许控制，如下图当使能点的值>=1时，允许进行有功功率设置；遥控同理。
群控群调¶
说明¶
在一些逆变器的控制中，要用到群控群调功能。如某个光伏站接入了10个逆变器，调度需要对有功功率进行调节，比如1MW，需要分配给每个逆变器的有功功率就是1M/10=1000kW。这时就需要用到群调功能，配置方法如下：
-
在任意采集通道建立一个计算点，命名为"总遥调"作为转发给调度的遥调点；
-
选中"总遥调"测点，点击公式计算按钮；
-
在弹出的对话框中，选中需要执行遥调的源通道以及源设备，并通过检索功能把相关的遥调测点找出来，然后点击群调(平均值)按钮，把相应的遥调点加入的计算即可；
-
群控(相等)是指接每个逆变器的遥调值=总遥调值，群控是每个逆变器的遥控值=总遥控值，配置方法同上。
提示
公式计算配置界面可能会因为电脑屏幕分辨率问题右侧的显示框显示不了，可以把这个界面纵向拉长点解决这个问题。
Ended: 本地配置
Ended: 开始使用
驱动帮助 ↵
PLC/CNC ↵
西门子(Siemens) ↵
S7-200¶
云端配置(西门子S7-200/200smart)¶
新建通道¶
新建一个采集通道，协议选择S7-200/200smart，IP地址填写PLC的IP地址，端口号默认102。
注意
PLC一次性读取的寄存器个数有数量限制，建议在规约特征里配置单帧寄存器最大个数以实现自动分组。
新建设备¶
新建一个设备，自定义设备名称，设备的通讯地址填写PLC的TSAP，例如网关采集端的TSAP(源)为10.01，PLC端TSAP(目的)为10.04，那么在“通讯地址”处填写“10011004”，其余参数留空。
提示
TSAP由两个字节组成，第一个字节表示连接数，第二个字节是机架号和CPU槽号;
例如0201，02代表允许2个链接，0代表0号机架、1代表1号插槽；
假设PLC的TSAP为1003，如果通讯地址填02011003连接不上，那么减小PLC的TSAP的连接数再试，例如02010303。
注意
如果不知道TSAP信息的，那么填写02010201即可。
新建测点¶
DB寄存器¶
已知一个测点的寄存类型为DB寄存器(也叫VS寄存器、VD寄存器、VW寄存器、VB寄存器)，寄存器地址为100，数据类型为real，
那么在基本属性页，功能码选择DB寄存器，地址填100，数据格式选择1234，数据类型选择单精度浮点数;
提示
PI寄存器的建点过程同DB寄存器一致。
关于数据类型
在西门子PLC中，VD是双字(32位)，VW是字(16位)，VB是字节(8位)，VD0包含了VW0和VW2，包含了VB0、VB1、VB2、VB3，以此类推，它们在PLC中使用的是同一片内存；所以它们的功能码都选择DB寄存器，数据类型上VD选32位有/无符号或单精度浮点数，VW选16位有/无符号，VB选8位有/无符号，数据格式根据实际情况选择，寄存器地址则按照原样填写。
M寄存器¶
已知一个测点的寄存类型为M寄存器，寄存器地址为10、按位取3(在PLC编程软件中为M10.3)，
那么在基本属性页，功能码选择M寄存器，地址填10，数据格式选择12，数据类型为8位无符号，在高级设置页中，勾选按位取值，起始位和终止位都选3。
提示
I寄存器、Q寄存器的建点过程同M寄存器一致。
C寄存器¶
提示
T寄存器(计时器)的建点过程同C寄存器一致。
已知一个测点的寄存类型为C寄存器，寄存器地址为15，
那么在基本属性页，功能码选择C寄存器，地址填15，数据格式选择12，数据类型选择位时，读取该寄存器的开关(0或1)状态，数据类型选择16位有符号时，读取该寄存器的计数(计时)值。
本地配置(西门子S7-200/200smart)¶
新建通道¶
新建一个采集通道，协议选择S7-200/200smart，IP地址填写PLC的IP地址，端口号默认102。
注意
PLC一次性读取的寄存器个数有数量限制，建议在规约特征里配置单帧寄存器最大个数以实现自动分组。
新建设备¶
新建一个设备，自定义设备名称，设备的通讯地址填写PLC的TSAP，例如网关采集端的TSAP(源)为10.01，PLC端TSAP(目的)为10.04，那么在“通讯地址”处填写“10011004”，其余参数留空。
提示
TSAP由两个字节组成，第一个字节表示连接数，第二个字节是机架号和CPU槽号;
例如0201，02代表允许2个链接，0代表0号机架、1代表1号插槽；
假设PLC的TSAP为1003，如果通讯地址填02011003连接不上，那么减小PLC的TSAP的连接数再试，例如02010303。
注意
如果不知道TSAP信息的，那么填写02010201即可。
新建测点¶
DB寄存器¶
已知一个测点的寄存类型为DB寄存器(也叫VS寄存器、VD寄存器、VW寄存器、VB寄存器)，寄存器地址为100，数据类型为real，
那么添加一个测点，功能码选择DB寄存器，地址填100，高低位顺序选择1234，数据类型选择单精度浮点数;
提示
PI寄存器的建点过程同DB寄存器一致。
关于数据类型
在西门子PLC中，VD是双字(32位)，VW是字(16位)，VB是字节(8位)，VD0包含了VW0和VW2，包含了VB0、VB1、VB2、VB3，以此类推，它们在PLC中使用的是同一片内存；所以它们的功能码都选择DB寄存器，数据类型上VD选32位有/无符号或单精度浮点数，VW选16位有/无符号，VB选8位有/无符号，数据格式根据实际情况选择，寄存器地址则按照原样填写。
M寄存器¶
已知一个测点的寄存类型为M寄存器，寄存器地址为10、按位取3(在PLC编程软件中为M10.3)，
那么添加一个测点，功能码选择M寄存器，地址填10，数据格式选择12，数据类型为8位无符号，按位取值选择是，取值起始位和取值终止位都选3。
提示
I寄存器、Q寄存器的建点过程同M寄存器一致。
C寄存器¶
提示
T寄存器(计时器)的建点过程同C寄存器一致。
已知一个测点的寄存类型为C寄存器，寄存器地址为15，
那么在基本属性页，功能码选择C寄存器，地址填15，数据格式选择12，数据类型选择位时，读取该寄存器的开关(0或1)状态，数据类型选择16位有符号时，读取该寄存器的计数(计时)值。
S7-200PPI¶
云端配置(西门子S7-200PPI)¶
新建通道¶
新建一个采集通道，协议选择西门子200(PPI)，主参数中，串口名称按照网关与PLC的DB9通讯接口的8，3引脚的接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，其它参数如无特殊要求保持默认即可。
注意
PLC一次性读取的寄存器个数有数量限制，建议在规约特征里配置单帧寄存器最大个数以实现自动分组。
新建设备¶
新建一个设备，自定义设备名称，设备的通讯地址填写PPI地址，例如PPI通信地址为1，那么在“通讯地址”处填写“1”，其余参数留空。
注意
如果不知道PPI地址的，那么填写-1即可，在这种情况下，驱动程序会从地址1-255进行逐个地址轮询。
新建测点¶
DB寄存器¶
已知一个测点的寄存类型为DB寄存器(也叫VS寄存器、VD寄存器、VW寄存器、VB寄存器)，寄存器地址为100，数据类型为real，
那么在基本属性页，功能码选择DB寄存器，地址填100，数据格式选择1234，数据类型选择单精度浮点数;
提示
PI寄存器的建点过程同DB寄存器一致。
关于数据类型
在西门子PLC中，VD是双字(32位)，VW是字(16位)，VB是字节(8位)，VD0包含了VW0和VW2，包含了VB0、VB1、VB2、VB3，以此类推，它们在PLC中使用的是同一片内存；所以它们的功能码都选择DB寄存器，数据类型上VD选32位有/无符号或单精度浮点数，VW选16位有/无符号，VB选8位有/无符号，数据格式根据实际情况选择，寄存器地址则按照原样填写。
M寄存器¶
已知一个测点的寄存类型为M寄存器，寄存器地址为10、按位取3(在PLC编程软件中为M10.3)，
那么在基本属性页，功能码选择M寄存器，地址填10.3，数据格式选择12，数据类型为8位无符号。
提示
I寄存器、Q寄存器的建点过程同M寄存器一致。
本地配置(西门子S7-200PPI)¶
新建通道¶
新建一个采集通道，协议选择S7-200PPI，串口名称按照网关与PLC的DB9通讯接口的8，3引脚的接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，其它参数如无特殊要求保持默认即可。
注意
PLC一次性读取的寄存器个数有数量限制，建议在规约特征里配置单帧寄存器最大个数以实现自动分组。
新建设备¶
新建一个设备，自定义设备名称，设备的通讯地址填写PPI地址，例如PPI通信地址为1，那么在“通讯地址”处填写“1”，其余参数留空。
注意
如果不知道PPI地址的，那么填写-1即可，在这种情况下，驱动程序会从地址1-255进行逐个地址轮询。
新建测点¶
DB寄存器¶
已知一个测点的寄存类型为DB寄存器(也叫VS寄存器、VD寄存器、VW寄存器、VB寄存器)，寄存器地址为100，数据类型为real，
那么添加一个测点，功能码选择DB寄存器，地址填100，高低位顺序选择1234，数据类型选择单精度浮点数;
提示
PI寄存器的建点过程同DB寄存器一致。
关于数据类型
在西门子PLC中，VD是双字(32位)，VW是字(16位)，VB是字节(8位)，VD0包含了VW0和VW2，包含了VB0、VB1、VB2、VB3，以此类推，它们在PLC中使用的是同一片内存；所以它们的功能码都选择DB寄存器，数据类型上VD选32位有/无符号或单精度浮点数，VW选16位有/无符号，VB选8位有/无符号，数据格式根据实际情况选择，寄存器地址则按照原样填写。
M寄存器¶
已知一个测点的寄存类型为M寄存器，寄存器地址为10、按位取3(在PLC编程软件中为M10.3)，
那么添加一个测点，功能码选择M寄存器，地址填10.3，数据格式选择12，数据类型为8位无符号。
提示
I寄存器、Q寄存器的建点过程同M寄存器一致。
S7-300¶
云端配置(西门子S7-300/400)¶
新建通道¶
新建一个采集通道，协议选择S7-300/400，IP地址填写PLC的IP地址，端口号默认102。
注意
PLC一次性读取的寄存器个数有数量限制，建议在规约特征里配置单帧寄存器最大个数以实现自动分组。
新建设备¶
新建一个设备，自定义设备名称，设备的通讯地址填写PLC的TSAP，例如网关采集端的TSAP(源)为02.01，PLC端TSAP(目的)为10.04，那么在“通讯地址”处填写“02011004”，其余参数留空。
提示
TSAP由两个字节组成，第一个字节表示连接数，第二个字节是机架号和CPU槽号;
例如0201，02代表允许2个链接，0代表0号机架、1代表1号插槽；
假设PLC的TSAP为1003，如果通讯地址填02011003连接不上，那么减小PLC的TSAP的连接数再试，例如02010303。
注意
如果不知道TSAP信息的，那么填写02010201即可。
新建测点¶
DB寄存器¶
已知一个测点的寄存类型为DB寄存器(也叫VS寄存器、VD寄存器、VW寄存器、VB寄存器)，DB块编号为20，寄存器地址为124，数据类型为real，
那么在基本属性页，功能码选择DB寄存器，地址填20.124，数据格式选择1234，数据类型选择单精度浮点数;
提示
PI寄存器的建点过程同DB寄存器一致。
关于数据类型
在西门子PLC中，VD是双字(32位)，VW是字(16位)，VB是字节(8位)，VD0包含了VW0和VW2，包含了VB0、VB1、VB2、VB3，以此类推，它们在PLC中使用的是同一片内存；所以它们的功能码都选择DB寄存器，数据类型上VD选32位有/无符号或单精度浮点数，VW选16位有/无符号，VB选8位有/无符号，数据格式根据实际情况选择，寄存器地址则按照原样填写。
M寄存器¶
已知一个测点的寄存类型为M寄存器，寄存器地址为10、按位取3(在PLC编程软件中为M10.3)，
那么在基本属性页，功能码选择M寄存器，地址填10，数据格式选择12，数据类型为8位无符号，在高级设置页中，勾选按位取值，起始位和终止位都选3。
提示
I寄存器、Q寄存器、DBX寄存器(即先读取DB寄存器里的值再对其进行按位取值)的建点过程同M寄存器一致。
重要提示
下位机软件版本≥1.3.58时，上述M寄存器例子支持直接在地址处填写10.3，自动按位取值，此时数据类型要选择16位无符号，无需再在高级设置页手动配置按位取值了。
本地配置(西门子S7-300/400)¶
新建通道¶
新建一个采集通道，协议选择S7-300/400，IP地址填写PLC的IP地址，端口号默认102。
注意
PLC一次性读取的寄存器个数有数量限制，建议在规约特征里配置单帧寄存器最大个数以实现自动分组。
新建设备¶
新建一个设备，自定义设备名称，设备的通讯地址填写PLC的TSAP，例如网关采集端的TSAP(源)为10.01，PLC端TSAP(目的)为10.04，那么在“通讯地址”处填写“10011004”，其余参数留空(如果不知道TSAP信息的，那么填写02010201即可)。
提示
TSAP由两个字节组成，第一个字节表示连接数，第二个字节是机架号和CPU槽号;
例如0201，02代表允许2个链接，0代表0号机架、1代表1号插槽；
假设PLC的TSAP为1003，如果通讯地址填02011003连接不上，那么减小PLC的TSAP的连接数再试，例如02010303。
注意
如果不知道TSAP信息的，那么填写02010201即可。
新建测点¶
DB寄存器¶
已知一个测点的寄存类型为DB寄存器(也叫VS寄存器、VD寄存器、VW寄存器、VB寄存器)，DB块编号为20，寄存器地址为124，数据类型为real，
那么在基本属性页，功能码选择DB寄存器，地址填20.124，数据格式选择1234，数据类型选择单精度浮点数;
提示
PI寄存器的建点过程同DB寄存器一致。
关于数据类型
在西门子PLC中，VD是双字(32位)，VW是字(16位)，VB是字节(8位)，VD0包含了VW0和VW2，包含了VB0、VB1、VB2、VB3，以此类推，它们在PLC中使用的是同一片内存；所以它们的功能码都选择DB寄存器，数据类型上VD选32位有/无符号或单精度浮点数，VW选16位有/无符号，VB选8位有/无符号，数据格式根据实际情况选择，寄存器地址则按照原样填写。
M寄存器¶
已知一个测点的寄存类型为M寄存器，寄存器地址为10、按位取3(在PLC编程软件中为M10.3)，
那么添加一个测点，功能码选择M寄存器，地址填10，数据格式选择12，数据类型为8位无符号，按位取值选择是，取值起始位和取值终止位都选3。
提示
I寄存器、Q寄存器、DBX寄存器(即先读取DB寄存器里的值再对其进行按位取值)的建点过程同M寄存器一致。
重要提示
下位机软件版本≥1.3.58时，上述M寄存器例子支持直接在地址处填写10.3，自动按位取值，此时数据类型要选择16位无符号，无需再手动配置按位取值了。
S7-1200¶
云端配置(西门子S7-1200)¶
新建通道¶
新建一个采集通道，协议选择S7-1200，IP地址填写PLC的IP地址，端口号默认102。
注意
PLC一次性读取的寄存器个数有数量限制，建议在规约特征里配置单帧寄存器最大个数以实现自动分组。
注意
若数据采集不到，且查看通道监测报文，有报文交互，但是一直重连，
那么请检查：
1、PLC编程软件是否开启允许来自远程对象的PUT/GET通信访问；
2、检查属性->常规->连接资源中，S7通信的最大连接数，对应PLC的TSAP参数的最大连接数。
配置完成，下载后到PLC后生效！
提示
TSAP由两个字节组成，第一个字节表示连接数，第二个字节是机架号和CPU槽号;
例如0201，02代表允许2个链接，0代表0号机架、1代表1号插槽；
假设PLC的TSAP为1003，如果通讯地址填02011003连接不上，那么减小PLC的TSAP的连接数再试，例如02010303。
剩余步骤请参照西门子S7-300的配置过程。
本地配置(西门子S7-1200)¶
新建通道¶
新建一个采集通道，协议选择S7-1200，IP地址填写PLC的IP地址，端口号默认102。
注意
PLC一次性读取的寄存器个数有数量限制，建议在规约特征里配置单帧寄存器最大个数以实现自动分组。
注意
若数据采集不到，且查看通道监测报文，有报文交互，但是一直重连，
那么请检查：
1、PLC编程软件是否开启允许来自远程对象的PUT/GET通信访问；
2、检查属性->常规->连接资源中，S7通信的最大连接数，对应PLC的TSAP参数的最大连接数。
配置完成，下载后到PLC后生效！
提示
TSAP由两个字节组成，第一个字节表示连接数，第二个字节是机架号和CPU槽号;
例如0201，02代表允许2个链接，0代表0号机架、1代表1号插槽；
假设PLC的TSAP为1003，如果通讯地址填02011003连接不上，那么减小PLC的TSAP的连接数再试，例如02010303。
剩余步骤请参照西门子S7-300的配置过程。
S7-1500¶
云端配置(西门子S7-1500)¶
新建通道¶
新建一个采集通道，协议选择S7-1500，IP地址填写PLC的IP地址，端口号默认102。
注意
PLC一次性读取的寄存器个数有数量限制，建议在规约特征里配置单帧寄存器最大个数以实现自动分组。
注意
若数据采集不到，且查看通道监测报文，有报文交互，但是一直重连，
那么请检查：
1、PLC编程软件是否开启允许来自远程对象的PUT/GET通信访问；
2、检查属性->常规->连接资源中，S7通信的最大连接数，对应PLC的TSAP参数的最大连接数。
配置完成，下载后到PLC后生效！
提示
TSAP由两个字节组成，第一个字节表示连接数，第二个字节是机架号和CPU槽号;
例如0201，02代表允许2个链接，0代表0号机架、1代表1号插槽；
假设PLC的TSAP为1003，如果通讯地址填02011003连接不上，那么减小PLC的TSAP的连接数再试，例如02010303。
剩余步骤请参照西门子S7-300的配置过程。
本地配置(西门子S7-1500)¶
新建通道¶
新建一个采集通道，协议选择S7-1500，IP地址填写PLC的IP地址，端口号默认102。
注意
PLC一次性读取的寄存器个数有数量限制，建议在规约特征里配置单帧寄存器最大个数以实现自动分组。
注意
若数据采集不到，且查看通道监测报文，有报文交互，但是一直重连，
那么请检查：
1、PLC编程软件是否开启允许来自远程对象的PUT/GET通信访问；
2、检查属性->常规->连接资源中，S7通信的最大连接数，对应PLC的TSAP参数的最大连接数。
配置完成，下载后到PLC后生效！
提示
TSAP由两个字节组成，第一个字节表示连接数，第二个字节是机架号和CPU槽号;
例如0201，02代表允许2个链接，0代表0号机架、1代表1号插槽；
假设PLC的TSAP为1003，如果通讯地址填02011003连接不上，那么减小PLC的TSAP的连接数再试，例如02010303。
剩余步骤请参照西门子S7-300的配置过程。
Ended: 西门子(Siemens)
松下电工(Matsushita) ↵
松下FP系列PLC¶
云端配置(松下FP系列PLC)¶
新建通道¶
新建一个采集通道，协议选择松下FP系列PLC，串口名称以实际情况为准，其它参数通常保持默认即可；
新建设备¶
自定义设备名称，设备的通讯地址填写PLC的站号。
新建测点¶
R寄存器¶
举例采集一个R8寄存器(见下图梯形图红框处)，那么新建一个测点，功能码选择R(内部继电器)，地址为0，数据类型选择16位有/无符号(以实际情况为准)，数据格式选择21，在高级设置中，勾选按位取值，取值起始位8，终止位8;
地址换算
注1：R寄存器1个采集分组内，寄存器地址最大值最小值相差不能大于10(不含)；
注2：地址换算公式：x / 10 = y … z(x除以常数10得y余数z)，x为梯形图内寄存器编号，y为采集测点地址，z为采集测点按位取值，例如R21寄存器，21 / 10 = 2 … 1，那么采集测点地址为2，按位取值为1；
注3：X、Y、L寄存器建点过程和R寄存器相同；
注4：T、C寄存器建点过程和R相同，仅在地址换算时常数10改为16，即地址换算公式为：x / 16 = y … z；
DT寄存器¶
举例采集一个DT25寄存器(见下图梯形图红框处)，那么新建一个测点，功能码选择D(数据寄存器DT)，地址为25，数据类型选择16位有/无符号，数据格式通常选择21(以实际情况为准);
提示
LD、FL、WX、WY、WR、WL寄存器建点过程和DT寄存器相同；
如果数据类型是32位有/无符号或者单精度浮点数，那么数据格式通常选择4321(以实际情况为准)；
本地配置(松下FP系列PLC)¶
新建通道¶
新建一个采集通道，协议选择松下FP系列PLC，串口名称以实际情况为准，其它参数通常保持默认即可；
新建设备¶
自定义设备名称，设备的通讯地址填写PLC的站号。
新建测点¶
R寄存器¶
举例采集一个R8寄存器(见下图梯形图红框处)，那么新建一个测点，功能码选择R(内部继电器)，地址为0，数据类型选择16位有/无符号(以实际情况为准)，数据格式选择21，在高级设置中，勾选按位取值，取值起始位8，终止位8;
地址换算
注1：R寄存器1个采集分组内，寄存器地址最大值最小值相差不能大于10(不含)；
注2：地址换算公式：x / 10 = y … z(x除以常数10得y余数z)，x为梯形图内寄存器编号，y为采集测点地址，z为采集测点按位取值，例如R21寄存器，21 / 10 = 2 … 1，那么采集测点地址为2，按位取值为1；
注3：X、Y、L寄存器建点过程和R寄存器相同；
注4：T、C寄存器建点过程和R相同，仅在地址换算时常数10改为16，即地址换算公式为：x / 16 = y … z；
DT寄存器¶
举例采集一个DT25寄存器(见下图梯形图红框处)，那么新建一个测点，功能码选择D(数据寄存器DT)，地址为25，数据类型选择16位有/无符号，高低位顺序通常选择21(以实际情况为准);
提示
LD、FL、WX、WY、WR、WL寄存器建点过程和DT寄存器相同；
如果数据类型是32位有/无符号或者单精度浮点数，那么数据格式通常选择4321(以实际情况为准)；
Ended: 松下电工(Matsushita)
通用电气(GeneralElectric) ↵
GE-SRTP¶
云端配置(GE-SRTP)¶
新建通道¶
新建一个采集通道，协议选择GE-SRTP(通用电气)，IP地址填写PLC的IP地址，端口号通常保持默认即可；
新建设备¶
自定义设备名称，其余参数保持默认；
新建测点¶
%R寄存器¶
举例采集一个%R寄存器地址为15，那么新建一个测点，功能码选择%R(寄存器)，地址为15，数据类型选择单精度浮点数(以实际情况为准)，数据格式选择4321；
提示
当采集%R寄存器数据类型为16位有/无符号时，数据格式一般选择21。
注意
%R寄存器1个采集分组内，寄存器地址最大值最小值相差不能大于100(不含)，超过100的需要分组。
%Q寄存器¶
举例采集一个%Q寄存器地址为311，那么新建一个测点，功能码选择%Q(离散输出)，地址为311，数据类型选择位，数据格式选择12；
提示
注：%I、%M、%S、%G寄存器建点过程和%Q寄存器相同；
本地配置(GE-SRTP)¶
新建通道¶
新建一个采集通道，协议选择GE-SRTP(通用电气)，IP地址填写PLC的IP地址，端口号通常保持默认即可；
新建设备¶
自定义设备名称，其余参数保持默认；
新建测点¶
%R寄存器¶
举例采集一个%R寄存器地址为15，那么新建一个测点，功能码选择%R(寄存器)，地址为15，数据类型选择单精度浮点数(以实际情况为准)，数据格式选择4321；
提示
当采集%R寄存器数据类型为16位有/无符号时，数据格式一般选择21。
注意
%R寄存器1个采集分组内，寄存器地址最大值最小值相差不能大于100(不含)，超过100的需要分组。
%Q寄存器¶
举例采集一个%Q寄存器地址为311，那么新建一个测点，功能码选择%Q(离散输出)，地址为311，数据类型选择位，数据格式选择12；
提示
注：%I、%M、%S、%G寄存器建点过程和%Q寄存器相同；
Ended: 通用电气(GeneralElectric)
欧姆龙(Omron) ↵
Omron-HostLink¶
云端配置(Omron-HostLink(FINS))¶
新建通道¶
新建一个采集通道，协议选择Omron-HostLink(FINS)(欧姆龙TCP协议)，IP地址填写PLC的IP地址，端口号默认9600；
新建设备¶
自定义设备名称，其余参数保持默认；
新建测点¶
CIO寄存器¶
举例采集一个地址为0.05的CIO寄存器(0CH通道下第5个IO点)，那么新建一个测点，功能码选择CIO，地址填0.5，数据类型选择16位无符号，数据格式选择12;
提示
IR、DR建点过程和CIO一致。
注意
连续读寄存器最大最小值相差不能大于48。
DM寄存器¶
举例采集一个地址为2的DM寄存器(即D寄存器)，那么新建一个测点，功能码选择DM，地址填2，数据类型选择16位有符号(以实际情况为准)，数据格式选择12;
提示
注1:WR、HR、AR建点过程和DM一致。
注2:数据类型如果为单精度浮点数或32位有/无符号，那么数据格式为1234；
注3:数据类型如果为布尔型(Boolean)，那么数据类型选择位，寄存器地址填写格式为a.b，a为PLC中的地址，b位按位取值的位数。
本地配置(Omron-HostLink(FINS))¶
新建通道¶
新建一个采集通道，协议选择Omron-HostLink(FINS)(欧姆龙TCP协议)，IP地址填写PLC的IP地址，端口号默认9600；
新建设备¶
自定义设备名称，其余参数保持默认；
新建测点¶
CIO寄存器¶
举例采集一个地址为0.05的CIO寄存器(0CH通道下第5个IO点)，那么新建一个测点，功能码选择CIO，地址填0.5，数据类型选择16位无符号，数据格式选择12;
提示
IR、DR建点过程和CIO一致。
注意
连续读寄存器最大最小值相差不能大于48。
DM寄存器¶
举例采集一个地址为2的DM寄存器(即D寄存器)，那么新建一个测点，功能码选择DM，地址填2，数据类型选择16位有符号(以实际情况为准)，数据格式选择12;
提示
注1:WR、HR、AR建点过程和DM一致；
注2:数据类型如果为单精度浮点数或32位有/无符号，那么数据格式为1234；
注3:数据类型如果为布尔型(Boolean)，那么数据类型选择位，寄存器地址填写格式为a.b，a为PLC中的地址，b位按位取值的位数。
编程软件配置¶
如果出现网关能ping通PLC，但是打不开PLC端口的情况，那么在编程软件中，PLC设定->串口1->通信设置->模式，选择Host Link。
提示
不管是串口通信还是网口通信，都要选择Host Link模式，下图仅仅展示串口通信情况下的设置。
下图为PLC功能码与数据类型说明：
Omron-HostLink串口¶
云端配置(Omron-HostLink(串口))¶
新建通道¶
新建一个采集通道，协议选择Omron-HostLink(串口)(欧姆龙串口协议)，串口的默认参数为标准配置，根据实际情况更改；
新建设备¶
自定义设备名称，设备通讯地址即为PLC单元号(通常为0，本例中为1)，其余参数保持默认；
新建测点¶
CIO寄存器¶
举例采集一个地址为0.05的CIO寄存器(0CH通道下第5个IO点)，那么新建一个测点，功能码选择CIO，地址填0.5，数据类型选择位，数据格式选择21;
提示
IR建点过程和CIO一致；暂不支持TC计数器状态采集。
DM寄存器¶
举例采集一个地址为2的DM寄存器(即D寄存器)，那么新建一个测点，功能码选择DM，地址填2，数据类型选择16位有符号(以实际情况为准)，数据格式选择21;
提示
注1：HR、AR、LR、CH建点过程和DM一致。
注2：数据类型如果为单精度浮点数或32位有/无符号，那么数据格式为3412；
注3：PV计时器的数据类型应该选择16位BCD，数据格式为21，暂不支持计数器采集；
注4：使用DM寄存器采集字符串时，数据格式选择12，若实际字符串长度为8(字符串长度必须为偶数)，应在采集测点的系数里填写字符串长度16。
本地配置(Omron-HostLink(串口))¶
新建通道¶
新建一个采集通道，协议选择Omron-HostLink(串口)(欧姆龙串口协议)，串口的默认参数为标准配置，根据实际情况更改；
新建设备¶
自定义设备名称，设备通讯地址即为PLC单元号(通常为0，本例中为1)，其余参数保持默认；
新建测点¶
CIO寄存器¶
举例采集一个地址为0.05的CIO寄存器(0CH通道下第5个IO点)，那么新建一个测点，功能码选择CIO，地址填0.5，数据类型选择位，数据格式选择21;
提示
IR建点过程和CIO一致；暂不支持TC计数器状态采集。
DM寄存器¶
举例采集一个地址为2的DM寄存器(即D寄存器)，那么新建一个测点，功能码选择DM，地址填2，数据类型选择16位有符号(以实际情况为准)，数据格式选择21;
提示
注1：HR、AR、LR、CH建点过程和DM一致。
注2：数据类型如果为单精度浮点数或32位有/无符号，那么数据格式为3412；
注3：PV计时器的数据类型应该选择16位BCD，数据格式为21，暂不支持计数器采集；
注4：使用DM寄存器采集字符串时，数据格式选择12，若实际字符串长度为8(字符串长度必须为偶数)，应在采集测点的系数里填写字符串长度16。
编程软件配置¶
在编程软件中，PLC设定->串口1->通信设置->模式，选择Host Link，配置在串口1还是串口2上根据实际情况而定。
下图为PLC功能码与数据类型说明：
接线方式¶
1、从CP1W-CIF11扩展串口(5pin端子)接，RDA-接RS485-，RDB+接RS485+；模块背后拨码开关2、3、5、6拨到ON，1、4拨到OFF(1为终端电阻)；
2、从CP1W-CIF01扩展串口(DB9头)接，需要422转232线缆。
Omron-EIP¶
云端配置(Omron-EIP)¶
新建通道¶
新建一个采集通道，协议选择Omron-EIP(欧姆龙)，IP地址填写PLC的IP地址，端口号默认44818；
提示
本驱动为欧姆龙Ethernet/IP通信协议，可以通过标签的形式采集PLC(例如omron-NX1P)的数据，PLC的标签数据请在编程软件SysmacStudio中的全局变量里查看。
新建设备¶
自定义设备名称，其余参数保持默认；
新建测点¶
PLC-网关测点类型对照表¶
| PLC数据类型 | 网关测点数据类型 |
|---|---|
| BOOL | 位 |
| SINT | 8位有符号 |
| INT | 16位有符号 |
| DINT | 32位有符号 |
| LINT | 64位有符号 |
| USINT | 8位无符号 |
| UINT | 16位无符号 |
| UDINT | 32位无符号 |
| ULINT | 64位无符号 |
| REAL | 单精度浮点数 |
| LREAL | 双精度浮点数 |
例1¶
举例采集PLC中一个名称为内圈总数、类型为DINT的标签名，那么新建一个测点，功能码选择读写数据(默认)，地址填内圈总数，按照PLC-网关测点类型对照表，DINT数据类型对应网关测点类型选择32位有符号，数据格式选择4321，根据实际需求修改系数、偏移;
例2¶
举例采集PLC中的数组结构的变量内沟径测量值移位、下标为2、类型为INT的寄存器，那么新建一个测点，功能码选择读写数据(默认)，地址填内沟径测量值移位[2]，数据类型选择16位有符号，数据格式选择21;
注意
所有数据类型的数据格式均为递减格式，如数据类型为32位有/无符号的数据格式选择4321，16位有/无符号的数据格式选择21。
提示
采集数组点时，格式为数组名[下标]，例如GROUP1[3]。
采集结构体点时，格式为结构体名.成员名，例如GROUP1.CS003。
本地配置(Omron-EIP)¶
新建通道¶
新建一个采集通道，协议选择Omron-EIP(欧姆龙)，IP地址填写PLC的IP地址，端口号默认44818；
提示
本驱动为欧姆龙Ethernet/IP通信协议，可以通过标签的形式采集PLC(例如omron-NX1P)的数据，PLC的标签数据请在编程软件SysmacStudio中的全局变量里查看。
新建设备¶
在左侧任务树中选中通道，新建一个设备，自定义设备名称，其余参数保持默认；
新建测点¶
例1¶
举例采集PLC中一个名称为内圈总数、类型为DINT的标签名，那么新建一个测点，功能码选择读写数据(默认)，地址填内圈总数，按照PLC-网关测点类型对照表，DINT数据类型对应网关测点类型选择32位有符号，高低位顺序格式选择4321，根据实际需求修改系数、偏移;
例2¶
举例采集PLC中的INT型数组结构的变量内沟径测量值移位、下标为2、类型为INT的寄存器，那么新建一个测点，功能码选择读写数据(默认)，地址填内沟径测量值移位[2]，数据类型选择16位有符号，数据格式选择21;
注意
所有数据类型的高低位顺序均为递减格式，如数据类型为32位有/无符号的数据格式选择4321，16位有/无符号的数据格式选择21。
提示
采集数组点时，格式为数组名[下标]，例如GROUP1[3]。
采集结构体点时，格式为结构体名.成员名，例如GROUP1.CS003。
Ended: 欧姆龙(Omron)
罗克韦尔(Rockwell) ↵
ControlLogix¶
云端配置(ControlLogix)¶
新建通道¶
新建一个采集通道，协议选择ControlLogix(罗克韦尔)，IP地址填写PLC的IP地址，端口号默认44818；
新建设备¶
自定义设备名称，其余参数保持默认；
新建测点¶
例1¶
举例采集一个地址为CS001、类型为BOOL型的寄存器，那么新建一个测点，功能码选择读/写命令，地址填CS001，数据类型选择位(以实际情况为准)，数据格式选择12(默认即可);
例2¶
举例采集一个地址为GROUP1.CS003、类型为REAL型的寄存器，那么新建一个测点，功能码选择读/写命令，地址填GROUP1.CS003，数据类型选择单精度浮点数(以实际情况为准)，数据格式选择4321;
提示
数据类型为32位有/无符号的数据格式选择4321，16位有/无符号的数据格式选择21。
采集数组点时，按照原标签填写即可，例如GROUP1[3].CS003。
本地配置(ControlLogix)¶
新建通道¶
新建一个采集通道，协议选择ControlLogix(罗克韦尔)，IP地址填写PLC的IP地址，端口号默认44818；
新建设备¶
自定义设备名称，其余参数保持默认；
新建测点¶
例1¶
举例采集一个地址为CS001、类型为BOOL型的寄存器，那么新建一个测点，功能码选择读/写命令，地址填CS001，数据类型选择位(以实际情况为准)，数据格式选择12(默认即可);
例2¶
举例采集一个地址为GROUP1.CS003、类型为REAL型的寄存器，那么新建一个测点，功能码选择读/写命令，地址填GROUP1.CS003，数据类型选择单精度浮点数(以实际情况为准)，数据格式选择4321;
提示
数据类型为32位有/无符号的数据格式选择4321，16位有/无符号的数据格式选择21。
采集数组点时，按照原标签填写即可，例如GROUP1[3].CS003。
ControlLogix-PCCC¶
云端配置(CIP-PCCC)¶
新建通道¶
新建一个采集通道，协议选择CIP-PCCC(罗克韦尔)，IP地址填写PLC的IP地址，端口号默认44818；
新建设备¶
自定义设备名称，其余参数保持默认；
新建测点¶
提示
B寄存器和N寄存器的数据地址格式为B28:0/4，首个字母"B"为寄存器类型，对应采集功能码。"28"为文件编号，对应采集分组。冒号后面"0"为元素编号，对应寄存器地址。斜杠后"4"为偏移，说明数据为二进制类型(位)，对应开启按位取值，填写偏移。如果没有斜杠后的偏移，说明数据类型为16位类型，根据实际情况选择。所有数据格式都要选择大端格式，21或4321。
B寄存器¶
举例采集一个地址为B28:0/4、类型为二进制的寄存器，那么新建一个测点，功能码选择B寄存器，采集分组填28，寄存器地址填0，数据类型选择位，数据格式选择21。在高级设置中勾选按位取值，起始位和终止位填写4;
N寄存器¶
举例采集一个地址为N152:4、类型为无符号16位的寄存器，那么新建一个测点，功能码选择N寄存器，采集分组填152，寄存器地址填4，数据类型选择16位无符号，数据格式选择21;
T寄存器¶
提示
T寄存器数据地址格式为T28:0/DN，首个字母"T"为寄存器类型，对应采集功能码。"28"为文件编号，对应采集分组。冒号后面"0/DN"为元素编号和寄存器参数，对应寄存器地址，格式为0.DN。数据类型选择16位无符号，数据格式选择21。不同参数对应设置测点的按位取值如下：
DN:起始位和终止位填写13
TT:起始位和终止位填写14
EN:起始位和终止位填写15
PRE:无需填写
ACC:无需填写
举例采集一个地址为T28:0/DN，那么新建一个测点，功能码选择T寄存器，采集分组填28，寄存器地址填0.DN，数据类型选择16位无符号，数据格式选择21,在高级设置中勾选按位取值，起始位和终止位填写13;
举例采集一个地址为T28:0/PRE，那么新建一个测点，功能码选择T寄存器，采集分组填28，寄存器地址填0.PRE，数据类型选择16位无符号，数据格式选择21;
本地配置(CIP-PCCC)¶
新建通道¶
新建一个采集通道，协议选择CIP-PCCC(罗克韦尔)，IP地址填写PLC的IP地址，端口号默认44818；
新建设备¶
自定义设备名称，其余参数保持默认；
新建测点¶
提示
B寄存器和N寄存器的数据地址格式为B28:0/4，首个字母"B"为寄存器类型，对应采集功能码。"28"为文件编号，对应采集分组。冒号后面"0"为元素编号，对应寄存器地址。斜杠后"4"为偏移，说明数据为二进制类型(位)，对应开启按位取值，填写偏移。如果没有斜杠后的偏移，说明数据类型为16位类型，根据实际情况选择。所有数据格式都要选择大端格式，21或4321。
B寄存器¶
举例采集一个地址为B28:0/4、类型为二进制的寄存器，那么新建一个测点，功能码选择B寄存器，采集分组填28，寄存器地址填0，数据类型选择位，数据格式选择21。启用按位取值，起始位和终止位填写4;
N寄存器¶
举例采集一个地址为N152:4、类型为无符号16位的寄存器，那么新建一个测点，功能码选择N寄存器，采集分组填152，寄存器地址填4，数据类型选择16位无符号，数据格式选择21;
T寄存器¶
提示
T寄存器数据地址格式为T28:0/DN，首个字母"T"为寄存器类型，对应采集功能码。"28"为文件编号，对应采集分组。冒号后面"0/DN"为元素编号和寄存器参数，对应寄存器地址，格式为0.DN。数据类型选择16位无符号，数据格式选择21。不同参数对应设置测点的按位取值如下：
DN:起始位和终止位填写13
TT:起始位和终止位填写14
EN:起始位和终止位填写15
PRE:无需填写
ACC:无需填写
举例采集一个地址为T28:0/DN，那么新建一个测点，功能码选择T寄存器，采集分组填28，寄存器地址填0.DN，数据类型选择16位无符号，数据格式选择21，启用按位取值，起始位和终止位填写13;
举例采集一个地址为T28:0/PRE，那么新建一个测点，功能码选择T寄存器，采集分组填28，寄存器地址填0.PRE，数据类型选择16位无符号，数据格式选择21;
DF1¶
云端配置(DF1协议)¶
新建通道¶
新建一个采集通道，协议选择DF1协议，主参数中，串口名称按照网关接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，其它参数如无特殊要求保持默认即可。
注意
本驱动实现的是DF1协议中的全双工点对点通信部分。不支持半双工模式通信；
DF1协议中的测点是自动分组为主，即自动把测点按照功能码，数据类型和地址组合成一帧来读取；
为了避免报文过长可以手动修改测点的分组属性和在规约特征里配置单帧最大字节数(0不限制)来控制分组。
新建设备¶
新建一个设备，自定义设备名称，设备的通讯地址填写DF地址，例如DF通信地址为1，那么在“通讯地址”处填写“1”，其余参数留空。
新建测点¶
CSP寻址¶
DF1协议使用CSP寻址，即地址格式是:Axx:yy形式。A为描述数据表功能的字母,xx为表格编号,yy为表格中的元素后偏移量;在建立测点时，需要根据AB点表说明书上数据表名上的“CSP文件号”来确定地址。如读取AB点表的频率参数，其CSP地址为:F21:12。
提示
本驱动中的测点不需要填写数据表功能字母，即测点的地址格式是xx:yy。
故在建立测点读取频率参数，测点信息如下配置：
关于功能码和数据类型
在DF1协议中，最常用的是“三维数组”功能码，一般保持默认即可；
数据类型跟数据表功能的字母对应，如F21:12，中数据表功能的字母为F，其数据类型为浮点；其他如N为整数，EN,TT,DN为布尔型。
本地配置(DF1协议)¶
新建通道¶
新建一个采集通道，协议选择DF1协议，主参数中，串口名称按照网关接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，其它参数如无特殊要求保持默认即可。
注意
本驱动实现的是DF1协议中的全双工点对点通信部分。不支持半双工模式通信；
DF1协议中的测点是自动分组为主，即自动把测点按照功能码，数据类型和地址组合成一帧来读取；
为了避免报文过长可以手动修改测点的分组属性和在规约特征里配置单帧最大字节数(0不限制)来控制分组。
新建设备¶
新建一个设备，自定义设备名称，设备的通讯地址填写DF地址，例如DF通信地址为1，那么在“通讯地址”处填写“1”，其余参数留空。
新建测点¶
CSP寻址¶
DF1协议使用CSP寻址，即地址格式是:Axx:yy形式。A为描述数据表功能的字母,xx为表格编号,yy为表格中的元素后偏移量;在建立测点时，需要根据AB点表说明书上数据表名上的“CSP文件号”来确定地址。如读取AB点表的频率参数，其CSP地址为:F21:12。
提示
本驱动中的测点不需要填写数据表功能字母，即测点的地址格式是xx:yy。
关于功能码和数据类型
在DF1协议中，最常用的是“三维数组”功能码，一般保持默认即可；
数据类型跟数据表功能的字母对应，如F21:12，中数据表功能的字母为F，其数据类型为浮点；其他如N为整数，EN,TT,DN为布尔型。
Ended: 罗克韦尔(Rockwell)
三菱电机(Mitsubishi) ↵
三菱FX系列编程口¶
云端配置(三菱FX系列(编程口))¶
新建通道¶
新建一个采集通道，协议选择三菱FX系列(编程口)(此处编程口指三菱PLC的八针圆头RS422接口)，串口名称按照实际情况选择，其余参数保持默认即可；
新建设备¶
自定义设备名称，其余参数保持默认。
新建测点¶
M寄存器¶
举例采集一个M寄存器地址为217，那么新建一个测点，功能码选择M(辅助寄存器)，地址填217，数据类型选择位，数据格式选择12(默认即可);
提示
X、Y、S、T、C寄存器建点过程同M寄存器一致。
D寄存器¶
举例采集一个D寄存器地址为210，数据类型为REAL型，那么新建一个测点，功能码选择D(数据寄存器)，地址填210，数据类型选择单精度浮点数，数据格式选择4321;
提示
TN、CN寄存器建点过程同D寄存器一致；
数据类型为32位有/无符号的数据格式通常选择4321；
16位有/无符号的数据格式通常选择21。
本地配置(三菱FX系列(编程口))¶
新建通道¶
新建一个采集通道，协议选择三菱FX系列(编程口)(此处编程口指三菱PLC的八针圆头RS422接口)，串口名称按照实际情况选择，其余参数保持默认即可；
新建设备¶
自定义设备名称，其余参数保持默认。
新建测点¶
M寄存器¶
举例采集一个M寄存器地址为217，那么新建一个测点，功能码选择M(辅助寄存器)，地址填217，数据类型选择位 ，数据格式选择12(默认即可);
提示
X、Y、S、T、C寄存器建点过程同M寄存器一致。
D寄存器¶
举例采集一个D寄存器地址为210，数据类型为REAL型，那么新建一个测点，功能码选择D(数据寄存器)，地址填210，数据类型选择单精度浮点数，高低位顺序选择4321;
提示
TN、CN寄存器建点过程同D寄存器一致；
数据类型为32位有/无符号的数据格式通常选择4321；
16位有/无符号的数据格式通常选择21。
接线方式¶
通过编程口通信，无需使用编程软件对PLC进行配置，只需要一根转换线缆，8针圆头编程口转成RS232接口，即可和网关通信，即插即用，无需任何配置。
三菱FX系列扩展串口¶
云端配置(三菱FX系列(扩展串口))¶
新建通道¶
新建一个采集通道，协议选择三菱FX系列(扩展串口)(此处扩展串口指使用三菱的485-BD扩展模块)，串口名称按照实际情况选择，其余参数保持默认即可；
新建设备¶
自定义设备名称，设备通讯地址填写PLC站号，通常要填写0，其余参数保持默认。
新建测点¶
M寄存器¶
举例采集一个M寄存器地址为217，那么新建一个测点，功能码选择M(辅助寄存器)，地址填217，数据类型选择位，数据格式选择12(默认即可);
提示
X、Y、S、T、C寄存器建点过程同M寄存器一致。
D寄存器¶
举例采集一个D寄存器地址为210，数据类型为REAL型，那么新建一个测点，功能码选择D(数据寄存器)，地址填210，数据类型选择单精度浮点数，数据格式选择3412;
提示
TN、CN寄存器建点过程同D寄存器一致；
数据类型为32位有/无符号的数据格式通常选择3412；
16位有/无符号的数据格式通常选择21。
本地配置(三菱FX系列(扩展串口))¶
新建通道¶
新建一个采集通道，协议选择三菱FX系列(扩展串口)(此处扩展串口指使用三菱的485-BD扩展模块)，串口名称按照实际情况选择，其余参数保持默认即可；
新建设备¶
自定义设备名称，设备通讯地址填写PLC站号，通常要填写0，其余参数保持默认。
新建测点¶
M寄存器¶
举例采集一个M寄存器地址为217，那么新建一个测点，功能码选择M(辅助寄存器)，地址填217，数据类型选择位 ，数据格式选择12(默认即可);
提示
X、Y、S、T、C寄存器建点过程同M寄存器一致。
D寄存器¶
举例采集一个D寄存器地址为210，数据类型为REAL型，那么新建一个测点，功能码选择D(数据寄存器)，地址填210，数据类型选择单精度浮点数，高低位顺序选择3412;
提示
TN、CN寄存器建点过程同D寄存器一致；
数据类型为32位有/无符号的数据格式通常选择3412；
16位有/无符号的数据格式通常选择21。
编程软件配置¶
如果出现网关的通道监测有发送报文，但是收不到PLC回复的报文，那么按照下图设置：
1、使用编程线缆通过编程口(圆头8针)连接PLC和电脑，使用三菱编程软件搜索到PLC；
2、对PLC接口进行配置，其中，"CH1"根据实际接线到哪个串口进行选择，协议必须为"专用协议通信"，串口参数可以自定义，只需要与网关的通道配置相一致即可，H/W类型必须选择"RS-485"，"和校验"必须打钩，站号按需更改，传送控制步骤必须为"格式1(无CR,LF)"，保存设置后，下装回PLC，下装完成后断电重启PLC；
接线方式¶
通讯正常的情况下，模块的SD红灯与RD红灯会交替闪烁，表示报文正在交互，接线示意图如下：
三菱FX系列TCP¶
云端配置(三菱FX系列(TCP))¶
新建通道¶
新建一个采集通道，协议选择三菱FX系列(TCP)，IP地址按照实际情况填写，直连PLC时端口号通常为5551(或5556)，其余参数保持默认即可；
新建设备¶
自定义设备名称，其余参数保持默认。
新建测点¶
M寄存器¶
举例采集一个M寄存器地址为217，那么新建一个测点，功能码选择M(辅助寄存器)，地址填217，数据类型选择位，数据格式选择12(默认即可);
提示
X、Y、S、T、C寄存器建点过程同M寄存器一致。
D寄存器¶
举例采集一个D寄存器地址为217，数据类型为REAL型，那么新建一个测点，功能码选择D(数据寄存器)，地址填217，数据类型选择单精度浮点数，数据格式选择4321;
提示
数据类型为32位有/无符号的数据格式选择4321；
16位有/无符号的数据格式选择21。
本地配置(三菱FX系列(TCP))¶
新建通道¶
新建一个采集通道，协议选择三菱FX系列(TCP)，IP地址按照实际情况填写，直连PLC时端口号通常为5551(或5556)，其余参数保持默认即可；
新建设备¶
自定义设备名称，其余参数保持默认。
新建测点¶
M寄存器¶
举例采集一个M寄存器地址为217，那么新建一个测点，功能码选择M(辅助寄存器)，地址填217，数据类型选择位，数据格式选择12(默认即可);
提示
X、Y、S、T、C寄存器建点过程同M寄存器一致。
D寄存器¶
举例采集一个D寄存器地址为210，数据类型为REAL型，那么新建一个测点，功能码选择D(数据寄存器)，地址填210，数据类型选择单精度浮点数，高低位顺序选择4321;
提示
数据类型为32位有/无符号的数据格式选择4321；
16位有/无符号的数据格式选择21。
编程软件配置¶
如果出现网关能ping通PLC，但是打不开PLC端口的情况，那么按照下图设置：
1、电脑网线和PLC直连，使用三菱编程软件搜索到PLC；
2、设置PLC对外的通讯协议(其中本站端口号按需配置，并非必须是4999)，保存设置后，下装回PLC，下装完成后断电重启PLC。
三菱Q系列TCP¶
云端配置(三菱Q系列(TCP))¶
新建通道¶
新建一个采集通道，协议选择三菱Q系列(TCP)，IP地址填PLC的IP，端口号按照PLC编程软件里的配置填写，其余参数保持默认即可；
提示
本协议本质上是三菱MC协议，可切换二进制模式与ASCII模式，帧格式为3E帧，非1E帧、4E帧；
只要支持MC协议的PLC均可接入，不局限于Q系列。
新建设备¶
自定义设备名称，其余参数保持默认。
新建测点¶
M寄存器¶
举例采集一个M寄存器地址为130，那么新建一个测点，功能码选择M(辅助寄存器)，地址填130，通常情况下数据类型选择位，数据格式默认。
提示
X、Y、B、F、L、TS、TC、SS、SC、CS、CC寄存器建点过程同M寄存器一致。
D寄存器¶
举例采集一个D寄存器地址为6066，数据类型为32位无符号，那么新建一个测点，功能码选择D(通用寄存器)，地址填6066，数据类型选择32位无符号，数据格式选择3412;
提示
D数据类型通常为3412或21，请根据实际情况选择；
R寄存器的配置过程同D寄存器一致，其数据类型通常为4321。
本地配置(三菱Q系列(TCP))¶
新建通道¶
新建一个采集通道，协议选择三菱Q系列(TCP)，IP地址填PLC的IP，端口号按照PLC编程软件里的配置填写，其余参数保持默认即可；
提示
本协议本质上是三菱MC协议，可切换二进制模式与ASCII模式，帧格式为3E帧，非1E帧、4E帧；
只要支持MC协议的PLC均可接入，不局限于Q系列。
新建设备¶
自定义设备名称，其余参数保持默认。
新建测点¶
M寄存器¶
举例采集一个M寄存器地址为130，那么新建一个测点，功能码选择M(辅助寄存器)，地址填130，通常情况下数据类型选择位，数据格式默认。
提示
X、Y、B、F、L、TS、TC、SS、SC、CS、CC寄存器建点过程同M寄存器一致。
D寄存器¶
举例采集一个D寄存器地址为6066，数据类型为32位无符号，那么新建一个测点，功能码选择D(通用寄存器)，地址填6066，数据类型选择32位无符号，数据格式选择3412;
提示
D数据类型通常为3412或21，请根据实际情况选择；
R寄存器的配置过程同D寄存器一致，其数据类型通常为4321。
Ended: 三菱电机(Mitsubishi)
施耐德(Schneider) ↵
施耐德M218¶
云端配置(施耐德M218)¶
新建通道¶
新建一个采集通道，协议选择施耐德M218，IP地址按照实际情况填写，其余参数保持默认即可；
注意
PLC一次性读取的寄存器个数有数量限制，建议在规约特征里配置单帧寄存器最大个数以实现自动分组。
新建设备¶
自定义设备名称，按实际情况修改设备通讯地址，通常为1，其余参数保持默认。
新建测点¶
MW寄存器¶
举例采集一个MW寄存器地址为1000，那么新建一个测点，功能码选择MW寄存器，地址填1000，数据类型选择单精度浮点数(根据实际情况选择)，数据格式选择3412;
QX寄存器¶
举例采集一个QX寄存器地址为1010.6，那么在基本属性页，功能码选择QX寄存器，地址填1010，数据类型选择8位无符号，数据格式选择12(保持默认即可)，在高级设置页中，勾选按位取值，取值起始位和终止位都选6;
本地配置(施耐德M218)¶
新建通道¶
新建一个采集通道，协议选择施耐德M218，IP地址按照实际情况填写，其余参数保持默认即可；
注意
PLC一次性读取的寄存器个数有数量限制，建议在规约特征里配置单帧寄存器最大个数以实现自动分组。
新建设备¶
自定义设备名称，按实际情况修改设备通讯地址，通常为1，其余参数保持默认。
新建测点¶
MW寄存器¶
举例采集一个MW寄存器地址为1000，那么新建一个测点，功能码选择MW寄存器，地址填1000，数据类型选择单精度浮点数(根据实际情况选择)，高低位顺序选择3412;
QX寄存器¶
举例采集一个QX寄存器地址为1010.6，那么新建一个测点，功能码选择QX寄存器，地址填1010，数据类型选择8位无符号，高低位顺序选择12(保持默认即可)，按位取值选择是，取值起始位和终止位都选6 ;
Ended: 施耐德(Schneider)
永宏电机(FATEK) ↵
永宏FBs¶
云端配置(永宏FBs)¶
暂无说明。
Ended: 永宏电机(FATEK)
发那科(FANUC) ↵
fanuc_oi¶
云端配置(FANUC_Oi)¶
新建通道¶
新建一个采集通道，协议选择FANUC-Oi(发那科)，IP地址填写PLC的IP地址，端口号默认8193。
新建设备¶
新建一个设备，自定义设备名称，其余参数保持默认即可。
新建测点¶
提示
点击下载点表模板：FANUC-Oi点表
模式信息¶
读取机床的仿真模式(寄存器地址2)、TM模式(寄存器地址3)、工作模式(寄存器地址4)、运行状态(寄存器地址5)、Motion(寄存器地址6)、MSTB(寄存器地址7)、急停状态(寄存器地址8)、告警状态(寄存器地址9)、编辑状态(寄存器地址10)等信息，新建测点时，功能码选择模式信息，然后只需填写寄存器地址，其余参数保持默认即可。
坐标信息¶
读轴的坐标信息，共有4种类型，绝对坐标(采集分组0)、机械坐标(采集分组1)、相对坐标(采集分组2)、剩余移动量(采集分组3)，
每种类型下(即每种采集分组下)坐标的寄存器地址从0开始递增，通常情况下，X轴坐标的寄存器地址为0，Y轴坐标地址1，Z轴坐标地址2，A轴坐标地址3，C轴坐标地址4，B轴坐标地址5，W轴坐标地址6；
新建一个测点读取Z轴的机械坐标，那么功能码选择坐标信息，采集分组填1，地址填2，其余参数保持默认即可。
主轴信息¶
读取机床的进给轴转速(寄存器地址0)、主轴转速(寄存器地址1)数据，功能码选择主轴信息，地址填1意为读取主轴转速，其余参数保持默认即可。
刀具信息¶
举例读取机床的刀具寿命信息，目标刀具所在组号为2，组内索引为1，那么新建一个测点，功能码选择刀具信息，采集分组填组号2，地址填1.0，1意为读取该组内的第1把刀的数据，0意为读取刀具状态，类似的，地址填1.1读取刀具编号，填1.2读取刀具使用次数，填1.3读取刀具寿命；
再比如采集分组填5，地址填3.2，意为读取第5组中第3把刀的刀具使用次数。
工件信息¶
暂未实现。
报警信息¶
新建一个测点，功能码选择报警信息，地址从0开始递增(最大值为9)，最多同时读取最近的10条报警信息；
数据类型保持默认，则测点值为报警编号，例如100，数据类型选择字符串，则测点值会加上报警类型，例如SW0100；
当报警被消除后或当前没有报警时，该测点的质量会变为坏，这是正常的。
负载信息¶
读取机床的进给轴负载数据，寄存器地址从0开始递增，通常情况下，X轴负载的寄存器地址为0，Y轴负载地址1，Z轴负载地址2，A轴负载地址3，C轴负载地址4，B轴负载地址5，W轴负载地址6。
时间信息¶
读机床的开机时间(寄存器地址0)、运行时间(寄存器地址1)、切削时间(寄存器地址2)、循环时间(寄存器地址3)等信息，新建测点时，功能码选择时间信息，地址填1意为读运行时间，数据类型选择字符串，数据格式选择4321。
提示
当时间值解析不正确(例如出现极大值)时，请更改数据格式为1234再试。
宏变量¶
读机床的宏变量数据(可读可写)，新建一个测点，功能码选择宏变量，地址填3901意为读取当前加工件数，其余参数保持默认即可。
提示
不同的机床，相同宏变量地址中存储的数据是不一样的；
特别的，有：当前加工件数的宏变量地址为3901，总加工件数的地址为3902，当前日期的地址为3011，当前时间的地址为3012，进给设定转速的地址为4309，主轴设定转速的地址为4319。
PMC数据¶
读机床的PMC数据(可读可写)，新建一个测点，功能码选择PMC数据，地址填子功能码+地址，例如"D18"，数据类型默认为8位有符号，根据实际情况选择；
支持读取和写入的子功能码有G、F、Y、X、A、R、T、K、C、D。
系统参数¶
读机床的系统参数数据(只读不可写)，新建一个测点，功能码选择系统参数，地址填10意为读取00010的系统参数，默认情况下读取的是十进制值；
如下图，可以配置按位取值，来读取00010这个系统参数中的第1个bit位(索引从0开始)。
本地配置(FANUC_Oi)¶
新建通道¶
新建一个采集通道，协议选择FANUC-Oi(发那科)，IP地址填写PLC的IP地址，端口号默认8193。
新建设备¶
新建一个设备，自定义设备名称，其余参数保持默认即可。
新建测点¶
提示
点击下载点表模板：FANUC-Oi点表
请参照云端配置操作。
Ended: 发那科(FANUC)
海德汉(HEIDENHAIN) ↵
heidenhain¶
云端配置(HEIDENHAIN)¶
新建通道¶
新建一个采集通道，协议选择HEIDENHAIN，IP地址填写CNC的IP地址，端口号默认19000。
新建设备¶
新建一个设备，自定义设备名称，其余参数保持默认即可。
新建测点¶
注意
数值型数据的数据类型选择任意非字符串类型即可，字符串型数据的数据类型选择字符串型。
版本信息¶
新建测点，功能码选择版本信息，数据类型选择字符串，使用不同的寄存器地址读取不同数据，其余参数默认即可。
- CNC型号(寄存器地址0)、CNC版本(寄存器地址1)、PLC版本(寄存器地址2)。
坐标信息¶
新建测点，功能码选择坐标信息，使用不同的采集分组和寄存器地址组合读取不同数据，其余参数默认即可。
-
机械坐标(采集分组0)、相对坐标(采集分组1)。
-
坐标轴一般为X、Y、Z、C、B、c、w，读取不同坐标轴需对应填写名称到寄存器地址中。
举例读取机械X轴坐标，采集分组填写0，寄存器地址填写X。
程序信息¶
新建测点，功能码选择程序信息，使用不同的采集分组和寄存器地址组合读取不同数据。
-
程序运行所处行号(采集分组0、寄存器地址0)、程序运行文件路径(采集分组0、寄存器地址1、数据类型字符串)。
-
程序运行状态码(采集分组1、寄存器地址任意)，数据类型为字符串时会对程序运行状态码进行文字说明。
时间信息¶
新建测点，功能码选择时间信息，数据类型选择32位无符号，使用不同的寄存器地址读取不同数据。
- 开机时间(寄存器地址0)、运行时间(寄存器地址2)、切削时间(寄存器地址3)。
错误信息¶
新建测点，功能码选择错误信息，数据类型选择字符串，其他参数默认即可，如果有多条错误信息，新建多个测点即可。
内存信息¶
新建测点，功能码选择内存信息，寄存器地址填写需要读取的十进制内存地址。
刀具信息¶
新建测点，功能码选择刀具信息，使用不同的寄存器地址读取不同数据。
- 刀编号(寄存器地址0)、刀索引(寄存器地址1)、刀方向(寄存器地址2，数据类型为字符串时会展示轴方向信息)、刀长度(寄存器地址3)、刀半径(寄存器地址4)。
本地配置(HEIDENHAIN)¶
新建通道¶
新建一个采集通道，协议选择HEIDENHAIN(发那科)，IP地址填写PLC的IP地址，端口号默认8193。
新建设备¶
新建一个设备，自定义设备名称，其余参数保持默认即可。
新建测点¶
注意
数值型数据的数据类型选择任意非字符串类型即可，字符串型数据的数据类型选择字符串型。
请参照云端配置操作。
Ended: 海德汉(HEIDENHAIN)
凯恩帝(KND) ↵
KND¶
云端配置(KND)¶
新建通道¶
新建一个采集通道，协议选择凯恩帝数控，IP地址填写CNC的IP地址，端口号默认80。
新建设备¶
新建一个设备，自定义设备名称，其余参数保持默认即可。
新建测点¶
注意
数值型数据的数据类型选择单精度浮点型即可，字符串型数据的数据类型选择字符串型。
提示
点击下载点表模板：KND点表
读CNC数据¶
新建测点，功能码选择读CNC数据，数据类型根据实际类型选择，使用不同接口的数据需不同的数据分组，使用不同的寄存器地址读取不同对象数据，其余参数默认即可。
各接口对应的测点分组如下所示：
- 举例读取设备id和设备制造商。
其中要读取设备id和设备制造商，可先通过设备的参考文档确认其信息获取接口，确认其返回数据的数据类型，如当前要读的两个对象是在“/”这个接口，id返回的数据是数字，制造商返回的是字符串。
然后在云端添加测点，进行如下设置
其中地址处输入的是设备参考文档里的对象的名字，如果对象是数组，则输入数字（从0开始），如果对象是嵌套的，则要一级一级对象往下，写到最小对象名，中间用'.'号分割。比如
这个软限位序号这一个对象。他是“/config/axes/”接口（第四测点组）中的第一个轴的数据中的“soft-limit”对象中的第一个数组对象中的“no”对象，因为这个接口返回的数据是以数组形式返回的所以查询命令为“0.soft-limit.0.no”,第一各0表示第一个轴，soft-limit表示是第一个轴中的soft-limit对象，第二个0表示是第一个soft-limit对象中的第一个数组，no表示是oft-limit对象中的第一个数组中的no对象。对象名中间用'.'分割。
读PLC数据¶
举例要读取R521.3寄存器的数据，那么在采集分组填27(参照上面excel表)，在寄存器地址填"R521"，要求其以无符号16位形式返回，那么数据类型选择16位无符号，并在高级设置里开启按位取值，起始位和终止位均填3。
读宏变量¶
设置方式同读PLC数据，不过其辅助参数中的要填的数据格式不同。若使用“/vars/
使用“/vars/?name=
读刀具信息¶
设置方式同上，不过其辅助参数的内容决定其读取的时哪一个刀补，比如要读第一个刀补的刀尖方向，其辅助参数处输入1，基础设置如下所示
本地配置(KND)¶
新建通道¶
新建一个采集通道，协议选择凯恩帝，IP地址填写实际的IP地址，端口号默认80。
注意
数值型数据的数据类型选择单精度浮点型即可，字符串型数据的数据类型选择字符串型。
请参照云端配置操作。
Ended: 凯恩帝(KND)
Ended: PLC/CNC
MODBUS协议 ↵
modbus-rtu采集¶
云端配置(modbus-rtu采集)¶
新建通道¶
新建一个采集通道，协议选择MODBUS-RTU，主参数中，串口名称按照网关实际的接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，其它参数如无特殊要求保持默认即可；
提示
本协议支持切换协议类型为TCP，可做TCP Server接收DTU数据，此时设备公共地址填DTU的注册帧字符串。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写modbus从站的485地址，其余参数留空即可。
新建测点¶
举例新建一个保持寄存器测点，已知寄存器地址为4100，数据类型为16位有符号位整型，那么功能码选择03,06号命令，地址填写4100，数据类型选择16位有符号，数据格式(高低位)选择12。
提示
有些设备的点表在描述时，可能会将寄存器类型作为数字拼接到寄存器的最高位，例如“4100”，也有可能指功能码“04号命令(读输入寄存器)”、地址为“100”。
举例读字符串数据，该字符串保存在保持寄存器中，已知寄存器地址为260，字符串值长度为9，那么功能码选择03,06号命令，地址填写260，数据格式(高低位)选择21(根据实际情况可以更改为12)，数据类型选择字符串，此时系数一栏会变成字符串长度，在此填写9。
提示
为了避免字符串读取不全，本驱动中对长度做了x2处理，所以此处填5(计算时长度补足为偶数然后除以2(9+1)/2=5)或者9都是能读到的。
本地配置(modbus-rtu采集)¶
展开查看视频
新建通道¶
新建一个采集通道，协议选择MODBUS-RTU，主参数中，串口名称按照网关实际的接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，其它参数如无特殊要求保持默认即可；
提示
本协议支持切换协议类型为TCP，可做TCP Server接收DTU数据，此时设备公共地址填DTU的注册帧字符串。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写modbus从站的485地址，其余参数留空即可。
新建测点¶
举例新建一个保持寄存器测点，已知寄存器地址为4100，数据类型为16位有符号位整型，那么功能码选择03,06号命令，地址填写4100，数据类型选择16位有符号，数据格式(高低位)选择12。
提示
有些设备的点表在描述时，可能会将寄存器类型作为数字拼接到寄存器的最高位，例如“4100”，也有可能指功能码“04号命令(读输入寄存器)”、地址为“100”。
注意
使用01、02功能码读取时，测点数据类型必须为位；
使用03、04功能读取，且需要按位取值时，测点数据类型应该为16位有/无符号或32位有/无符号。
举例读字符串数据，该字符串保存在保持寄存器中，已知寄存器地址为260，字符串值长度为9，那么功能码选择03,06号命令，地址填写260，数据格式(高低位)选择21(根据实际情况可以更改为12)，数据类型选择字符串，此时系数一栏填写字符串长度9。
提示
为了避免字符串读取不全，本驱动中对长度做了x2处理，所以此处填5(计算时长度补足为偶数然后除以2(9+1)/2=5)或者9都是能读到的。
modbus-tcp采集¶
云端配置(modbus-tcp采集)¶
新建通道¶
新建一个采集通道，协议选择MODBUS-TCP，主参数中，IP地址填写modbus从站的IP地址，端口号默认502，按需修改；
提示
本协议支持通讯方向改为等待接入，此时设备公共地址填DTU的注册帧字符串。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写modbus从站的设备地址，其余参数留空即可。
新建测点¶
举例新建一个保持寄存器测点，已知寄存器地址为4100，数据类型为16位有符号位整型，那么功能码选择03,06号命令，地址填写4100，数据类型选择16位有符号，数据格式(高低位)选择12。
提示
有些设备的点表在描述时，可能会将寄存器类型作为数字拼接到寄存器的最高位，例如“4100”，也有可能指功能码“04号命令(读输入寄存器)”、地址为“100”。
本地配置(modbus-tcp采集)¶
展开查看视频
新建通道¶
新建一个采集通道，协议选择MODBUS-TCP，主参数中，IP地址填写modbus从站的IP地址，端口号默认502，按需修改；
提示
本协议支持通讯方向改为等待接入，此时设备公共地址填DTU的注册帧字符串。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写modbus从站的设备地址，其余参数留空即可。
新建测点¶
举例新建一个保持寄存器测点，已知寄存器地址为4100，数据类型为16位有符号位整型，那么功能码选择03,06号命令，地址填写4100，数据类型选择16位有符号，数据格式(高低位)选择12。
提示
有些设备的点表在描述时，可能会将寄存器类型作为数字拼接到寄存器的最高位，例如“4100”，也有可能指功能码“04号命令(读输入寄存器)”、地址为“100”。
注意
使用01、02功能码读取时，测点数据类型必须为位；
使用03、04功能读取，且需要按位取值时，测点数据类型应该为16位有/无符号或32位有/无符号。
modbus-rtu转发¶
云端配置(modbus-rtu转发)¶
新建通道¶
新建一个转发通道，协议选择MODBUS-RTU(转发)，主参数中，串口名称按照网关实际的接线情况选择对应的COM口，其它参数如无特殊要求的留空即可；
新建设备¶
新建一个设备，自定义设备名称，设备通讯地址为MODBUS协议转发出去的从站设备地址，其余参数留空即可。
新建测点¶
提示
不管用哪种功能码转发，您可以任意指定地址，尽管它们是不连续的，留空的地址默认实时值为0；
需要注意的是，地址在递增时，位、8位、16位有/无符号步长为1(例如27、28、29...)，32位有/无符号或单精度浮点数步长为2(例如12、14、16...)。
保持寄存器(0x03功能码)¶
举例转发一个保持寄存器测点，测点可以批量新增已有的采集点或中间点为转发测点；
已知寄存器地址为4100，数据类型为int(16位有符号)，那么功能码选择03,06号命令，地址填写4100，数据类型选择16位有符号，数据格式(高低位)选择12；如下图：
提示
转发测点的寄存器地址从0开始，最小地址为0；
输入寄存器(0x04功能码)建点过程与保持寄存器(0x03功能码)一致。
假设上述测点当前值为6789，Modbus Poll读取报文如下：
发送>>01 03 10 04 00 0A 80 CC
接收<<01 03 14 1A 85 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 1C 4D
配置如下：
离散寄存器(0x01功能码)¶
举例转发一个离散寄存器测点，已知寄存器地址为4，数据类型为BIT(位)，那么功能码选择01,05号命令，地址填写4，数据类型选择位，高低位选择12。
提示
转发测点的寄存器地址从0开始，最小地址为0；
离散输入寄存器(0x02功能码)建点过程与离散寄存器(0x01功能码)一致。
假设上述测点当前值为1，Modbus Poll读取报文如下：
发送>>01 01 00 00 00 0A BC 0D
接收<<01 01 02 10 00 B4 3C
配置如下：
本地配置(modbus-rtu转发)¶
新建通道¶
新建一个转发通道，协议选择MODBUS-RTU(转发)，主参数中，串口名称按照网关实际的接线情况选择对应的COM口，其它参数如无特殊要求的留空即可；
新建设备¶
新建一个设备，自定义设备名称，设备通讯地址为MODBUS协议转发出去的从站设备地址，其余参数留空即可。
新建测点¶
提示
不管用哪种功能码转发，您可以任意指定地址，尽管它们是不连续的，留空的地址默认实时值为0；
需要注意的是，地址在递增时，位、8位、16位有/无符号步长为1(例如27、28、29...)，32位有/无符号或单精度浮点数步长为2(例如12、14、16...)。
保持寄存器(0x03功能码)¶
举例转发一个保持寄存器测点，测点可以批量新增已有的采集点或中间点为转发测点；
已知寄存器地址为4100，数据类型为int(16位有符号)，那么功能码选择03,06号命令，地址填写4100，数据类型选择16位有符号，数据格式(高低位)选择12；如下图：
提示
转发测点的寄存器地址从0开始，最小地址为0；
输入寄存器(0x04功能码)建点过程与保持寄存器(0x03功能码)一致。
假设上述测点当前值为6789，Modbus Poll读取报文如下：
发送>>01 03 10 04 00 0A 80 CC
接收<<01 03 14 1A 85 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 1C 4D
配置如下：
离散寄存器(0x01功能码)¶
举例转发一个离散寄存器测点，已知寄存器地址为4，数据类型为BIT(位)，那么功能码选择01,05号命令，地址填写4，数据类型选择位，高低位选择12。
提示
转发测点的寄存器地址从0开始，最小地址为0；
离散输入寄存器(0x02功能码)建点过程与离散寄存器(0x01功能码)一致。
假设上述测点当前值为1，Modbus Poll读取报文如下：
发送>>01 01 00 00 00 0A BC 0D
接收<<01 01 02 10 00 B4 3C
配置如下：
modbus-tcp转发¶
云端配置(modbus-tcp转发)¶
新建通道¶
新建一个转发通道，协议选择MODBUS-TCP(转发)，主参数中，IP地址保持默认即可，端口号按需修改；
提示
报文序列号、IP白名单、连接数等更多设置见规约特征页面。
剩余步骤参照modbus-rtu转发(标准)。
本地配置(modbus-tcp转发)¶
新建通道¶
新建一个转发通道，协议选择MODBUS-TCP(转发)，主参数中，IP地址保持默认即可，端口号按需修改；
提示
报文序列号、IP白名单、连接数等更多设置见规约特征页面。
剩余步骤参照modbus-rtu转发(标准)。
保护类modbus扩展¶
云端配置(保护类modbus)¶
新建通道¶
新建一个采集通道，协议选择保护类MODBUS，本驱动属于modbus-rtu采集(标准)协议的扩展，基本配置过程可参照modbus-rtu采集(标准)。
扩展功能¶
广播对时¶
-
举例
每60分钟，下发一次广播对时。
-
协议要求
-
规约特征配置
-
通配符说明
| 符号 | 描述 |
|---|---|
| %?A | 将被替换为设备通讯地址(Address)，?处填写字符串长度，下同 |
| %?P | 将被替换为设备公共地址(Public Address) |
| %?Y | 将被替换为年份，%4Y则为四位数年份，%2Y则取年份后两位 (Year) |
| %?M | 将被替换为月份(Value) |
| %?D | 将被替换为日期 (Day) |
| %?H | 将被替换为小时 (Hour) |
| %?F | 将被替换为分钟 (Min) |
| %?S | 将被替换为秒钟，%4S精确到毫秒，%2S精确到秒 (Second) |
| %?C | 将被替换为校验码(Check) |
注意
注1：规约特征配置中的命令均为十六进制，以字符串的形式表示，且区分大小写(通配符中的字母为大写，十六进制报文中的a-f为小写)，2个字符串合为1个字节，例如字符串a3代表十六进制的0xa3，为1个字节长度；
注2：%号后面的?，为数字，代表字符串长度，例如设备地址为5，通配符为%2A，那么实际发出去的报文就是1字节的05；例如寄存器个数为3，通配符为%4N，那么实际发出去的报文就是2字节的0003；该长度肯定为偶数；
按照上述配置，发出去的对时报文为：
00 10 80 00 00 04 08 70 c9 34 10 14 07 15 00 a9 85
有符号整数解析方式¶
-
举例
16进制有符号数0x807f，默认情况下解析为十进制值：
32895，选择原码方式解析则为：-127。 -
规约特征配置
本地配置(保护类modbus)¶
新建通道¶
新建一个采集通道，协议选择保护类MODBUS，本驱动属于modbus-rtu采集(标准)协议的扩展，基本配置过程可参照modbus-rtu采集(标准)。
扩展功能¶
广播对时¶
-
举例
每60分钟，下发一次广播对时。
-
协议要求
-
规约特征数配置
- 通配符说明
| 符号 | 描述 |
|---|---|
| %?A | 将被替换为设备通讯地址(Address)，?处填写字符串长度，下同 |
| %?P | 将被替换为设备公共地址(Public Address) |
| %?Y | 将被替换为年份，%4Y则为四位数年份，%2Y则取年份后两位 (Year) |
| %?M | 将被替换为月份(Value) |
| %?D | 将被替换为日期 (Day) |
| %?H | 将被替换为小时 (Hour) |
| %?F | 将被替换为分钟 (Min) |
| %?S | 将被替换为秒钟，%4S精确到毫秒，%2S精确到秒 (Second) |
| %?C | 将被替换为校验码(Check) |
注意
注1：规约特征配置中的命令均为十六进制，以字符串的形式表示，且区分大小写(通配符中的字母为大写，十六进制报文中的a-f为小写)，2个字符串合为1个字节，例如字符串a3代表十六进制的0xa3，为1个字节长度；
注2：%号后面的?，为数字，代表字符串长度，例如设备地址为5，通配符为%2A，那么实际发出去的报文就是1字节的05；例如寄存器个数为3，通配符为%4N，那么实际发出去的报文就是2字节的0003；该长度肯定为偶数；
按照上述配置，发出去的对时报文为：
00 10 80 00 00 04 08 70 c9 34 10 14 07 15 00 a9 85
有符号整数解析方式¶
-
举例
16进制有符号数0x807f，默认情况下解析为十进制值：
32895，选择原码方式解析则为：-127。 -
规约特征配置
modbus-rtu监听¶
云端配置(modbus-rtu监听)¶
新建通道¶
新建一个采集通道，协议选择MODBUS-RTU(监听)，主参数中，串口名称按照网关实际的接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，其它参数如无特殊要求保持默认即可；
本驱动能够在不改变原有485通讯线路的情况下，通过并联接入的方式，不往外发送采集报文，而是监听原有的485报文，来对数据进行解析。
注意
MODBUS-RTU(监听)通道不允许串口复用,即本通道使用的串口，不允许配置到其他通道上。
要采集的测点的寄存器地址必须是原有485通讯里已经存在的；
例如，有modbus主站已经在采集从站地址为1、寄存器地址0~99的数据，那么我们可以用本驱动监听、解析到这0~99个寄存器的数据，除此之外的其它寄存器是无法采集到的。
新建设备¶
请参照modbus-rtu采集(标准)的配置过程。
新建测点¶
请参照modbus-rtu采集(标准)的配置过程。
本地配置(modbus-rtu监听)¶
新建通道¶
新建一个采集通道，协议选择MODBUS-RTU(监听)，主参数中，串口名称按照网关实际的接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，其它参数如无特殊要求保持默认即可；
本驱动能够在不改变原有485通讯线路的情况下，通过并联接入的方式，不往外发送采集报文，而是监听原有的485报文，来对数据进行解析。
注意
MODBUS-RTU(监听)通道不允许串口复用,即本通道使用的串口，不允许配置到其他通道上。
要采集的测点的寄存器地址必须是原有485通讯里已经存在的；
例如，有modbus主站已经在采集从站地址为1、寄存器地址0~99的数据，那么我们可以用本驱动监听、解析到这0~99个寄存器的数据，除此之外的其它寄存器是无法采集到的。
新建设备¶
请参照modbus-rtu采集(标准)的配置过程。
新建测点¶
请参照modbus-rtu采集(标准)的配置过程。
Ended: MODBUS协议
电力协议 ↵
104规约 ↵
104主站采集¶
云端配置(104主站采集)¶
新建通道¶
新建一个采集通道，协议选择104主站采集(IEC)，通道地址填写104从站的RTU地址，主参数中，IP地址按实际情况填写，端口号默认为2404；
举例：
要采集的104从站的IP地址是192.168.1.100，端口号是2424。
提示
本驱动支持通讯方向选择等待接入(服务端)。
新建设备¶
设备的参数自定义或保持默认即可，在本驱动中，设备的参数无实际意义。
新建测点¶
举例采集一个遥测点，其104寄存器地址为4003H，类型为浮点型，
新建一个测点，功能码选择遥测量YC，地址填2(即4003H减去104遥测基地址4001H，基地址4001H对应地址0)，数据类型与数据格式保持默认即可(会根据报文内容自动适配)；
举例采集一个遥控点，其104寄存器地址为6001H，
新建一个测点，功能码选择遥控YK，地址填0(即6001H减去104遥控基地址6001H)，数据类型与数据格式保持默认即可(会根据报文内容自动适配)。
本地配置(104主站采集)¶
展开查看视频
新建通道¶
新建一个采集通道，协议选择104主站采集(IEC)，通道地址填写104从站的RTU地址，主参数中，IP地址按实际情况填写，端口号默认为2404；
举例：
要采集的104从站的IP地址是192.168.1.100，端口号是2424。
提示
本驱动支持通讯方向(即角色)选择等待接入(服务端)。
新建设备¶
设备的参数自定义或保持默认即可，在本驱动中，设备的参数无实际意义。
新建测点¶
举例采集一个遥测点，其104寄存器地址为4003H，类型为浮点型，
新建一个测点，功能码选择遥测量YC，地址填2(即4003H减去104遥测基地址4001H，基地址4001H对应地址0)，数据类型与数据格式保持默认即可(会根据报文内容自动适配)；
举例采集一个遥控点，其104寄存器地址为6001H，
新建一个测点，功能码选择遥控YK，地址填0(即6001H减去104遥控基地址6001H)，数据类型与数据格式保持默认即可(会根据报文内容自动适配)。
提示
软件界面上方的遥测、遥信、遥脉等分组，仅对测点做分类，可以将遥测量建在遥测分类中，遥信量建在遥信分类中，一一对应。
104从站转发¶
云端配置(104从站转发)¶
新建通道¶
新建一个转发通道，协议选择104从站转发(IEC)，通道地址填写本104从站的RTU地址，主参数中，IP地址填写0.0.0.0，端口号填2404，通讯方向选择等待接入(服务端)；
提示
通讯方向通常都是等待接入，以实际情况为准可选主动连接。
注意
RTU地址在以下2种情况下使用转发设备的通讯地址:
-
存在多个转发设备时.
-
只有一个转发设备，且通道地址等于1时。
规约特征中可以配置104协议相关参数以及IP白名单等，参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 10 | 测试帧间隔 | 设置为0则不主动发送测试帧 |
| 12 | 遥信类型 | 1单点遥信信息， 3双点遥信信息 |
| 13 | SOE类型 | 30带长时标的单点信息，31带长时标的双点信息 |
| 14 | 变化遥信是否带时标 | 只有打开该选项(参数值为1)，变化遥信(SOE)才会带时标 |
| 16 | 循环数据周期 | 即使主站不召唤数据，也会以该周期定时发送全量数据 |
| 17 | 是否循环数据上送 | 填0关闭，填1开启，则使得编号为16的参数生效 |
| 20 | 是否发送初始化帧 | 仅在通道主参数通讯方向为主动连接时生效 |
新建设备¶
当只有一个主站来采集，且只有一份转发表时，设备的参数保持默认无需修改，无实际意义；
当有多个主站来采集，且监听的IP地址和端口号相同，且转发点表不同时，在设备的通讯地址填写从站RTU地址，设备的公共地址填写主站IP，此时会根据连入主站的IP自适应不同设备下的转发点表进行转发；
例如，主站A(192.168.0.100)和主站B(192.168.0.101)都连接本网关的192.168.0.177:2404进行数据采集，且他们的转发点不同，那么建两个转发设备，公共地址分别对应两个主站的IP地址。
新建测点¶
举例转发一个遥测点，其104寄存器地址为4001H，新建一个测点，功能码选择遥测量YC，地址填0(即4001H减去104遥测基地址4001H)，数据类型与数据格式保持默认即可(统一转出类型为短浮点型)。
提示
转发不同类型(单点、双点、长时标)的遥信点时，相关配置见规约特征。
本地配置(104从站转发)¶
新建通道¶
新建一个转发通道，协议选择104从站转发(IEC)，通道地址填写本104从站的RTU地址，主参数中，IP地址填写0.0.0.0，端口号填2404，通讯方向(即角色)选择等待接入(服务端)；
提示
通讯方向(即角色)通常都是等待接入，以实际情况为准可选主动连接。
规约特征中可以配置104协议相关参数以及IP白名单等，参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 10 | 测试帧间隔 | 设置为0则不主动发送测试帧 |
| 12 | 遥信类型 | 1单点遥信信息， 3双点遥信信息 |
| 13 | SOE类型 | 30带长时标的单点信息，31带长时标的双点信息 |
| 14 | 变化遥信是否带时标 | 只有打开该选项(参数值为1)，变化遥信(SOE)才会带时标 |
| 16 | 循环数据周期 | 即使主站不召唤数据，也会以该周期定时发送全量数据 |
| 17 | 是否循环数据上送 | 填0关闭，填1开启，则使得编号为16的参数生效 |
| 20 | 是否发送初始化帧 | 仅在通道主参数通讯方向为主动连接时生效 |
新建设备¶
当只有一个主站来采集，且只有一份转发表时，设备的参数保持默认无需修改，无实际意义；
当有多个主站来采集，且监听的IP地址和端口号相同，且转发点表不同时，在设备的通讯地址填写从站RTU地址，设备的公共地址填写主站IP，此时会根据连入主站的IP自适应不同设备下的转发点表进行转发；
例如，主站A(192.168.0.100)和主站B(192.168.0.101)都连接本网关的192.168.0.177:2404进行数据采集，且他们的转发点不同，那么建两个转发设备，公共地址分别对应两个主站的IP地址。
新建测点¶
举例转发一个遥测点，其104寄存器地址为4001H，新建一个测点，功能码选择遥测量YC，地址填0(即4001H减去104遥测基地址4001H)，数据类型与数据格式保持默认即可(统一转出类型为短浮点型)。
提示
转发不同类型(单点、双点、长时标)的遥信点时，相关配置见规约特征。
许继104采集¶
云端配置(许继104采集)¶
新建通道¶
新建一个采集通道，协议选择许继104采集，通道地址填写104从站的RTU地址，主参数中，IP地址按实际情况填写，端口号默认为2404，其余参数保持默认；
新建设备¶
新建一个设备，设备的通讯地址填写许继104中的扇区地址，设备的公共地址填写许继104中的公共地址；
新建测点¶
剩余步骤参照104主站采集->新建测点。
本地配置(许继104采集)¶
新建通道¶
新建一个采集通道，协议选择许继104采集，通道地址填写104从站的RTU地址，主参数中，IP地址按实际情况填写，端口号默认为2404，其余参数保持默认；
新建设备¶
新建一个设备，设备的通讯地址填写许继104中的扇区地址，设备的公共地址填写许继104中的公共地址；
新建测点¶
剩余步骤参照104主站采集->新建测点。
华云104从站转发¶
云端配置(华云104从站转发)¶
新建通道¶
新建一个转发通道，协议选择华云104从站转发，本驱动中，通道的交互频率无效；
通道主参数中，通讯方向默认为主动连接(客户端)，IP地址与端口号根据实际用到的服务器的情况填写；
提示
通讯方向通常都是主动连接，以实际情况为准可选等待接入。
规约特征中可以配置华云104转发协议相关参数，例如mac地址、数据循环上送周期、断网补传等，通常规约特征保持默认就能成功接入。
配置设备¶
提示
当一个网关要传多个华云平台的电站时，可以新建多个华云104从站转发通道，在转发通道的规约特征里配置不同的MAC例如${mac0}、${mac1}，然后将${mac0}、${mac1}填写到转发通道对应设备的保留1字段中，那么不同转发通道仅会上传设备的MAC与自己的规约特征里的MAC相匹配的数据，从而实现一个网关上传多个电站数据。
该转发协议无需新建转发设备。
我们回到采集通道下的子设备管理，设备公共地址即为104从站的RTU地址，一个通道下转发设备的公共地址不能重复，然后兼容平台选择"华云光伏平台"，设备类型根据实际情况选择。
配置测点¶
该转发协议无需新增转发测点。
我们回到采集设备下的采集测点管理，修改测点的基本属性，将是否上传打上勾，然后选择这个测点的PV标识例如"A相电流"。
提示
没有看到这个PV属性设置或者属性设置不对的，请参照本小节的第二步，选择正确的兼容平台与设备型号后再试。
本地配置(104从站转发)¶
新建通道¶
新建一个转发通道，协议选择华云104从站转发，本驱动中，通道的交互频率无效；
通道主参数中，通讯方向(即角色)默认为主动连接(客户端)，IP地址与端口号根据实际用到的服务器的情况填写；
提示
通讯方向(即角色)通常都是主动连接，以实际情况为准可选等待接入。
规约特征中可以配置华云104转发协议相关参数，例如mac地址、数据循环上送周期、断网补传等，通常规约特征保持默认就能成功接入。
配置设备¶
提示
当一个网关要传多个华云平台的电站时，可以新建多个华云104从站转发通道，在转发通道的规约特征里配置不同的MAC例如${mac0}、${mac1}，然后将${mac0}、${mac1}填写到转发通道对应设备的保留1字段中，那么不同转发通道仅会上传设备的MAC与自己的规约特征里的MAC相匹配的数据，从而实现一个网关上传多个电站数据。
该转发协议无需新建转发设备。
我们回到采集通道下的子设备管理，设备公共地址即为104从站的RTU地址，一个通道下转发设备的公共地址不能重复，然后兼容平台选择"华云光伏平台"，设备类型根据实际情况选择。
配置测点¶
该转发协议无需新增转发测点。
我们回到采集设备下的采集测点管理，修改测点的PV上传标识，是否上传选择是，然后选择这个测点的PV标识例如"A相电流"。
提示
没有看到这个PV属性设置或者属性设置不对的，请参照本小节的第二步，选择正确的兼容平台与设备型号后再试。
104从站转发(文件传输)¶
云端配置(104从站转发(文件传输))¶
新建通道¶
新建一个转发通道，协议选择104从站转发(文件传输)，通道地址填写本104从站的RTU地址，主参数中，IP地址填写要接入网关的IP地址，端口号填2404，通讯方向选择等待接入(服务端)；
提示
通讯方向通常都是等待接入，以实际情况为准可选主动连接。
注意
RTU地址在以下2种情况下使用转发设备的通讯地址:
-
存在多个转发设备时.
-
只有一个转发设备，且通道地址等于1时。
规约特征中可以配置104文件传输协议相关参数以及IP白名单等，将需要扫描的目标路径填写到规约参数文件扫描路径中。参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 10 | 测试帧间隔 | 设置为0则不主动发送测试帧 |
| 12 | 遥信类型 | 1单点遥信信息， 3双点遥信信息 |
| 13 | SOE类型 | 30带长时标的单点信息，31带长时标的双点信息 |
| 14 | 变化遥信是否带时标 | 只有打开该选项(参数值为1)，变化遥信(SOE)才会带时标 |
| 16 | 循环数据周期 | 即使主站不召唤数据，也会以该周期定时发送全量数据 |
| 17 | 是否循环数据上送 | 填0关闭，填1开启，则使得编号为16的参数生效 |
| 20 | 是否发送初始化帧 | 仅在通道主参数通讯方向为主动连接时生效 |
| 45 | 文件扫描路径 | 要扫描的目标文件夹在网关设备的路径 |
新建设备¶
当只有一个主站来采集，且只有一份转发表时，设备的参数保持默认无需修改，无实际意义；
当有多个主站来采集，且监听的IP地址和端口号相同，且转发点表不同时，在设备的通讯地址填写从站RTU地址，设备的公共地址填写主站IP，此时会根据连入主站的IP自适应不同设备下的转发点表进行转发；
例如，主站A(192.168.0.100)和主站B(192.168.0.101)都连接本网关的192.168.0.177:2404进行数据采集，且他们的转发点不同，那么建两个转发设备，公共地址分别对应两个主站的IP地址。
新建测点¶
举例转发一个遥测点，其104寄存器地址为4001H，新建一个测点，功能码选择遥测量YC，地址填0(即4001H减去104遥测基地址4001H)，数据类型与数据格式保持默认即可(统一转出类型为短浮点型)。
提示
转发不同类型(单点、双点、长时标)的遥信点时，相关配置见规约特征。
本地配置(104从站转发(文件传输))¶
新建通道¶
新建一个转发通道，协议选择104从站转发(IEC)，通道地址填写本104从站的RTU地址，主参数中，IP地址填写要接入网关的IP地址，端口号填2404，通讯方向(即角色)选择等待接入(服务端)；
提示
通讯方向(即角色)通常都是等待接入，以实际情况为准可选主动连接。
规约特征中可以配置104协议相关参数以及IP白名单等，，将需要扫描的目标路径填写到规约参数文件扫描路径中。参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 10 | 测试帧间隔 | 设置为0则不主动发送测试帧 |
| 12 | 遥信类型 | 1单点遥信信息， 3双点遥信信息 |
| 13 | SOE类型 | 30带长时标的单点信息，31带长时标的双点信息 |
| 14 | 变化遥信是否带时标 | 只有打开该选项(参数值为1)，变化遥信(SOE)才会带时标 |
| 16 | 循环数据周期 | 即使主站不召唤数据，也会以该周期定时发送全量数据 |
| 17 | 是否循环数据上送 | 填0关闭，填1开启，则使得编号为16的参数生效 |
| 20 | 是否发送初始化帧 | 仅在通道主参数通讯方向为主动连接时生效 |
| 45 | 文件扫描路径 | 要扫描的目标文件夹在网关设备的路径 |
新建设备¶
当只有一个主站来采集，且只有一份转发表时，设备的参数保持默认无需修改，无实际意义；
当有多个主站来采集，且监听的IP地址和端口号相同，且转发点表不同时，在设备的通讯地址填写从站RTU地址，设备的公共地址填写主站IP，此时会根据连入主站的IP自适应不同设备下的转发点表进行转发；
例如，主站A(192.168.0.100)和主站B(192.168.0.101)都连接本网关的192.168.0.177:2404进行数据采集，且他们的转发点不同，那么建两个转发设备，公共地址分别对应两个主站的IP地址。
新建测点¶
举例转发一个遥测点，其104寄存器地址为4001H，新建一个测点，功能码选择遥测量YC，地址填0(即4001H减去104遥测基地址4001H)，数据类型与数据格式保持默认即可(统一转出类型为短浮点型)。
提示
转发不同类型(单点、双点、长时标)的遥信点时，相关配置见规约特征。
Ended: 104规约
103规约 ↵
南自103采集¶
云端配置(南自103采集)¶
新建通道¶
新建一个采集通道，协议选择南自103采集，主参数中，IP地址填写0.0.0.0，端口号填1048(这是103从站来连接我们的端口号，以实际为准)。
注意
假如从站收不到主站的广播报文，那么规约特征里可以填写主站(指本网关)广播地址(本例中该网口的IP地址为192.168.0.177，那么广播地址就是192.168.0.255)，主站广播端口号对应保护设备的UDP广播端口，本例中为1032(以实际为准)，或者启用向每个设备发送UDP广播报文功能；
举例：
要采集的继电保护装置的IP地址为192.168.0.107，UDP广播端口为1032。
新建设备¶
设备的通讯地址填写该保护的IP地址，本例中是192.168.0.107，公共地址填写该保护的103地址，本例中为1；
新建测点¶
功能码按实际情况选择，地址7.1意为：
该测点所在的组号为7，在该组中的序号为1，数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
注意
通常情况下，有下表的对应关系，不按下表关系配置可能导致通讯异常；如需采集遥脉数据，还要在规约特征中填写遥脉组号。
| 属性 | 组号 |
|---|---|
| 遥测 | 7 |
| 遥信 | 8 |
| 遥脉(电量) | 10 |
| 告警 | 5 |
| 动作 | 4 |
| 压板 | 14 |
| 遥控(跳/合) | 11 |
本地配置(南自103采集)¶
新建通道¶
新建一个采集通道，协议选择南自103采集，主参数中，IP地址填写0.0.0.0，端口号填1048(这是103从站来连接我们的端口号，以实际为准)。
举例：
要采集的继电保护装置的IP地址为192.168.0.107，UDP广播端口为1032。
注意
假如从站收不到主站的广播报文，那么规约特征里可以填写主站(指本网关)广播地址(本例中该网口的IP地址为192.168.0.177，那么广播地址就是192.168.0.255)，主站广播端口号对应保护设备的UDP广播端口，本例中为1032(以实际为准)，或者启用向每个设备发送UDP广播报文功能；
新建设备¶
设备的通讯地址填写该保护的IP地址，本例中是192.168.0.107，公共地址填写该保护的103地址，本例中为1；
新建测点¶
功能码按实际情况选择，地址7.1意为：
该测点所在的组号为7，在该组中的序号为1，数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
注意
通常情况下，有下表的对应关系，不按下表关系配置可能导致通讯异常；如需采集遥脉数据，还要在规约特征中填写遥脉组号。
| 属性 | 组号 |
|---|---|
| 遥测 | 7 |
| 遥信 | 8 |
| 遥脉(电量) | 10 |
| 告警 | 5 |
| 动作 | 4 |
| 压板 | 14 |
| 遥控(跳/合) | 11 |
南自103转发¶
云端配置(南自103转发)¶
新建通道¶
举例：本设备模拟为103从站，监听主站UDP广播的端口号为1032，欲连接的主站的端口号为1048；
新建一个转发通道，协议选择南自103转发，通道地址为103从站地址，主参数中IP地址填写0.0.0.0，端口号填写监听UDP广播的端口号1032(以实际为准)，帧间隔影响发送的相邻两帧报文之间的时间，推荐300ms，其余参数默认即可。
新建设备¶
新建一个设备，通讯地址填写1意为CPU号1，多个设备对应多个CPU，其余参数保持默认即可。
新建测点¶
新增一个转发测点，地址填写7.1,其中7意为组号，1意为组内序号，功能码按照实际情况选择，其余参数保持默认即可。
注意
通常情况下，有下表的对应关系，不按下表关系配置可能导致通讯异常。
| 属性 | 组号 |
|---|---|
| 遥测 | 7 |
| 遥信 | 8 |
| 告警 | 5 |
| 动作 | 4 |
| 压板 | 14 |
| 遥控(跳/合) | 11 |
本地配置(南自103转发)¶
新建通道¶
举例：本设备模拟为103从站，监听主站UDP广播的端口号为1032，欲连接的主站的端口号为1048；
新建一个转发通道，协议选择南自103转发，通道地址为103从站地址，主参数中IP地址填写0.0.0.0，端口号填写监听UDP广播的端口号1032(以实际为准)，帧间隔影响发送的相邻两帧报文之间的时间，推荐300ms，其余参数默认即可。
新建设备¶
新建一个设备，通讯地址填写1意为CPU号1，多个设备对应多个CPU，其余参数保持默认即可。
新建测点¶
新增一个转发测点，地址填写7.1,其中7意为组号，1意为组内序号，功能码按照实际情况选择，其余参数保持默认即可。
注意
通常情况下，有下表的对应关系，不按下表关系配置可能导致通讯异常。
| 属性 | 组号 |
|---|---|
| 遥测 | 7 |
| 遥信 | 8 |
| 告警 | 5 |
| 动作 | 4 |
| 压板 | 14 |
| 遥控(跳/合) | 11 |
南瑞103采集¶
云端配置(南瑞103采集)¶
新建通道¶
新建一个采集通道，协议选择南瑞103采集，主参数中，IP地址填写对端保护设备的IP地址例如198.122.0.100(以实际情况为准)，端口号保持不变。
提示
如果出现只读到遥测，遥信数据上来慢的情况，请在规约特征里打开"启用通用分类读命令15H"，或者请查看保护装置的检修压板是否退出。
新建设备¶
设备的通讯地址填写该保护的IP地址，本例中是198.122.0.100，公共地址填写该保护的103地址，本例中为100；
新建测点¶
功能码按实际情况选择，地址7.1意为：
该测点所在的组号为7，在该组中的序号为1，数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
本地配置(南瑞103采集)¶
新建通道¶
新建一个采集通道，协议选择南瑞103采集，主参数中，IP地址填写对端保护设备的IP地址例如198.122.0.100(以实际情况为准)，端口号保持不变。
提示
如果出现只读到遥测，遥信数据上来慢的情况，请在规约特征里打开"启用通用分类读命令15H"，或者请查看保护装置的检修压板是否退出。
新建设备¶
设备的通讯地址填写该保护的IP地址，本例中是198.122.0.100，公共地址填写该保护的103地址，本例中为100；
新建测点¶
功能码按实际情况选择，地址7.1意为：
该测点所在的组号为7，在该组中的序号为1，数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
许继串口103采集¶
云端配置(许继串口103采集)¶
新建通道¶
新建一个采集通道，协议选择许继串口103采集，主参数中，串口配置保持默认即可。
注意
在规约特征中可以配置总召唤周期，默认300秒，总召唤周期不建议配置的过小。
新建设备¶
新建一个设备，设备的通讯地址填写该许继103保护的公共地址；
新建测点¶
功能码按实际情况选择，地址227.132意为：
该测点的FUN为227，INF为132，以小数点分隔，数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
注意
请将保护装置的CPU号(即对应下图表格中的公共地址)填在采集分组中，如果不知道CPU号的，填写255即可，意为总召所有CPU数据；
本例中为0，但是通常CPU号为1，请根据实际情况设置。
本地配置(许继串口103采集)¶
新建通道¶
新建一个采集通道，协议选择许继串口103采集，主参数中，串口配置保持默认即可。
注意
在规约特征中可以配置总召唤周期，默认300秒，总召唤周期不建议配置的过小。
新建设备¶
新建一个设备，设备的通讯地址填写该许继103保护的公共地址；
新建测点¶
功能码按实际情况选择，地址227.132意为：
该测点的FUN为227，INF为132，以小数点分隔，数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
注意
请将保护装置的CPU号(即对应下图表格中的公共地址)填在测点分组中，如果不知道CPU号的，填写255即可，意为总召所有CPU数据；
本例中为0，但是通常CPU号为1，请根据实际情况设置。
sr103master¶
云端配置(深瑞103采集)¶
新建通道¶
新建一个采集通道，协议选择深瑞103采集，主参数中，IP地址和端口号填写要采集的保护装置的IP地址及端口号。
新建设备¶
设备的通讯地址填写该保护的103地址，本例中是2，公共地址填写该保护的103地址，本例中为2；
新建测点¶
功能码按实际情况选择，地址1.92意为：
该测点所在的组号为1，在该组中的序号为92，数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
注意
通常情况下，有下表的对应关系，不按下表关系配置可能导致通讯异常。
| 属性 | 组号 | 序号 |
|---|---|---|
| 遥测 | 1~6 | 92~148 |
| 遥信 | 1 | 149~238 |
| 遥信 | 2~6 | 149~255 |
| 遥脉 | 1~6 | 6~31 |
| 遥控 | 1~6 | 48~75 |
本地配置(深瑞103采集)¶
新建通道¶
新建一个采集通道，协议选择深瑞103采集，主参数中，IP地址和端口号填写要采集的保护装置的IP地址及端口号。
新建设备¶
设备的通讯地址填写该保护的103地址，本例中是2，公共地址填写该保护的103地址，本例中为2；
新建测点¶
功能码按实际情况选择，地址1.92意为：
该测点所在的组号为1，在该组中的序号为92，数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
注意
通常情况下，有下表的对应关系，不按下表关系配置可能导致通讯异常。
| 属性 | 组号 | 序号 |
|---|---|---|
| 遥测 | 1~6 | 92~148 |
| 遥信 | 1 | 149~238 |
| 遥信 | 2~6 | 149~255 |
| 遥脉 | 1~6 | 6~31 |
| 遥控 | 1~6 | 48~75 |
串口103采集¶
云端配置(串口103采集)¶
新建通道¶
新建一个采集通道，协议选择串口103采集，主参数中，串口配置保持默认即可。
注意
在规约特征中可以配置总召唤周期，默认300秒，总召唤周期不建议配置的过小。
新建设备¶
新建一个设备，设备的通讯地址填写该串口103保护的公共地址，地址范围必须在0~63范围之内；
新建测点¶
功能码按实际情况选择，地址填写信息元标识符(FUN.INF),以小数点分隔。数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
遥脉读取¶
目前支持2种遥脉读取方式。
通用分类读命令读取遥脉¶
新建一个遥脉采集测点，选择功能码为YM(遥脉)，地址按实际情况填写。
然后把遥脉的FUN值配置到规约参数6 遥脉组号，如本例中，配置为6。
提示
一般情况都是用这种方式来读取遥脉值。
使用电度冻结命令读取遥脉¶
如果上一种方式无法读取到遥脉，那么就要使用ASDU88电度冻结命令读取。
新建遥脉采集测点同上，不再赘述。然后在规约参数配置8 启用ASDU88电度召唤项配置为启用即可。
本地配置(串口103采集)¶
新建通道¶
新建一个采集通道，协议选择串口103采集，主参数中，串口配置保持默认即可。
注意
在规约特征中可以配置总召唤周期，默认300秒，总召唤周期不建议配置的过小。
新建设备¶
新建一个设备，设备的通讯地址填写该串口103保护的公共地址，地址范围必须在0~63范围之内；
新建测点¶
功能码按实际情况选择，地址填写信息元标识符(FUN.INF),以小数点分隔。数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
遥脉读取¶
目前支持2种遥脉读取方式。
通用分类读命令读取遥脉¶
新建一个遥脉采集测点，选择功能码为YM(遥脉)，地址按实际情况填写。
然后把遥脉的FUN值配置到规约参数6 遥脉组号，如本例中，配置为6。
提示
一般情况都是用这种方式来读取遥脉值。
使用电度冻结命令读取遥脉¶
如果上一种方式无法读取到遥脉，那么就要使用ASDU88电度冻结命令读取。
新建遥脉采集测点同上，不再赘述。然后在规约参数配置8 启用ASDU88电度召唤项配置为启用即可。
Ended: 103规约
101规约 ↵
uart101master¶
云端配置(串口101采集)¶
新建通道¶
新建一个采集通道，协议选择串口101采集(非平衡)，串口通信参数按照现场实际情况配置。
规约特征中可以配置串口101采集协议相关参数，参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 3 | RTU从站地址长度 | 可配置为1或2，要与接入的从站相同 |
| 5 | 传输原因长度 | 可配置为1或2，要与接入的从站相同 |
| 6 | 信息体地址长度 | 可配置为1或2，要与接入的从站相同 |
| 8-12 | 基地址 | 各种类型测点基地址，按需配置 |
| 13 | 长度设置生效 | 如果3,5,6任意一个参数有修改，此项必须设为1，否则修改不生效 |
新建设备¶
新建一个此埃及设备，通信地址配置101链路地址。本协议支持多设备采集，不同设备配置不同的101链路地址。
新建测点¶
测点的寄存器地址为101协议的信息体地址减去对应的基地址。如现要采集一个信息体地址为4001H的遥测测点，在规约参数中遥测基地址配置为4001H的情况下，新建一个采集点，功能码选择遥测，地址填0。数据类型与数据格式保持默认即可(驱动根据报文自动识别数据类型),系数和偏移按需配置。
提示
测点地址的配置一定要配合规约参数中的基地址数值一起配置。
本地配置(串口101采集)¶
新建通道¶
新建一个采集通道，协议选择串口101采集(非平衡)，串口通信参数按照现场实际情况配置。
规约特征中可以配置串口101采集协议相关参数，参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 3 | RTU从站地址长度 | 可配置为1或2，要与接入的从站相同 |
| 5 | 传输原因长度 | 可配置为1或2，要与接入的从站相同 |
| 6 | 信息体地址长度 | 可配置为1或2，要与接入的从站相同 |
| 8-12 | 基地址 | 各种类型测点基地址，按需配置 |
| 13 | 长度设置生效 | 如果3,5,6任意一个参数有修改，此项必须设为1，否则修改不生效 |
新建设备¶
新建一个此埃及设备，通信地址配置101链路地址。本协议支持多设备采集，不同设备配置不同的101链路地址。
新建测点¶
测点的寄存器地址为101协议的信息体地址减去对应的基地址。如现要采集一个信息体地址为4001H的遥测测点，在规约参数中遥测基地址配置为4001H的情况下，新建一个采集点，功能码选择遥测，地址填0。数据类型与数据格式保持默认即可(驱动根据报文自动识别数据类型),系数和偏移按需配置。
提示
测点地址的配置一定要配合规约参数中的基地址数值一起配置。
uart101slave¶
云端配置(串口101从站转发)¶
新建通道¶
新建一个转发通道，协议选择串口101转发，串口通信参数按照现场实际情况配置。
[规约特征]。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 传输模式 | 0 非平衡传输，1 平衡模式 |
| 1 | RTU从站地址长度 | 可配置为1或2，要与接入的主站相同 |
| 2 | 传输原因长度 | 可配置为1或2，要与接入的主站相同 |
| 3 | 信息体地址长度 | 可配置为1或2，要与接入的主站相同 |
| 4 | 站点角色 | 可配置为:0 从动站,1 主动站。 |
| 7 | 支持对时 | 0 不支持，1 支持。不支持对时配置下，会对主站下发的对时报文发送否定应答 |
| 10 | 加密模块类型 | 经过加密模块上传，且加密模块是按海南加密协议通讯时，需要在此配置 |
提示
非平衡传输规则下，在分层系统系统中，任何中间节点在面向外站方向，它是启动站，在面向控制方向，它是从动站。一般情况下网关作为从动站。
新建设备¶
在非平衡传输模式下，一个转发通道只能建一个转发设备，在平衡传输模式下，一个转发通道可以建立多个转发设备,通信地址需要配置101链路地址。
如果配置了海南加密，公共地址配置加密模块的中心编号.
新建测点¶
举例转发一个遥测点，其101寄存器地址为4001H，新建一个测点，功能码选择遥测，地址填0(即4001H减去101遥测基地址4001H)，数据类型与数据格式保持默认即可(统一转出类型为短浮点型)，转发系数按需配置，在实际发送的值是采集值乘上转发系数。
提示
101转发的基址:遥测=4001H,遥信=1H,遥脉=0C01H。
本地配置(串口101从站转发)¶
新建通道¶
新建一个转发通道，协议选择串口101转发，串口通信参数按照现场实际情况配置。
[规约特征]。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 传输模式 | 0 非平衡传输，1 平衡模式 |
| 1 | RTU从站地址长度 | 可配置为1或2，要与接入的主站相同 |
| 2 | 传输原因长度 | 可配置为1或2，要与接入的主站相同 |
| 3 | 信息体地址长度 | 可配置为1或2，要与接入的主站相同 |
| 4 | 站点角色 | 可配置为:0 从动站,1 主动站。 |
| 7 | 支持对时 | 0 不支持，1 支持。不支持对时配置下，会对主站下发的对时报文发送否定应答 |
| 10 | 加密模块类型 | 经过加密模块上传，且加密模块是按海南加密协议通讯时，需要在此配置 |
提示
非平衡传输规则下，在分层系统系统中，任何中间节点在面向外站方向，它是启动站，在面向控制方向，它是从动站。一般情况下网关作为从动站。
新建设备¶
在非平衡传输模式下，一个转发通道只能建一个转发设备，在平衡传输模式下，一个转发通道可以建立多个转发设备,通信地址需要配置101链路地址。
如果配置了海南加密，公共地址配置加密模块的中心编号.
新建测点¶
举例转发一个遥测点，其101寄存器地址为4001H，新建一个测点，功能码选择遥测，地址填0(即4001H减去101遥测基地址4001H)，数据类型与数据格式保持默认即可(统一转出类型为短浮点型)，转发系数按需配置，在实际发送的值是采集值乘上转发系数。
提示
101转发的基址:遥测=4001H,遥信=1H,遥脉=0C01H。
net101slave¶
云端配置(网络101从站转发)¶
新建通道¶
新建一个转发通道，协议选择网络101转发，主参数中IP/域名和端口号按现场实际情况填写,交互频率影响遥信变化的检测速度，需要按照实际需要配置。
提示
网络101转发暂时不支持等待连接模式。
[规约特征]。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 传输模式 | 0 非平衡传输，1 平衡模式 |
| 1 | RTU从站地址长度 | 可配置为1或2，要与接入的主站相同 |
| 2 | 传输原因长度 | 可配置为1或2，要与接入的主站相同 |
| 3 | 信息体地址长度 | 可配置为1或2，要与接入的主站相同 |
| 4 | 站点角色 | 可配置为:0 从动站,1 主动站。 |
| 5 | 支持对时 | 0 不支持，1 支持。不支持对时配置下，会对主站下发的对时报文发送否定应答 |
| 6 | 遥测基址 | 遥测基址 |
| 7 | 遥信基址 | 遥信基址 |
| 8 | 遥脉基址 | 遥脉基址 |
| 9 | 遥控基址 | 遥控基址 |
提示
非平衡传输规则下，在分层系统系统中，任何中间节点在面向外站方向，它是启动站，在面向控制方向，它是从动站。一般情况下网关作为从动站。
新建设备¶
一个转发通道可以建立多个转发设备，通信地址需要配置101链路地址。
新建测点¶
举例转发一个遥测点，其101寄存器地址为4001H，新建一个测点，功能码选择遥测，地址填0(即4001H减去101遥测基地址4001H)，数据类型与数据格式保持默认即可(统一转出类型为短浮点型)，转发系数按需配置，在实际发送的值是采集值乘上转发系数。
本地配置(网络101从站转发)¶
新建通道¶
新建一个转发通道，协议选择网络101转发，主参数中IP/域名和端口号按现场实际情况填写,交互频率影响遥信变化的检测速度，需要按照实际需要配置。
提示
网络101转发暂时不支持等待连接模式。
[规约特征]。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 传输模式 | 0 非平衡传输，1 平衡模式 |
| 1 | RTU从站地址长度 | 可配置为1或2，要与接入的主站相同 |
| 2 | 传输原因长度 | 可配置为1或2，要与接入的主站相同 |
| 3 | 信息体地址长度 | 可配置为1或2，要与接入的主站相同 |
| 4 | 站点角色 | 可配置为:0 从动站,1 主动站。 |
| 5 | 支持对时 | 0 不支持，1 支持。不支持对时配置下，会对主站下发的对时报文发送否定应答 |
| 6 | 遥测基址 | 遥测基址 |
| 7 | 遥信基址 | 遥信基址 |
| 8 | 遥脉基址 | 遥脉基址 |
| 9 | 遥控基址 | 遥控基址 |
提示
非平衡传输规则下，在分层系统系统中，任何中间节点在面向外站方向，它是启动站，在面向控制方向，它是从动站。一般情况下网关作为从动站。
新建设备¶
一个转发通道可以建立多个转发设备，通信地址需要配置101链路地址。
新建测点¶
举例转发一个遥测点，其101寄存器地址为4001H，新建一个测点，功能码选择遥测，地址填0(即4001H减去101遥测基地址4001H)，数据类型与数据格式保持默认即可(统一转出类型为短浮点型)，转发系数按需配置，在实际发送的值是采集值乘上转发系数。
Ended: 101规约
隔离网闸 ↵
正向隔离TCP转发¶
云端配置(正向隔离TCP转发)¶
新建通道¶
新建一个转发通道，协议选择正向隔离TCP转发(Client)，交互频率即为数据上传的时间间隔，建议设置为1000ms，可以适当放大、缩小，然后填写ip地址和端口号(以实际情况为准)；
提示
本驱动运行在内网环境中。
新建设备¶
设备的参数自定义或保持默认即可，在本驱动中，设备的参数无实际意义。
新建测点¶
新建一个转发测点，转发功能码根据实际情况选择，然后填写测点的地址，其余参数保持默认即可；
注意
测点地址的填写范围为0-65535(含)，相同功能码的测点，地址不能重复，不同功能码的测点，地址可以重复；
如果有多个转发设备，不同转发设备下，测点地址也不能重复。
本地配置(正向隔离TCP转发)¶
新建通道¶
新建一个转发通道，协议选择正向隔离TCP转发(Client)，交互频率即为数据上传的时间间隔，建议设置为1000ms，可以适当放大、缩小，然后填写ip地址和端口号(以实际情况为准)；
提示
本驱动运行在内网环境中。
新建设备¶
设备的参数自定义或保持默认即可，在本驱动中，设备的参数无实际意义。
新建测点¶
新建一个转发测点，转发功能码根据实际情况选择，然后填写测点的地址，其余参数保持默认即可；
注意
测点地址的填写范围为0-65535(含)，相同功能码的测点，地址不能重复，不同功能码的测点，地址可以重复；
如果有多个转发设备，不同转发设备下，测点地址也不能重复。
常见网络拓扑图¶
正向隔离TCP采集¶
云端配置(正向隔离TCP采集)¶
新建通道¶
新建一个采集通道，协议选择正向隔离TCP采集(Server)，然后填写ip地址为0.0.0.0，端口号以实际情况为准，其余参数默认即可；
提示
本驱动运行在外网环境中。
新建设备¶
设备的参数自定义或保持默认即可，在本驱动中，设备的参数无实际意义。
新建测点¶
新建一个采集测点， 测点功能码的选择必须和配置正向隔离TCP转发时被采集的测点相一致，同样的，测点地址的填写也必须一致，其余参数保持默认即可。
注意
测点地址的填写范围为0-65535(含)，相同功能码的测点，地址不能重复，不同功能码的测点，地址可以重复；
如果有多个转发设备，不同转发设备下，测点地址也不能重复。
本地配置(正向隔离TCP采集)¶
新建通道¶
新建一个采集通道，协议选择正向隔离TCP采集(Server)，然后填写ip地址为0.0.0.0，端口号以实际情况为准，其余参数默认即可；
提示
本驱动运行在外网环境中。
新建设备¶
设备的参数自定义或保持默认即可，在本驱动中，设备的参数无实际意义。
新建测点¶
新建一个采集测点， 测点功能码的选择必须和配置正向隔离TCP转发时被转发的测点相一致，同样的，测点地址的填写也必须一致，其余参数保持默认即可。
注意
测点地址的填写范围为0-65535(含)，相同功能码的测点，地址不能重复，不同功能码的测点，地址可以重复；
如果有多个转发设备，不同转发设备下，测点地址也不能重复。
常见网络拓扑图¶
Ended: 隔离网闸
E文件 ↵
E文件生成¶
云端配置(E文件生成协议)¶
本协议暂不支持通过云端配置。
本地配置(E文件生成协议)¶
新建通道¶
新建一个转发通道，协议选择E文件生成协议，交互频率为解析(读取)E文件的时间间隔(E文件生成周期请参照下文在规约特征中配置)，交互频率建议设置为1000ms，可以适当放大、缩小，然后填写ip地址和端口号(填写对端虚拟IP地址和端口号)；
规约特征配置说明如下：
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 分隔符空格的数量 | 0表示用Tab键分隔(默认)，1表示1个空格分隔，2表示2个空格分隔，以此类推 |
| 1 | 时间精度 | 0精确到分钟(默认)，1精确到秒，通常保持默认即可 |
| 2 | 编码格式 | 0表示BGK编码，1表示UTF-8编码(默认)，通常保持默认即可 |
| 3 | 地区名称 | 格式为XX.YY(例如"杭州.滨江"可填写为HZ.BJ)，建议使用英文避免编码问题 |
| 4 | 厂站名称 | 例如"光伏电站"可填写为GF，建议使用英文避免编码问题 |
| 5 | 系统名称 | 保持默认即可，如非必要请勿修改 |
| 6 | E文件存储路径 | 保持默认即可，如非必要请勿修改 |
| 8 | 文件保存天数(0永久保存) | 保持默认即可，南瑞文件传输软件会负责删除文件 |
| 9 | E文件生成周期(单位:秒) | 默认60秒，根据测点个数可适当放大、缩小 |
| 10 | 遥测是否变位上送 | 若为1，则当遥测测点的值发生变化时，立刻生成E文件，默认为0 |
| 11 | 遥信是否变位上送 | 若为1，则当遥信测点的值发生变化时，立刻生成E文件，默认为1 |
| 12 | 自动发送E文件 | 若网络结构为常见网络拓扑图1，选择是(自动接收)；若网络结构为常见网络拓扑图2，选择否(依赖南瑞软件) |
新建设备¶
设备的参数自定义或保持默认即可，在本驱动中，设备的参数无实际意义。
新建测点¶
点击添加按钮，可以将采集测点选择为转发测点进行转发，转发功能码根据实际情况选择，然后填写测点的地址，其余参数保持默认即可；
注意
测点地址的填写范围为0-65535(含)，相同功能码的测点，地址不能重复，不同功能码的测点，地址可以重复；
如果有多个转发设备，不同转发设备下，测点地址也不能重复。
常见网络拓扑图1¶
E文件解析¶
云端配置(E文件解析协议)¶
本协议暂不支持通过云端配置。
本地配置(E文件解析协议)¶
新建通道¶
新建一个采集通道，协议选择E文件解析协议，然后填写ip地址为0.0.0.0，端口号以实际情况为准，其余参数默认即可；
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 分隔符空格的数量 | 0表示用Tab键分隔(默认)，1表示1个空格分隔，2表示2个空格分隔，以此类推 |
| 1 | 时间精度 | 0精确到分钟(默认)，1精确到秒，通常保持默认即可 |
| 2 | 编码格式 | 0表示BGK编码，1表示UTF-8编码(默认)，通常保持默认即可 |
| 3 | 地区名称 | 格式为XX.YY(例如"杭州.滨江"可填写为HZ.BJ)，建议使用英文避免编码问题 |
| 4 | 厂站名称 | 例如"光伏电站"可填写为GF，建议使用英文避免编码问题 |
| 5 | 系统名称 | 保持默认即可，如非必要请勿修改 |
| 6 | E文件存储路径 | 保持默认即可，如非必要请勿修改 |
| 7 | E文件备份路径 | 保持默认即可，如非必要请勿修改 |
| 8 | 备份保存天数(0不保存) | 保持默认即可，如非必要请勿修改 |
| 15 | 自动发送E文件 | 若网络结构为常见网络拓扑图1，选择是(自动接收)；若网络结构为常见网络拓扑图2，选择否(依赖南瑞软件) |
新建设备¶
设备的参数自定义或保持默认即可，在本驱动中，设备的参数无实际意义。
新建测点¶
新建一个采集测点， 测点功能码的选择必须和配置E文件生成协议时被转发的测点功能码相一致，同样的，测点地址的填写也必须一致，其余参数保持默认即可。
注意
测点地址的填写范围为0-65535(含)，相同功能码的测点，地址不能重复，不同功能码的测点，地址可以重复；
如果有多个转发设备，不同转发设备下，测点地址也不能重复。
常见网络拓扑图1¶
Ended: E文件
IEC61850 ↵
GOOSE_master¶
云端配置说明¶
新建通道¶
新建一个goose采集通道，协议选择Goose采集。其他参数无需设置。
注意
Goose采集需要指定监听的网卡，本协议默认在规约特征里配置了监听网卡为"NET1"，按实际需要修改该配置。
新建设备¶
在采集goose数据时，一个goose数据集对应一个设备。需要接收一个goose数据集的数据时，就需要新建一个设备，自定义设备名称，通讯地址填写Application ID即GOOSE数据的虚拟局域网应用连接ID，保留0填写GOOSE ID即，其余参数留空即可。
其中Application ID需要goose发送方提供。GOOSE ID在scd(或icd)文件的“GSEControl”元素中的“appID”字段值。如下图所示是一个goose模拟软件中相关的值。
新建测点¶
建好设备后，在数据集中选取需要读取的值，数据集中的一个值对应一个测点。测点按照goose数据集中的顺序来建立采集点，采集点的地址填该测点在数据集中的顺序即可，测点数据类型按照实际类型来填写。如下图所示的一个goose数据集，它对应的采集点的地址是0-21：
新建一个采集测点，如地址设置为10，那么就是取上图中数据集的“CBCSWI1.Pos.stVal”的值。
本地配置说明¶
新建通道¶
新建一个goose采集通道，协议选择Goose采集。其他参数无需设置。
注意
Goose采集需要指定监听的网卡，本协议默认在规约特征里配置了监听网卡为"NET1"，按实际需要修改该配置。
新建设备¶
在采集goose数据时，一个goose数据集对应一个设备。需要接收一个goose数据集的数据时，就需要新建一个设备，自定义设备名称，通讯地址填写Application ID即GOOSE数据的虚拟局域网应用连接ID，保留0填写GOOSE ID即，其余参数留空即可。
其中Application ID需要goose发送方提供。GOOSE ID在scd(或icd)文件的“GSEControl”元素中的“appID”字段值。如下图所示是一个goose模拟软件中相关的值。
新建测点¶
建好设备后，在数据集中选取需要读取的值，数据集中的一个值对应一个测点。测点按照goose数据集中的顺序来建立采集点，采集点的地址填该测点在数据集中的顺序即可，测点数据类型按照实际类型来填写。如下图所示的一个goose数据集，它对应的采集点的地址是0-21：
新建一个采集测点，如地址设置为10，那么就是取上图中数据集的“CBCSWI1.Pos.stVal”的值。
SV_master¶
云端配置说明¶
新建通道¶
新建一个SV采集通道，协议选择SV采集。其他参数无需设置。
设置规约参数¶
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 监听网卡 | 该通道的SV数据接入网口 |
| 1 | APPID | 接收的SV报文的APPID，该APPID的获取后面会详述 |
| 2 | 通信中断数据清零（不含遥信） | 检测到SV通信中断后，清除遥信以外的测点的值 |
| 3 | 通信中断遥信清零 | 检测到SV通信中断后，清除遥信测点的值 |
| 4 | 质量码字节数 | SV报文中每个值后面跟随的质量码字节数，一般不需要配置 |
| 5 | 采样平均值次数 | 实时值进行平均值计算时的采集次数。需要对实时值进行平均值计算时配置为大于0的值即可 |
SV的APPID可以用IEDScout软件打开客户提供的ICD/SCD文件，找到需要采集的SV逻辑设备的LLN0节点，然后找到其中的smvcb信息中的APPID的值，然后把它转换成十六进制填写到规约参数中即可。
新建设备¶
在采集SV数据时，一个SV数据集对应一个设备。需要接收一个SV数据集的数据时，就需要新建一个设备，自定义设备名称，通讯地址填写smvID其余参数留空即可。smvID可以用IEDScout软件打开客户提供的ICD/SCD文件，找到需要采集的SV逻辑设备的LLN0节点，然后找到其中的smvcb信息中的MsvID，如下图所示.
新建测点¶
建好设备后，在SV数据集中选取需要读取的值，数据集中的一个值对应一个测点。测点按照SV数据集中的顺序来建立采集点，采集点的地址填该测点在数据集中的字节偏移，测点数据类型按照实际类型来填写。如下图所示的一个SV数据集，每一项数据包含一个整型和一个质量码，因此每个数据项占用8字节，图中的测点序号是16，它对应的采集点的地址是128：
提示
功能码有效值是驱动在接收过程中根据SV报文中的smpCnt序号来进行计算，当smpCnt在增加时，每次值取绝对值进行累加，等待smpCnt变小，说明一次完整的SV采样值传输完毕，把此时的累积结果取平均值作为有效值输出到测点上，例如采样率是4000的SV控制块，会在一秒钟发送smpCnt从0~3999共4000个采样报文，驱动在收到3999->0这个报文时，计算出结果。实时值则是把每次接收到的SV报文的值输出给测点，如果在规约参数中配置了采样平均值次数大于零，则会对其配置的次数进行去平均值。
本地配置说明¶
新建通道¶
新建一个SV采集通道，协议选择SV采集。其他参数无需设置。
设置规约参数¶
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 监听网卡 | 该通道的SV数据接入网口 |
| 1 | APPID | 接收的SV报文的APPID，该APPID的获取后面会详述 |
| 2 | 通信中断数据清零（不含遥信） | 检测到SV通信中断后，清除遥信以外的测点的值 |
| 3 | 通信中断遥信清零 | 检测到SV通信中断后，清除遥信测点的值 |
| 4 | 质量码字节数 | SV报文中每个值后面跟随的质量码字节数，一般不需要配置 |
| 5 | 采样平均值次数 | 实时值进行平均值计算时的采集次数。需要对实时值进行平均值计算时配置为大于0的值即可 |
SV的APPID可以用IEDScout软件打开客户提供的ICD/SCD文件，找到需要采集的SV逻辑设备的LLN0节点，然后找到其中的smvcb信息中的APPID的值，然后把它转换成十六进制填写到规约参数中即可。
新建设备¶
在采集SV数据时，一个SV数据集对应一个设备。需要接收一个SV数据集的数据时，就需要新建一个设备，自定义设备名称，通讯地址填写smvID其余参数留空即可。smvID可以用IEDScout软件打开客户提供的ICD/SCD文件，找到需要采集的SV逻辑设备的LLN0节点，然后找到其中的smvcb信息中的MsvID，如下图所示.
新建测点¶
建好设备后，在SV数据集中选取需要读取的值，数据集中的一个值对应一个测点。测点按照SV数据集中的顺序来建立采集点，采集点的地址填该测点在数据集中的字节偏移，测点数据类型按照实际类型来填写。如下图所示的一个SV数据集，每一项数据包含一个整型和一个质量码，因此每个数据项占用8字节，图中的测点序号是16，它对应的采集点的地址是128：
提示
功能码有效值是驱动在接收过程中根据SV报文中的smpCnt序号来进行计算，当smpCnt在增加时，每次值取绝对值进行累加，等待smpCnt变小，说明一次完整的SV采样值传输完毕，把此时的累积结果取平均值作为有效值输出到测点上，例如采样率是4000的SV控制块，会在一秒钟发送smpCnt从0~3999共4000个采样报文，驱动在收到3999->0这个报文时，计算出结果。实时值则是把每次接收到的SV报文的值输出给测点，如果在规约参数中配置了采样平均值次数大于零，则会对其配置的次数进行去平均值。
GOOSE_slave_new¶
云端配置说明¶
新建通道¶
新建一个goose转发通道，协议选择Goose转发(新)。在通道的交互频率参数中设置goose报文的发送周期。
注意
Goose转发需要指定转发网卡，本协议默认在规约特征里配置了转发网卡为"NET1"，按实际需要修改该配置。
新建设备¶
转发goose设备，对应一个goose数据集。需要转发数据时，按数据集转发，一个数据集对应一个设备，按照实际需要创建设备。自定义设备名称，通讯地址填写GOOSE报文的Application ID。公共地址填写GOOSE报文的目标MAC地址，也可以不配置目标MAC地址，此时将使用默认MAC地址:01:0c:cd:01:00:01。保留0填写GOOSE ID。保留1填写DataSet reference。其余参数留空即可。
上图所配置的信息，在实际的goose报文中的信息如下。
新建测点¶
建好设备后，在设备中选择转发测点，作为GOOSE数据集中的Data。测点地址必须从0开始，且必须连续。地址不得出现空缺，否则该设备将无法发送GOOSE报文。测点数据类型按照实际类型来填写。
注意
如果转发的测点是遥控，遥信，其数据类型需要配置成位，系数K来区分是单点还是双点，1表示单点类型，2表示双点类型。
提示
以上配置发送的报文如下。
本地配置说明¶
新建通道¶
新建一个goose转发通道，协议选择Goose转发(新)。在通道的交互频率参数中设置goose报文的发送周期。
注意
Goose转发需要指定转发网卡，本协议默认在规约特征里配置了转发网卡为"NET1"，按实际需要修改该配置。
新建设备¶
转发goose设备，对应一个goose数据集。需要转发数据时，按数据集转发，一个数据集对应一个设备，按照实际需要创建设备。自定义设备名称，通讯地址填写GOOSE报文的Application ID。公共地址填写GOOSE报文的目标MAC地址，也可以不配置目标MAC地址，此时将使用默认MAC地址:01:0c:cd:01:00:01。保留0填写GOOSE ID。保留1填写DataSet reference。其余参数留空即可。
上图所配置的信息，在实际的goose报文中的信息如下。
新建测点¶
建好设备后，在设备中选择转发测点，作为GOOSE数据集中的Data。测点地址必须从0开始，且必须连续。地址不得出现空缺，否则该设备将无法发送GOOSE报文。测点数据类型按照实际类型来填写。
注意
如果转发的测点是遥控，遥信，其数据类型需要配置成位，系数K来区分是单点还是双点，1表示单点类型，2表示双点类型。
提示
以上配置发送的报文如下。
61850采集¶
本地配置说明¶
举例：要采集的远动设备的IP地址为192.168.0.22，UDP端口为102。
提示
目前61850的“ICD导入”功能只有在本公司的“数据配置工具”上实现。因此61850采集只能在本地“数据配置工具”上操作。云端暂时不支持该功能。
新建通道¶
新建一个采集通道,协议选择IEC60850客户端。主参数中，IP地址和端口号按实际填写,在本示例中填写的是:192.168.0.22:10；交互频率是读取测点实时值的周期(配置了报告读取则不受此影响)，一般保持默认即可，如果发现网关CPU负荷过高，应适当调大该参数。
导入ICD配置文件¶
选中上一步添加的IEC61850通道，点击“IEC导入”按钮。选中需要装载的IEC61850设备的ICD文件，配置软件会自动生成采集设备和测点。如下图所示。
提示
导入的ICD文件必须有且只有一个物理设备模型（即只有一个IED对象）。ICD文件不能重复导入，如想更换ICD文件，删除当前通道，然后新建一个通道重新选择ICD文件导入。
查看通道配置¶
ICD模型中的一个物理设备(IED)模型对应的一个采集通道。采集通道的保留0配置的是该IED的IED名.
查看设备配置¶
ICD模型中的一个逻辑节点(LN)会生成一个采集设备。采集设备的保留0配置的是该设备所属的逻辑设备(LD)名称,通信地址配置的是该设备的逻辑节点实例名称(lnClass+inst)。
查看测点配置¶
ICD模型中的每一个实例化数据对象对应一个采集测点。可以在测点界面上，选中全部来查看生成的所有测点，测点的数据类型可以忽略，IEC61850会自动根据读取的数据的实际类型来处理。
规约参数配置¶
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 按设备读取 | 若该参数为1，驱动会根据采集设备下的测点，在服务器上创建动态数据集，用动态数据集来读取数据 |
| 3-9 | 读取数据集 | 用配置的数据集来采集数据。如:TEMPLATEMONT/LLN0$dsDin |
| 10-16 | 报告Reference | 使能对应的报告，并用接收到的报告中的数据来采集数据，可以指定实例号,如:TEMPLATEMONT/LLN0BRbrcbDin03，或者自动获取实例号，如:TEMPLATEMONT/LLN0BRbrcbDin |
提示
规约参数中提到的3种数据读取方式，应该选其中的一种。如配置了报告Reference，就把按设备读取配置成0，并把读取数据集里面的配置清空。
模拟通信¶
工程下装重启之后，可以使用“IEDScout”软件来模拟IEC61850服务器。用“IEDScount”与网关进行61850通信。 “IEDScount”打开后，切换到“Simulator”界面。如下图所示：
61850转发¶
云端配置说明¶
[warning]注：目前61850的“ICD导出”功能只有在本公司的“数据配置工具”上实现。因此61850转发只能在本地“数据配置工具”上操作。钉工云暂时不支持该功能。
本地配置说明¶
新建通道¶
- 1.添加IEC61850服务器通道 选中左侧菜单中“数据配置工具-任务树”，然后点击通道配置表中“添加”按钮，默认增加1行通道配置，如下图： 新建一个IEC61850服务器，协议选择IEC61850服务器。在通道的交互频率控制数据刷新周期，因为这个默认参数比较大，故一般需要调整到3000即可。保留0配置IEDName，此参数可在ICD导出中配置。
提示
IEDName可以手动配置。如果CPU负荷过高，要适当加大交互频率。
规约参数配置¶
规约参数大多不需要配置，只需要关注下表中最后两条配置。
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 报告扫描间隔 | 该配置影响报告的响应速度，一般保持默认即可 |
| 1 | 缓冲报告缓冲大小 | 缓存报告的存储大小，一般保持默认即可 |
| 2 | 启用日志功能 | 已废弃 |
| 3 | 本端文件目录 | 当使用tftp功能读取装置录波文件时，录波文件存储在本机的路径 |
| 4 | 远端文件目录 | 已废弃 |
| 5 | 模拟数据 | 已废弃 |
| 6 | 模拟数据间隔 | 已废弃 |
| 7 | 模拟控制 | 已废弃 |
| 8 | 模拟定制组 | 已废弃 |
| 9 | 运行时类型最大值 | 已废弃 |
| 10 | 录波文件tftp服务器IP | 需要从装置读取录波文件时配置 |
| 11 | 录波文件tftp服务器端口 | 需要从装置读取录波文件时配置 |
| 12 | 双点遥信 | 已废弃 |
| 13 | 录波文件前缀 | 装置录波文件名的前缀 |
| 14 | 录波文件触发测点名前缀 | 此类测点表示装置中当前的录波值，发生变化会触发录波文件的读取 |
| 15 | 依据测点功能码生成数据对象 | 已废弃 |
| 16 | 使用转发测点地址创建对象 | 配置为1时，使用转发测点地址来创建数据对象。在多个设备下对象名称需要一样时要配置为1 |
| 17 | ICD文件IP地址 | 该配置会写入到ICD模型文件中，按需配置 |
| 18 | 创建录波设备 | 一般保持默认即可，在需要开启录波文件读取时开启 |
| 19 | 公共地址加入逻辑节点名称 | 创建逻辑节点时，用转发设备通信地址+公共地址作为其lnClass属性，来确保lnClass唯一性 |
| 20-30 | 各种类型测点的数据集名字 | 新工程建议将数据集中有'Relay'字段的数据集名字都改下，如把dsRelayDin改成dsDin |
| 31 | 版本号 | 把该配置为2.0时，创建的逻辑节点lnClass统一为'GGIO'，并且使用通信地址作为实例号。新工程建议将其配置为2.0 |
提示
数据集名字会影响报告的属性。在遇到61850客户端无法读取61850转发数据时，可以尝试修改数据集名字来解决，如把dsRelayDin改成dsDin。
警告
当把版本号配置为2.0之后，转发设备的通信地址必须修改为数字并且不能重复，否则建模会出错。
新建转发设备¶
①选择上一步建立的61850服务器通道； ②点击右上方的“ICD导出”按钮； ③在弹出的对话框中选中需要加入61850服务器中的设备，并根据需要设置IEDName名称；
点击确认后就能自动生产转发设备。如下图所示。
设备通信地址将作为61850的LN。保留0作为61850的LD，来自同一个采集通道下的设备将会被分配同样的LD。
提示
转发设备的对应的LN和LD可以手动编辑。一个LD下转发测点数量不能超过1000点。整个转发通道下的测点数量不能超过2000点。
提示
新建的工程建议将规约参数的版本号配置为2.0，并把转发设备地址从1开始递增。这样转发设备映射的逻辑节点就是"GGIO1,GGIO2..."，更加规范。
使用转发测点地址创建对象时的转发设备映射信息¶
当规约参数16 使用转发测点地址创建对象被配置为1时，转发设备映射到逻辑节点LN的规则会有所区别.如下图所示。
警告
由于转发通道名称会参与生成逻辑节点的lnType，因此转发通道名称不允许使用特殊符号或者中文名。
新建转发测点¶
警告
转发测点名会被映射成DO对象名，因此必须符合61850规范。测点名要用大写字母开始，不许用数字或特殊符号开头!!!。测点名中不要有特殊符号，也不要用中文名字，否则SCL软件导入时，在进行"Schema校验"时会报错从而导致无法导入。建议在采集通道创建测点时测点名字就按下表的规则命名。
| 测点类型 | 建议测点名 |
|---|---|
| 遥测测点 | AnInd1开始递增 |
| 遥信测点 | Ind1或Alm1开始递增 |
| 遥控测点 | SPCSO1开始递增 |
| 遥调测点 | ISCSO1开始递增 |
在第2步导出ICD后，在61850服务器通道下的设备会自动创建对应的设备和测点。目前暂不支持定值组的转发。在测点中需要配置功能码以及数据类型，不同的功能码，将被组织到不同的数据集中，如下图所示。
| 转发功能码 | CDC/FC | 数据集 |
|---|---|---|
| 保护遥信 | CN_SPS/ST | dsRelayDin |
| 保护遥测 | CN_MV/MX | dsRelayAin |
| 保护事件 | CN_ACT/ST | dsTripInfo |
| 故障信号 | CN_SPS/ST | dsAlarm |
| 告警信号 | CN_SPS/ST | dsWarning |
| 装置参数 | CN_ING_SP_EX/SP | dsParameter |
| 保护定值 | CN_ASG_SG_EX/SG | dsSetting |
| 保护压板 | CN_SPC/ST | dsRelayEna |
| 保护故障 | CN_MV_EX/MX | dsRelayRec |
| 模拟定值 | ASG/SP | dsSetPoint |
| 可控状态量 | SPC/DPC/INC /CO | dsRemoteCtrl |
| 可控模拟量 | APC/CO | dsRemoteReg |
提示
可控状态量根据其数据类型使用不同的CDC，一共有三种类型的:单点遥控，就是SPC；双点遥控，就是DPC;整型遥控，就是INC。
提示
遥控,遥信类型的转发测点，默认都是作为单点处理，如果需要作为双点处理，在系数上配置成2即可。遥测类型的测点的“转发数据类型”与源采集测点数据类型的对应关系如下：
| 源采集测点数据类型 | 转发测点数据类型 |
|---|---|
| 8位有符号 | 32位有符号 |
| 16位有符号 | 32位有符号 |
| 32位有符号 | 32位有符号 |
| 8位有符号 | 32位无符号 |
| 16位有符号 | 32位无符号 |
| 32位有符号 | 32位无符号 |
| 其他类型 | 单精度浮点 |
使用转发测点地址创建对象时的转发测点配置¶
需要把对象doName配置到转发测点地址上。
警告
所属设备的lnClass是一样的测点配置必须完全一样，否则会出错。
读取ICD文件¶
工程下发网关重启之后，61850转发通道工作之后，会按照转发通道配置，生成ICD文件，点击网关管理工具界面的读取ICD来读取生成的ICD文件。
模拟通信¶
下载配置，等待启动之后，可以使用“IEDScout”软件来模拟IEC61850客户端与PBox的61850转出通道通信。用“IEDScount”与网关进行61850通信。 “IEDScount”打开后，点击“Discover IED”图标。如下图所示：
在弹出的对话框的“IP address：”栏填写PBox的IP地址，填好之后，再点击“Discover”按钮。如下图所示：
如果通信成功，就能获取到PBox的61850转出数据信息了，如下图所示，点击“Read all”按钮可以更新当前数据。
如果要自动更新变化数据，则需要使能报告。选中对应的报告，然后点击“Enable”按就可以了。
使能成功后，在报告中的测点值发生后，就能在界面上看到发生变化的数据对应的节点路径上有感叹号。
控制数据（暂时只支持遥控）：选中要控制的数据属性，点击控制按钮，如下图所示：
在弹出的对话框中输入要写入的值，然后再点击“Operate”即可：
61850GXX¶
云端配置说明¶
[warning]注：目前61850的“ICD导出”功能只有在本公司的“数据配置工具”上实现。因此61850转发只能在本地“数据配置工具”上操作。钉工云暂时不支持该功能。
本地配置说明¶
新建通道¶
- 1.添加IEC61850服务器通道 选中左侧菜单中“数据配置工具-任务树”，然后点击通道配置表中“添加”按钮，默认增加1行通道配置，如下图： 新建一个IEC61850转高新兴，协议选择IEC61850转高新兴。在通道的交互频率参数中设置数据刷新周期。保留0或通道名称配置IEDName，优先使用保留0中的配置。
提示
IEDName可以手动配置。
- 2.规约参数配置
选中61850服务器通道，点击规约按钮，弹出规约特征配置，如下图所示。
根据实际需求修改规约参数，一般保持默认即可，如有特殊需要可以进行针对配置。 其中第10~12项，通过tftp协议从装置中获取录波文件和事件文件，根据实际情况配置；第17项ICD文件IP地址配置将会配置到生成的ICD文件中IP地址属性中。
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 0 | ST报告扫描周期 | 状态类数据报告的扫描周期 |
| 1 | MX报告扫描周期 | 测量值类数据报告的扫描周期 |
| 2 | 测点类型 | 61850建模时，选择转发测点哪个属性作为数据对象的名称。0:测点名称;1:测点地址;2:测点描述 |
| 3 | 文件路径 | 61850提供文件服务时，从网关的哪个路径取文件。有多个转发通道时，需要配置成不同的，避免通道间混淆 |
| 4 | ICD文件中的IP地址 | 改值会配置到生成的ICD文件中IP地址属性中，不配置的话，ICD文件中该值是192.168.2.202 |
| 5 | MX数据集名称 | 测量值类数据的数据集名称，如不配置则不创建该类数据集 |
| 6 | ST数据集名称 | 状态类数据的数据集名称，如不配置则不创建该类数据集 |
| 7 | CF数据集名称 | 配置类数据的数据集名称，如不配置则不创建该类数据集 |
| 8 | SP数据集名称 | 定值类数据的数据集名称，如不配置则不创建该类数据集 |
| 9 | CO数据集名称 | 控制类数据的数据集名称，如不配置则不创建该类数据集 |
| 10 | 公共逻辑设备名 | 把转发设备中哪个设备作为公共设备，公共设备中会汇集其他设备的数据集和报告控制块 |
- 3.新建设备
新建有一个设备，自定义设备名称，一个转发设备映射成一个61850数据模型中的一个逻辑节点(LN)。设备的设备描述LN的“lnClass”属性，设备通信地址填写LN的“inst”属性，设备公共地址填写该LN的父逻辑设备(LDevice)的"inst"属性。多个转发设备可以配置到同一个逻辑设备下，如下图所示。
- 4.新建测点 转发测点工具实际情况选择对应的功能码即可。数据类型一般不需要配置，程序会自动根据功能码自动为测点生成正确的数据类型。不过，也有下面三类功能码的测点允许配置数据类型。
| 功能码 | 支持的数据类型 |
|---|---|
| 采样定值(SAV) | 32位有符号,单精度浮点。默认配置是单精度浮点 |
| 测量值(MV) | 32位有符号,32位无符号,单精度浮点。默认配置是单精度浮点 |
| 模拟定值(ASG) | 32位有符号,单精度浮点。默认配置是单精度浮点 |
注意
使用不定长字符串定值(VSG)功能码时，只支持数据发送，不支持对该类型数据的写操作；
-
5.下载配置 配置完成后，保存，点击下装，下装完成之后，重启网关。
-
6.读取ICD文件 网关重启之后，61850转发通道工作之后，会按照转发通道配置，生成ICD文件，点击网关管理工具界面的读取ICD来读取生成的ICD文件。
-
7.模拟通信 下载配置，等待启动之后，可以使用“IEDScout”软件来模拟IEC61850客户端与PBox的61850转出通道通信。用“IEDScount”与网关进行61850通信。 “IEDScount”打开后，点击“Discover IED”图标。如下图所示：
在弹出的对话框的“IP address：”栏填写PBox的IP地址，填好之后，再点击“Discover”按钮。如下图所示：
如果通信成功，就能获取到PBox的61850转出数据信息了，如下图所示，点击“Read all”按钮可以更新当前数据。
如果要自动更新变化数据，则需要使能报告。选中对应的报告，然后点击“Enable”按就可以了。
使能成功后，在报告中的测点值发生后，就能在界面上看到发生变化的数据对应的节点路径上有感叹号。
控制数据（支持INC,SPC,DPC）：选中要控制的数据属性，点击控制按钮，如下图所示：
在弹出的对话框中输入要写入的值，然后再点击“Operate”即可：
定值设置
Ended: IEC61850
多功能电表 ↵
多功能电表DLT645-1997¶
云端配置(DLT645-1997)¶
新建通道¶
新建一个采集通道，协议选择DLT645-1997，主参数中，波特率选择1200，数据位8，停止位1，校验为偶校验，串口参数根据实际情况按需修改；
注意
因为波特率比较小，所以仪表回复数据的时间会比较久，若出现数据采集不到的情况，请调大交互频率(建议1000ms)、每帧间隔(建议1000ms)、超时(建议3000ms-8000ms)后再试。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写电表地址，地址长度为12位，不足12位的，高位补0，如下图所示：
提示
若不知道电表的地址，且一条485链路上只有一个电表，那么填写通配地址12个A(AAAAAAAAAAAA)再试。
强烈建议
新建设备时，可以勾选是否选择模板，然后在右侧搜索1997即可选择系统预设的点表模板。
新建测点¶
举例要采集电表的正向有功总，其寄存器地址为9010H(H代表9010为16进制)，那么功能码选择读数据，地址填写9010，其余参数保持默认即可，协议会根据报文自动适配。
提示
本协议新建测点时，地址按照16进制填写；
通常情况下，多功能电表都支持读取电能量数据，但是有少数电表不支持读取频率、电压、电流等三相数据。
本地配置(DLT645-1997)¶
新建通道¶
新建一个采集通道，协议选择DLT645-1997，主参数中，波特率选择1200，数据位8，停止位1，校验为偶校验，串口参数根据实际情况按需修改；
注意
因为波特率比较小，所以仪表回复数据的时间会比较久，若出现数据采集不到的情况，请调大交互频率(建议1000ms)、每帧间隔(建议1000ms)、超时(建议3000ms-8000ms)后再试。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写电表地址，地址长度为12位，不足12位的，高位补0，如下图所示：
提示
若不知道电表的地址，且一条485链路上只有一个电表，那么填写通配地址12个A(AAAAAAAAAAAA)再试。
新建测点¶
举例要采集电表的正向有功总，其寄存器地址为9010H(H代表9010为16进制)，那么功能码选择读数据，地址填写9010，其余参数保持默认即可，协议会根据报文自动适配。
提示
本协议新建测点时，地址按照16进制填写；
通常情况下，多功能电表都支持读取电能量数据，但是有少数电表不支持读取频率、电压、电流等三相数据。
点击下载点表模板：电能表DLT645-1997点表(仅电能量)
多功能电表DLT645-2007¶
云端配置(DLT645-2007)¶
新建通道¶
新建一个采集通道，协议选择DLT645-2007，主参数中，波特率选择2400，数据位8，停止位1，校验为偶校验，串口参数根据实际情况按需修改；
注意
因为波特率比较小，所以仪表回复数据的时间会比较久，若出现数据采集不到的情况，请调大交互频率(建议1000ms)、每帧间隔(建议1000ms)、超时(建议3000ms-8000ms)后再试。
提示
本协议支持切换协议类型为TCP，可做TCP Server接收DTU数据，此时设备公共地址填DTU的注册帧字符串；
本协议支持在规约特征中开启监听模式。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写电表地址，地址长度为12位，不足12位的，高位补0，如下图所示：
提示
若不知道电表的地址，且一条485链路上只有一个电表，那么填写通配地址12个A(AAAAAAAAAAAA)再试；
设备保留0字段为控制分合闸的密码和操作员代码，用点号分隔，若无需密码，则不用填写；举例密码为123456，那么保留0字段填写12345602(在结尾补02，意为指定鉴权方式)。
强烈建议
新建设备时，可以勾选是否选择模板，然后在右侧搜索2007即可选择系统预设的点表模板。
新建测点¶
数据采集¶
举例要采集电表的正向有功总，寄存器地址为00010000H(H代表00010000为16进制)，那么功能码选择读数据，地址填写10000(可省略高位的0)，其余参数保持默认即可，协议会根据报文自动适配。
提示
本协议新建测点时，地址按照16进制填写；
通常情况下，多功能电表都支持读取电能量数据，但是有少数电表不支持读取频率、电压、电流等三相数据。
广播地址请求正向有功总电能例子报文：
发送 → FE FE FE FE 68 AA AA AA AA AA AA 68 11 04 33 33 34 33 AE 16 (20 bytes)
接收 ← FE FE FE FE 68 06 58 89 41 15 00 68 91 08 33 33 34 33 87 89 89 33 3F 16 (24 bytes)
分合闸控制¶
举例新建一个分合闸控制点，功能码选择分合闸，其余参数默认即可，对该测点写1即为合闸，写0即为分闸。
注意
并非所有的多功能电表都支持分合闸控制，默认分闸功能码0x4d，合闸功能码0x4e，若实际功能码与默认的不同，那么请在规约特征中手动配置分合闸功能码(填写时类型为十六进制，且需要加上0x33)。
读分合闸状态¶
举例要采集电表的分合闸状态，功能码选择读数据，地址填4000503，高级设置中，勾选按位取值，取值起始位和终止位均为4，分合闸状态0意为合闸，1意为分闸。
提示
并非所有的多功能电表都支持读取分合闸状态。
写值配置¶
举例新建一个“额定电流整定值过载保护动作电流Ir1”的写值测点配置，该点数据标识是04001401，数据类型是3字节BCD码，系数是0.1，如下图所示:
新建一个测点，功能码选择写数据，系数配置为0.1,在高级属性中的辅助参数配置为3来指示字节数量，其余参数默认即可。如下两图所示:
提示
目前只支持字节数为1~4字节的BCD类型的写值。如果字节数可以通过数据类型来确定，就无需配置辅助参数。如1字节的BCD，配置测点的数据类型为8位无符号即可，其他依次类推。
读负荷记录¶
举例新建一个"读最近一块负荷记录块"的测点，功能码选择读负荷记录，地址填6000002，数据类型选择实际要采集的数据类型选择，如下图所示：
提示
负荷记录返回报文长度会很长不能放到一个测点里进行解析，所以我们需要多配置几个相同地址的测点，并添加不同的辅助参数，让多个测点根据其自身的辅助参数对同一包进行分段解析
如果要读该负荷记录块的其他内容，请配置相同的寄存器地址并参照下表并给予不同的辅助参数。
-
负荷记录块各数据地址：
属性 参数 属性 参数 属性 参数 时间 1 B相有功功率 a 反向有功总电能 j A相电压 2 C相有功功率 b 组合无功1总电能 k B相电压 3 A相无功功率 c 组合无功2总电能 i C相电压 4 B相无功功率 d 第一象限无功总电能 m A相电流 5 C相无功功率 e 第二象限无功总电能 n B相电流 6 A相功率因数 f 第三象限无功总电能 o C相电流 7 B相功率因数 g 第四象限无功总电能 p 频率 8 C相功率因数 h 当前有功需量 q A相有功功率 9 正向有功总电能 i 当前无功需量 r 总有功功率 9 总无功功率 i 总功率因数 r
读冻结数据¶
功能码选择读数据，地址填05000101，数据类型选择单精度浮点数，如上图所示该测点返回报文长度会很长不能放到一个测点里进行解析，所以我们需要多配置几个相同地址的测点，并添加不同的辅助参数，让多个测点根据其自身的辅助参数对同一包进行分段解析，如下图所示：
读事件记录¶
举例新建一个读"(上 1 次)电压不平衡发生时刻"的测点，该点数据标识是16000101，数据类型是16位有符号数，如下图所示:
功能码选择读数据，地址填16000101， 数据类型选择16位有符号数，如上图所示 该测点返回报文长度有6位所以不能放到一个测点里进行解析，所以我们需要多配置几个相同地址的测点，并添加不同的辅助参数，让多个测点根据其自身的辅助参数对同一包进行分段解析，如下图所示：
提示
若数据长度在一个测点里可以展示出来，只配置一个测点即可，配置方法参考数据采集 。
本地配置(DLT645-2007)¶
新建通道¶
新建一个采集通道，协议选择DLT645-2007，主参数中，波特率选择2400，数据位8，停止位1，校验为偶校验，串口参数根据实际情况按需修改；
注意
因为波特率比较小，所以仪表回复数据的时间会比较久，若出现数据采集不到的情况，请调大交互频率(建议1000ms)、每帧间隔(建议1000ms)、超时(建议3000ms-8000ms)后再试。
提示
本协议支持切换协议类型为TCP，可做TCP Server接收DTU数据，此时设备公共地址填DTU的注册帧字符串。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写电表地址，地址长度为12位，不足12位的，高位补0，如下图所示：
提示
若不知道电表的地址，且一条485链路上只有一个电表，那么填写通配地址12个A(AAAAAAAAAAAA)再试。
设备保留0字段为控制分合闸的密码和操作员代码，用点号分隔，若无需密码，则不用填写；举例密码为123456，那么保留0字段填写12345602(在结尾补02，意为指定鉴权方式)
新建测点¶
数据采集¶
举例要采集电表的正向有功总，寄存器地址为00010000H(H代表00010000为16进制)，那么功能码选择读数据，地址填写10000(可省略高位的0)，其余参数保持默认即可，协议会根据报文自动适配。
广播地址请求正向有功总电能例子报文：
发送 → FE FE FE FE 68 AA AA AA AA AA AA 68 11 04 33 33 34 33 AE 16 (20 bytes)
接收 ← FE FE FE FE 68 06 58 89 41 15 00 68 91 08 33 33 34 33 87 89 89 33 3F 16 (24 bytes)
分合闸控制¶
举例新建一个分合闸控制点，功能码选择分合闸，其余参数默认即可，对该测点写1即为合闸，写0即为分闸。
注意
并非所有的多功能电表都支持分合闸控制，默认分闸功能码0x4d，合闸功能码0x4e，若实际功能码与默认的不同，那么请在规约特征中手动配置分合闸功能码(填写时类型为十六进制，且需要加上0x33)。
读分合闸状态¶
举例要采集电表的分合闸状态，功能码选择读数据，地址填4000503，按位取值选是，取值起始位和终止位均为4，分合闸状态0意为合闸，1意为分闸。
提示
并非所有的多功能电表都支持读取分合闸状态。
写值配置¶
举例新建一个“额定电流整定值过载保护动作电流Ir1”的写值测点配置，该点数据标识是04001401，数据类型是3字节BCD码，系数是0.1，如下图所示:
新建一个测点，功能码选择写数据，系数配置为0.1,在高级属性中的辅助参数配置为3来指示字节数量，其余参数默认即可。如下两图所示:
提示
目前只支持字节数为1~4字节的BCD类型的写值。如果字节数可以通过数据类型来确定，就无需配置辅助参数。如1字节的BCD，配置测点的数据类型为8位无符号即可，其他依次类推。
读负荷记录¶
举例新建一个"读最近一块负荷记录块"的测点，功能码选择读负荷记录，地址填6000002，数据类型选择实际要采集的数据类型选择，如下图所示：
提示
负荷记录返回报文长度会很长不能放到一个测点里进行解析，所以我们需要多配置几个相同地址的测点，并添加不同的辅助参数，让多个测点根据其自身的辅助参数对同一包进行分段解析
如果要读该负荷记录块的其他内容，请配置相同的寄存器地址并参照下表并给予不同的辅助参数。
-
负荷记录块各数据地址：
-
负荷记录块各数据地址：
属性 参数 属性 参数 属性 参数 时间 1 B相有功功率 a 反向有功总电能 j A相电压 2 C相有功功率 b 组合无功1总电能 k B相电压 3 A相无功功率 c 组合无功2总电能 i C相电压 4 B相无功功率 d 第一象限无功总电能 m A相电流 5 C相无功功率 e 第二象限无功总电能 n B相电流 6 A相功率因数 f 第三象限无功总电能 o C相电流 7 B相功率因数 g 第四象限无功总电能 p 频率 8 C相功率因数 h 当前有功需量 q A相有功功率 9 正向有功总电能 i 当前无功需量 r 总有功功率 9 总无功功率 i 总功率因数 r
读冻结数据¶
举例新建一个读“（上 1 次）定时冻结正向有功电能数据”的测点，该点数据标识是05000101，数据类型是单精度浮点数，如下图所示:
功能码选择读数据，地址填05000101， 数据类型选择单精度浮点数，如上图所示 该测点返回报文长度会很长不能放到一个测点里进行解析，所以我们需要多配置几个相同地址的测点，并添加不同的辅助数据标识，让多个测点解析同一包数据，从而完成解析，如下图所示：
读事件记录¶
举例新建一个读“（上 1 次）电压不平衡发生时刻”的测点，该点数据标识是16000101，数据类型是16位有符号数，如下图所示:
功能码选择读数据，地址填16000101， 数据类型选择16位有符号数，如上图所示 该测点返回报文长度有6位所以不能放到一个测点里进行解析，所以我们需要多配置几个相同地址的测点，并添加不同的辅助数据标识，让多个测点解析同一包数据，从而完成解析，如下图所示：
提示
若数据长度在一个测点里可以展示出来，那配置一个测点就好了，配置方法参考 数据采集
常用数据地址¶
-
正向有功数据块(格式XXXXXX.XX)：
属性 地址 正向有功总电量 00010000 正向有功尖电量 00010100 正向有功峰电量 00010200 正向有功平电量 00010300 正向有功谷电量 00010400 -
反向有功数据块(格式XXXXXX.XX)：
属性 地址 反向有功总电量 00020000 反向有功尖电量 00020100 反向有功峰电量 00020200 反向有功平电量 00020300 反向有功谷电量 00020400 -
电压数据块(格式XXX.X)：
属性 地址 A相电压 02010100 B相电压 02010200 C相电压 02010300 -
电流数据块(格式XXX.XXX)：
属性 地址 A相电流 02020100 B相电流 02020200 C相电流 02020300 -
瞬时有功功率数据块(格式XX.XXXX)：
属性 地址 瞬时总有功功率 02030000 瞬时A相有功功率 02030100 瞬时B相有功功率 02030200 瞬时C相有功功率 02030300 -
瞬时无功功率数据块(格式XX.XXXX)：
属性 地址 瞬时总无功功率 02040000 瞬时A相无功功率 02040100 瞬时B相无功功率 02040200 瞬时C相无功功率 02040300 -
瞬时视在功率数据块(格式XX.XXXX)：
属性 地址 瞬时总视在功率 02050000 瞬时A相视在功率 02050100 瞬时B相视在功率 02050200 瞬时C相视在功率 02050300 -
功率因数数据块(格式X.XXX)：
属性 地址 总功率因数 02060000 A相功率因数 02060100 B相功率因数 02060200 C相功率因数 02060300
多功能电表DLT698.45-2017¶
云端配置(DLT698.45-2017)¶
新建通道¶
新建一个采集通道，协议选择DLT698.45-2017，本通道的通道地址为客户机地址(即自己的地址)，默认为1，按需修改；
主参数中，波特率选择9600，数据位8，停止位1，校验为偶校验，根据实际情况按需修改；
注意
因为波特率比较小，所以仪表回复数据的时间会比较久，若出现数据采集不到的情况，请调大交互频率(建议1000ms)、每帧间隔(建议1000ms)、超时(建议3000ms-8000ms)后再试；
如果通道监测有报文交互，但是采集不到数据，那么将通道地址设置为160后再试。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写电表地址，地址长度为12位，不足12位的，高位补0，如下图所示：
提示
若不知道电表的地址，且一条485链路上只有一个电表，那么填写通配地址12个A(AAAAAAAAAAAA)再试。
强烈建议
新建设备时，可以勾选是否选择模板，然后在右侧搜索2017即可选择系统预设的点表模板。
新建测点¶
举例采集电表的正向有功总电能，它属于电能量类，查表可知电能量类对象标识为"OIA1"(见图1)，那么再查"OIA1"对应的表A.2(见图2)，得到正向有功电能的OI值为0010；再查电能量接口类定义表(见图3)，可知电能量属性中，总及费率电能量数组的索引为02，再查电能量类属性说明(见图4)可知，第1个数组元素是总电能量，那么索引为01，由此可得正向有功总电能测点地址为00100201(易得正向费率1电能量地址为00100202，依次类推)，测点配置见图5。
本地配置(DLT698.45-2017)¶
新建通道¶
新建一个采集通道，协议选择DLT698.45-2017，本通道的通道地址为客户机地址(即自己的地址)，默认为1，按需修改；
主参数中，波特率选择9600，数据位8，停止位1，校验为偶校验，根据实际情况按需修改；
注意
因为波特率比较小，所以仪表回复数据的时间会比较久，若出现数据采集不到的情况，请调大交互频率(建议1000ms)、每帧间隔(建议1000ms)、超时(建议3000ms-8000ms)后再试；
如果通道监测有报文交互，但是采集不到数据，那么将通道地址设置为160后再试。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写电表地址，地址长度为12位，不足12位的，高位补0，如下图所示：
提示
若不知道电表的地址，且一条485链路上只有一个电表，那么填写通配地址12个A(AAAAAAAAAAAA)再试。
新建测点¶
举例采集电表的正向有功总电能，它属于电能量类，查表可知电能量类对象标识为"OIA1"(见图1)，那么再查"OIA1"对应的表A.2(见图2)，得到正向有功电能的OI值为0010；再查电能量接口类定义表(见图3)，可知电能量属性中，总及费率电能量数组的索引为02，再查电能量类属性说明(见图4)可知，第1个数组元素是总电能量，那么索引为01，由此可得正向有功总电能测点地址为00100201(易得正向费率1电能量地址为00100202，依次类推)，测点配置见图5。
提示
点击下载点表模板：电能表DLT698.45-2017点表(含三相数据)
常用数据地址¶
-
电能量类：
属性名称 对象标识(OI) 属性编号 属性内元素索引 转换为地址 组合有功总电能 0000 02 01 00000201 组合有功尖电能 0000 02 02 00000202 组合有功峰电能 0000 02 03 00000203 组合有功平电能 0000 02 04 00000204 组合有功谷电能 0000 02 05 00000205 正向有功总电能 0010 02 01 00100201 正向有功尖电能 0010 02 02 00100202 正向有功峰电能 0010 02 03 00100203 正向有功平电能 0010 02 04 00100204 正向有功谷电能 0010 02 05 00100205 反向有功总电能 0020 02 01 00200201 反向有功尖电能 0020 02 02 00200202 反向有功峰电能 0020 02 03 00200203 反向有功平电能 0020 02 04 00200204 反向有功谷电能 0020 02 05 00200205 -
分相变量类：
属性名称 对象标识(OI) 属性编号 属性内元素索引 转换为地址 A相电压 2000 02 01 20000201 B相电压 2000 02 02 20000202 C相电压 2000 02 03 20000203 A相电流 2001 02 01 20010201 B相电流 2001 02 02 20010202 C相电流 2001 02 03 20010203 -
功率类：
属性名称 对象标识(OI) 属性编号 属性内元素索引 转换为地址 总有功功率 2004 02 01 20040201 A相有功功率 2004 02 02 20040202 B相有功功率 2004 02 03 20040203 C相有功功率 2004 02 04 20040204 总无功功率 2005 02 01 20050201 A相无功功率 2005 02 02 20050202 B相无功功率 2005 02 03 20050203 C相无功功率 2005 02 04 20050204 总视在功率 2006 02 01 20060201 A相视在功率 2006 02 02 20060202 B相视在功率 2006 02 03 20060203 C相视在功率 2006 02 04 20060204 总功率因数 200A 02 01 200A0201 A相功率因数 200A 02 02 200A0202 B相功率因数 200A 02 03 200A0203 C相功率因数 200A 02 04 200A0204 -
数据变量类：
属性名称 对象标识(OI) 属性编号 属性内元素索引 转换为地址 频率 200F 02 00 200F0200 表内温度 2010 02 00 20100200
集中器1376.1¶
集中器Q/GDW-1376.1(2012)¶
云端配置(Q/GDW-1376.1)¶
新建通道¶
新建一个采集通道，协议选择集中器GDW1376.1，主参数中，端口号根据集中器里配置的主用端口填写，其余参数保持默认即可；
注意
因为集中器本身采集的效率不高，所以采集通道的交互频率不宜设置的太小，例如集中器下有10块多功能表要采集，那么本通道的交互频率建议设置为180000ms(3分钟)。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写集中器的行政代码与终端地址拼接后的结果，公共地址填写集中器里的测量点号Pn(测量点号Pn指集中器的抄表顺序，集中器抄表时先抄测量点号1的表、再抄测量点号2的表...)，保留0暂无作用，可以用于备注该仪表的终端地址。
强烈建议
新建设备时，可以勾选是否选择模板，然后在右侧搜索集中器即可选择系统预设的点表模板。
新建测点¶
新建一个测点，功能码选择请求1类数据，寄存器地址填写33.1，33意为Fn33(含当前正向有/无功电能示值、一/四象限无功电能示值等数据)，1意为本数组(详见文末表格)中的第1个数据：抄表时间，数据类型选择字符串；
新建一个测点，功能码选择请求1类数据，寄存器地址填写33.3，33意为Fn33(含当前正向有/无功电能示值、一/四象限无功电能示值等数据)，3意为本数组(详见文末表格)中第3个数据：正向有功总电能，数据类型保持默认即可；
新建一个测点，功能码选择请求1类数据，寄存器地址填写25.6，25意为Fn25(含当前三相及总有/无功功率、功率因数，三相电压、电流、零序电流、视在功率等数据)，6意为本数组(详见文末表格)中第6个数据：总无功功率，数据类型保持默认即可；
本地配置(Q/GDW-1376.1)¶
新建通道¶
新建一个采集通道，协议选择集中器GDW1376.1，主参数中，端口号根据集中器里配置的主用端口填写，其余参数保持默认即可；
注意
因为集中器本身采集的效率不高，所以采集通道的交互频率不宜设置的太小，例如集中器下有10块多功能表要采集，那么本通道的交互频率建议设置为180000ms(3分钟)。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写集中器的行政代码与终端地址拼接后的结果，公共地址填写集中器里的测量点号Pn(测量点号Pn指集中器的抄表顺序，集中器抄表时先抄测量点号1的表、再抄测量点号2的表...)，保留0暂无作用，可以用于备注该仪表的终端地址。
新建测点¶
新建一个测点，功能码选择请求1类数据，寄存器地址填写33.1，33意为Fn33(含当前正向有/无功电能示值、一/四象限无功电能示值等数据)，1意为本数组(详见文末表格)中的第1个数据：抄表时间，数据类型选择字符串；
新建一个测点，功能码选择请求1类数据，寄存器地址填写33.3，33意为Fn33(含当前正向有/无功电能示值、一/四象限无功电能示值等数据)，3意为本数组(详见文末表格)中第3个数据：正向有功总电能，数据类型保持默认即可；
新建一个测点，功能码选择请求1类数据，寄存器地址填写25.6，25意为Fn25(含当前三相及总有/无功功率、功率因数，三相电压、电流、零序电流、视在功率等数据)，6意为本数组(详见文末表格)中第6个数据：总无功功率，数据类型保持默认即可；
提示
点击下载点表模板：集中器GDW1376.1点表
常用数据地址¶
-
表Fn25：
数据序号 数据内容 1 抄表时间 2 总有功功率 3 A相有功功率 4 B相有功功率 5 C相有功功率 6 总无功功率 7 A相无功功率 8 B相无功功率 9 C相无功功率 10 功率因数 11 A相功率因数 12 B相功率因数 13 C相功率因数 14 A相电压 15 B相电压 16 C相电压 17 A相电流 18 B相电流 19 C相电流 20 零序电流 21 总视在功率 22 A相视在功率 23 B相视在功率 24 C相视在功率 -
表Fn33：
数据序号 数据内容 1 抄表时间 2 费率个数(通常为4,1≤n≤12) 3 当前正向有功总电能示值 4 当前费率1正向有功总电能示值(尖) 5 当前费率2正向有功总电能示值(峰) 6 当前费率3正向有功总电能示值(平) 7 当前费率4正向有功总电能示值(谷) ... ... n+3 当前费率n正向有功总电能示值(n≤12)
Ended: 多功能电表
四方继保 ↵
CSC2000采集(四方继保)¶
云端配置(CSC2000采集)¶
新建通道¶
举例：要采集的继电保护装置的IP地址为192.168.1.32，组播IP地址为236.8.8.8，UDP主站接收端口为1888，发送端口为1889。
新建一个采集通道，协议选择四方CSC2000采集，主参数中，IP地址填写236.8.8.8，端口号填1888；
提示
如果能ping通保护的IP，但是通道监测一直收不到数据，那么将和保护相连的网口设置为默认网关，或者添加路由236.8.8.8/32下一跳192.168.1.1再试。
新建设备¶
新建一个设备，设备的通讯地址填写该保护的IP地址，例如192.168.1.32，通讯地址的最后一部分(本例中为32)应该设置为该保护的设备LON网地址；
提示
假如设备LON网地址错误，仅影响遥控；
可以在规约特征中启用将设备公共地址作为LON网地址，否则自动取IP最后一部分作为LON网地址，当同一个IP地址包含多个LON网地址设备的数据时必须开启此项。
新建测点¶
采集¶
新建一个测点，功能码按实际情况选择，地址7.1意为：该测点所在的组号为7，在该组中的序号为1，数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
提示
关于数据类型，当功能码选择YM(遥脉)时，选择单精度浮点数，按照4字节浮点(或3字节浮点自动适配)解析，高低位默认即可；
选择32位无符号，按照4字节整型解析，高低位通常为4321；选择16位无符号，高低位通常为21，按照2字节整型解析。
控制¶
新建一个测点，功能码选择YK(遥控)，默认0组为断路器组，1组为压板组，写0代表分，写1代表合。
本地配置(CSC2000采集)¶
新建通道¶
举例：要采集的继电保护装置的IP地址为192.168.1.32，组播IP地址为236.8.8.8，UDP主站接收端口为1888，发送端口为1889。
新建一个采集通道，协议选择四方CSC2000采集，主参数中，IP地址填写236.8.8.8，端口号填1888；
提示
如果能ping通保护的IP，但是通道监测一直收不到数据，那么将和保护相连的网口设置为默认网关，或者添加路由236.8.8.8/32下一跳192.168.1.1再试。
新建设备¶
新建一个设备，设备的通讯地址填写该保护的IP地址，例如192.168.1.32，通讯地址的最后一部分(本例中为32)应该设置为该保护的设备LON网地址；
提示
假如设备LON网地址错误，仅影响遥控；
可以在规约特征中启用将设备公共地址作为LON网地址，否则自动取IP最后一部分作为LON网地址，当同一个IP地址包含多个LON网地址设备的数据时必须开启此项。
新建测点¶
采集¶
新建一个测点，功能码按实际情况选择，地址7.1意为：该测点所在的组号为7，在该组中的序号为1，数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
提示
关于数据类型，当功能码选择YM(遥脉)时，选择单精度浮点数，按照4字节浮点(或3字节浮点自动适配)解析，高低位默认即可；
选择32位无符号，按照4字节整型解析，高低位通常为4321；选择16位无符号，高低位通常为21，按照2字节整型解析。
控制¶
新建一个测点，功能码选择YK(遥控)，默认0组为断路器组，1组为压板组，写0代表分，写1代表合。
CSC2000转发(四方继保)¶
云端配置(CSC2000转发)¶
新建通道¶
举例：本网关模拟充当CSC2000保护装置，组播IP地址为236.8.8.8，UDP发送端口为1888，接收端口为1889。
新建一个转发通道，协议选择四方CSC2000转发，主参数中，IP地址填写236.8.8.8，端口号填1888；
新建设备¶
新建一个设备，设备的通讯地址填写要模拟的保护装置的设备地址；
提示
假如设备地址错误，仅影响遥控。
新建测点¶
新建一个遥测点，功能码按实际情况选择，地址7.1意为：该测点所在的组号为7，在该组中的序号为1，数据类型与数据格式保持默认即可。
遥测起始组号从0开始，组内序号从0开始，遥测1组限6个测点，例如1.0~1.5是有效地址，1.6这种地址是无效的；
遥信起始组号从1开始，组内序号从0开始，遥信1个组内分两个小组，每个小组限8个测点，例如小组3.0~3.7和小组4.0~4.7，同属于遥信第2组，3.8这种地址是无效的；
新建一个遥控点，默认0组为断路器组，1组为压板组，如下图；
本地配置(CSC2000转发)¶
新建通道¶
举例：本网关模拟充当CSC2000保护装置，组播IP地址为236.8.8.8，UDP发送端口为1888，接收端口为1889。
新建一个转发通道，协议选择CSC2000转发，主参数中，IP地址填写236.8.8.8，端口号填1888；
新建设备¶
新建一个设备，设备的通讯地址填写要模拟的保护装置的设备地址；
提示
假如设备地址错误，仅影响遥控。
新建测点¶
新建一个遥测点，功能码按实际情况选择，地址7.1意为：该测点所在的组号为7，在该组中的序号为1，数据类型与数据格式保持默认即可。
遥测起始组号从0开始，组内序号从0开始，遥测1组限6个测点，例如1.0~1.5是有效地址，1.6这种地址是无效的；
遥信起始组号从1开始，组内序号从0开始，遥信1个组内分两个小组，每个小组限8个测点，例如小组3.0~3.7和小组4.0~4.7，同属于遥信第2组，3.8这种地址是无效的；
新建一个遥控点，默认0组为断路器组，1组为压板组，如下图；
Ended: 四方继保
CDT循环式远动规约 ↵
串口CDT采集¶
云端配置(串口CDT采集)¶
新建通道¶
新建一个采集通道，协议选择串口CDT采集(标准)，主参数中，串口号按实际情况选择，其余参数保持默认即可；规约参数中可以设置是否解析溢出标志和有效标志
新建设备¶
新建一个设备，设备的通讯地址填写该保护设备下的子设备的地址，其余参数保持默认即可；
新建测点¶
新建一个测点，功能码按实际情况选择，地址即为CDT规约中的地址，数据类型保持默认，数据格式选择21，协议会根据报文内容自动解析；下图的地址0.1，0意为第0个遥测，1意为地址0中的第1个值(一个地址里存两个值，其索引分别为0和1)；
同理采集遥信时，地址应填写类似于240.0这样的格式。
本地配置(串口CDT采集)¶
新建通道¶
新建一个采集通道，协议选择串口CDT采集(标准)，主参数中，串口号按实际情况选择，其余参数保持默认即可；规约参数中可以设置是否解析溢出标志和有效标志
新建设备¶
新建一个设备，设备的通讯地址填写该保护设备下的子设备的地址，其余参数保持默认即可；
新建测点¶
新建一个测点，功能码按实际情况选择，地址即为CDT规约中的地址，数据类型保持默认，高低位顺序选择21，协议会根据报文内容自动解析；下图的地址0.1，0意为第0个遥测，1意为地址0中的第1个值(一个地址里存两个值，其索引分别为0和1)；
同理采集遥信时，地址应填写类似于240.0这样的格式。
串口CDT转发¶
云端配置(串口CDT转发)¶
新建通道¶
新建一个转发通道，协议选择串口CDT转发(标准)，主参数中，串口号按实际情况选择，其余参数保持默认即可；
新建设备¶
新建一个设备，设备的通讯地址填写该保护设备下的子设备的地址，其余参数保持默认即可；
新建测点¶
新建一个测点，功能码按实际情况选择，数据类型与数据格式保持默认即可，地址从0递增即可；
本地配置(串口CDT转发)¶
新建通道¶
新建一转发通道，协议选择串口CD转发(标准)，主参数中，串口号按实际情况选择，其余参数保持默认即可；
新建设备¶
新建一个设备，设备的通讯地址填写该保护设备下的子设备的地址，其余参数保持默认即可；
新建测点¶
添加一个转发测点，功能码按实际情况选择，数据类型与数据格式保持默认即可，地址从0递增即可；
CDT7采集正泰自动化¶
云端配置(CDT7采集)¶
新建通道¶
举例：要采集的远动设备的IP地址为192.168.1.249，UDP端口为6000。
新建一个采集通道，协议选择CDT7采集(正泰自动化)，主参数中，IP地址填写192.168.1.249，端口号填6000，其余参数保持默认即可；
新建设备¶
新建一个设备，设备的通讯地址填写该保护设备下的子设备的地址，其余参数保持默认即可；
新建测点¶
新建一个测点，功能码按实际情况选择，地址即为CDT规约中的地址，数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
本地配置(CDT7采集)¶
新建通道¶
举例：要采集的远动设备的IP地址为192.168.1.249，UDP端口为6000。
新建一个采集通道，协议选择CDT7采集(正泰自动化)，主参数中，IP地址填写192.168.1.249，端口号填6000，其余参数保持默认即可；
新建设备¶
新建一个设备，设备的通讯地址填写该保护设备下的子设备的地址，其余参数保持默认即可；
新建测点¶
新建一个测点，功能码按实际情况选择，地址即为CDT规约中的地址，数据类型与数据格式保持默认即可，协议会根据报文内容自动解析。
Ended: CDT循环式远动规约
网络安全 ↵
syslog采集¶
云端配置(syslog采集)¶
新建通道¶
新建一个采集通道，协议选择syslog采集，IP地址与端口号保持默认既可。
提示
使用本驱动需要额外安装插件，请参照插件下载。
新建设备¶
新建一个设备，自定义设备名称，例如"防火墙"，设备描述处填写设备厂家名称，例如"绿盟"，设备的通讯地址填写要采集的网络设备的IP地址，并正确选择兼容平台与设备类型。
绿盟防火墙在系统->系统配置->引擎->NanRui服务器配置项中，填写智能网关的IP与端口(端口号默认即可)，本选项默认不带，需要对防火墙进行升级后才可配置。
新建测点¶
只需要新建一个通讯中断点既可。
注意
由于本协议为UDP协议，无法根据连接情况判断子设备通讯状态，请根据实际需求在本协议的规约特征中配置启用ping探测子设备；
启用：1分钟探测一次，当本机能ping通子设备时，认为子设备在线，通讯正常，否则认为通讯中断；
禁用：3分钟内接收到过syslog报文，则通讯正常，超过3分钟未接收到任何报文，认为通讯中断。
本地配置(syslog采集)¶
新建通道¶
新建一个采集通道，协议选择syslog采集，IP地址与端口号保持默认既可。
提示
使用本驱动需要额外安装插件，请向我们技术支持索取插件升级包。
新建设备¶
新建一个设备，自定义设备名称，例如"防火墙"，设备描述处填写设备厂家名称，例如"绿盟"，设备的通讯地址填写要采集的网络设备的IP地址，并正确选择兼容平台与设备类型。
绿盟防火墙在系统->系统配置->引擎->NanRui服务器配置项中，填写智能网关的IP与端口(端口号默认即可)，本选项默认不带，需要对防火墙进行升级后才可配置。
新建测点¶
只需要新建一个通讯中断点既可；
注意
由于本协议为UDP协议，无法根据连接情况判断子设备通讯状态，请根据实际需求在本协议的规约特征中配置启用ping探测子设备；
启用：1分钟探测一次，当本机能ping通子设备时，认为子设备在线，通讯正常，否则认为通讯中断；
禁用：3分钟内接收到过syslog报文，则通讯正常，超过3分钟未接收到任何报文，认为通讯中断。
snmp采集¶
云端配置(snmp采集)¶
新建通道¶
新建一个采集通道，协议选择snmp采集，IP地址与端口号保持默认既可。
新建设备¶
单个子设备同一时间只能接入一个SNMP版本，推荐使用SNMPv2；
SNMPv1/SNMPv2c：
新建一个设备，自定义设备名称，例如"交换机"，设备的通讯地址填写要采集的网络设备的IP地址，
设备描述填写设备厂家命名，例如"H3C"，兼容平台选择网安资产，设备类型选择交换机(根据实际情况选择)，
保留0为只读团体名，例如"public"，保留1为读写团体名，例如"private"，可自定义修改，
H3C交换机的SNMP团体配置页面，只读团体名为public，读写团体名为private，可新增自定义团体名，新增目的主机转发时，安全字填写团体名，且需要和前述新建设备时的保留0或者保留1相对应。
SNMPv3：
新建一个设备，自定义设备名称，例如"交换机"，设备的通讯地址填写要采集的网络设备的IP地址，
公共地址为要采集的网络设备的EngineID(引擎ID)，设备描述为用户名(建议采用设备厂家命名，例如"H3C")，
兼容平台选择网安资产，设备类型选择交换机(根据实际情况选择)，
保留0为认证密码，保留1为加密密码，格式为"加密方式:密码"，其中认证密码的加密方式支持MD5或SHA，加密密码的加密方式支持AES或DES，密码长度均不得小于8位，
H3C交换机的SNMP用户配置页面，两个密码二选一填写，或者两个都填写均可，建议两个都填写。
新建测点¶
只需要新建一个通讯中断点既可；
注意
由于本协议为UDP协议，无法根据连接情况判断子设备通讯状态，请根据实际需求在本协议的规约特征中配置启用ping探测子设备；
启用：1分钟探测一次，当本机能ping通子设备时，认为子设备在线，通讯正常，否则认为通讯中断；
禁用：3分钟内接收到过snmp报文，则通讯正常，超过3分钟未接收到任何报文，认为通讯中断。
本地配置(snmp采集)¶
新建通道¶
新建一个采集通道，协议选择snmp采集，IP地址与端口号保持默认既可。
新建设备¶
单个子设备同一时间只能接入一个SNMP版本，推荐使用SNMPv2；
SNMPv1/SNMPv2c：
新建一个设备，自定义设备名称，例如"交换机"，设备的通讯地址填写要采集的网络设备的IP地址，
设备描述填写设备厂家命名，例如"H3C"，兼容平台选择网安资产，设备类型选择交换机(根据实际情况选择)，
保留0为只读团体名，例如"public"，保留1为读写团体名，例如"private"，可自定义修改，
H3C交换机的SNMP团体配置页面，只读团体名为public，读写团体名为private，可新增自定义团体名，新增目的主机转发时，安全字填写团体名，且需要和前述新建设备时的保留0或者保留1相对应。
SNMPv3：
新建一个设备，自定义设备名称，例如"交换机"，设备的通讯地址填写要采集的网络设备的IP地址，
公共地址为要采集的网络设备的EngineID(引擎ID)，设备描述为用户名(建议采用设备厂家命名，例如"H3C")，
兼容平台选择网安资产，设备类型选择交换机(根据实际情况选择)，
保留0为认证密码，保留1为加密密码，格式为"加密方式:密码"，其中认证密码的加密方式支持MD5或SHA，加密密码的加密方式支持AES或DES，密码长度均不得小于8位，
H3C交换机的SNMP用户配置页面，两个密码二选一填写，或者两个都填写均可，建议两个都填写。
新建测点¶
只需要新建一个通讯中断点既可；
注意
由于本协议为UDP协议，无法根据连接情况判断子设备通讯状态，请根据实际需求在本协议的规约特征中配置启用ping探测子设备；
启用：1分钟探测一次，当本机能ping通子设备时，认为子设备在线，通讯正常，否则认为通讯中断；
禁用：3分钟内接收到过snmp报文，则通讯正常，超过3分钟未接收到任何报文，认为通讯中断。
agent采集¶
云端配置(agent采集)¶
新建通道¶
新建一个采集通道，协议选择agent采集，IP地址与端口号保持默认既可，本协议通常用来接入部署了探针程序的后台主机。
新建设备¶
新建一个设备，自定义设备名称，设备的通讯地址填写要采集的网络设备的IP地址，其余参数默认既可。
新建测点¶
只需要新建一个通讯中断点既可；
通讯中断点的判断逻辑为：有agnet链接，则通讯正常，否则认为通讯中断。
本地配置(agent采集)¶
新建通道¶
新建一个采集通道，协议选择agent采集，IP地址与端口号保持默认既可，本协议通常用来接入部署了探针程序的后台主机。
新建设备¶
新建一个设备，自定义设备名称，设备的通讯地址填写要采集的网络设备的IP地址，其余参数默认既可。
新建测点¶
只需要新建一个通讯中断点既可；
通讯中断点的判断逻辑为：有agnet链接，则通讯正常，否则认为通讯中断。
网安管理平台转发¶
云端配置(网安管理平台转发)¶
新建通道¶
新建一个采集通道，协议选择网安管理平台转发，本驱动可以将使用syslog、snmp、agent(探针)等协议采集到的数据转发到网络安全管理平台；
IP地址填写对端网安管理平台的IP，端口号保持默认8800既可，无需配置交互频率，触发式上传安全事件；
可以在规约特征里配置高危命令清单参数；
提示
代理端口8801的相关功能，本驱动仅支持调阅。
本协议需要在右上角操作菜单中上传证书，然后导入主站CA证书与签名证书，CA证书导入到"CA文件"，签名证书导入到"客户端证书文件"；
新建设备¶
本转发协议无需新建转发设备，会自动转发所有兼容平台为"网安资产"且选择了设备类型的采集设备。
新建测点¶
本转发协议无需新建转发测点。
本地配置(网安管理平台转发)¶
新建通道¶
新建一个采集通道，协议选择网安管理平台转发，本驱动可以将使用syslog、snmp、agent(探针)等协议采集到的数据转发到网络安全管理平台；
IP地址填写对端网安管理平台的IP，端口号保持默认8800既可，无需配置交互频率，触发式上传安全事件；
可以在规约特征里配置高危命令清单参数；
提示
代理端口8801的相关功能，本驱动仅支持调阅。
本协议需要在上方点击上传证书按钮上传证书，然后导入主站CA证书与签名证书，CA证书导入到"CA文件"，签名证书导入到"客户端证书文件"；
新建设备¶
本转发协议无需新建转发设备，会自动转发所有兼容平台为"网安资产"且选择了设备类型的采集设备。
新建测点¶
本转发协议无需新建转发测点。
Ended: 网络安全
Ended: 电力协议
水表协议 ↵
CJT188-2004¶
云端配置(水表CJT188-2004)¶
新建通道¶
新建一个采集通道，协议选择水表CJT188-2004，主参数中，波特率选择2400，停止位1，数据位8，校验为偶校验，根据实际情况按需修改；
新建设备¶
新建一个设备，设备通讯地址填写水表的地址，兼容平台选择远传水表，设备类型根据实际情况选择，选择错误可能会影响数据读取；
提示
若不知道水表的地址，且一条485链路上只有一个水表，那么填写通配地址14个A(AAAAAAAAAAAAAA)再试。
新建测点¶
新建一个测点，读当前水表读数，功能码选择读数据命令，寄存器地址填写1F90(十六进制)，数据类型选择16位BCD，高级设置里测点的辅助参数填写要读取的数据的索引。
本地配置(水表CJT188-2004)¶
新建通道¶
新建一个采集通道，协议选择水表CJT188-2004，主参数中，波特率选择2400，停止位1，数据位8，校验为偶校验，根据实际情况按需修改；
新建设备¶
新建一个设备，设备通讯地址填写水表的地址，兼容平台选择远传水表，设备类型根据实际情况选择，选择错误可能会影响数据读取；
提示
若不知道水表的地址，且一条485链路上只有一个水表，那么填写通配地址14个A(AAAAAAAAAAAAAA)再试。
新建测点¶
新建一个测点，读当前水表读数，功能码选择读数据命令，寄存器地址填写1F90(十六进制)，数据类型选择16位BCD，测点的辅助参数填写要读取的数据的索引。
不同仪表类型代码¶
| 仪表类型 | 代码 |
|---|---|
| 冷水水表 | 0x10 |
| 生活热水水表 | 0x11 |
| 直饮水水表 | 0x12 |
| 中水水表 | 0x13 |
| 热量表(计热量) | 0x20 |
| 热量表(计冷量) | 0x21 |
| 燃气表 | 0x30 |
| 电度表 | 0x40 |
Ended: 水表协议
OPC协议 ↵
OPCUA_Client采集¶
云端配置说明(OPC_UA(client))¶
注意
低性能型号因为内核不支持OPCUA协议族，故无法使用该协议。
新建通道¶
新建一个采集通道，协议选择“OPC_UA(Client)”，主参数中，只需要配置交互频率即可；
规约特征中可以配置OPCUA采集协议相关参数，参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | OPC_UA服务器地址 | 按实际配置，例如opc.tcp://192.168.11.199:49320 |
| 1 | OPC_UA账号 | 按实际配置 |
| 2 | OPC_UA密码 | 按实际配置 |
| 6 | 加密等级 | 按实际配置 |
| 7 | 加密策略 | 一般无需配置，默认即可 |
| 8 | 证书URL | 在需要证书的时候要配置，后面会详述 |
上传证书¶
如果用户需要上传自己的证书，可以通过“操作”选项框点击“上传证书”，弹出证书上传目录。
上传证书后，还需要把证书的URL填到上一部的的证书URL中。
提示
如果证书文件不是.pem结尾，需要手动先把证书后缀改成pem。绑定目标通道必须是所对应的OPCUA_Client通道才能生效。
提示
证书URL的查看方法有2中，在window上，如果系统能够识别的话，直接双击证书，在弹出的信息框中可以找到如下的信息：
如果window无法识别证书，则需要把证书放到linux系统中，通过openssl命令来读取，如下图所示。
$ openssl x509 -in MiniWeb_OPCUA.pem -inform PEM -text | grep urn
提示
命令中-inform选项可以是PEM或者DER，根据证书的实际类型设置。
新建设备¶
新建一个设备，自定义设备名称，其余参数保持默认即可；
新建测点¶
根据OPC UA服务器的“Address Space”中的数据属性建立测点，地址配置NameSpace Index,Identifier，以及数据类型和功能码要配置正确。
例读取以下OPC UA服务器的”Counter1”的值的配置。
提示
测点地址的NameSpace Index,Identifier之间是英文逗号.
本地配置说明(OPC_UA(client))¶
新建通道¶
新建一个采集通道，协议选择“OPC_UA(Client)”，主参数中，只需要配置交互频率即可；
规约特征中可以配置OPCUA采集协议相关参数，参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | OPC_UA服务器地址 | 按实际配置，例如opc.tcp://192.168.11.199:49320 |
| 1 | OPC_UA账号 | 按实际配置 |
| 2 | OPC_UA密码 | 按实际配置 |
| 6 | 加密等级 | 按实际配置 |
| 7 | 加密策略 | 一般无需配置，默认即可 |
| 8 | 证书URL | 在需要证书的时候要配置，后面会详述 |
上传证书¶
如果用户需要上传自己的证书，通过上传证书按钮选择证书，绑定通道必须选择对应的OPC_UA(Client)通道。
上传证书后，还需要把证书的URL填到上一部的的证书URL中。
提示
如果证书文件不是.pem结尾，需要手动先把证书后缀改成pem。绑定目标通道必须是所对应的OPCUA_Client通道才能生效。
提示
证书URL的查看方法有2中，在window上，如果系统能够识别的话，直接双击证书，在弹出的信息框中可以找到如下的信息：
如果window无法识别证书，则需要把证书放到linux系统中，通过openssl命令来读取，如下图所示。
$ openssl x509 -in MiniWeb_OPCUA.pem -inform PEM -text | grep urn
提示
命令中-inform选项可以是PEM或者DER，根据证书的实际类型设置。
新建设备¶
新建一个设备，自定义设备名称，其余参数保持默认即可；
新建测点¶
根据OPC UA服务器的“Address Space”中的数据属性建立测点，地址配置NameSpace Index,Identifier，以及数据类型和功能码要配置正确。
例读取以下OPC UA服务器的”Counter1”的值的配置。
提示
测点地址的NameSpace Index,Identifier之间是英文逗号.
OPCUA_Server转发¶
云端配置说明(OPC_UA(server))¶
注意
低性能型号因为内核不支持OPCUA协议族，故无法使用该协议。
新建通道¶
新建一个转发通道，协议选择“OPC_UA(Server)”，主参数中，只需要配置端口号即可；
规约特征配置¶
设置OPCUA服务的访问控制信息地址，是否允许匿名登录及最多3个客户端登录使用的用户名，密码，每对用户名与密码之间用空格分隔；如果不需要设置用户名，密码，把参数清空即可。
加密等级可以设置OPCUA服务器的通信加密方式，根据实际情况设置。如果需要加密通信，则需要导入证书，此时就需要在证书URL设置导入的证书的“URL”（该信息的获取参考OPCUA_Client中的证书URL的查看说明）。
测点自动分配OPC节点ID如果设置为1，则转发测点的转发地址设置不生效，由OPCUA服务器自动为转发测点生成NodeId。否则的话，OPCUA服务器按照转发测点的转发类型和转发地址来生成OPCUA的NodeId。
新建设备¶
新建一个设备，自定义设备名称，其余参数保持默认即可；
新建测点¶
新建一个转发测点，根据实际需求，对转发测点的NodeId进行设置，要设置NodeId类型，NodeId的NameSpace Index, identifier，以及测点的数据类型。
其中NodeId类型通过功能码来设置；NameSpace Index, identifier通过地址来设置，它们之间用逗号分隔。也可以省略NameSpace Index，只设置 identifier。
提示
注意：如果地址是NameSpace Index, identifier格式，NameSpace Index必须是1。
下2图是两种设置测点地址的方式，均可；如果没有特殊要求，推荐功能码选择字符串NodeId。
如果NodeId设置为字符串类型，在转发地址中可以使用通配符${name}来指代测点名称(测点名称不可以出现中文)。如下图所示，${name}即“Yc_1”。
其他说明¶
上传证书和加密¶
如果需要进行加密通信，在规约特征中加密等级进行设置，可以设置为：“不加密”，“加密登录”和“登录和加密”。
如果通信需要证书，请联系我司，由我司为网关生成证书；生成的文件有三个“网关编号.pem”,“网关编号.key”, “网关编号.der”。前两者通过本平台上传到网关，如下所示，上传证书时注意选择的“绑定目标通道”。
“网关编号.der”则提供给客户的OPC UA Client软件使用，（如需要）用于安装到OPC UA Client软件的证书信任列表中。另外，该文件还提供了证书URL，用于配置在规约特征的“证书URL中”。先双击证书，打开详细信息列，找到“使用者可选名称”项目，拷贝“URL=”之后的内容：
然后再到本平台上打开网关的OPCUA转发通道配置规约特征，拷贝前面获得的URL到“证书URL”配置项中即可。
OPCUA转发的树形结构¶
如果成功建立了OPCUA转发通道，将会按照工程中的树形结构来形成OPC测点结构。如下图所示：
本地配置说明(OPC_UA(server))¶
新建通道¶
新建一个转发通道，协议选择“OPC_UA(Server)”，主参数中，只需要配置端口号即可；
规约特征配置¶
设置OPCUA服务的访问控制信息地址，是否允许匿名登录及最多3个客户端登录使用的用户名，密码，每对用户名与密码之间用空格分隔；如果不需要设置用户名，密码，把参数清空即可。
加密等级可以设置OPCUA服务器的通信加密方式，根据实际情况设置。如果需要加密通信，则需要导入证书，此时就需要在证书URL设置导入的证书的“URL”（该信息的获取参考OPCUA_Client中的证书URL的查看说明）。
测点自动分配OPC节点ID如果设置为1，则转发测点的转发地址设置不生效，由OPCUA服务器自动为转发测点生成NodeId。否则的话，OPCUA服务器按照转发测点的转发类型和转发地址来生成OPCUA的NodeId。
新建设备¶
新建一个设备，自定义设备名称，其余参数保持默认即可；
新建测点¶
新建一个转发测点，根据实际需求，对转发测点的NodeId进行设置，要设置NodeId类型，NodeId的NameSpace Index, identifier、以及测点的数据类型。
其中NodeId类型通过功能码来设置；NameSpace Index, identifier通过地址来设置，它们之间用逗号分隔。也可以省略NameSpace Index，只设置 identifier。
提示
注意：如果地址是NameSpace Index, identifier格式，NameSpace Index必须是1。
下2图是两种设置测点地址的方式，均可；如果没有特殊要求，推荐功能码选择字符串NodeId。
如果NodeId设置为字符串类型，在转发地址中可以使用通配符”{name}”来指代测点名称(测点名称不可以出现中文)。如下图所示，“”即“Yc_1”。
其他说明¶
上传证书和加密¶
如果需要进行加密通信，在规约特征中加密等级进行设置，可以设置为：“不加密”，“加密登录”和“登录和加密”。
如果通信需要证书，联系我司，由我司为网关生成证书；生成的文件有三个“网关编号.pem”,“网关编号.key”, “网关编号.der”。前两者通过本平台上传到网关，如下所示，上传证书时注意选择的“绑定目标通道”。
“网关编号.der”则提供给客户的OPC UA Client软件使用，（如需要）用于安装到OPC UA Client软件的证书信任列表中。另外，该文件还提供了证书URL，用于配置在规约特征的“证书URL中”。先双击证书，打开详细信息列，找到“使用者可选名称”项目，拷贝“URL=”之后的内容：
然后再到本平台上打开网关的OPCUA转发通道配置规约特征，拷贝前面获得的URL到“证书URL”配置项中即可。
OPCUA转发的树形结构¶
如果成功建立了OPCUA转发通道，将会按照工程中的树形结构来形成OPC测点结构。如下图所示：
OPCTunnel采集¶
云端配置(OPCTunnel采集)¶
新建通道¶
新建一个采集通道，协议选择OPCTunnel采集，本驱动用于采集OPC转http的小工具Restful产生的http服务，IP地址填写OPC服务器的IP地址，端口号保持默认48888即可。
新建设备¶
新建一个设备，自定义设备名称，其余参数留空即可。
新建测点¶
新建一个测点，功能码选择读写实时数据，地址填写OPC的标签地址，例如a.b.c，测点的数据类型按照OPC中的数据类型进行选择。
注意
关于测点的数据类型，要和OPC中的类型一一对应，在OPC中是布尔型(bool)的，测点的数据类型选择位，其它类型按照对应关系选择，例如short选择8位有符号，int选16位有符号，uint32选32位无符号，float选单精度浮点数，string选择字符串。
本地配置(OPCTunnel采集)¶
新建通道¶
新建一个采集通道，协议选择OPCTunnel采集，本驱动用于采集OPC转http的小工具Restful产生的http服务，IP地址填写OPC服务器的IP地址，端口号保持默认48888即可。
新建设备¶
新建一个设备，自定义设备名称，其余参数留空即可。
新建测点¶
添加一个测点，功能码选择读写实时数据，地址填写OPC的标签地址，例如a.b.c，测点的数据类型按照OPC中的数据类型进行选择。
注意
关于测点的数据类型，要和OPC中的类型一一对应，在OPC中是布尔型(bool)的，测点的数据类型选择位，其它类型按照对应关系选择，例如short选择8位有符号，int选16位有符号，uint32选32位无符号，float选单精度浮点数，string选择字符串。
Ended: OPC协议
MQTT协议 ↵
阿里云IoT¶
云端配置(阿里云IoT)¶
新建通道¶
新建一个转发通道，协议选择阿里云IoT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数保持默认即可，如有需要，可填写自定义的阿里云域名；
提示
在配置本协议的工程时，尽量不要在采集/转发的通道名称、设备名称中出现中文，测点名称不允许有中文，否则会导致上传失败，因为阿里云物模型不支持！
阿里云平台的产品概念，对应我们的转发通道的概念。
举例，阿里云上申请的三元组为：
| JSON | |
|---|---|
提示
订阅与发布主题中，${pkey}为通配符，将被替换为ProductKey，${dev}为通配符，将被替换为设备名称。
新建设备¶
新建一个设备，设备名称填写对应的阿里云平台的设备名称，设备通讯地址填写该设备的productKey，其余参数默认。
举例，根据三元组已知DeviceName为lamp，DeviceSecret为da4715376b171d279ab2dd59f6489427，那么转发设备的参数按照下图填写。
提示
阿里云平台产品下的设备概念，对应我们转发通道下的转发设备概念。
新建测点¶
发送实时数据¶
举例转发一个测点，点击测点名称的编辑框，即可选择采集测点，物模型标识按照实际情况填写，功能码按照实际情况选择。
注意
转发测点新增时，默认使用的是采集测点的名称对应阿里云平台物模型的标识符，假如采集测点名称中含有通道名称、设备名称前缀的，在上传时会自动去掉，如下图，它们也认为是对应的。
强烈建议
在规约特征的对应物模型标识符参数中将其修改为物模型标识。
如果阿里云物模型中含有模块，那么在填写物模型时以英文冒号分隔模块标识符和功能标识符。
实时数据写值¶
配置了发送实时数据功能码，且阿里云平台物模型的读写属性可写的，可以由阿里云平台下发写值。
测试如下图所示，在监控运维中点击在线调试，选择对应的产品与设备，然后在属性调试下方选择要写值的测点，填上要写的值，即可对该测点进行写值，如下图：
提示
测点属性为“读写”，调试时才可以选择“设置”。
服务调用.召读多测点¶
举例通过服务调用来召读某一测点，
在阿里云平台物模型添加自定义功能，功能类型选择服务，功能名称自定义，功能标识符为ReadData，输入参数1标识符为DevPubAddr，输入参数2标识符为DataAddr，输出参数1为DataResult，然后发布(数据类型均为text)；
在本平台上新建一个中间点，测点名称为ReadData(即上述服务的标识符)，在转发设备中添加这个中间点，功能码选择服务调用.召读测点，地址填写为DevPubAddr,DataAddr;DataResult(格式：输入参数1标识符,输入参数2标识符;输出参数1标识符，其中输入参数1必须为采集设备的公共地址，输入参数2必须为采集测点的寄存器地址)。
服务调用.快速刷新¶
暂未实现。
服务调用.读写单测点¶
举例通过服务调用写值，转发时，功能码选择服务调用.读写单测点，即可通过该服务下发写值或读值。
本地配置(阿里云IoT)¶
新建通道¶
新建一个转发通道，协议选择阿里云IoT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数保持默认即可，如有需要，可填写自定义的阿里云域名；
提示
在配置本协议的工程时，尽量不要在采集/转发的通道名称、设备名称中出现中文，测点名称不允许有中文，否则会导致上传失败，因为阿里云物模型不支持！
阿里云平台的产品概念，对应我们的转发通道的概念。
举例，阿里云上申请的三元组为：
| JSON | |
|---|---|
提示
订阅与发布主题中，${pkey}为通配符，将被替换为ProductKey，${dev}为通配符，将被替换为设备名称。
新建设备¶
新建一个设备，设备名称填写对应的阿里云平台的设备名称，设备通讯地址填写该设备的productKey，其余参数默认。
举例，根据三元组已知DeviceName为lamp，DeviceSecret为da4715376b171d279ab2dd59f6489427，那么转发设备的参数按照下图填写。
提示
阿里云平台产品下的设备概念，对应我们转发通道下的转发设备概念。
新建测点¶
发送实时数据¶
举例转发一个测点，点击添加按钮，即可选择采集测点进行转发，转发测点的其它属性默认即可，待添加完毕后，再按需修改。
注意
转发测点新增时，默认使用的是采集测点的名称对应阿里云平台物模型的标识符，假如采集测点名称中含有通道名称、设备名称前缀的，在上传时会自动去掉。
强烈建议
在规约特征的对应物模型标识符参数中将其修改为物模型标识。
提示
如果阿里云物模型中含有模块，那么在填写物模型时以英文冒号分隔模块标识符和功能标识符。
实时数据写值、服务调用.召读多测点、服务调用.快速刷新、服务调用.读写单测点请参照本页的云端配置。
百度BLink协议¶
云端配置(百度BLink协议)¶
新建通道¶
新建一个转发通道，协议选择百度BLink协议，交互频率意为数据全量上送间隔(填写范围1秒-6小时，单位ms)；如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，请按照实际情况填写IP/域名与端口号。
提示
MQTT的账号、密码、clinetID以及其它更多参数请在规约特征中配置。
新建设备¶
新建一个设备，设备名称填写对应的BLink平台的设备名称(DeviceName)，设备公共地址填写该设备的productKey，其余参数默认。
提示
可以在规约特征中更改DeviceName的对应关系，默认取下图的设备名称，也可以改成取下图的设备描述。
新建测点¶
举例转发一个测点，点击测点名称的编辑框，即可选择采集测点，物模型标识按照实际情况填写，功能码按照实际情况选择。
关于Online状态
要实现BLink平台设备Online状态上报，需要注意3点，
注1：您必须在采集设备下手动添加设备通讯中断测点(参照新增采集测点里对测点属性的说明)；
注2：您必须在转发设备下手动添加上述的设备通讯中断测点，并将其物模型标识设置为"Online"，功能码选择终端在线状态；
注3：我们的通讯中断点0为正常，1为异常，在上传时会自动转换成1在线，0离线。
本地配置(百度BLink协议)¶
新建通道¶
新建一个转发通道，协议选择百度BLink协议，交互频率意为数据全量上送间隔(填写范围1秒-6小时，单位ms)；如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，请按照实际情况填写IP/域名与端口号。
提示
MQTT的账号、密码、clinetID以及其它更多参数请在规约特征中配置。
新建设备¶
新建一个设备，设备名称填写对应的BLink平台的设备名称(DeviceName)，设备公共地址填写该设备的productKey，其余参数默认。
提示
可以在规约特征中更改DeviceName的对应关系，默认取下图的设备名称，也可以改成取下图的设备描述。
新建测点¶
举例转发一个测点，点击添加按钮，即可选择采集测点进行转发，物模型标识按照实际情况填写，功能码按照实际情况选择。
关于Online状态
要实现BLink平台设备Online状态上报，需要注意3点，
注1：您必须在采集设备下手动添加设备通讯中断测点(参照新增采集测点里对测点属性的说明)；
注2：您必须在转发设备下手动添加上述的设备通讯中断测点，并将其物模型标识设置为"Online"，功能码选择终端在线状态；
注3：我们的通讯中断点0为正常，1为异常，在上传时会自动转换成1在线，0离线。
涂鸦智能 ↵
涂鸦智能MQTT¶
云端配置(涂鸦智能MQTT)¶
新建通道¶
新建一个转发通道，协议选择涂鸦智能MQTT，主参数中，参数保持默认即可；
交互频率即为实时数据全量上传的时间间隔，设置范围为10s < time < 12hour，建议设置为5分钟；
产品ID、变化上送等参数请在规约特征中设定。
新建设备¶
新建一个设备，其中，转发设备的设备通讯地址为涂鸦平台的DeviceID，设备公共地址为涂鸦平台的DeviceSecret；
新建测点¶
新增转发测点，点击批量新增按钮，选择已有的采集点添加即可；
其中，转发测点的物模型标识，为涂鸦平台产品的功能定义下，功能的标识符。
本地配置(涂鸦智能MQTT)¶
新建通道¶
新建一个转发通道，协议选择涂鸦智能MQTT，主参数中，参数保持默认即可；
交互频率即为实时数据全量上传的时间间隔，设置范围为10s < time < 12hour，建议设置为5分钟；
产品ID、变化上送等参数请在规约特征中设定。
新建设备¶
新建一个设备，其中，转发设备的设备通讯地址为涂鸦平台的DeviceID，设备公共地址为涂鸦平台的DeviceSecret；
新建测点¶
新增转发测点，点击批量新增按钮，选择已有的采集点添加即可；
其中，转发测点的物模型标识，为涂鸦平台产品的功能定义下，功能的标识符。
涂鸦智能OS¶
云端配置(涂鸦智能OS)¶
新建通道¶
新建一个转发通道，协议选择涂鸦智能OS，主参数中，IP/域名和端口号均保持默认即可；
交互频率即为实时数据全量上传的时间间隔，设置范围为10s < time < 12hour；
产品ID、UUID、tuyaKey等参数请在规约特征中设定，该三个参数为网关本身的参数。
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，公共地址填子设备的产品ID(ProductId)，兼容平台选择涂鸦智能OS，设备类型选择PCS(根据实际情况选择) 。
配置测点¶
该转发协议无需新增转发测点。
我们进入采集设备的采集测点管理，新建(或修改)一个变量，例如开关3，勾选是否上传(默认是勾选状态)，PV标识选择开关3，PV上传系数保持默认即可，那么这个测点就会上传。
提示
没有看到这个PV属性设置或者属性设置不对的，请参照本小节的第二步，选择正确的兼容平台与设备型号后再试。
本地配置(涂鸦智能OS)¶
新建通道¶
新建一个转发通道，协议选择涂鸦智能OS，主参数中，IP/域名和端口号均保持默认即可；
交互频率即为实时数据全量上传的时间间隔，设置范围为10s < time < 12hour；
产品ID、UUID、tuyaKey等参数请在规约特征中设定，该三个参数为网关本身的参数。
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，公共地址填子设备的产品ID(ProductId)，兼容平台选择涂鸦智能OS，设备类型选择PCS(根据实际情况选择) 。
配置测点¶
该转发协议无需新增转发测点。
我们进入采集设备的采集测点管理，新建(或修改)一个变量，例如开关3，勾选是否上传(默认是勾选状态)，PV标识选择开关3，PV上传系数保持默认即可，那么这个测点就会上传。
提示
没有看到这个PV属性设置或者属性设置不对的，请参照本小节的第二步，选择正确的兼容平台与设备型号后再试。
Ended: 涂鸦智能
和远智能 ↵
和远智能MQTT¶
云端配置(和远智能MQTT)¶
新建通道¶
新建一个转发通道，协议选择和远智能MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
新建设备¶
新建一个设备，设备名称填写和远平台的设备编号，其余参数默认。
新建测点¶
举例转发一个测点，点击测点名称的编辑框，即可选择采集测点，物模型标识对应和远平台的物模型标识符，功能码按照实际情况选择。
关于Online状态
要实现和远平台设备Online状态上报，需要注意3点，
注1：您必须在采集设备下手动添加设备通讯中断测点(参照新增采集测点里对测点属性的说明)；
注2：您必须在转发设备下手动添加上述的设备通讯中断测点，并将其物模型标识设置为"sta"，功能码选择终端在线状态；
注3：我们的通讯中断点0为正常，1为异常，在上传时会自动转换成1在线，0离线。
本地配置(和远智能MQTT)¶
新建通道¶
新建一个转发通道，协议选择和远智能MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
新建设备¶
新建一个设备，设备名称填写和远平台的设备编号，其余参数默认。
新建测点¶
举例转发一个测点，点击添加按钮，即可选择采集测点进行转发，物模型标识对应和远平台的物模型标识符，功能码按照实际情况选择。
关于Online状态
要实现和远平台设备Online状态上报，需要注意3点，
注1：您必须在采集设备下手动添加设备通讯中断测点(参照[新增采集测点]里对测点属性的说明)；
注2：您必须在转发设备下手动添加上述的设备通讯中断测点，并将其物模型标识设置为"sta"，功能码选择终端在线状态；
注3：我们的通讯中断点0为正常，1为异常，在上传时会自动转换成1在线，0离线。
和远智能MQTT新¶
云端配置(和远智能MQTT新)¶
新建通道¶
新建一个转发通道，协议选择和远智能MQTT(新)，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
新建设备¶
新建一个设备，设备名称填写和远平台的设备编号，其余参数默认。
新建测点¶
举例转发一个测点，点击测点名称的编辑框，即可选择采集测点，物模型标识对应和远平台的物模型标识符，功能码按照实际情况选择。
关于Online状态
要实现和远平台设备Online状态上报，需要注意3点，
注1：您必须在采集设备下手动添加设备通讯中断测点(参照新增采集测点里对测点属性的说明)；
注2：您必须在转发设备下手动添加上述的设备通讯中断测点，并将其物模型标识设置为"state"，功能码选择终端在线状态；
注3：我们的通讯中断点0为正常，1为异常，在上传时会自动转换成1在线，0离线。
本地配置(和远智能MQTT新)¶
新建通道¶
新建一个转发通道，协议选择和远智能MQTT(新)，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
新建设备¶
新建一个设备，设备名称填写和远平台的设备编号，其余参数默认。
新建测点¶
举例转发一个测点，点击添加按钮，即可选择采集测点进行转发，物模型标识对应和远平台的物模型标识符，功能码按照实际情况选择。
关于Online状态
要实现和远平台设备Online状态上报，需要注意3点，
注1：您必须在采集设备下手动添加设备通讯中断测点(参照[新增采集测点]里对测点属性的说明)；
注2：您必须在转发设备下手动添加上述的设备通讯中断测点，并将其物模型标识设置为"state"，功能码选择终端在线状态；
注3：我们的通讯中断点0为正常，1为异常，在上传时会自动转换成1在线，0离线。
Ended: 和远智能
通用MQTT ↵
通用MQTT采集¶
云端配置(通用MQTT采集)¶
新建通道¶
新建一个采集通道，协议选择通用MQTT采集，主参数中，IP地址与端口号，填写和通用MQTT转发相一致的MQTT服务器的IP地址与端口号；
订阅的网关编号、测点ID类型等更多参数见规约特征配置，订阅的网关编号指的是配置了通用MQTT转发的网关编号，单个通道下最多订阅16个；
新建设备¶
新增一个采集设备，自定义设备名称，设备的通讯地址填写网关的SN号，设备的公共地址填写转出数据的网关配置通用MQTT转发时，设备的公共地址；
新建测点¶
新增一个测点，根据规约特征中测点ID类型的配置不同，可以选择测点名称匹配、物模型标识匹配与地址匹配，该参数要与配置通用MQTT转发时的测点ID相一致，本采集协议不关心系数、偏移、数据类型、数据格式等参数。
本地配置(通用MQTT采集)¶
新建通道¶
新建一个采集通道，协议选择通用MQTT采集，主参数中，IP地址与端口号，填写和通用MQTT转发相一致的MQTT服务器的IP地址与端口号；
订阅的网关编号、测点ID类型等更多参数见规约特征配置，订阅的网关编号指的是配置了通用MQTT转发的网关编号，单个通道下最多订阅16个；
新建设备¶
新增一个采集设备，自定义设备名称，设备的通讯地址填写网关的SN号，设备的公共地址填写转出数据的网关配置通用MQTT转发时，设备的公共地址；
新建测点¶
新增一个测点，根据规约特征中测点ID类型的配置不同，可以选择测点名称匹配、物模型标识匹配与地址匹配，该参数要与配置通用MQTT转发时的测点ID相一致，本采集协议不关心系数、偏移、数据类型、数据格式等参数。
通用MQTT转发¶
云端配置(通用MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择通用MQTT转发，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，一般保持默认即可；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，订阅主题、发布主题、是否使用物模型转发等更多参数见规约特征配置；
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
-
不新建转发设备
我们回到采集通道下的子设备管理，公共地址填1(多个设备依次顺延，同一网关下公共地址不能重复)，其余属性保持原来的参数不变；
-
新建了转发设备
新增一个转发设备，自定义设备名称，公共地址填1(多个设备依次顺延，同一网关下公共地址不能重复)，其余属性保持原来的参数不变；
新建测点¶
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，转发测点的属性均保持默认；
如果未新建转发设备，那么需要配置采集测点的是否上传属性，打钩(默认)则转发，不打勾不转发。
本地配置(通用MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择通用MQTT转发，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，一般保持默认即可；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，订阅主题、发布主题、是否使用物模型转发等更多参数见规约特征配置；
部分规约特征说明如下：
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 4 | 开启变化上送 | 0:关闭;1:开启;2:开启且只发遥信变位;3:开启且只发遥信以外变位 |
| 12 | 转发测点ID类型 | 0:测点名称;1:测点地址;2:物模型标识 |
| 13 | 设备地址 | 0:使用设备公共地址;1:使用设备通讯地址 |
| 14 | 测点信息 | 0:简洁信息;1:详细信息 |
| 15 | MQTT消息持久性 | 0:不保持;1:持久保持 |
| 16 | 是否匿名登录 | 0:否;1:是 |
| 17 | 不发质量码坏点 | 0:发送;1:不发送 |
| 18 | 按设备发数据 | 0:按通道发;1:按设备发 |
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
-
不新建转发设备
我们回到采集通道下的子设备管理，公共地址填1(多个设备依次顺延，同一网关下公共地址不能重复)，其余属性保持原来的参数不变；
-
新建了转发设备
新增一个转发设备，自定义设备名称，公共地址填1(多个设备依次顺延，同一网关下公共地址不能重复)，其余属性保持原来的参数不变；
新建测点¶
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，转发测点的属性均保持默认；
如果未新建转发设备，那么需要配置采集测点的是否上传属性，选择是(默认)则转发，选择否不转发。
Ended: 通用MQTT
树根互联 ↵
树根互联3.0MQTT¶
云端配置(树根互联3.0MQTT)¶
新建通道¶
新建一个转发通道，协议选择树根互联3.0MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
提示
在协议名称左边点击小齿轮，可以进行规约特征设置，含MQTT账号(对应根云平台云盒ID)、密码(对应根云平台云盒的secretID)、以及ClientID(对应根云平台云盒ID)等；
另外可根据需求开启变化上送，变化上送周期可以设置为1S；
也可以在此配置对应物模型属性ID，默认使用物模型标识(测点描述)进行对应。
注意
往同一个IP/域名传数据时，clientID不能重复！别的网关用过的clientID不能再次使用。
新建设备¶
新建一个设备，其中，转发设备的设备通讯地址即为根云平台的slave ID(编辑设备窗口可见)，设备公共地址即为根云平台的设备编号。
新建测点¶
新增转发测点，点击批量新增按钮，选择已有的采集点添加，功能码选择发送实时数据，物模型标识对应根云平台的物模型属性ID，其余参数保持默认即可。
提示
在配置采集测点时，可以提前配置好物模型标识，此时批量新增转发测点，物模型标识会自动拷贝过来。
本地配置(树根互联3.0MQTT)¶
新建通道¶
新建一个转发通道，协议选择树根互联3.0MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
提示
点击规约按钮，可以进行规约特征设置，含MQTT账号(对应根云平台云盒ID)、密码(对应根云平台云盒的secretID)、以及ClientID(对应根云平台云盒ID)等；
另外可根据需求开启变化上送，变化上送周期可以设置为1S；
也可以在此配置对应物模型属性ID，默认使用物模型标识(测点描述)进行对应。
注意
往同一个IP/域名传数据时，clientID不能重复！别的网关用过的clientID不能再次使用。
新建设备¶
新建一个设备，其中，转发设备的设备通讯地址即为根云平台的slave ID(编辑设备窗口可见)，设备公共地址即为根云平台的设备编号。
新建测点¶
新增转发测点，点击新增按钮，选择已有的采集点添加，功能码选择发送实时数据，物模型标识对应根云平台的物模型属性ID，其余参数保持默认即可。
提示
在配置采集测点时，可以提前配置好物模型标识，此时批量新增转发测点，物模型标识会自动拷贝过来。
树根互联4.0MQTT¶
云端配置(树根互联4.0MQTT)¶
新建通道¶
新建一个转发通道，协议选择树根互联4.0MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
提示
在协议名称左边点击小齿轮，可以进行规约特征设置，含MQTT账号(对应根云平台认证标识)、密码(对应根云平台认证秘钥)、以及ClientID(对应根云平台认证标识)等；
另外可根据需求开启变化上送，变化上送周期可以设置为1S；如需断点续传，需要手动配置离线数据存储天数；
也可以在此配置对应物模型属性ID，默认使用物模型标识(测点描述)进行对应。
注意
往同一个IP/域名传数据时，clientID不能重复！别的网关用过的clientID不能再次使用。
新建设备¶
新建一个设备，其中，转发设备的设备公共地址即为根云平台的物标识。
新建测点¶
新增转发测点，点击批量新增按钮，选择已有的采集点添加，功能码选择发送实时数据，物模型标识对应根云平台的物模型属性ID，其余参数保持默认即可。
提示
在配置采集测点时，可以提前配置好物模型标识，此时批量新增转发测点，物模型标识会自动拷贝过来。
本地配置(树根互联4.0MQTT)¶
新建通道¶
新建一个转发通道，协议选择树根互联4.0MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
提示
点击规约按钮，可以进行规约特征设置，含MQTT账号(对应根云平台认证标识)、密码(对应根云平台认证秘钥)、以及ClientID(对应根云平台认证标识)等；
另外可根据需求开启变化上送，变化上送周期可以设置为1S；如需断点续传，需要手动配置离线数据存储天数；
也可以在此配置对应物模型属性ID，默认使用物模型标识(测点描述)进行对应。
注意
往同一个IP/域名传数据时，clientID不能重复！别的网关用过的clientID不能再次使用。
新建设备¶
新建一个设备，其中，转发设备的设备公共地址即为根云平台的物标识。
新建测点¶
新增转发测点，点击新增按钮，选择已有的采集点添加，功能码选择发送实时数据，物模型标识对应根云平台的物模型属性ID，其余参数保持默认即可。
提示
在配置采集测点时，可以提前配置好物模型标识，此时批量新增转发测点，物模型标识会自动拷贝过来。
Ended: 树根互联
联通物联网MQTT¶
云端配置(联通物联网MQTT)¶
新建通道¶
新建一个转发通道，协议选择联通物联网MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数保持默认即可，如有需要，可填写自定义的联通平台(雁飞•格物DMP平台)域名；
提示
在配置本协议的工程时，尽量不要在采集/转发的通道名称、设备名称中出现中文，测点名称不允许有中文，否则会导致上传失败，因为联通平台物模型不支持！
联通平台平台的产品概念，对应我们的转发通道的概念。
举例，联通平台上的设备鉴权信息为：
则在规约特征中ProductKey字段填写“cu1qzdvzf8y0bfE7”，其余参数默认即可。
提示
规约特征中的DeviceKey是为了兼容旧工程保留的，后续版本(≥1.3.28)请留空。
新建设备¶
新建一个设备，设备名称自定义，设备通讯地址填写该设备的deviceSecret，设备公共地址填写该设备的deviceKey，其余参数默认。
提示
联通平台平台产品下的设备概念，对应我们转发通道下的转发设备概念。
新建测点¶
举例转发一个测点，点击测点名称的编辑框，即可选择采集测点，物模型标识按照联通平台的标识符填写，功能码选择发送实时数据。
本地配置(联通物联网MQTT)¶
新建通道¶
新建一个转发通道，协议选择联通物联网MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数保持默认即可，如有需要，可填写自定义的联通平台(雁飞•格物DMP平台)域名；
提示
在配置本协议的工程时，尽量不要在采集/转发的通道名称、设备名称中出现中文，测点名称不允许有中文，否则会导致上传失败，因为联通平台物模型不支持！
联通平台平台的产品概念，对应我们的转发通道的概念。
举例，联通平台上的设备鉴权信息为：
则在规约特征中ProductKey字段填写“cu1qzdvzf8y0bfE7”，其余参数默认即可。
提示
规约特征中的DeviceKey是为了兼容旧工程保留的，后续版本(≥1.3.28)请留空。
新建设备¶
新建一个设备，设备名称自定义，设备通讯地址填写该设备的deviceSecret，设备公共地址填写该设备的deviceKey，其余参数默认。
提示
联通平台平台产品下的设备概念，对应我们转发通道下的转发设备概念。
新建测点¶
举例转发一个测点，点击添加按钮，即可选择采集测点进行转发，物模型标识按照联通平台的标识符填写，功能码选择发送实时数据。
恒创MQTT¶
云端配置(恒创MQTT)¶
新建通道¶
新建一个转发通道，协议选择恒创MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
取的恒创平台的${ProductSN}、${DeviceSN}、${DeviceSecret}等认证要素，填写在规约特征中，
举例平台信息如下图：
注意
1、填写时，MQTT账号格式为【所属产品序列号|设备序列号|1】，ClientID格式为【所属产品序列号.设备序列号】；
2、若需要上传多个类型的设备，例如既要传逆变器又要传仪表，此时需要将所属产品序列号填写在各自设备的保留1中，若保留1留空，则默认取规约特征中的产品序列号。
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，设备公共地址填写恒创平台的子设备序列号，设备保留1字段填写上一步中的产品序列号，其余参数默认。
配置测点¶
该转发协议无需新增转发测点。
默认转发所有采集测点，不需要转发的，取消勾选测点的是否上传属性；测点的物模型标识(测点描述)对应恒创平台的标识符。
本地配置(恒创MQTT)¶
新建通道¶
新建一个转发通道，协议选择恒创MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
取的恒创平台的${ProductSN}、${DeviceSN}、${DeviceSecret}等认证要素，填写在规约特征中，
举例平台信息如下图：
注意
1、填写时，MQTT账号格式为【所属产品序列号|设备序列号|1】，ClientID格式为【所属产品序列号.设备序列号】；
2、若需要上传多个类型的设备，例如既要传逆变器又要传仪表，此时需要将所属产品序列号填写在各自设备的保留1中，若保留1留空，则默认取规约特征中的产品序列号。
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，设备公共地址填写恒创平台的子设备序列号，设备保留1字段填写上一步中的产品序列号，其余参数默认。
配置测点¶
该转发协议无需新增转发测点。
默认转发所有采集测点，不需要转发的，取消勾选测点的是否上传属性；测点的物模型标识(测点描述)对应恒创平台的标识符。
晟能MQTT¶
云端配置(晟能MQTT)¶
新建通道¶
新建一个转发通道，协议选择晟能MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
取得晟能平台的${ProductSN}、${DeviceSN}、${DeviceSecret}等认证要素，填写在规约特征中，
举例平台信息如下图：
注意
1、填写时，MQTT账号格式为【所属产品序列号|设备序列号|1】，ClientID格式为【所属产品序列号.设备序列号】；
2、若需要上传多个类型的设备，例如既要传逆变器又要传仪表，此时需要将所属产品序列号填写在各自设备的保留1中，若保留1留空，则默认取规约特征中的产品序列号。
新建设备¶
在上述转发通道下的子设备管理中，点击批量新增按钮，勾选要转发的采集设备进行转发，会自动带入采集设备下的测点；
添加完毕后，需要修改转发设备，其中设备公共地址填写晟能平台的子设备序列号，设备保留0填写所采集的DLT645-2007电表的通讯地址(如果采集不是DLT645-2007协议则此项留空)，设备保留1字段填写上一步中的产品序列号，其余参数默认。
新建测点¶
批量新建设备时已经自动带入相应采集测点进行转发，如果有不需要转发的测点，批量勾选转发测点，然后删除即可；
测点的物模型标识(测点描述)对应晟能平台的标识符。
本地配置(晟能MQTT)¶
新建通道¶
新建一个转发通道，协议选择晟能MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
取得晟能平台的${ProductSN}、${DeviceSN}、${DeviceSecret}等认证要素，填写在规约特征中，
举例平台信息如下图：
注意
1、填写时，MQTT账号格式为【所属产品序列号|设备序列号|1】，ClientID格式为【所属产品序列号.设备序列号】；
2、若需要上传多个类型的设备，例如既要传逆变器又要传仪表，此时需要将所属产品序列号填写在各自设备的保留1中，若保留1留空，则默认取规约特征中的产品序列号。
新建设备¶
在上述转发通道下的子设备管理中，点击批量新增按钮，勾选要转发的采集设备进行转发，会自动带入采集设备下的测点；
添加完毕后，需要修改转发设备，其中设备公共地址填写晟能平台的子设备序列号，设备保留0填写所采集的DLT645-2007电表的通讯地址(如果采集不是DLT645-2007协议则此项留空)，设备保留1字段填写上一步中的产品序列号，其余参数默认。
新建测点¶
批量新建设备时已经自动带入相应采集测点进行转发，如果有不需要转发的测点，批量选中转发测点，然后删除即可；
测点的物模型标识(测点描述)对应晟能平台的标识符。
陀曼MQTT转发¶
云端配置(陀曼云MQTT)¶
新建通道¶
新建一个转发通道，协议选择陀曼云MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，一般保持默认即可；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，订阅主题、发布主题、离线存储天数等更多参数见规约特征配置；
添加完转发通道后，网关会自动把所有采集通道下的数据转发到陀曼云，每一个采集通道对应陀曼云平台的通道，采集通道的通道名称即对应陀曼云通道的通道名称。
提示
配置转发时请务必保存一次规约特征，使得MQTT参数、离线存储天数等配置生效。
新建设备¶
该转发协议无需新建转发设备；
网关会自动把所有采集设备的数据转发到陀曼云，每一个采集设备对应陀曼云平台的控制器，采集设备的设备名称即对应控制器的控制器名称。
新建测点¶
该转发协议无需新建转发测点；
网关会自动把所有采集测点的数据转发到陀曼云，每一个采集测点对应陀曼云平台的采集点位，采集测点的物模型标识(测点描述)即对应采集点位的变量标识符。
本地配置(陀曼云MQTT)¶
新建通道¶
新建一个转发通道，协议选择陀曼云MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，一般保持默认即可；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，订阅主题、发布主题、是否使用物模型转发等更多参数见规约特征配置；
添加完转发通道后，网关会自动把所有采集通道下的数据转发到陀曼云，每一个采集通道对应陀曼云平台的通道，采集通道的通道名称即对应陀曼云通道的通道名称。
提示
配置转发时请务必保存一次规约特征，使得MQTT参数、离线存储天数等配置生效。
新建设备¶
该转发协议无需新建转发设备；
网关会自动把所有采集设备的数据转发到陀曼云，每一个采集设备对应陀曼云平台的控制器，采集设备的设备名称即对应控制器的控制器名称。
新建测点¶
该转发协议无需新建转发测点；
网关会自动把所有采集测点的数据转发到陀曼云，每一个采集测点对应陀曼云平台的采集点位，采集测点的物模型标识(测点描述)即对应采集点位的变量标识符。
领祺工业云MQTT¶
云端配置(领祺工业云MQTT)¶
新建通道¶
新建一个转发通道，协议选择领祺工业云MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，一般保持默认即可；
交互频率即为实时数据上传的时间间隔，设置范围为3s < time < 12hour，建议设置为5分钟，订阅主题、发布主题等更多参数见规约特征配置；
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
-
不新建转发设备
我们回到采集通道下的子设备管理，公共地址填1(多个设备依次顺延，同一网关下公共地址不能重复)，其余属性保持原来的参数不变；
-
新建了转发设备
新增一个转发设备，自定义设备名称，公共地址填1(多个设备依次顺延，同一网关下公共地址不能重复)，其余属性保持原来的参数不变；
新建测点¶
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，转发测点的属性均保持默认；
如果未新建转发设备，那么采集测点的是否上传属性，打钩则转发，不打勾不转发。
本地配置(领祺工业云MQTT)¶
新建通道¶
新建一个转发通道，协议选择领祺工业云MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，一般保持默认即可；
交互频率即为实时数据上传的时间间隔，设置范围为3s < time < 12hour，建议设置为5分钟，订阅主题、发布主题等更多参数见规约特征配置；
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
-
不新建转发设备
我们回到采集通道下的子设备管理，公共地址填1(多个设备依次顺延，同一网关下公共地址不能重复)，其余属性保持原来的参数不变；
-
新建了转发设备
新增一个转发设备，自定义设备名称，公共地址填1(多个设备依次顺延，同一网关下公共地址不能重复)，其余属性保持原来的参数不变；
新建测点¶
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，转发测点的属性均保持默认。
指令集MQTT¶
云端配置(指令集MQTT)¶
新建通道¶
新建一个转发通道，协议选择指令集MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
提示
设备类key、设备ID、设备秘钥与设备状态上传周期请在规约特征里配置。
新建设备¶
新建一个设备，设备名称填写对应的指令集平台的设备ID，通讯地址填写设备密钥(非必须)，设备公共地址填写该设备的设备类key，其余参数默认。
新建测点¶
举例转发一个测点，点击测点名称的编辑框，即可选择采集测点，物模型标识对应指令集平台的物模型标识符，功能码按照实际情况选择。
关于Online状态
要实现指令集平台设备状态(DEV_STAT)上报，需要注意4点，
注1：您必须在采集设备下手动添加设备通讯中断测点(参照新增采集测点里对测点属性的说明)；
注2：您必须在转发设备下手动添加上述的设备通讯中断测点，并将其物模型标识设置为"online"，功能码选择设备状态上报；
注3：我们的通讯中断点0为正常，1为异常，在上传时会自动转换成1在线，0离线；
注4：其余转发测点功能码选择设备状态上报时，也会周期性的上报。
本地配置(指令集MQTT)¶
新建通道¶
新建一个转发通道，协议选择指令集MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
提示
设备类key、设备ID与设备秘钥请在规约特征里配置。
新建设备¶
新建一个设备，设备名称填写对应的指令集平台的设备ID，通讯地址填写设备密钥(非必须)，设备公共地址填写该设备的设备类key，其余参数默认。
新建测点¶
举例转发一个测点，点击添加按钮，即可选择采集测点进行转发，物模型标识对应指令集平台的物模型标识符，功能码按照实际情况选择。
关于Online状态
要实现指令集平台设备状态(DEV_STAT)上报，需要注意4点，
注1：您必须在采集设备下手动添加设备通讯中断测点(参照[新增采集测点]里对测点属性的说明)；
注2：您必须在转发设备下手动添加上述的设备通讯中断测点，并将其物模型标识设置为"online"，功能码选择设备状态上报；
注3：我们的通讯中断点0为正常，1为异常，在上传时会自动转换成1在线，0离线；
注4：其余转发测点功能码选择设备状态上报时，也会周期性的上报。
数能物联MQTT¶
云端配置(数能物联MQTT)¶
新建通道¶
新建一个转发通道，协议选择数能物联MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)；主参数中，各个参数按照实际情况填写；
规约特征中可配置MQTT账号、密码、productKey、网关名称、是否开启SSL、离线存储天数等参数；
如需开启SSL，请参照上传证书。
提示
关于离线存储功能，5000个转发测点，1分钟的交互频率(1分钟存储一次)，运行16个小时，磁盘占用约200MB左右。
新建设备¶
新建一个设备，设备名称自定义，设备描述对应平台端的dev字段(采集设备编码)，保留0对应平台端的sysId字段(系统ID)，其余参数默认。
新建测点¶
举例转发一个测点，点击测点名称的编辑框，即可选择采集测点，物模型标识对应平台端的m字段(指标名称)，功能码选择实时消息。
注意
受限于单帧报文最大长度的原因，单个转发设备下的转发测点最大数量应控制在500个左右。
本地配置(数能物联MQTT)¶
新建通道¶
新建一个转发通道，协议选择数能物联MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)；主参数中，各个参数按照实际情况填写；
规约特征中可配置MQTT账号、密码、productKey、网关名称、是否开启SSL、离线存储天数等参数。
提示
关于离线存储功能，5000个转发测点，1分钟的交互频率(1分钟存储一次)，运行16个小时，磁盘占用约200MB左右。
新建设备¶
新建一个设备，设备名称自定义，设备描述对应平台端的dev字段(采集设备编码)，保留0对应平台端的sysId字段(系统ID)，其余参数默认。
新建测点¶
举例转发一个测点，点击添加按钮，即可选择采集测点进行转发，物模型标识对应平台端的m字段(指标名称)，功能码选择实时消息。
注意
受限于单帧报文最大长度的原因，单个转发设备下的转发测点最大数量应控制在500个左右。
正泰物联MQTT转发¶
云端配置(正泰物联MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择正泰物联MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟；
ClientID、DevTyp等更多参数配置见规约特征页面，在配置规约特征时，ClinetID有两个通配符，${sn}将被替换为智能网关SN码，${DevTyp}将被替换为规约特征中编号为11的参数网关系列编号；
如果需要上传证书的，需要在规约参数里启用SSL，并上传服务器下发的证书到网关。
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，设备的公共地址填1(同一网关下公共地址不能重复，多个设备的公共地址依次顺延)，保留1字段填写DevType内容。
配置测点¶
所有的采集测点默认全部上传，有不想上传的点，在测点的基本属性页，取消勾选是否上传即可。
配置工况测点¶
该转发协议虽然不需要配置测点的转发设备。但是如果需要在工况信息中发送某些状态信息，则需要配置转发设备，用于承载通道状态和设备状态测点。
配置通道工况测点¶
新建一个转发设备用于配置通道状态测点，这里可以把转发设备名字设置成通道状态（非必须）。
进入通道状态设备，添加通道状态测点。此处需要根据需要配置物模型标识，且把功能码选成通道状态即可。
配置设备工况测点¶
新建一个转发设备用于配置设备状态测点。这里必须配置通信地址，它与采集设备的公共地址一一对应。
进入设备状态转发设备，添加设备状态测点。此处需要根据需要配置物模型标识，且把功能码选成设备状态即可。
本地配置(正泰物联MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择正泰物联MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟；
ClientID、DevTyp等更多参数配置见规约特征页面，在配置规约特征时，ClinetID有两个通配符，${sn}将被替换为智能网关SN码，${DevTyp}将被替换为规约特征中编号为11的参数网关系列编号；
如果需要上传证书的，需要在规约参数里启用SSL，并上传服务器下发的证书到网关。
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，设备的公共地址填1(同一网关下公共地址不能重复，多个设备的公共地址依次顺延)，保留1字段填写DevType内容。
配置测点¶
所有的采集测点默认全部上传，有不想上传的点，将采集测点的是否上传属性选择否即可。
配置工况测点¶
该转发协议虽然不需要配置测点的转发设备。但是如果需要在工况信息中发送某些状态信息，则需要配置转发设备，用于承载通道状态和设备状态测点。
配置通道工况测点¶
新建一个转发设备用于配置通道状态测点，这里可以把转发设备名字设置成通道状态（非必须）。
进入通道状态设备，添加通道状态测点。此处需要根据需要配置物模型标识，且把功能码选成通道状态即可。
配置设备工况测点¶
新建一个转发设备用于配置设备状态测点。这里必须配置通信地址，它与采集设备的公共地址一一对应。
进入设备状态转发设备，添加设备状态测点。此处需要根据需要配置物模型标识，且把功能码选成设备状态即可。
三水智能MQTT¶
云端配置(三水智能MQTT)¶
新建通道¶
新建一个转发通道，协议选择三水智能MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，订阅主题、发布主题等更多参数见规约特征配置；
注意!!!
ID类型配置默认物模型标识(测点描述)，设备ID类型默认设备描述；
该功能在软件版本≥1.3.24后支持，由于兼容性问题，当前已有的工程下发时请留意网关软件版本号，软件版本必须≥1.3.24且升级完成后工程必须重新下发，否则会导致转发数据异常。
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，设备描述填写三水平台的设备标识，其余参数默认。
提示
你可以在规约特征中自由配置设备标识取设备名称还是公共地址还是设备描述，默认为设备描述。
配置测点¶
该转发协议无需新增转发测点。
默认转发所有采集测点，不需要转发的，取消勾选测点的是否上传属性；测点的物模型标识(测点描述)对三水平台的ID。
提示
你可以在规约特征中自由配置ID取测点名称还是测点地址还是物模型标识，默认为物模型标识。
按照上述配置完成后，部分json内容如下，其中A2_Q1由通道名、设备描述拼接而成：
本地配置(三水智能MQTT)¶
新建通道¶
新建一个转发通道，协议选择三水智能MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，订阅主题、发布主题等更多参数见规约特征配置；
注意!!!
ID类型配置默认物模型标识(测点描述)，设备ID类型默认设备描述；
该功能在软件版本≥1.3.24后支持，由于兼容性问题，当前已有的工程下发时请留意网关软件版本号，软件版本必须≥1.3.24且升级完成后工程必须重新下发，否则会导致转发数据异常。
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，设备描述填写三水平台的设备标识，其余参数默认。
提示
你可以在规约特征中自由配置设备标识取设备名称还是公共地址还是设备描述，默认为设备描述。
配置测点¶
该转发协议无需新增转发测点。
默认转发所有采集测点，不需要转发的，取消勾选测点的是否上传属性；测点的物模型标识(测点描述)对三水平台的ID。
提示
你可以在规约特征中自由配置ID取测点名称还是测点地址还是物模型标识，默认为物模型标识。
按照上述配置完成后，部分json内容如下，其中A2_Q1由通道名、设备描述拼接而成：
万马MQTT¶
云端配置(万马MQTT)¶
新建通道¶
新建一个转发通道，协议选择万马MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；交互频率即为实时数据全量上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟；
订阅主题、发布主题、开启SSL等参数请在规约特征中设定；如果开启了SSL，那么需要上传证书，证书绑定目标转发通道，一个通道对应一组证书文件，通道删除重建的话需要重新上传证书。
新建设备¶
在刚刚创建的转发通道下，新增一个转发设备，自定义设备名称，其余参数保持默认即可。
新建测点¶
在刚刚创建的转发设备下，批量添加需要转发的测点，不添加不转发。
本地配置(万马MQTT)¶
新建通道¶
新建一个转发通道，协议选择万马MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；交互频率即为实时数据全量上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟；
订阅主题、发布主题、开启SSL等参数请在规约特征中设定；如果开启了SSL，那么需要上传证书，证书绑定目标转发通道，一个通道对应一组证书文件，通道删除重建的话需要重新上传证书。
新建设备¶
在刚刚创建的转发通道下，新增一个转发设备，自定义设备名称，其余参数保持默认即可。
新建测点¶
在刚刚创建的转发设备下，批量添加需要转发的测点，不添加不转发。
杭州锐创MQTT¶
云端配置(杭州锐创MQTT)¶
新建通道¶
新建一个转发通道，协议选择杭州锐创MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟；
发布主题、订阅主题、建筑代码(F_BuildID)、采集器代码(F_GateWayID)等在通道的规约特征里设置。
新建设备¶
新建一个转发设备，设备名称自定义，通讯地址(数字)填写电表地址(F_Address)，公共地址(数字)填写仪表编码(MetterID)，协议能源代码按照实际情况填写，COM口填写串口索引。
新建测点¶
在新建的转发设备中，批量新增转发测点，转发测点的寄存器地址为功能ID(F_FunctionID)。
本地配置(杭州锐创MQTT)¶
新建通道¶
新建一个转发通道，协议选择杭州锐创MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟；
发布主题、订阅主题、建筑代码(F_BuildID)、采集器代码(F_GateWayID)等在通道的规约特征里设置。
新建设备¶
新建一个转发设备，设备名称自定义，通讯地址(数字)填写电表地址(F_Address)，公共地址(数字)填写仪表编码(MetterID)，保留字段0(数字)填写仪表类型(F_MeterType)，保留字段1填写串口索引。
新建测点¶
在新建的转发设备中，批量新增转发测点，转发测点的寄存器地址为功能ID(F_FunctionID)。
华为物联网平台¶
云端配置(华为物联网平台)¶
新建通道¶
新建一个转发通道，协议选择华为物联网平台，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟；
发布主题、订阅主题、ClientID、网关类型、MQTT连接ID、协议版本等在通道的规约特征里设置。
新建设备¶
新建一个转发设备，设备名称自定义，公共地址填写服务号(serviceId)。
新建测点¶
在新建的转发设备中，批量新增转发测点，转发测点的寄存器地址为服务数据的key。
本地配置(华为物联网平台)¶
新建通道¶
新建一个转发通道，协议选择华为物联网平台，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟；
发布主题、订阅主题、ClientID、网关类型、MQTT连接ID、协议版本等在通道的规约特征里设置。
新建设备¶
新建一个转发设备，设备名称自定义，公共地址填写服务号(serviceId)。
新建测点¶
在新建的转发设备中，批量新增转发测点，转发测点的寄存器地址为服务数据的key。
沣泰MQTT¶
云端配置(沣泰MQTT)¶
新建通道¶
新建一个转发通道，协议选择沣泰MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，订阅主题、发布主题等更多参数见规约特征配置；
新建设备¶
新建一个转发设备，该设备的通讯地址即为mqtt消息中的devaddr，其余参数保持默认即可；
新建测点¶
在刚建的转发设备下，批量添加转发测点，只有被添加的测点才会被转发，其中地址一栏的内容即为mqtt消息中的tag(测点编号)。
云端配置(沣泰MQTT)¶
新建通道¶
新建一个转发通道，协议选择沣泰MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，订阅主题、发布主题等更多参数见规约特征配置；
新建设备¶
新建一个转发设备，该设备的通讯地址即为mqtt消息中的devaddr，其余参数保持默认即可；
新建测点¶
在刚建的转发设备下，批量添加转发测点，只有被添加的测点才会被转发，其中地址一栏的内容即为mqtt消息中的tag(测点编号)。
MQTT2EFR32zigbee¶
适用型号¶
本驱动适用的ZigBee网关型号是：EFR32。
云端配置(ZigBeeMQTT)¶
新建通道¶
新建一个采集通道，协议选择MQTT2EFR32zigbee，主参数中，只需要填写端口号，为MQTT服务器的要使用的端口号；
交互频率即为轮询ZigBee网关传感器实时值的时间间隔，订阅主题、发布主题等更多参数见规约特征配置；
设置规约参数¶
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 主题前缀 | 一般不用动。与ZigBee网关发送的主题一致即可 |
| 1 | 主题主体 | 与ZigBee网关的MQTT设置界面中保持一致，如下图所示 |
注意!!!
主题前缀暂时没有在ZigBee网关的配置项中找到，故暂时保持不动就行。即使不对，不会影响正常的数据读取和控制。只是无法接收变化数据，导致传感器状态变化后无法及时被采集到而已。
新建设备¶
新建一个采集设备，设备地址填写传感器地址。
提示
传感器地址的ZigBee网关的设置页面中查看。如下图所示。注意要把查看到的传感器地址按照原样填写，不得有任何变化。
新建测点¶
新建测点，功能码选择**开关**，地址填写改测点对应传感器上开关号，传感器有几个开关就配置几个地址。如传感器有4个开关，配置4个测点，地址为0~3。
提示
目前只支持开关数据的解析。
本地配置(ZigBeeMQTT)¶
新建通道¶
新建一个采集通道，协议选择MQTT2EFR32zigbee，主参数中，只需要填写端口号，为MQTT服务器的要使用的端口号；
交互频率即为轮询ZigBee网关传感器实时值的时间间隔，订阅主题、发布主题等更多参数见规约特征配置；
设置规约参数¶
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 主题前缀 | 一般不用动。与ZigBee网关发送的主题一致即可 |
| 1 | 主题主体 | 与ZigBee网关的MQTT设置界面中保持一致，如下图所示 |
注意!!!
主题前缀暂时没有在ZigBee网关的配置项中找到，故暂时保持不动就行。即使不对，不会影响正常的数据读取和控制。只是无法接收变化数据，导致传感器状态变化后无法及时被采集到而已。
新建设备¶
新建一个采集设备，设备地址填写传感器地址。
提示
传感器地址的ZigBee网关的设置页面中查看。如下图所示。注意要把查看到的传感器地址按照原样填写，不得有任何变化。
新建测点¶
新建测点，功能码选择**开关**，地址填写改测点对应传感器上开关号，传感器有几个开关就配置几个地址。如传感器有4个开关，配置4个测点，地址为0~3。
提示
目前只支持开关数据的解析。
扶贫MQTT¶
云端配置(扶贫MQTT)¶
新建通道¶
新建一个转发通道，协议选择扶贫MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，mqtt客户端连接信息、离线存储天数等参数需要在规约特征配置；
如果用户需要上传自己的证书，可以通过“操作”选项框点击“上传证书”，弹出证书上传目录。
提示
配置转发时请务必保存一次规约特征，使得MQTT参数、离线存储天数等配置生效。
新建设备¶
新建一个转发设备，设备通讯地址填写平台上对应的设备序号，设备公共地址填写三位设备类型。
新建测点¶
新建一个转发测点，地址填写指标编码，功能码选择发送数据，如果是告警数据，功能码选择发送告警。
本地配置(扶贫MQTT)¶
新建通道¶
新建一个通道，类型选择转发通道，协议选择扶贫MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，mqtt客户端连接信息、离线存储天数等参数需要在规约特征配置；
如果用户需要上传自己的证书，可以点击“上传证书”，弹出证书上传目录。
提示
配置转发时请务必保存一次规约特征，使得MQTT参数、离线存储天数等配置生效。
新建设备¶
新建一个转发设备，设备通讯地址填写平台上对应的设备序号，设备公共地址填写三位设备类型。
新建测点¶
新建一个转发测点，地址填写指标编码，功能码选择发送数据，如果是告警数据，功能码选择发送告警。
蓝卓MQTT转发¶
云端配置(蓝卓MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择蓝卓MQTT转发，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，交互频率即为实时数据上传的时间间隔；
将平台上的网关的UUID和网关名称分别填写到规约特征中的UUID和网关名称中。
根据平台上位号元数据的唯一性，在位号元数据对应字段选择测点名称，对应平台的别名，平台中展示的"名称"在规约中可以选择名称对应字段进行配置。
其他参数见规约特征配置；
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的通道的所有采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
-
不新建转发设备
我们回到采集通道下的子设备管理，在发送数据时的topic中的设备ID会使用采集设备中的公共地址，可以根据需要修改采集设备的公共地址，如果采集设备的公共地址x修改时与采集协议冲突，这种情况需要到转发通道新建转发设备。
-
新建了转发设备
新增一个转发设备，自定义设备名称，在发送数据时的topic中的设备ID会使用转发设备中的公共地址。
新建测点¶
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，转发测点的属性均保持默认；
如果未新建转发设备，那么需要配置采集测点的是否上传属性，打钩(默认)则转发，不打勾不转发。
转发数据时根据转发通道的规约特征中的位号元数据对应字段上传位号元数据，测点数据类型中位对应平台的BOOLEAN，单精度浮点数和双精度浮点数对应平台的DOUBLE，字符串对应平台的STRING，其他所有类型对应平台的LONG。
本地配置(蓝卓MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择蓝卓MQTT转发，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，交互频率即为实时数据上传的时间间隔；
将平台上的网关的UUID和网关名称分别填写到规约特征中的UUID和网关名称中。
根据平台上位号元数据的唯一性，在位号元数据对应字段选择测点名称，对应平台的别名，平台中展示的"名称"在规约中可以选择名称对应字段进行配置。
其他参数见规约特征配置；
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的通道的所有采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
-
不新建转发设备
我们回到采集通道下的子设备管理，在发送数据时的topic中的设备ID会使用采集设备中的公共地址，可以根据需要修改采集设备的公共地址，如果采集设备的公共地址x修改时与采集协议冲突，这种情况需要到转发通道新建转发设备。
-
新建了转发设备
新增一个转发设备，自定义设备名称，在发送数据时的topic中的设备ID会使用转发设备中的公共地址。
新建测点¶
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，转发测点的属性均保持默认；
如果未新建转发设备，那么需要配置采集测点的是否上传属性。
转发数据时根据转发通道的规约特征中的位号元数据对应字段上传位号元数据，测点数据类型中位对应平台的BOOLEAN，单精度浮点数和双精度浮点数对应平台的DOUBLE，字符串对应平台的STRING，其他所有类型对应平台的LONG。
naquanMQTTslave¶
云端配置(纳泉MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择纳泉MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，一般保持默认即可；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，网关的Productkey、DeviceSN等更多参数见规约特征配置；
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
不新建转发设备¶
我们回到采集通道下的子设备管理，公共地址填该设备的DeviceSN属性，保留0填该设备的productKey属性，如果该设备属于某个父设备之下，保留1填父设备的DeviceSN。如下图中该设备是电池包设备，属于一个电池族设备的子设备，故保留1配置了其父设备的DeviceSN属性180000110Cluster1；
提示
采集设备的通讯地址不能随意修改，而其将作为数据报文中，测点数组的key值发送，故在实际配置工程中要考虑该值是否能符合要求。如果不能就必须新建转发设备了。此外，采集设备不支持订阅主题配置。
新建转发设备¶
新增一个转发设备，自定义设备名称，通讯地址填测点数组的key值，公共地址填该设备的DeviceSN属性，保留0填该设备的productKey属性，如果该设备属于某个父设备之下，保留1填父设备的DeviceSN。如果本设备需要订阅主题，则在设备描述中填写订阅主题，主题中可用通配符:{0}会被替换为本设备的**productKey**，会被替换为本设备的DeviceSN，如本例中的设备的订阅主题是:meta/v1/1200000000UKAUZD/202302072513/write,应答主题是:meta/v1/1200000000UKAUZD/202302072513/write_ack。
警告
如果本设备不需要订阅主题，一定要把设备描述清零。
新建测点¶
如果未新建转发设备，那么需要配置采集测点的是否上传属性，打钩(默认)则转发，不打勾不转发。
提示
使用采集测点转发时，模拟量类型测点将作为遥测数据转发，开关量数据将作为遥信数据转发。
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，按需配置转发测点的物模型属性以及功能码。
本地配置(纳泉MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择纳泉MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，一般保持默认即可；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，网关的Productkey、DeviceSN等更多参数见规约特征配置
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
不新建转发设备¶
我们回到采集通道下的子设备管理，公共地址填该设备的DeviceSN属性，保留0填该设备的productKey属性，如果该设备属于某个父设备之下，保留1填父设备的DeviceSN。如下图中该设备是电池包设备，属于一个电池族设备的子设备，故保留1配置了其父设备的DeviceSN属性180000110Cluster1；
提示
采集设备的通讯地址不能随意修改，而其将作为数据报文中，测点数组的key值发送，故在实际配置工程中要考虑该值是否能符合要求。如果不能就必须新建转发设备了。此外，采集设备不支持订阅主题配置。
新建转发设备¶
新增一个转发设备，自定义设备名称，通讯地址填测点数组的key值，公共地址填该设备的DeviceSN属性，保留0填该设备的productKey属性，如果该设备属于某个父设备之下，保留1填父设备的DeviceSN。如果本设备需要订阅主题，则在设备描述中填写订阅主题，主题中可用通配符:{0}会被替换为本设备的**productKey**，会被替换为本设备的DeviceSN，如本例中的设备的订阅主题是:meta/v1/1200000000UKAUZD/202302072513/write,应答主题是:meta/v1/1200000000UKAUZD/202302072513/write_ack。
警告
如果本设备不需要订阅主题，一定要把设备描述清零。
新建测点¶
如果未新建转发设备，那么需要配置采集测点的是否上传属性，配置为否则不转发。
提示
使用采集测点转发时，模拟量类型测点将作为遥测数据转发，开关量数据将作为遥信数据转发。
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，按需配置转发测点的物模型属性以及功能码。
jsenergy¶
云端配置(江苏省综E+平台)¶
新建通道¶
新建一个转发通道，协议选择江苏省综E+平台，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，按实际需要配置；
规约参数配置¶
规约参只列举比较重要的配置项，等更多参数见规约特征。
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 0 | MQTT账号(留空默认网关编号) | 按实际配置 |
| 1 | MQTT密码(留空默认网关密码) | 按实际配置 |
| 2 | ClientID(留空为随机ID) | 按实际配置 |
| 6 | 网关关联码 | 按实际配置 |
| 10 | 离线数据存储天数(0不存储) | 本协议未实现存储功能，本配置无效 |
| 12 | 测点标识 | 转发时，测点key值来源，一般默认即可 |
| 13 | 子设备ID(匹配采集设备公共地址,为0则全转发) | 当转发数据来自采集设备时，该值用于匹配采集设备，如该值为1时，只转发公共地址是1的采集设备 |
| 14 | 开启测试模式 | 当本网关没有订阅控制指令权限时，开启该选项，否则网关会一直断开重连，试图将该主题订阅成功 |
| 15 | 群调周期(单位秒,应大于网关一次完整扫描采集时间) | 多少时间执行一次群调策略 |
| 16 | 调节死区(kW) | 当需求功率值和总有功功率的差值小于该值，将不执行群控策略 |
| 17 | 空调增温发码 | 需要对空调增加温度时，发给空调控制器的码值。目前只有分立式空调需要用到 |
| 18 | 空调降温发码 | 需要对空调降低温度时，发给空调控制器的码值。目前只有分立式空调需要用到 |
| 19 | 空调制冷模式值 | 从空调控制器读取到冷热模式值等于该值时，判断空调处于制冷模式。需要按实际通讯文档配置 |
| 20 | 空调制热模式值 | 从空调控制器读取到冷热模式值等于该值时，判断空调处于制冷模式。需要按实际通讯文档配置 |
| 21 | 群控设备类型 | 本网群控的设备类型，需要按实际配置 |
提示
群控设备类型目前支持三种：分立式空调，冷水机，VRV空调。分立式空调每个空调设备都需要对应一个电表设备，来读取空调的功率，群控处理时将根据空调的功率值顺序，分别对空调设备进行群控处理。另外两种则对所有的设备统一控制。
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
-
不新建转发设备
如果所有的采集设备都需要上传，则无需对采集设备进行任何配置。如果只需要转发部分设备，则将公共地址配置为与规约特征第13条一样的非零值即可；
-
新建了转发设备
新增一个转发设备，自定义设备名称其他参数保持默认即可。
新建测点¶
在配置转发测点时，需要事先获得相应的平台测点点表，我们需要按照该点表配置转发测点的上传标识。默认情况下，配置在测点的物模型标识，如果在规约特征中第12条有修改，那么这个上传标识就要配置到相应的属性上。
如果未新建转发设备，那么需要配置采集测点的是否上传属性，打钩(默认)则转发，不打勾不转发,对需要转发的测点的物模型标识上配置上正确的测点标识。
提示
使用采集测点转发时，模拟量类型测点将作为遥测数据转发，开关量数据将作为遥信数据转发。
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，按需配置转发测点的物模型即可。
本地配置(江苏省综E+平台)¶
新建通道¶
新建一个转发通道，协议选择江苏省综E+平台，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，按实际需要配置；
规约参数配置¶
规约参只列举比较重要的配置项，等更多参数见规约特征。
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 0 | MQTT账号(留空默认网关编号) | 按实际配置 |
| 1 | MQTT密码(留空默认网关密码) | 按实际配置 |
| 2 | ClientID(留空为随机ID) | 按实际配置 |
| 6 | 网关关联码 | 按实际配置 |
| 10 | 离线数据存储天数(0不存储) | 本协议未实现存储功能，本配置无效 |
| 12 | 测点标识 | 转发时，测点key值来源，一般默认即可 |
| 13 | 子设备ID(匹配采集设备公共地址,为0则全转发) | 当转发数据来自采集设备时，该值用于匹配采集设备，如该值为1时，只转发公共地址是1的采集设备 |
| 14 | 开启测试模式 | 当本网关没有订阅控制指令权限时，开启该选项，否则网关会一直断开重连，试图将该主题订阅成功 |
| 15 | 群调周期(单位秒,应大于网关一次完整扫描采集时间) | 多少时间执行一次群调策略 |
| 16 | 调节死区(kW) | 当需求功率值和总有功功率的差值小于该值，将不执行群控策略 |
| 17 | 空调增温发码 | 需要对空调增加温度时，发给空调控制器的码值。目前只有分立式空调需要用到 |
| 18 | 空调降温发码 | 需要对空调降低温度时，发给空调控制器的码值。目前只有分立式空调需要用到 |
| 19 | 空调制冷模式值 | 从空调控制器读取到冷热模式值等于该值时，判断空调处于制冷模式。需要按实际通讯文档配置 |
| 20 | 空调制热模式值 | 从空调控制器读取到冷热模式值等于该值时，判断空调处于制冷模式。需要按实际通讯文档配置 |
| 21 | 群控设备类型 | 本网群控的设备类型，需要按实际配置 |
提示
群控设备类型目前支持三种：分立式空调，冷水机，VRV空调。分立式空调每个空调设备都需要对应一个电表设备，来读取空调的功率，群控处理时将根据空调的功率值顺序，分别对空调设备进行群控处理。另外两种则对所有的设备统一控制。
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
-
不新建转发设备
如果所有的采集设备都需要上传，则无需对采集设备进行任何配置。如果只需要转发部分设备，则将公共地址配置为与规约特征第13条一样的非零值即可；
-
新建了转发设备
新增一个转发设备，自定义设备名称其他参数保持默认即可。
新建测点¶
在配置转发测点时，需要事先获得相应的平台测点点表，我们需要按照该点表配置转发测点的上传标识。默认情况下，配置在测点的物模型标识，如果在规约特征中第12条有修改，那么这个上传标识就要配置到相应的属性上。
如果未新建转发设备，那么需要配置采集测点的是否上传属性，打钩(默认)则转发，不打勾不转发,对需要转发的测点的物模型标识上配置上正确的测点标识。
提示
使用采集测点转发时，模拟量类型测点将作为遥测数据转发，开关量数据将作为遥信数据转发。
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，按需配置转发测点的物模型即可。
鸿晟电力MQTT转发¶
云端配置(鸿晟电力MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择鸿晟电力MQTT转发，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，一般保持默认即可；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，MQTT账号、密码、版本号、站点项目代码等更多参数见规约特征配置，对于本驱动来说，订阅主题和发布主题保持默认即可，通常无需改变；
配置设备¶
该转发协议无需新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
我们回到采集通道下的子设备管理，公共地址填1(多个设备依次顺延，同一网关下公共地址不能重复)，其余属性保持原来的参数不变；
配置测点¶
我们回到采集设备下的采集测点管理，配置采集测点的是否上传属性，打钩(默认)则转发，不打勾不转发；
采集测点的测点类型选择"模拟量"，会自动发布到遥测主题，采集测点的测点类型选择"开关量"，会自动发布到遥信主题。
本地配置(鸿晟电力MQTT转发)¶
请参考云端配置。
仪表云MQTT¶
云端配置(仪表云MQTT)¶
新建通道¶
新建一个转发通道，协议选择仪表云MQTT，主参数中，IP地址与端口号填写http接口地址，而非MQTT服务器地址，网关会根据接口地址主动请求MQTT服务器地址；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，productKey等参数见规约特征配置；
配置设备¶
该转发协议不用新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，将采集测点的是否上传取消勾选)；
我们回到采集通道下的子设备管理，公共地址填1(多个设备依次顺延，同一网关下公共地址不能重复)，保留0字段填写sysId(如有)，保留1字段填写devType(如有)；
配置测点¶
配置采集测点的物模型标识以及是否上传属性。
本地配置(仪表云MQTT)¶
新建通道¶
新建一个转发通道，协议选择仪表云MQTT，主参数中，IP地址与端口号填写http接口地址，而非MQTT服务器地址，网关会根据接口地址主动请求MQTT服务器地址；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，productKey等参数见规约特征配置；
配置设备¶
该转发协议不用新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，将采集测点的是否上传取消勾选)；
我们回到采集通道下的子设备管理，公共地址填1(多个设备依次顺延，同一网关下公共地址不能重复)，保留0字段填写sysId(如有)，保留1字段填写devType(如有)；
配置测点¶
配置采集测点的物模型标识以及是否上传属性。
greenpower_mqtt¶
云端配置(绿电交通MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择绿电交通MQTT转发，主参数中，IP地址与端口号填写MQTT服务器地址和端口；
交互频率在本驱动中无效，设备实时数据的发送周期与具体的设备类型相关，各种设备的默认数据发送周期见下表；
| 序号 | 设备类型 | 默认实时数据周期(单位:秒) |
|---|---|---|
| 0 | 高压断路器状态 | 10 |
| 1 | 高压断路器综保定值状态 | 0(不发周期性数据) |
| 2 | 温控仪状态 | 300 |
| 3 | 低压进线断路器状态 | 10 |
| 4 | 低压出线断路器状态 | 10 |
产品编码，配电箱编码等参数见规约特征配置；
配置设备¶
该转发协议不用新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，将采集测点的是否上传取消勾选)；
我们回到采集通道下的子设备管理，兼容平台选择绿电交通，设备类型按照实际的设备类型选择，公共地址填写swapId，保留0字段填写vcbId，如果该设备不想按照默认的周期发送实时数据，则在保留1字段填写数据发送周期(秒)；
配置测点¶
配置采集测点的PV标识以及是否上传属性。
本地配置(绿电交通MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择绿电交通MQTT转发，主参数中，IP地址与端口号填写MQTT服务器地址和端口；
交互频率在本驱动中无效，设备实时数据的发送周期与具体的设备类型相关，各种设备的默认数据发送周期见下表；
| 序号 | 设备类型 | 默认实时数据周期(单位:秒) |
|---|---|---|
| 0 | 高压断路器状态 | 10 |
| 1 | 高压断路器综保定值状态 | 0(不发周期性数据) |
| 2 | 温控仪状态 | 300 |
| 3 | 低压进线断路器状态 | 10 |
| 4 | 低压出线断路器状态 | 10 |
产品编码，配电箱编码等参数见规约特征配置；
配置设备¶
该转发协议不用新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，将采集测点的是否上传取消勾选)；
我们回到采集通道下的子设备管理，兼容平台选择绿电交通，设备类型按照实际的设备类型选择，公共地址填写swapId，保留0字段填写vcbId，如果该设备不想按照默认的周期发送实时数据，则在保留1字段填写数据发送周期(秒)；
配置测点¶
配置采集测点的PV标识以及是否上传属性。
淄博水务MQTT¶
云端配置(淄博水务MQTT)¶
新建通道¶
新建一个转发通道，协议选择淄博水务MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
取得淄博水务平台的MQTT账号，MQTT密码以及订阅主题、发布主题，填写在规约参数中， 如下图所示：
配置设备¶
该转发协议不用新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，将采集测点的是否上传取消勾选)；
我们回到采集通道下的子设备管理，公共地址填组织id(同一网关下公共地址不能重复)；
配置测点¶
配置采集测点的物模型标识以及是否上传属性。
本地配置(淄博水务MQTT)¶
新建通道¶
新建一个转发通道，协议选择淄博水务MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
取得淄博水务平台的MQTT账号，MQTT密码以及订阅主题、发布主题，填写在规约参数中，点击保存即可， 如下图所示：
配置设备¶
该转发协议不用新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，将采集测点的是否上传取消勾选)；
我们回到采集通道下的子设备管理，公共地址填组织id(同一网关下公共地址不能重复)；
配置测点¶
配置采集测点的物模型标识以及是否上传属性。
东峻光伏平台MQTT¶
云端配置(东峻光伏平台MQTT)¶
新建通道¶
新建一个转发通道，协议选择东峻光伏平台MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
取得东峻光伏平台的MQTT账号，MQTT密码以及订阅主题、发布主题，填写在规约参数中， 如下图所示：
配置设备¶
该转发协议不用新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，将采集测点的是否上传取消勾选)；
我们回到采集通道下的子设备管理，公共地址填逆变器SN(同一网关下公共地址不能重复)；
配置测点¶
配置采集测点的物模型标识以及是否上传属性。
本地配置(东峻光伏平台MQTT)¶
新建通道¶
新建一个转发通道，协议选择东峻光伏平台MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；
取得东峻光伏平台的MQTT账号，MQTT密码以及订阅主题、发布主题，填写在规约参数中，点击保存即可， 如下图所示：
配置设备¶
该转发协议不用新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，将采集测点的是否上传取消勾选)；
我们回到采集通道下的子设备管理，公共地址填逆变器SN(同一网关下公共地址不能重复)；
配置测点¶
配置采集测点的物模型标识以及是否上传属性。
协鑫MQTT¶
云端配置(协鑫MQTT)¶
新建通道¶
新建一个转发通道，协议选择协鑫MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写，转发通道的保留0处需要填写在mqtt消息中dn内站编码的内容。假设为站编码为station01;
根据协鑫平台情况和需求在规约参数中修改相关参数
注意
1、变量数据上传默认是开启的，如后续需要关闭请将规约参数中的开启变化上送改为关闭。
2、如果觉得变量数据上传的不及时可以减小规约参数中变化上送周期的值一般选在5~10秒。
3、如若后期需要更改遥信遥测遥脉等数据的发布主题也可在规约参数中的对应位置进行修改。
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
-
不新建转发设备
我们回到采集通道下的子设备管理，公共地址填协鑫平台MQTT消息中dn内设备编码的值，，其余属性保持原来的参数不变；
* 新建了转发设备新增一个转发设备，自定义设备名称，公共地址填填协鑫平台MQTT消息中dn内设备编码的值，其余属性保持原来的参数不变；
新建测点¶
批量新建设备时已经自动带入相应采集测点进行转发，如果有不需要转发的测点，批量勾选转发测点，然后删除即可；
测点的物模型标识(测点描述)对应MQTT消息中data内的属性名。
本地配置(协鑫MQTT)¶
新建通道¶
新建一个转发通道，协议选择协鑫MQTT，交互频率意为全量上送间隔(填写范围1秒-12小时，单位ms)，如有需要，变位上送间隔请在规约特征配置里开启与填写(填写范围1秒-5分钟，单位ms)；主参数中，各个参数按照实际情况填写；转发通道的保留0处需要填写在mqtt消息中dn内站编码的内容。假设为站编码为station01;
根据协鑫平台情况和需求在规约参数中修改相关参数
注意
1、变量数据上传默认是开启的，如后续需要关闭请将规约参数中的开启变化上送改为关闭。
2、如果觉得变量数据上传的不及时可以减小规约参数中变化上送周期的值一般选在5~10秒。
3、如若后期需要更改遥信遥测遥脉等数据的发布主题也可在规约参数中的对应位置进行修改。
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
-
不新建转发设备
我们回到采集通道下的子设备管理，公共地址填协鑫平台MQTT消息中dn内设备编码的值，，其余属性保持原来的参数不变；
* 新建了转发设备新增一个转发设备，自定义设备名称，公共地址填填协鑫平台MQTT消息中dn内设备编码的值，其余属性保持原来的参数不变；
新建测点¶
批量新建设备时已经自动带入相应采集测点进行转发，如果有不需要转发的测点，批量选中转发测点，然后删除即可；
测点的物模型标识(测点描述)对应MQTT消息中data内的属性名。
嘉兴虚拟电厂MQTT¶
云端配置(嘉兴虚拟电厂MQTT)¶
新建通道¶
新建一个转发通道，协议选择嘉兴虚拟电厂，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，订阅主题、发布主题、是否使用物模型转发等更多参数见规约特征配置；
规约相关¶
如果是储能聚合平台使用本协议需将规约参数中的接入模式改为数据直采、直控模式； MQTT账号(留空默认网关编号)填写网关产品序列号； MQTT密码(留空默认网关密码)填写网关密钥,其余情况默认即可；
新建设备¶
新增一个转发设备，自定义设备名称，第一个设备的公共地址填网关设备序列号，
设备的保留0填子设备产品序列号
设备的保留1填子设备序列号devicesn其余属性保持原来的参数不变；
新建测点¶
批量新建设备时已经自动带入相应采集测点进行转发，如果有不需要转发的测点，批量勾选转发测点，然后删除即可；
测点的物模型标识(测点描述)对应MQTT消息中的字段名。
注意
如果是策略转发点需将功能码改为策略，同时同组的策略地址需要相同；起始时间，结束时间，功率需连续；
本地配置(嘉兴虚拟电厂MQTT)¶
新建通道¶
新建一个转发通道，协议选择嘉兴虚拟电厂，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，订阅主题、发布主题、是否使用物模型转发等更多参数见规约特征配置；
规约相关¶
如果是储能聚合平台使用本协议需将规约参数中的接入模式改为数据直采、直控模式； MQTT账号(留空默认网关编号)填写网关产品序列号； MQTT密码(留空默认网关密码)填写网关密钥,其余情况默认即可；
新建设备¶
新增一个转发设备，自定义设备名称，第一个设备的公共地址填网关设备序列号， 设备的保留0填子设备产品序列号 设备的保留1填子设备序列号devicesn其余属性保持原来的参数不变；
{.img-fluid tag=2}
新建测点¶
批量新建设备时已经自动带入相应采集测点进行转发，如果有不需要转发的测点，批量勾选转发测点，然后删除即可；
测点的物模型标识(测点描述)对应MQTT消息中的字段名。
注意
如果是策略转发点需将功能码改为策略，同时同组的策略地址需要相同；起始时间，结束时间，功率需连续；
晟能深中电MQTT转发¶
云端配置(晟能深中电MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择晟能深中电MQTT，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，一般保持默认即可；
交互频率即为全量数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，订阅主题、发布主题、是否使用物模型转发等更多参数见规约特征配置；
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
-
不新建转发设备
采集通道的属性保持原来的参数不变；
-
新建了转发设备
新增一个转发设备，自定义设备名称，公共地址填设备的SN（区分不同设备的标志）(同一网关下公共地址不能重复)，其余属性可根据具体要求进行修改；
新建测点¶
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，转发测点的属性均保持默认；
如果未新建转发设备，那么需要配置采集测点的是否上传属性，打钩(默认)则转发，不打勾不转发。
本地配置(晟能深中电MQTT转发)¶
新建通道¶
新建一个转发通道，协议选择通用MQTT转发，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，一般保持默认即可；
交互频率即为全量数据上传的时间间隔，设置范围为1s < time < 12hour，建议设置为5分钟，订阅主题、发布主题、是否使用物模型转发等更多参数见规约特征配置；
部分规约特征说明如下：
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | MQTT账号 | 连接服务器的账号（留空默认网关编号） |
| 1 | MQTT密码 | 连接服务器的账号（留空默认网关密码） |
| 4 | 开启变化上送 | 0:关闭;1:开启;2:开启且只发遥信变位;3:开启且只发遥信以外变位 |
| 5 | 变化上送的周期（单位：秒） | 打开变位数据上送才有效 |
| 12 | 转发测点ID类型 | 0:测点名称;1:测点地址;2:物模型标识 |
| 13 | 设备地址 | 0:使用设备公共地址;1:使用设备通讯地址 |
| 14 | 测点信息 | 0:简洁信息;1:详细信息 |
| 15 | MQTT消息持久性 | 0:不保持;1:持久保持 |
| 16 | 是否匿名登录 | 0:否;1:是 |
| 17 | 不发质量码坏点 | 0:发送;1:不发送 |
| 18 | 按设备发数据 | 0:按通道发;1:按设备发 |
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的属性中是否上传那一栏选择否)；
-
不新建转发设备
采集通道的属性保持原来的参数不变，此时设备的SN填写到采集设备的公共地址中去；
-
新建了转发设备
新增一个转发设备，自定义设备名称，公共地址填设备的SN（区分不同设备的标志）(同一网关下公共地址不能重复)，其余属性可根据具体要求进行修改；
新建测点¶
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，转发测点的属性均保持默认；
如果未新建转发设备，那么需要配置采集测点的是否上传属性，是(默认)则转发，否则不转发。
Ended: MQTT协议
数据库协议 ↵
SQL Server ↵
SQLServer采集¶
云端配置(SQLServer采集)¶
新建通道¶
提示
部分低性能网关不支持本驱动。
新建一个采集通道，协议选择SqlServer采集，本驱动用于采集微软Microsoft公司推出的关系型数据库中的数据；
通道的交互频率影响从数据库取数据的时间间隔，请根据数据入库的周期做相对较小的配置(例如数据入库周期为1分钟，则交互频率配置50~60秒)，如果不确定数据入库周期，那么根据数据刷新快慢需求来配置交互频率；
主参数中，IP地址填写数据库的IP，端口号通常保持默认即可(默认为1433)；
请务必在规约特征配置界面，配置数据库的名称(参照下图)、用户名以及密码，
查询条件1默认查最新时间的数据，其它查询条件按需开启，默认均禁用；
注意!!!
查询条件1中的查最新时间意为：
假设当前时间2021-11-26 18:17:00，通道的交互频率为90秒，那么查询时，会以Time > '2021-11-26 18:15:30'作为条件，即当前时间往前推一个交互频率，所以通道的交互频率建议不要设置过小。
当表结构为"纵向"，条件2为数据库中测点名所在的列名(如下图中的TAGNAME)，条件3为数据库中测点值所在的列名(如下图中的TAGVALUE)；
表结构默认为"横向"，如下图：
当表结构设置为"纵向"，如下图：
新建设备¶
新建一个采集设备，其余参数自定义，设备通讯地址填写[dbo].[MT0179]，参照上图。
新建测点¶
新建一个测点，功能码选择读数据，当前述步骤中表结构选择横向时，地址填写数据库中的"字段名"；当前述步骤中表结构选择纵向时，地址填写数据库中想要采集的数据的"测点名"(例如它的TAGNAME为tag1,则填写tag1)，参照上图，数据类型根据实际情况选择。
注意
配置时，数据类型分两种，字符串类型与单精度浮点数类型，此处的类型与数据库字段类型无关；
字符串：例如时间、告警消息等可以选择此类型，无需配置字符串长度，默认最长可读32个字符串长度的值；
单精度浮点数：例如温度、电压、电流等数据类的值都选择此类型，即使其在数据库中的类型是整型或字符串之类的也要选这个。
本地配置(SQLServer采集)¶
新建通道¶
提示
部分低性能网关不支持本驱动。
新建一个采集通道，协议选择SqlServer采集，本驱动用于采集微软Microsoft公司推出的关系型数据库中的数据；
通道的交互频率影响从数据库取数据的时间间隔，请根据数据入库的周期做相对较小的配置(例如数据入库周期为1分钟，则交互频率配置50~60秒)，如果不确定数据入库周期，那么根据数据刷新快慢需求来配置交互频率；
主参数中，IP地址填写数据库的IP，端口号通常保持默认即可(默认为1433)；
请务必在规约特征配置界面，配置数据库的名称(参照下图)、用户名以及密码，
查询条件1默认查最新时间的数据，其它查询条件按需开启，默认均禁用；
注意!!!
查询条件1中的查时间意为：
假设当前时间2021-11-26 18:17:00，通道的交互频率为90秒，那么查询时，会以Time > '2021-11-26 18:15:30'作为条件，即当前时间往前推一个交互频率，所以通道的交互频率建议不要设置过小。
当表结构为"纵向"，条件2为数据库中测点名所在的列名(如下图中的TAGNAME)，条件3为数据库中测点值所在的列名(如下图中的TAGVALUE)；
新建设备¶
新建一个采集设备，其余参数自定义，设备通讯地址填写[dbo].[MT0179]，参照上图。
新建测点¶
新建一个测点，功能码选择读数据，当前述步骤中表结构选择横向时，地址填写数据库中的"字段名"；当前述步骤中表结构选择纵向时，地址填写数据库中想要采集的数据的"测点名"(例如它的TAGNAME为tag1,则填写tag1)，参照上图，数据类型根据实际情况选择。
注意
配置时，数据类型分两种，字符串类型与单精度浮点数类型，此处的类型与数据库字段类型无关；
字符串：例如时间、告警消息等可以选择此类型，无需配置字符串长度，默认最长可读32个字符串长度的值；
单精度浮点数：例如温度、电压、电流等数据类的值都选择此类型，即使其在数据库中的类型是整型或字符串之类的也要选这个。
SQLServer转发¶
云端配置(SQLServer转发)¶
新建通道¶
提示
部分低性能网关不支持本驱动。
新建一个采集通道，协议选择SQLServer转发，本驱动用于将数据插入到微软Microsoft公司推出的关系型数据库中；
通道的交互频率影响数据插入数据库的间隔，主参数中，IP地址填写数据库的IP，端口号通常保持默认即可(默认为1433)；
注意!!!
横向建表时，将以测点物模型标识作为字段名，此时不同的物模型标识数量不可以超过512个，否则超过的部分不会插入到数据库。
请务必在规约特征配置界面，配置数据库的名称、用户名以及密码；
表名最好不要使用静态表名，而是通过填写通配符的方式，由网关根据日期自动生成表名，否则容易造成单表数据堆积过多；
| 通配符 | 替换说明 | 填写示例 | 替换结果 |
|---|---|---|---|
| ${sn} | 网关编号 | pbox_${sn} | pbox_123456789 |
| ${year} | 年份 | pbox_${sn}_${year} | pbox_123456789_2023 |
| ${mon} | 年份+月份 | pbox_${sn}_${mon} | pbox_123456789_202307 |
| ${day} | 年份+月份+日期 | pbox_${sn}_${day} | pbox_123456789_20230714 |
- 横向建表结构如下图：
提示
字段SN为网关编号，字段Dev为子设备名称，字段Time为数据入库时间，这些字段为保留字段，请勿在物模型中定义。
- 纵向建表结构如下图：
提示
字段Dev为子设备名称，字段Time为数据入库时间，字段TagName为测点物模型标识，字段Val为测点实时值，字段Qos为测点质量，0表示"好"，非0表示"坏"。
配置设备¶
提示
网关的字符集编码为UTF-8，如非必要，不建议使用中文设备名称。
本转发协议无需新建转发设备，会自动转发所有的采集设备，其中采集设备的名称会插入到字段名Dev中。
配置测点¶
本转发协议无需新建转发测点，会自动转发所有的采集测点，纵向建表时，测点的物模型标识会插入到字段名TagName中，不想转发的测点，取消勾选"是否上传"即可。
本地配置(SQLServer转发)¶
新建通道¶
提示
部分低性能网关不支持本驱动。
新建一个采集通道，协议选择SQLServer转发，本驱动用于将数据插入到微软Microsoft公司推出的关系型数据库中；
通道的交互频率影响数据插入数据库的间隔，主参数中，IP地址填写数据库的IP，端口号通常保持默认即可(默认为1433)；
注意!!!
横向建表时，将以测点物模型标识作为字段名，此时不同的物模型标识数量不可以超过512个，否则超过的部分不会插入到数据库。
请务必在规约特征配置界面，配置数据库的名称、用户名以及密码；
表名最好不要使用静态表名，而是通过填写通配符的方式，由网关根据日期自动生成表名，否则容易造成单表数据堆积过多；
| 通配符 | 替换说明 | 填写示例 | 替换结果 |
|---|---|---|---|
| ${sn} | 网关编号 | pbox_${sn} | pbox_123456789 |
| ${year} | 年份 | pbox_${sn}_${year} | pbox_123456789_2023 |
| ${mon} | 年份+月份 | pbox_${sn}_${mon} | pbox_123456789_202307 |
| ${day} | 年份+月份+日期 | pbox_${sn}_${day} | pbox_123456789_20230714 |
- 横向建表结构如下图：
提示
字段SN为网关编号，字段Dev为子设备名称，字段Time为数据入库时间，这些字段为保留字段，请勿在物模型中定义。
- 纵向建表结构如下图：
提示
字段Dev为子设备名称，字段Time为数据入库时间，字段TagName为测点物模型标识，字段Val为测点实时值，字段Qos为测点质量，0表示"好"，非0表示"坏"。
配置设备¶
提示
网关的字符集编码为UTF-8，如非必要，不建议使用中文设备名称。
本转发协议无需新建转发设备，会自动转发所有的采集设备，其中采集设备的名称会插入到字段名Dev中。
配置测点¶
本转发协议无需新建转发测点，会自动转发所有的采集测点，纵向建表时，测点的物模型标识会插入到字段名TagName中，不想转发的测点，"是否上传"选择"否"即可。
Ended: SQL Server
MySQL ↵
mysql转发协议¶
云端配置(mysql转发协议)¶
新建通道¶
新建一个转发通道，协议选择mysql转发协议，主参数中，IP地址与端口号，填写实际的mysql服务器的IP地址与端口号,超时为网关读写mysql服务器的超时时间；交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour更多参数见规约特征配置；
提示
MySQL数据库版本应在5.7(含)以上，8.0(不含)以下。
规约特征中可以配置myslq数据库的访问信息等，参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 用户名 | 可以访问mysql服务器的用户名 |
| 1 | 密码 | 访问密码 |
| 2 | 数据库名 | 网关创建表，插入数据的数据库名 |
| 3 | 表名 | Pbox存储数据时的表名，可以使用通配符，通配符的作用具体在下表所述 |
| 4 | 自动重连 | 数据库断开后重新连接 |
| 5 | 建表方式 | 具体在后续说明 |
| 6 | 整点上传 | 按分钟的整数进行上传 |
| 7 | 插入网关编号 | 是否把网关编号加入数据表 |
| 8 | 插入设备名 | 是否把设备名加入数据表 |
表名配置项的通配符具体作用及规则如下所示：
| 通配符 | 展开内容 | 示例 |
|---|---|---|
| ${sn} | 网关编号 | 20210604182 |
| ${year} | 年份 | 2021 |
| ${mon} | 年份+月份 | 202107 |
| ${day} | 年份+月份+日期 | 20210701 |
| ${hour} | 年份+月份+日期+小时 | 2021070118 |
| ${min} | 年份+月份+日期+小时+分钟 | 202107011825 |
这些通配符在运行中会被替换成“展开内容”，因此只要在表名中加入时间相关的通配符，即可根据当前时间，动态建表，从而实现按分钟、小时、日、月、年来建表的功能；强烈建议使用时间通配符而不是静态固定的表名，否则容易造成单表数据堆积过多。
提示
该转发协议可以不配置转发设备与转发测点，默认转发所有的采集点。这在情况下跳过配置转发设备和转发测点的配置。
新建设备¶
新建一个转发设备，可以根据需要设置设备名称参数，其他参数无需设置。
新建测点¶
按照需要把需要转发的测点加入即可。
竖向建表与横向建表¶
竖向建表时，测点作为数据行插入数据，如下图所示(质量Qos，0意为good，其它值均意为bad)。
横向建表把测点名作为数据列名，要求转发测点数量不得超过1000点，超过的转发测点将不会被转发。如下图所示:
警告
当修改了规约参数中与数据库表字段相关的参数时，如建表方式，插入网关编号，插入设备名这类参数时，要修改表名，或在工程下发之前对数据库做好备份。否则当工程下发重启后，驱动发现需要操作的表和现存的表结构不一致，会删除掉现存的表，从而现有的数据丢失。
本地配置(mysql转发协议)¶
新建通道¶
新建一个转发通道，协议选择mysql转发协议，主参数中，IP地址与端口号，填写实际的mysql服务器的IP地址与端口号,超时为网关读写mysql服务器的超时时间；交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour更多参数见规约特征配置；
提示
MySQL数据库版本应在5.7(含)以上，8.0(不含)以下。
规约特征中可以配置myslq数据库的访问信息等，参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 用户名 | 可以访问mysql服务器的用户名 |
| 1 | 密码 | 访问密码 |
| 2 | 数据库名 | 网关创建表，插入数据的数据库名 |
| 3 | 表名 | Pbox存储数据时的表名，可以使用通配符，通配符的作用具体在下表所述 |
| 4 | 自动重连 | 数据库断开后重新连接 |
| 5 | 建表方式 | 具体在后续说明，0竖向建表1横向建表 |
| 6 | 整点上传 | 按分钟的整数进行上传 |
| 7 | 插入网关编号 | 是否把网关编号加入数据表 |
| 8 | 插入设备名 | 是否把设备名加入数据表 |
表名配置项的通配符具体作用及规则如下所示：
| 通配符 | 展开内容 | 示例 |
|---|---|---|
| ${sn} | 网关编号 | 20210604182 |
| ${year} | 年份 | 2021 |
| ${mon} | 年份+月份 | 202107 |
| ${day} | 年份+月份+日期 | 20210701 |
| ${hour} | 年份+月份+日期+小时 | 2021070118 |
| ${min} | 年份+月份+日期+小时+分钟 | 202107011825 |
这些通配符在运行中会被替换成“展开内容”，因此只要在表名中加入时间相关的通配符，即可根据当前时间，动态建表，从而实现按分钟、小时、日、月、年来建表的功能；强烈建议使用时间通配符而不是静态固定的表名，否则容易造成单表数据堆积过多。
提示
该转发协议可以不配置转发设备与转发测点，默认转发所有的采集点。这在情况下跳过配置转发设备和转发测点的配置。
新建设备¶
新建一个转发设备，可以根据需要设置设备名称参数，其他参数无需设置。
新建测点¶
按照需要把需要转发的测点加入即可。
竖向建表与横向建表¶
竖向建表时，测点作为数据行插入数据，如下图所示(质量Qos，0意为good，其它值均意为bad)。
横向建表把测点名作为数据列名，要求转发测点数量不得超过1000点，超过的转发测点将不会被转发。如下图所示:
警告
当修改了规约参数中与数据库表字段相关的参数时，如建表方式，插入网关编号，插入设备名这类参数时，要修改表名，或在工程下发之前对数据库做好备份。否则当工程下发重启后，驱动发现需要操作的表和现存的表结构不一致，会删除掉现存的表，从而现有的数据丢失。
Ended: MySQL
MongoDB ↵
mongodb转发协议¶
云端配置(mongodb转发协议)¶
新建通道¶
新建一个转发通道，协议选择MongoDB转发协议，主参数中，IP地址与端口号，填写实际的mongodb服务器的IP地址与端口号,超时为网关读写mongodb服务器的超时时间；交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour更多参数见规约特征配置；
规约特征中可以配置mongodb数据库的访问信息等，参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 数据库名 | 网关创建集合，插入数据的数据库名 |
| 1 | 用户名 | 可以访问mongodb服务器的用户名 |
| 2 | 密码 | 访问密码 |
| 3 | 表名称 | Pbox存储数据时的集合名，可以使用通配符，通配符的作用具体在下表所述（在mongodb数据库中称集合） |
| 4 | 整点上传 | 按分钟的整数进行上传 |
| 5 | 插入网关编号 | 是否把网关编号加入数据文档 |
| 6 | 插入设备名 | 是否把设备名加入数据文档 |
| 7 | 自动重连 | 数据库断开后重新连接 |
| 8 | 转发数据类型 | 是否使用测点类型进行mongodb存储 |
表名配置项的通配符具体作用及规则如下所示：
| 通配符 | 展开内容 | 示例 |
|---|---|---|
| ${sn} | 网关编号 | 20210604182 |
| ${year} | 年份 | 2021 |
| ${mon} | 年份+月份 | 202107 |
| ${day} | 年份+月份+日期 | 20210701 |
| ${hour} | 年份+月份+日期+小时 | 2021070118 |
| ${min} | 年份+月份+日期+小时+分钟 | 202107011825 |
这些通配符在运行中会被替换成“展开内容”，因此只要在表名中加入时间相关的通配符，即可根据当前时间，动态建集合，从而实现按分钟、小时、日、月、年来建集合的功能；强烈建议使用时间通配符而不是静态固定的表名，否则容易造成单集合数据堆积过多。
提示
该转发协议可以不配置转发设备与转发测点，默认转发所有的采集点。这在情况下跳过配置转发设备和转发测点的配置。
新建设备¶
新建一个转发设备，可以根据需要设置设备名称参数，其他参数无需设置。
新建测点¶
按照需要把需要转发的测点加入即可。
建集合¶
建集合时，集合下的存放每个测点的具体信息，要求单测点全部信息大小不能超过16M，如下图所示(质量Qos，0意为good，其它值均意为bad)。
本地配置(mongodb转发协议)¶
新建通道¶
新建一个转发通道，协议选择MongoDB转发协议，主参数中，IP地址与端口号，填写实际的mongodb服务器的IP地址与端口号,超时为网关读写mongodb服务器的超时时间；交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour更多参数见规约特征配置；
规约特征中可以配置mongodb数据库的访问信息等，参数详解见下表(简单参数不再赘述)
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 数据库名 | 网关创建集合，插入数据的数据库名 |
| 1 | 用户名 | 可以访问mongodb服务器的用户名 |
| 2 | 密码 | 访问密码 |
| 3 | 表名称 | Pbox存储数据时的集合名，可以使用通配符，通配符的作用具体在下表所述（在mongodb数据库中称集合） |
| 4 | 整点上传 | 按分钟的整数进行上传 |
| 5 | 插入网关编号 | 是否把网关编号加入数据文档 |
| 6 | 插入设备名 | 是否把设备名加入数据文档 |
| 7 | 自动重连 | 数据库断开后重新连接 |
| 8 | 转发数据类型 | 是否使用测点类型进行mongodb存储 |
表名配置项的通配符具体作用及规则如下所示：
| 通配符 | 展开内容 | 示例 |
|---|---|---|
| ${sn} | 网关编号 | 20210604182 |
| ${year} | 年份 | 2021 |
| ${mon} | 年份+月份 | 202107 |
| ${day} | 年份+月份+日期 | 20210701 |
| ${hour} | 年份+月份+日期+小时 | 2021070118 |
| ${min} | 年份+月份+日期+小时+分钟 | 202107011825 |
这些通配符在运行中会被替换成“展开内容”，因此只要在表名中加入时间相关的通配符，即可根据当前时间，动态建集合，从而实现按分钟、小时、日、月、年来建集合的功能；强烈建议使用时间通配符而不是静态固定的表名，否则容易造成单集合数据堆积过多。。
提示
该转发协议可以不配置转发设备与转发测点，默认转发所有的采集点。这在情况下跳过配置转发设备和转发测点的配置。
新建设备¶
新建一个转发设备，可以根据需要设置设备名称参数，其他参数无需设置。
新建测点¶
按照需要把需要转发的测点加入即可。
建集合¶
建集合时，集合下的存放每个测点的具体信息，要求单测点全部信息大小不能超过16M，如下图所示(质量Qos，0意为good，其它值均意为bad)。
Ended: MongoDB
Redis ↵
Redis采集¶
云端配置(Redis采集)¶
新建通道¶
新建一个采集通道，协议选择Redis采集协议，在主参数中，IP地址与端口号，填写实际的Redis服务器的IP地址与端口号，超时为网关读写Redis服务器的超时时间；交互频率即从数据库取数据的时间间隔，设置范围为0.1s < time < 1hour更多参数见规约特征配置；
请务必在规约特征配置界面，配置数据库的密码。
新建设备¶
新建一个采集设备，设备通讯地址代表db_index,范围在0~15之间，设备描述填写要采集的设备名称，其余参数默认即可。
如下代表采集0号数据库的device_1设备的数据。
新建测点¶
新建一个测点，功能码选择读string，即采集以string数据结构存储的测点数据。
string数据结构数据以如下形式存储在Redis数据库中。
新建一个测点，功能码选择读hash，即采集以hash数据结构存储的测点数据。
hash数据结构数据以如下形式存储在Redis数据库中。
新建一个测点，功能码选择设备通讯中断，来反映当前设备的采集状态，系数(k)>0时，该测点数据为0代表设备采集正常，为1代表设备采集异常。
本地配置(Redis采集)¶
新建通道¶
新建一个采集通道，协议选择Redis采集协议，主参数中，IP地址与端口号，填写实际的Redis服务器的IP地址与端口号,超时为网关读写Redis服务器的超时时间；交互频率即从数据库取数据的时间间隔，设置范围为0.1s < time < 1hour更多参数见规约特征配置；
请务必在规约特征配置界面，配置数据库的密码。
新建设备¶
新建一个采集设备，设备通讯地址代表db_index,范围在0~15之间，设备描述填写要采集的设备名称，其余参数默认即可。
新建测点¶
新建一个测点，功能码选择读string，即采集以string数据结构存储的测点数据。
string数据结构数据以如下形式存储在Redis数据库中。
新建一个测点，功能码选择读hash，即采集以hash数据结构存储的测点数据。
hash数据结构数据以如下形式存储在Redis数据库中。
新建一个测点，功能码选择设备通讯中断，来反映当前设备的采集状态，系数(k)>0时，该测点数据为0代表设备采集正常，为1代表设备采集异常。
采集结果：
提示
序号为1013的测点，质量显示坏，变量值为0，表示Redis数据库中不存在该测点。
Redis转发协议¶
云端配置(Redis转发协议)¶
新建通道¶
新建一个转发通道，协议选择Redis转发协议，主参数中，IP地址与端口号，填写实际的Redis服务器的IP地址与端口号,超时为网关读写Redis服务器的超时时间；交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour更多参数见规约特征配置；
规约特征中可以配置Redis数据库的访问信息等，参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 密码 | 访问数据库的密码，若Redis无设置密码留空即可 |
| 1 | db数据库索引 | 默认使用Redis的索引为0的数据库 |
| 2 | 整点上传 | 按分钟的整数进行上传，默认开启整点上传 |
| 3 | 遥信变位上传周期 | 默认0，即遥信不变位上传 |
| 4 | 存储结构 | 默认使用hash数据结构存储，可替换为string数据结构 |
提示
该转发协议可以不配置转发设备与转发测点，默认转发所有的采集点，这种情况下跳过转发设备和转发测点的配置。
新建设备¶
新建一个转发设备，可以根据需要设置设备名称参数，其他参数无需设置。
新建测点¶
按照需要把需要转发的测点加入即可。
hash和string数据结构存储数据¶
使用hash结构存储数据时，键(Key)是设备的名称，字段(Field)是测点的名称，值(Value)包含三部分内容：测点的值，测点质量(0意为good，其它值均意为bad)以及测点数据转发时间，且值的三部分由分隔符'_'相隔。
提示
以下所展示的图形用户界面是使用 Redis 数据库的客户端工具RedisDesktopManager。
使用string结构存储数据时，键(Key)是"设备名:测点名",值(Value)与hash数据结构的值(Value)含义完全相同。
警告
使用Redis的string数据结构存储数据时，相同的键(Key)的值(Value)是会覆盖的，存储最新转发数据。使用Redis的hash数据结构存储数据时，相同的键(Key)并且相同的字段(Field)的值(Value)是会覆盖的，存储最新转发数据。若有存储历史数据需求使用mysql转发协议。
本地配置(Redis转发协议)¶
新建通道¶
新建一个转发通道，协议选择Redis转发协议，主参数中，IP地址与端口号，填写实际的Redis服务器的IP地址与端口号,超时为网关读写Redis服务器的超时时间；交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 12hour更多参数见规约特征配置；
提示
Redis数据库版本应在1.2.0(含)以上。
规约特征中可以配置Redis数据库的访问信息等，参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 密码 | 访问数据库的密码，若Redis无设置密码留空即可 |
| 1 | db数据库索引 | 默认使用Redis的索引为0的数据库 |
| 2 | 整点上传 | 按分钟的整数进行上传，默认开启整点上传 |
| 3 | 遥信变位上传周期 | 默认0，即遥信不变位上传 |
| 4 | 存储结构 | 默认使用hash数据结构存储，可替换为string数据结构 |
提示
该转发协议可以不配置转发设备与转发测点，默认转发所有的采集点，这种情况下跳过转发设备和转发测点的配置。
新建设备¶
新建一个转发设备，可以根据需要设置设备名称参数，其他参数无需设置。
新建测点¶
按照需要把需要转发的测点加入即可。
hash和string数据结构存储数据¶
使用hash结构存储数据时，键(Key)是设备的名称，字段(Field)是测点的名称，值(Value)包含三部分内容：测点的值，测点质量(0意为good，其它值均意为bad)以及测点数据转发时间，且值的三部分由分隔符'_'相隔。
提示
以下所展示的图形用户界面是使用 Redis 数据库的客户端工具RedisDesktopManager。
使用string结构存储数据时，键(Key)是"设备名:测点名",值(Value)与hash数据结构的值(Value)含义完全相同。
警告
使用Redis的string数据结构存储数据时，相同的键(Key)的值(Value)是会覆盖的，存储最新转发数据。使用Redis的hash数据结构存储数据时，相同的键(Key)并且相同的字段(Field)的值(Value)是会覆盖的，存储最新转发数据。若有存储历史数据需求使用mysql转发协议。
Ended: Redis
Ended: 数据库协议
环境监测 ↵
HJ212-2017_slave¶
云端配置(HJ212-2017转发)¶
新建通道¶
新建一个转发通道，协议选择HJ212-2017(转发)，主参数中，IP地址和端口号填写服务器的IP地址和端口号，通讯方向选择主动连接(客户端)；
新建设备¶
新建一个转发设备，通讯地址填写24个{0-9，A-F}的字符串组成的设备唯一标识MN。公共地址填写系统编码ST,见系统编码表；
提示
MN 由 EPC-96 编码转化的字符串组成，EPC-96 编码结构如下图所示
系统编码表（引用 GB/T16706-1996）
| 序号 | 系统名称 | 系统编码 | 描述 |
|---|---|---|---|
| 0 | 地表水质量监测 | 21 | |
| 1 | 空气质量监测 | 22 | |
| 2 | 声环境质量监测 | 23 | |
| 3 | 地下水质量监测 | 24 | |
| 4 | 土壤质量监测 | 25 | |
| 5 | 海水质量监测 | 26 | |
| 6 | 挥发性有机物监测 | 27 | |
| 7 | 大气环境污染源 | 31 | |
| 8 | 地表水体环境污染源 | 32 | |
| 9 | 地下水体环境污染源 | 33 | |
| 10 | 海洋环境污染源 | 34 | |
| 11 | 土壤环境污染源 | 35 | |
| 12 | 声环境污染源 | 36 | |
| 13 | 振动环境污染源 | 37 | |
| 14 | 放射性环境污染源 | 38 | |
| 15 | 工地扬尘污染源 | 39 | |
| 16 | 电磁环境污染源 | 41 | |
| 17 | 烟气排放过程监控 | 51 | |
| 18 | 污水排放过程监控 | 52 | |
| 19 | 系统交互 | 91 | 用于现场机和上位机的交互 |
新建测点¶
举例转发一个遥测点，地址填要发生的数据字段名，功能码按需选择,功能码决定了发送数据时的命令编码CN。
字段对照表
功能码与命令编码CN对照表
| 功能码 | 命令编码CN | 命令名称 | 描述 |
|---|---|---|---|
| 实时数据 | 2011 | 上传污染物实时数据 | 用于现场机上传污染物实时数据 |
| 分钟数据 | 2051 | 上传污染物分钟数据 | 用于现场机上传污染物分钟历史数据 |
| 小时数据 | 2061 | 上传污染物小时数据 | 用于现场机上报污染物小时历史数据 |
| 日历史数据 | 2031 | 上传污染物日历史数据 | 用于现场机上传污染物日历史数据 |
| 设备运行时间日历史数据 | - | - | 未实现 |
| 运行状态数据 | 2021 | 上传设备运行状态数据 | 用于现场机上传污染治理设施运行状态 |
| 噪声声级实时数据 | 2011 | 上传污染物实时数据 | 用于现场机上传污染物实时数据 |
| 噪声声级分钟数据 | 2051 | 上传污染物分钟数据 | 用于现场机上传污染物分钟历史数据 |
| 噪声声级日历史数据 | 2031 | 上传污染物日历史数据 | 用于现场机上传污染物日历史数据 |
| 工况实时数据 | 2011 | 上传污染物实时数据 | 用于现场机上传污染物实时数据 |
| 设备唯一标识 | 3019 | 上传设备唯一标识 | 用于现场机上传在线监控（监测）仪器仪表的设备唯一标识。在线监控（监测）仪器仪表发生更换时，上传在线监控（监测）仪器仪表设备唯一标识 |
| 现场机信息(状态 | 3020 | 上传现场机信息 | 用于现场机上传现场机信息，或现场机信息变化时，上报现场机信息 |
| 现场机信息(参数) | 3020 | 上传现场机信息 | 用于现场机上传现场机信息，或现场机信息变化时，上报现场机信息 |
本地配置(HJ212-2017转发)¶
新建通道¶
新建一个转发通道，协议选择HJ212-2017(转发)，主参数中，IP地址和端口号填写服务器的IP地址和端口号，通讯方向选择主动连接(客户端)；
新建设备¶
新建一个转发设备，通讯地址填写24个{0-9，A-F}的字符串组成的设备唯一标识MN。公共地址填写系统编码ST,见系统编码表；
提示
MN 由 EPC-96 编码转化的字符串组成，EPC-96 编码结构如下图所示
系统编码表（引用 GB/T16706-1996）
| 序号 | 系统名称 | 系统编码 | 描述 |
|---|---|---|---|
| 0 | 地表水质量监测 | 21 | |
| 1 | 空气质量监测 | 22 | |
| 2 | 声环境质量监测 | 23 | |
| 3 | 地下水质量监测 | 24 | |
| 4 | 土壤质量监测 | 25 | |
| 5 | 海水质量监测 | 26 | |
| 6 | 挥发性有机物监测 | 27 | |
| 7 | 大气环境污染源 | 31 | |
| 8 | 地表水体环境污染源 | 32 | |
| 9 | 地下水体环境污染源 | 33 | |
| 10 | 海洋环境污染源 | 34 | |
| 11 | 土壤环境污染源 | 35 | |
| 12 | 声环境污染源 | 36 | |
| 13 | 振动环境污染源 | 37 | |
| 14 | 放射性环境污染源 | 38 | |
| 15 | 工地扬尘污染源 | 39 | |
| 16 | 电磁环境污染源 | 41 | |
| 17 | 烟气排放过程监控 | 51 | |
| 18 | 污水排放过程监控 | 52 | |
| 19 | 系统交互 | 91 | 用于现场机和上位机的交互 |
新建测点¶
举例转发一个遥测点，地址填要发生的数据字段名，功能码按需选择,功能码决定了发送数据时的命令编码CN。
字段对照表
功能码与命令编码CN对照表
| 功能码 | 命令编码CN | 命令名称 | 描述 |
|---|---|---|---|
| 实时数据 | 2011 | 上传污染物实时数据 | 用于现场机上传污染物实时数据 |
| 分钟数据 | 2051 | 上传污染物分钟数据 | 用于现场机上传污染物分钟历史数据 |
| 小时数据 | 2061 | 上传污染物小时数据 | 用于现场机上报污染物小时历史数据 |
| 日历史数据 | 2031 | 上传污染物日历史数据 | 用于现场机上传污染物日历史数据 |
| 设备运行时间日历史数据 | - | - | 未实现 |
| 运行状态数据 | 2021 | 上传设备运行状态数据 | 用于现场机上传污染治理设施运行状态 |
| 噪声声级实时数据 | 2011 | 上传污染物实时数据 | 用于现场机上传污染物实时数据 |
| 噪声声级分钟数据 | 2051 | 上传污染物分钟数据 | 用于现场机上传污染物分钟历史数据 |
| 噪声声级日历史数据 | 2031 | 上传污染物日历史数据 | 用于现场机上传污染物日历史数据 |
| 工况实时数据 | 2011 | 上传污染物实时数据 | 用于现场机上传污染物实时数据 |
| 设备唯一标识 | 3019 | 上传设备唯一标识 | 用于现场机上传在线监控（监测）仪器仪表的设备唯一标识。在线监控（监测）仪器仪表发生更换时，上传在线监控（监测）仪器仪表设备唯一标识 |
| 现场机信息(状态 | 3020 | 上传现场机信息 | 用于现场机上传现场机信息，或现场机信息变化时，上报现场机信息 |
| 现场机信息(参数) | 3020 | 上传现场机信息 | 用于现场机上传现场机信息，或现场机信息变化时，上报现场机信息 |
Ended: 环境监测
私有协议 ↵
万能采集协议¶
云端配置(万能采集协议)¶
新建通道¶
新建一个采集通道，协议选择万能采集协议，本驱动用于一些报文简单的通信协议，可以实现由客户自己组包发送、自己解析报文，目前仅支持串口类型。
例：通过本万能采集协议，实现标准modbus-rtu采集协议功能。
现有modbus从站地址为18，要以03功能码读取寄存器地址为20-30、04功能码读取寄存器地址为40-50的数据；
打开规约特征配置界面，配置读命令以及校验方式；
提示
规约特征配置中的命令均为十六进制，以字符串的形式表示，且区分大小写(通配符中的字母为大写，十六进制报文中的a-f为小写)，2个字符串合为1个字节，
例如字符串a3代表十六进制的0xa3，为1个字节长度。
通配符说明如下：
| 符号 | 描述 |
|---|---|
| %?A | 将被替换为设备通讯地址(Address)，?处填写字符串长度，下同 |
| %?P | 将被替换为设备公共地址(Public Address) |
| %?R | 将被替换为同一命令下最小的寄存器地址(Register Address) |
| %?V | 将被替换为要写的值(Value) |
| %?N | 读命令中将被替换为测点的个数，写命令中将被替换为写入字节的个数(Number) |
| %?C | 将被替换为校验码(Check) |
举例
%号后面的?，为数字，代表字符串长度，
例如设备地址为5，通配符为%2A，那么实际发出去的报文就是1字节的05；
例如寄存器个数为3，通配符为%4N，那么实际发出去的报文就是2字节的0003；
该长度肯定为偶数。
新建设备¶
新建一个采集设备，设备通讯地址填写例子中的18。
新建测点¶
读命令¶
新建一个测点，功能码选择读命令1(和规约特征中的参数相匹配)，地址填写3，数据类型与数据格式以实际情况填写；
按照上图配置的测点，当收到报文后，会从报文的第3个字节(首个字节从0开始计算)开始，按照16位有符号进行解析，其值为20；下一个寄存器，地址应该为5，其值为21，以此类推。
写命令¶
模拟06和10功能码写值，规约特征配置如下：
写命令1实现了06功能码写值。
对地址为20的寄存器写入十进制的33，数据类型为16位有符号，报文如下：
写命令2实现了10功能码写值。
对地址为38的寄存器写入十进制的55，数据类型为单精度浮点数，报文如下：
本地配置(万能采集协议)¶
新建通道¶
新建一个采集通道，协议选择万能采集协议，本驱动用于一些报文简单的通信协议，可以实现由客户自己组包发送、自己解析报文，目前仅支持串口类型。
例：通过本万能采集协议，实现标准modbus-rtu采集协议功能。
现有modbus从站地址为18，要以03功能码读取寄存器地址为20-30、04功能码读取寄存器地址为40-50的数据；
打开规约特征配置界面，配置读命令以及校验方式(0:CRC循环冗余校验,1:SUM和校验,2:XOR异或校验)；
提示
规约特征配置中的命令均为十六进制，以字符串的形式表示，且区分大小写(通配符中的字母为大写，十六进制报文中的a-f为小写)，2个字符串合为1个字节，
例如字符串a3代表十六进制的0xa3，为1个字节长度。
通配符说明如下：
| 符号 | 描述 |
|---|---|
| %?A | 将被替换为设备通讯地址(Address)，?处填写字符串长度，下同 |
| %?P | 将被替换为设备公共地址(Public Address) |
| %?R | 将被替换为同一命令下最小的寄存器地址(Register Address) |
| %?V | 将被替换为要写的值(Value) |
| %?N | 读命令中将被替换为测点的个数，写命令中将被替换为写入字节的个数(Number) |
| %?C | 将被替换为校验码(Check) |
举例
%号后面的?，为数字，代表字符串长度，
例如设备地址为5，通配符为%2A，那么实际发出去的报文就是1字节的05；
例如寄存器个数为3，通配符为%4N，那么实际发出去的报文就是2字节的0003；
该长度肯定为偶数。
新建设备¶
新建一个采集设备，设备通讯地址填写例子中的18；
新建测点¶
读命令¶
新建一个测点，功能码选择读命令1(和规约特征中的参数相匹配)，地址填写3，数据类型与数据格式以实际情况填写；
按照上图配置的测点，当收到报文后，会从报文的第3个字节(首个字节从0开始计算)开始，按照16位有符号进行解析，其值为20；下一个寄存器，地址应该为5，其值为21，以此类推。
写命令¶
模拟06和10功能码写值，规约特征配置如下：
写命令1实现了06功能码写值。
写命令2实现了10功能码写值。
万能透传协议转发¶
云端配置(万能透传协议(转发))¶
新建通道¶
新建一个转发通道，协议选择万能透传协议(转发)，本驱动用于串口到串口的透传、串口到tcp(支持client和server)的透传等方式，任意组合均可；
提示
当源串口已经在使用(采集)时，也可以实现透传，但是通讯稳定性会下降。
举例：现在要将COM2(9600/8/1/N)的数据，以TCP Client的形式转发到服务端，协议类型选择TCP/IP，通讯方向选择主动连接(客户端)，IP地址和端口号以实际情况填写，其余参数保持默认，点击确定。
打开规约特征配置，透传源(指上图COM2)方式选择串口(也支持tcp)，然后填写COM2的串口参数配置(如果选择的是tcp，那么只需要填写IP信息，如果是做tcp server，那么IP地址填0.0.0.0)，点击确定，配置完成。
注意
注1：当透传源方式为串口，且该串口已经被智能网关使用时，源采集通道的交互频率与帧间隔越大越好，否则容易读写冲突；
注2：当透传源方式为串口，且该串口被多次指定为透传源时(例如COM1与COM2透传，COM1也与COM3透传)，规约特征中是否共用源通道从默认的优先改为是；
注3：当串口和TCP进行透传、TCP和TCP进行透传时，是否共用源通道应当选择优先，优先模式暂不支持注册帧和心跳帧，且不支持通道监测。
新建设备¶
本转发协议无需新建转发设备。
新建测点¶
本转发协议无需新建转发测点。
本地配置(万能透传协议(转发))¶
新建通道¶
新建一个转发通道，协议选择万能透传协议(转发)，本驱动用于串口到串口的透传、串口到tcp(支持client和server)的透传等方式，任意组合均可；
提示
当源串口已经在使用(采集)时，也可以实现透传，但是通讯稳定性会下降。
举例：现在要将COM2(9600/8/1/N)的数据，以TCP Client的形式转发到服务端，协议类型选择TCP/IP，通讯方向选择主动连接(客户端)，IP地址和端口号以实际情况填写，其余参数保持默认，点击确定。
打开规约特征配置，透传源(指上图COM2)方式选择串口(也支持tcp)，然后填写COM2的串口参数配置(如果选择的是tcp，那么只需要填写IP信息，如果是做tcp server，那么IP地址填0.0.0.0)，点击确定，配置完成。
注意
注1：当透传源方式为串口，且该串口已经被智能网关使用时，源采集通道的交互频率与帧间隔越大越好，否则容易读写冲突；
注2：当透传源方式为串口，且该串口被多次指定为透传源时(例如COM1与COM2透传，COM1也与COM3透传)，规约特征中是否共用源通道从默认的优先改为是；
注3：当串口和TCP进行透传、TCP和TCP进行透传时，是否共用源通道应当选择优先，优先模式暂不支持注册帧和心跳帧，且不支持通道监测。
新建设备¶
本转发协议无需新建转发设备。
新建测点¶
本转发协议无需新建转发测点。
LongShine新耀能源¶
云端配置(LongShine)¶
新建通道¶
例：我有一个采集通道1，采集了逆变器数据，现在想要将该数据上传至新耀平台。
新建一个转发通道，协议选择LongShine上传协议，交互频率即为数据上传间隔，主参数中，IP地址填写新耀平台的IP地址121.43.67.60(以实际为准)，端口号填12011(以实际为准)，其余参数默认即可；
注意
网关编号对应新耀平台的MAC地址，例：网关编号为1021712345，在新耀平台建档填写12位MAC地址的时候，填102171234500即可(末尾补0，补齐12位)。
提示
当一个网关上传的设备数量超过254时，可以额外新建一个转发通道，在规约特征中填写虚拟SN编号；
默认为0时意为不虚拟，此时上传设备公共地址1~254的设备数据；
填1意为虚拟SN号在原基础上+1(102171234500变为102171234501)，此时上传设备公共地址1001~1254的设备数据(实际对应新耀平台的地址仍为1~254)；
填2意为虚拟SN号在原基础上+2(102171234500变为102171234502)，此时上传设备公共地址2001~2254的设备数据(实际对应新耀平台的地址仍为1~254)；
按照上述配置虚拟SN后，102171234501与102171234502这两个编号将不可再次使用！
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，公共地址填1(对应新耀平台的采集地址码)，兼容平台选择新耀，设备类型选择逆变器(根据实际情况选择) 。
提示
先在采集通道下配置上传PV等信息，最后再添加转发通道，也是可以的，对顺序没有要求。
配置测点¶
该转发协议无需新增转发测点。
上传实时数据¶
我们进入采集设备的采集测点管理，新建(或修改)一个变量，例如支路1电压，勾选是否上传(默认是勾选状态)，PV标识选择第1路直流输入电压，PV上传系数保持默认即可，那么这个测点就会上传。
提示
没有看到这个PV属性设置或者属性设置不对的，请参照本小节的第二步，选择正确的兼容平台与设备型号后再试。
上传报警数据¶
新建一个测点，例如想要上传逆变器的温度低报警，测点类型必须为开关量，PV标识选择温度过低(按实际情况选择)，那么当该测点的值从0变到1的时候，就会往平台发送温度过低的告警事件。
上传离线数据¶
请在规约特征中开启离线数据存储天数，方可生效，如果由于网络中断导致数据上传失败，那么网关会存储上传失败的数据，直至网络恢复后，会重新上传这些先前上传失败过的数据。
注意
有两个或以上转发通道使用了本协议时，请修改这些转发通道的通道地址避免其重复，否则离线(历史)数据的存储会冲突，未启用历史存储则无须注意。
本地配置(LongShine)¶
新建通道¶
例：我有一个采集通道1，采集了逆变器数据，现在想要将该数据上传至新耀平台。
新建一个转发通道，协议选择LongShine上传协议，交互频率即为数据上传间隔，主参数中，IP地址填写新耀平台的IP地址121.43.67.60(以实际为准)，端口号填12011(以实际为准)，其余参数默认即可；
注意
网关编号对应新耀平台的MAC地址，例：网关编号为1021712345，在新耀平台建档填写12位MAC地址的时候，填102171234500即可(末尾补0，补齐12位)。
提示
当一个网关上传的设备数量超过254时，可以额外新建一个转发通道，在规约特征中填写虚拟SN编号；
默认为0时意为不虚拟，此时上传设备公共地址1~254的设备数据；
填1意为虚拟SN号在原基础上+1(102171234500变为102171234501)，此时上传设备公共地址1001~1254的设备数据(实际对应新耀平台的地址仍为1~254)；
填2意为虚拟SN号在原基础上+2(102171234500变为102171234502)，此时上传设备公共地址2001~2254的设备数据(实际对应新耀平台的地址仍为1~254)；
按照上述配置虚拟SN后，102171234501与102171234502这两个编号将不可再次使用！
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，公共地址填1(对应新耀平台的采集地址码)，兼容平台选择新耀，设备类型选择逆变器(根据实际情况选择) 。
提示
先在采集通道下配置上传PV等信息，最后再添加转发通道，也是可以的，对顺序没有要求。
配置测点¶
该转发协议无需新增转发测点。
上传实时数据¶
我们进入采集设备的采集测点管理，新建(或修改)一个变量，例如支路1电压，勾选是否上传(默认是勾选状态)，PV标识选择第1路直流输入电压，PV上传系数保持默认即可，那么这个测点就会上传。
提示
没有看到这个PV属性设置或者属性设置不对的，请参照本小节的第二步，选择正确的兼容平台与设备型号后再试。
上传报警数据¶
新建一个测点，例如想要上传逆变器的温度低报警，测点类型必须为开关量(即遥信分组)，开关报警类型选择开报警，PV标识选择温度过低(按实际情况选择)，那么当该测点的值从0变到1的时候，就会往平台发送温度过低的告警事件。
上传离线数据¶
请在规约特征中开启离线数据存储天数，方可生效，如果由于网络中断导致数据上传失败，那么网关会存储上传失败的数据，直至网络恢复后，会重新上传这些先前上传失败过的数据。
注意
有两个或以上转发通道使用了本协议时，请修改这些转发通道的通道地址避免其重复，否则离线(历史)数据的存储会冲突，未启用历史存储则无须注意。
正泰中自光伏云¶
云端配置(正泰中自光伏云)¶
新建通道¶
例：有一个采集通道1，采集了逆变器数据，现在想要将该数据上传至中自平台。
新建一个转发通道，协议选择正泰中自光伏云，主参数中，IP地址填写中自平台的IP地址 solardrv.cn(以实际为准)，端口号填9999(以实际为准),通道的交互频率是指向中自平台传输数据的间隔，单位毫秒,保留0对应中自的单元SN，保留1对应中自的SN密码，保留2对应中自的AES密钥，其余参数默认即可；
可以在规约特征配置里开启上传开始时间(默认5)、结束时间(默认20)的控制，两个时间都配置为0则意为全天24小时都上传。
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，公共地址填1(对应中自平台的设备地址)，兼容平台选择正泰中自，设备类型选择逆变器(根据实际情况选择) 。
配置测点¶
该转发协议无需新增转发测点。
上传实时数据¶
我们进入采集设备的采集测点管理，新建(或修改)一个变量，例如日发电量，勾选是否上传(默认是勾选状态)，PV标识选择日发电量，PV上传系数保持默认即可，那么这个测点就会上传。
提示
没有看到这个PV属性设置或者属性设置不对的，请参照本小节的第二步，选择正确的兼容平台与设备型号后再试。
上传报警数据¶
已经采集了一个逆变器的报警点，叫做逆变器故障停运，该测点类型必须为开关量，那么在该测点的物模型标识(测点描述)里填写故障信息(该信息会上传到中自平台)，勾选是否上传，PV标识选择无；
报警属性中，勾选开启报警记录，触发类型选择开报警(或根据实际情况选择)，报警消息默认(该信息不会传到中自平台)，当报警触发时既可上传报警。
本平台报警级别与中自平台故障类型的对应关系如下：
| 本平台报警级别 | 中自平台故障类型 |
|---|---|
| 通知 | 警告 |
| 警告 | 一般故障 |
| 严重 | 重要故障 |
本地配置(正泰中自光伏云)¶
新建通道¶
例：我有一个采集通道1，采集了逆变器数据，现在想要将该数据上传至中自平台。
新建一个转发通道，协议选择正泰中自光伏云，主参数中，IP地址填写中自平台的IP地址 solardrv.cn(以实际为准)，端口号填9999(以实际为准),通道的交互频率是指向中自平台传输数据的间隔，单位毫秒,保留0对应中自的单元SN，保留1对应中自的SN密码，保留2对应中自的AES密钥，其余参数默认即可；
可以在规约特征配置里开启上传开始时间(默认5)、结束时间(默认20)的控制，两个时间都配置为0则意为全天24小时都上传。
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，公共地址填1(对应中自平台的设备地址)，兼容平台选择正泰中自，设备类型选择逆变器(根据实际情况选择) 。
配置测点¶
该转发协议无需新增转发测点。
上传实时数据¶
我们进入采集设备下的采集测点页面，新建(或修改)一个变量，例如日发电量，勾选是否上传(默认是勾选状态)，PV上传标识选择日发电量，PV上传系数保持默认即可，那么这个测点就会上传。
提示
没有看到这个PV属性设置或者属性设置不对的，请参照本小节的第二步，选择正确的兼容平台与设备型号后再试。
上传报警数据¶
已经采集了一个逆变器的报警点，叫做逆变器故障停运，该测点类型必须为开关量，那么在该测点的物模型标识(测点描述)里填写故障信息(该信息会上传到中自平台)，打开是否上传，PV上传标识选择无，开关报警类型选择开报警，开关报警消息默认(该信息不会传到中自平台)，当报警触发时既可上传报警；
本平台报警级别与中自平台故障类型的对应关系如下：
| 本平台报警级别 | 中自平台故障类型 |
|---|---|
| 通知 | 警告 |
| 警告 | 一般故障 |
| 严重 | 重要故障 |
433无线模块¶
云端配置(休普433无线模块)¶
新建通道¶
本驱动用于采集承载于433MHz无线数据收发的温度传感器数据，新建一个采集通道，协议选择433无线模块，串口号和串口配置根据实际情况填写，通常选择COM3或COM4，串口参数保持默认；
注意
本驱动在规约特征中默认开启"暂存模式"，此时通道的交互频率即为主动查询暂存模式数据的间隔。
新建设备¶
新建一个设备，设备通讯地址即为传感器ID，例如305614；
强烈建议
新建设备时，可以勾选是否选择模板，然后在右侧搜索433即可选择系统预设的点表模板。
提示
如果不知道传感器ID的，那么设备通讯地址可以先不填写，待工程配置完毕下发运行后，使用通道监测功能即可查看传感器ID。
新建测点¶
新建一个采集测点， 功能码选择接收数据，数据类型选择16位有符号，高低位顺序选择21，地址填写0意为读温度(自行填写系数0.1)，地址填写1意为读流水号。
本地配置(休普433无线模块)¶
新建通道¶
本驱动用于采集承载于433MHz无线数据收发的温度传感器数据，新建一个采集通道，协议选择433无线模块，串口号和串口配置根据实际情况填写，通常选择COM3或COM4，串口参数保持默认；
注意
本驱动在规约特征中默认开启"暂存模式"，此时通道的交互频率即为主动查询暂存模式数据的间隔。
新建设备¶
新建一个设备，设备通讯地址即为传感器ID，例如305614；
提示
如果不知道传感器ID的，那么设备通讯地址可以先不填写，待工程配置完毕下发运行后，使用通道监测功能即可查看传感器ID。
新建测点¶
提示
点击下载点表模板：433无线模块点表
新建一个采集测点， 功能码选择接收数据，数据类型选择16位有符号，高低位顺序选择21，地址填写0意为读温度(自行填写系数0.1)，地址填写1意为读流水号。
国网云光伏扶贫协议¶
云端配置(国网云光伏扶贫协议)¶
新建通道¶
例：我采集了逆变器数据，现在想要将该数据上传至国网云的扶贫平台。
新建一个转发通道，协议选择光伏扶贫上传协议，交互频率填写300000ms(5分钟)，意为每隔5分钟上传一次，建议为5分钟，按需修改，不可小于10秒；
主参数中，IP地址填写gfyfront.esgcc.com.cn(以实际为准)，端口号填19020 (以实际为准)，保留0字段填写国网云提供的账号(一般都是pvcloud)，保留1字段填写国网云提供的密码(一般都是pvcloud)；
提示
请事先整理好扶贫电站信息的excel表发给国网云工作人员进行电站注册以及索取点表文件。
新建设备¶
设备通讯地址填写国网云提供的文本文档中的设备序列号，设备公共地址填写国网云提供的excel中的电站ID，如下图所示：
新建测点¶
批量添加转发测点，不添加的点不转发，功能码选择发送实时数据，可以按需修改转发测点的系数，通常情况下无需修改，默认均为1；
必须修改每一个转发测点的地址，地址填写国网云提供的excel测点点表中的测点Id，数据类型通常情况下遥测量选双精度浮点数，遥信量选16位有符号。
提示
修改转发测点的系数仅仅影响数据上传，显示出来的值还是原始值。
本地配置(国网云光伏扶贫协议)¶
新建通道¶
例：我采集了逆变器数据，现在想要将该数据上传至国网云的扶贫平台。
新建一个转发通道，协议选择光伏扶贫上传协议，交互频率填写300000ms(5分钟)，意为每隔5分钟上传一次，建议为5分钟，按需修改，不可小于10秒；
主参数中，IP地址填写gfyfront.esgcc.com.cn(以实际为准)，端口号填19020 (以实际为准)，保留0字段填写国网云提供的账号(一般都是pvcloud)，保留1字段填写国网云提供的密码(一般都是pvcloud)；
提示
请事先整理好扶贫电站信息的excel表发给国网云工作人员进行电站注册以及索取点表文件。
新建设备¶
设备通讯地址填写国网云提供的文本文档中的设备序列号，设备公共地址填写国网云提供的excel中的电站ID，如下图所示：
新建测点¶
批量添加转发测点，不添加的点不转发，功能码选择发送实时数据，可以按需修改转发测点的系数，通常情况下无需修改，默认均为1；
必须修改每一个转发测点的地址，地址填写国网云提供的excel测点点表中的测点Id，数据类型通常情况下遥测量选双精度浮点数，遥信量选16位有符号。
提示
修改转发测点的系数仅仅影响数据上传，显示出来的值还是原始值。
tianxinLLJ¶
云端配置(天信流量计采集)¶
新建通道¶
新建一个采集通道，协议选择天信流量计，主参数中，串口名称按照网关实际的接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，其它参数如无特殊要求保持默认即可；
注意
天信流量计协议支持3中通信协议:CPU卡流量计通信协议,天信协议V1.2和天信协议V1.3。
本协议默认在规约特征里配置了协议版本为“天信协议V1.2”。如果需要配置成另外2种协议，在协议版本中选择成需要的协议即可。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写天信流量计的子机号，其余参数留空即可。
新建测点¶
测点的地址按照《天信流量计通信协议及数据解包方法》中定义的数据顺序来排序，协议中的点表见下面两张图片。
举例建一个读取天信协议V1.2当前流量的测点，则新建一个读命令测点，地址填0，数据类型填单精度浮点即可。其他测点的读取类似，只需要修改测点地址即可。
提示
目前天信协议只支持读取命令，不支持写命令。
注意
对于天信协议V1.3中的报警字位和状态字的读取，如果需要解析到位，那么在基本属性页，数据类型为按对应数据的字节数选择，在高级设置页中，勾选按位取值，起始位和终止位都选对应的相应的位序号即可。
本地配置(天信流量计采集)¶
新建通道¶
新建一个采集通道，协议选择天信流量计，主参数中，串口名称按照网关实际的接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，其它参数如无特殊要求保持默认即可；
注意
天信流量计协议有2个版本:CPU卡流量计通信协议,天信协议V1.2和天信协议V1.3。
本协议默认在规约特征里配置了协议版本为“120”即天信协议V1.2。如果需要采集天信协议V1.3，把该参数配置为130即可。如果需要采集CPU卡流量计通信协议，把该参数配置为0即可。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写天信流量计的子机号，其余参数留空即可。
新建测点¶
测点的地址按照《天信流量计通信协议及数据解包方法》中定义的数据顺序来排序，协议中的点表见下面两张图片。
举例建一个读取天信协议V1.2的当前流量测点，则新建一个读命令测点，地址填0，数据类型填单精度浮点即可。其他测点的读取类似，只需要修测点地址即可。
提示
目前天信协议只支持读取命令，不支持写命令。
注意
对于天信协议V1.3中的报警字位和状态字的读取，如果需要解析到位，那么在基本属性页，数据类型为按对应数据的字节数选择，在高级设置页中，勾选按位取值，起始位和终止位都选对应的相应的位序号即可。
能耗监测成都¶
云端配置(建筑能耗监测(成都))¶
新建通道¶
新建一个转发通道，协议选择公共建筑能耗监测(成都)，此处交互频率配置是无效的，默认为每个小时的第59分钟上传一次数据，主参数中，IP地址填写能耗监测平台接收数据的IP地址(默认IP为测试后台，以实际为准)，端口号填7601(以实际为准)，其余参数默认即可；
规约特征中可以配置建筑编码(例如510112E001)、采集器编码(例如510112E00101)以及AES加密(AES偏移即为初始向量)参数。
新建设备¶
新建一个转发设备，设备公共地址填写能耗平台的采集器下仪表的数据传输编码，兼容平台选择公共建筑能耗，设备类型选择电-照明插座用电(以实际情况为准)。
新建测点¶
新建一个转发测点，点击测点名称编辑框可以选择要转发的采集测点，测点的功能码选择数据上传，地址填1(按实际情况填写，对应能耗平台的function id)。
本地配置(建筑能耗监测(成都))¶
新建通道¶
新建一个转发通道，协议选择公共建筑能耗监测(成都)，此处交互频率配置是无效的，默认为每个小时的第59分钟上传一次数据，主参数中，IP地址填写能耗监测平台接收数据的IP地址(默认IP为测试后台，以实际为准)，端口号填7601(以实际为准)，其余参数默认即可；
规约特征中可以配置建筑编码(例如510112E001)、采集器编码(例如510112E00101)以及AES加密(AES偏移即为初始向量)参数。
新建设备¶
新建一个转发设备，设备公共地址填写能耗平台的采集器下仪表的数据传输编码，兼容平台选择公共建筑能耗，设备类型选择电-照明插座用电(以实际情况为准)。
新建测点¶
新建一个转发测点，选择要转发的采集测点添加，测点的功能码选择数据上传，地址填1(按实际情况填写，对应能耗平台的function id)。
能耗监测长沙¶
云端配置(建筑能耗监测(长沙))¶
新建通道¶
新建一个转发通道，协议选择公共建筑能耗监测(长沙)，此处交互频率配置表示采集器主动上传能耗远传数据包的频率，主参数中，IP地址填写能耗监测平台接收数据的IP地址(默认IP为测试后台，以实际为准)，端口号填5020(以实际为准)，其余参数默认即可。
规约特征中可以配置建筑编码即楼栋编号(例如123)、采集器编码(例如456)、AES密钥、心跳周期（例如5）、触发通讯中断的的最大空闲时长（例如180）以及离线存储天数（例如3）等参数。
新建设备¶
新建一个转发设备，设备公共地址表示能耗远传数据包中计量装置的设备号；所属通道、设备名称、通讯地址根据实际填写；其余配置默认即可。
新建测点¶
新建一个转发测点，物模型标识表示能耗远传数据包中的能耗数据分类/分项编码（例如01000），测点的功能码选择数据上传，地址表示能耗远传数据包中的function id(例如1)。
能耗数据分类/分项编码与function id如下（来自长沙市建筑能耗监测系统数据接入指南）：
本地配置(建筑能耗监测(长沙))¶
新建通道¶
新建一个转发通道，协议选择公共建筑能耗监测(长沙)，此处交互频率配置表示采集器主动上传能耗远传数据包的频率，主参数中，IP地址填写能耗监测平台接收数据的IP地址(默认IP为测试后台，以实际为准)，端口号填5020(以实际为准)，其余参数默认即可。
规约特征中可以配置建筑编码即楼栋编号(例如123)、采集器编码(例如456)、AES密钥、心跳周期（例如5）、触发通讯中断的的最大空闲时长（例如180）以及离线存储天数（例如3）等参数。
新建设备¶
新建一个转发设备，设备公共地址表示能耗远传数据包中计量装置的设备号；所属通道、设备名称、通讯地址根据实际填写；其余配置默认即可。
新建测点¶
新建一个转发测点，物模型标识表示能耗远传数据包中的能耗数据分类/分项编码（例如01000），测点的功能码选择数据上传，地址表示能耗远传数据包中的function id(例如1)。
钉电云EnergyCC¶
云端配置(钉电云)¶
新建通道¶
例：有一个采集通道1，采集了逆变器数据，现在想要将该数据上传至energycc光伏平台(钉电云)。
新建一个转发通道，协议选择钉电云上传协议，主参数中，IP地址默认为data.energycc.cn(以实际为准)，端口号默认为9766(以实际为准)，通道的交互频率是指向云平台传输数据的间隔，单位毫秒，建议360000ms(即6分钟)，其余参数默认即可；
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，公共地址填1(对应钉电云的通讯地址)，兼容平台选择钉电云，设备类型选择逆变器(根据实际情况选择) 。
配置测点¶
该转发协议无需新增转发测点。
上传实时数据¶
我们进入采集设备的采集测点管理，新建(或修改)一个变量，例如日发电量，勾选是否上传(默认是勾选状态)，PV标识选择日发电量，PV上传系数保持默认即可，那么这个测点就会上传。
提示
没有看到这个PV属性设置或者属性设置不对的，请参照本小节的第二步，选择正确的兼容平台与设备型号后再试。
上传报警数据¶
已经采集了一个逆变器的报警点，叫做逆变器故障停运，该测点类型必须为开关量，那么在该测点的物模型标识(测点描述)里填写故障信息(该信息会上传到钉电云平台)，勾选是否上传，PV标识选择无，当报警触发时既可上传报警(无需开启报警记录)。
本地配置(钉电云)¶
新建通道¶
例：有一个采集通道1，采集了逆变器数据，现在想要将该数据上传至energycc光伏平台(钉电云)。
新建一个转发通道，协议选择钉电云上传协议，主参数中，IP地址默认为data.energycc.cn(以实际为准)，端口号默认为9766(以实际为准)，通道的交互频率是指向云平台传输数据的间隔，单位毫秒，建议360000ms(即6分钟)，其余参数默认即可；
配置设备¶
该转发协议无需新增转发设备。
我们回到采集通道下的子设备管理，公共地址填1(对应钉电云的通讯地址)，兼容平台选择钉电云，设备类型选择逆变器(根据实际情况选择) 。
配置测点¶
该转发协议无需新增转发测点。
上传实时数据¶
我们进入采集设备下的采集测点页面，新建(或修改)一个变量，例如日发电量，勾选是否上传(默认是勾选状态)，PV标识选择日发电量，PV上传系数保持默认即可，那么这个测点就会上传。
提示
没有看到这个PV属性设置或者属性设置不对的，请参照本小节的第二步，选择正确的兼容平台与设备型号后再试。
上传报警数据¶
已经采集了一个逆变器的报警点，叫做逆变器故障停运，该测点类型必须为开关量，那么在该测点的物模型标识(测点描述)里填写故障信息(该信息会上传到中自平台)，打开是否上传，PV上传标识选择无，当报警触发时既可上传报警(无需开启报警记录)。
多用户表具协议k3¶
云端配置(多用户表具协议k3)¶
新建通道¶
新建一个采集通道，协议选择多用户表具协议(K3)型，通道的交互频率、每帧间隔以及串口通信参数，根据实际情况配置；如下图：
新建设备¶
新建一个设备，自定义设备名称，设备通讯地址填表具的编号来设置，表具编号的头四位作为系统号，后四位作为表号，两者之间用"."(点号)分隔；
设备公共地址可以填写设备模型标识(需要上传到平台时才配置，要跟转发协议配合使用)，不影响采集。
提示
新建设备时，可以勾选是否选择模板，然后在右侧搜索表具即可选择系统预设的点表模板。
新建测点¶
使用点表模板创建设备¶
使用“多用户表具协议(k3)型”模版建立的设备，只需要修改测点的分组即可；
分组用于指定表具中的户号，合理取值范围是1~39(含)，不可设置成这个范围之外的值，否则采集将会出错；
在同一个设备下的测点都是采集同一个用户的数据，故分组号需要一致；
如下图所示，可以全选测点，批量设置测点分组。
未使用点表模版创建设备¶
新建一个测点，自定义测点名称、物模型标识，功能码、测点分组、测点地址、数据类型等根据实际情况选择；
这里在读取单表数据和读取整表数据时，配置是不同的；
-
读取单表数据：
测点分组的个位和十位用于指定户号，户号必须在1-39之间(含)；
测点地址指定读取的数据类型，范围在0-2(含)；
地址取决于读取哪个数据：0 累积电量，1 购买电量，2 剩余电量。
-
读取整表数据：
测点分组的百位和千位指定数据类型，数据类型合理取值范围是1-10(含)，个位和十位必须为0；
测点地址指定户号，取值范围是0-38(含)。
本地配置(多用户表具协议k3)¶
暂无说明。
济中能源HTTP转发¶
云端配置(济中能源HTTP转发)¶
新建通道¶
本驱动将采集到的设备数据组织成json内容，以http post的方式，推送到服务器，新建一个转发通道，协议选择济中能源http转发，交互频率即为数据上传的间隔，然后填写ip地址和端口号(以实际情况为准)；
在规约特征配置中，选择性的设置网关的编号，留空默认网关出厂编号；
新建设备¶
本转发协议无需新建转发设备。
新建测点¶
提示
本转发协议无需创建转发设备与转发测点，将自动转发所有的采集点与中间点；采集测点里的数据类型对应json中的字段vt，采集测点名称对应json中的字段tnm。
本转发协议无需新建转发测点。
本地配置(济中能源HTTP转发)¶
新建通道¶
本驱动将采集到的设备数据组织成json内容，以http post的方式，推送到服务器，新建一个转发通道，协议选择济中能源http转发，交互频率即为数据上传的间隔，然后填写ip地址和端口号(以实际情况为准)；
在规约特征配置中，选择性的设置网关的编号，留空默认网关出厂编号；
新建设备¶
本转发协议无需新建转发设备。
新建测点¶
提示
本转发协议无需创建转发设备与转发测点，将自动转发所有的采集点与中间点；采集测点里的数据类型对应json中的字段vt，采集测点名称对应json中的字段tnm。
本转发协议无需新建转发测点。
汇中仪表SCL-61D系列¶
云端配置(汇中仪表SCL-61D系列)¶
新建通道¶
新建一个采集通道，协议选择汇中仪表SCL-61D系列，串口名称按实际情况选择，其余参数保持默认即可；
新建设备¶
新建一个设备，设备通讯地址填写仪表当前通讯号码(10进制)，其它参数默认即可；
新建测点¶
举例读取仪表正向数据中的瞬时流量，新建一个测点，功能码选择读取正向数据，系数按照点表说明应该填0.001，地址填0，数据类型选择32位BCD；
提示
正向瞬时流量地址为0(系数0.001)，正向累计流量地址为4(系数0.1)，累计运行时间地址为8，诊断信息代码地址为12；
本地配置(汇中仪表SCL-61D系列)¶
新建通道¶
新建一个采集通道，协议选择汇中仪表SCL-61D系列，串口名称按实际情况选择，其余参数保持默认即可；
新建设备¶
新建一个设备，设备通讯地址填写仪表当前通讯号码(10进制)，其它参数默认即可；
新建测点¶
举例读取仪表正向数据中的瞬时流量，新建一个测点，功能码选择读取正向数据，系数按照点表说明应该填0.001，地址填0，数据类型选择32位BCD；
提示
正向瞬时流量地址为0(系数0.001)，正向累计流量地址为4(系数0.1)，累计运行时间地址为8，诊断信息代码地址为12；
科诺伟业HTTP转发¶
云端配置(科诺伟业HTTP转发)¶
新建通道¶
本驱动将采集到的设备数据组织成json内容，以http post的方式，推送到服务器，新建一个转发通道，协议选择科诺伟业http转发，交互频率即为数据上传的间隔，然后填写ip地址和端口号(以实际情况为准)；
新建设备¶
举例新建一个转发设备气象站，那么它的通讯地址填写设备ID（例如CoronaYNGTZDCDC00014），公共地址填写设备类型（例如7），其余参数默认即可；
新建测点¶
举例新建一个转发测点，气象站的环境温度，地址填写HJC_Parm_005，其余参数默认即可。
本地配置(科诺伟业HTTP转发)¶
新建通道¶
本驱动将采集到的设备数据组织成json内容，以http post的方式，推送到服务器，新建一个转发通道，协议选择科诺伟业http转发，交互频率即为数据上传的间隔，然后填写ip地址和端口号(以实际情况为准)；
新建设备¶
举例新建一个转发设备气象站，那么它的通讯地址填写设备ID（例如CoronaYNGTZDCDC00014），公共地址填写设备类型（例如7），其余参数默认即可；
新建测点¶
举例新建一个转发测点，气象站的环境温度，地址填写HJC_Parm_005，其余参数默认即可。
ftp_slave¶
云端配置(ftp文件转发协议)¶
新建通道¶
新建一个转发通道，协议选择“ftp文件转发协议”，主参数中，可以根据需要配置交互频率和每帧间隔参数。交互频率影响扫描文件读取信号周期。每帧间隔影响两次ftp操作之间的时间间隔，该值要大于500毫秒，小于500毫秒的值将不生效；
编辑规约特征配置，主要配置ftp文件读取以及文件推送的ftp服务器信息。参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 文件读取地址 | ftp服务器地址 |
| 1 | 文件读取端口 | ftp服务器端口 |
| 2 | 文件读取用户名 | ftp用户名，匿名账户一般为ftp或anonymous，具体要看ftp服务器的配置 |
| 3 | 文件读取密码 | ftp密码，无需密码时留空 |
| 4 | 文件推送地址 | ftp服务器地址 |
| 5 | 文件推送端口 | ftp服务器端口 |
| 6 | 文件推送用户名 | ftp用户名，匿名账户一般为ftp或anonymous，具体要看ftp服务器的配置 |
| 7 | 文件推送密码 | ftp密码， 无需密码时留空 |
| 8 | 文件获取目录 | 读取文件时，可以指定从ftp服务器的哪个目录读取。从根目录读取时，留空。 |
| 9 | 文件推送目录 | 推送文件时，可以指定推送到ftp服务器的哪个目录读取。从根目录读取时，留空。 |
| 10 | 触发通讯中断的失败次数 | 读取文件或推送文件失败计算超过该值时，触发通信中断告警 |
| 11 | 触发延时时间，单位秒 | 检测到读取信号时，延迟多少时间触发读取操作，必须大于等于1秒 |
| 12 | 历史记录存储天数 | 文件推送记录存储天数 |
新建设备¶
设备的参数自定义或保持默认即可，在本驱动中，设备的参数无实际意义。
新建测点¶
转发测点有3种功能码:读文件触发信号，计算点，设备通信中断。读文件触发信号类型测点从0跳到1时，会触发读文件计时，当计时到达“触发延时时间”设置的时间时，从ftp服务器获取最新的文件列表，然后读取未上传过的文件。设备通信中断类型测点在触发通信中断告警时被设置成1，ftp通信正常时被设置成0。
本地配置(ftp文件转发协议)¶
新建通道¶
新建一个转发通道，协议选择“ftp文件转发协议”，主参数中，可以根据需要配置交互频率和每帧间隔参数。交互频率影响扫描文件读取信号周期。每帧间隔影响两次ftp操作之间的时间间隔，该值要大于500毫秒，小于500毫秒的值将不生效；
编辑规约特征配置，主要配置ftp文件读取以及文件推送的ftp服务器信息。参数详解见下表(简单参数不再赘述)。
| 编号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 文件读取地址 | ftp服务器地址 |
| 1 | 文件读取端口 | ftp服务器端口 |
| 2 | 文件读取用户名 | ftp用户名，匿名账户一般为ftp或anonymous，具体要看ftp服务器的配置 |
| 3 | 文件读取密码 | ftp密码，无需密码时留空 |
| 4 | 文件推送地址 | ftp服务器地址 |
| 5 | 文件推送端口 | ftp服务器端口 |
| 6 | 文件推送用户名 | ftp用户名，匿名账户一般为ftp或anonymous，具体要看ftp服务器的配置 |
| 7 | 文件推送密码 | ftp密码， 无需密码时留空 |
| 8 | 文件获取目录 | 读取文件时，可以指定从ftp服务器的哪个目录读取。从根目录读取时，留空。 |
| 9 | 文件推送目录 | 推送文件时，可以指定推送到ftp服务器的哪个目录读取。从根目录读取时，留空。 |
| 10 | 触发通讯中断的失败次数 | 读取文件或推送文件失败计算超过该值时，触发通信中断告警 |
| 11 | 触发延时时间，单位秒 | 检测到读取信号时，延迟多少时间触发读取操作，必须大于等于1秒 |
| 12 | 历史记录存储天数 | 文件推送记录存储天数 |
新建设备¶
设备的参数自定义或保持默认即可，在本驱动中，设备的参数无实际意义。
新建测点¶
转发测点有3种功能码:读文件触发信号，计算点，设备通信中断。读文件触发信号类型测点从0跳到1时，会触发读文件计时，当计时到达“触发延时时间”设置的时间时，从ftp服务器获取最新的文件列表，然后读取未上传过的文件。设备通信中断类型测点在触发通信中断告警时被设置成1，ftp通信正常时被设置成0。
电工所http转发¶
云端配置(电工所http转发)¶
新建通道¶
新建一个转发通道，协议选择电工所http转发，主参数中，IP地址与端口号，填写实际服务器的IP地址与端口号；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 6hour，建议设置为5分钟，设备编号、是否使用物模型转发等更多参数见规约特征配置；
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
提示
设备编号默认使用设备通讯地址进行对应，可以在规约特征中修改对应关系。
-
不新建转发设备
我们回到采集通道下的子设备管理，确保通讯地址对应平台分配的设备编号，其余属性保持原来的参数不变；
-
新建了转发设备
新增一个转发设备，自定义设备名称，确保通讯地址对应平台分配的设备编号，其余属性保持原来的参数不变；
新建测点¶
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，转发测点的属性均保持默认；
如果未新建转发设备，那么需要配置采集测点的是否上传属性，打钩(默认)则转发，不打勾不转发；
如下图，物模型标识对应平台的测点ID。
本地配置(电工所http转发)¶
新建通道¶
新建一个转发通道，协议选择电工所http转发，主参数中，IP地址与端口号，填写实际的MQTT服务器的IP地址与端口号，一般保持默认即可；
交互频率即为实时数据上传的时间间隔，设置范围为1s < time < 6hour，建议设置为5分钟，设备编号、是否使用物模型转发等更多参数见规约特征配置；
新建设备¶
该转发协议可以不新建转发设备与转发测点，此时默认转发所有的采集点(不想上传的，在测点的高级配置页，取消勾选是否上传)；
提示
设备编号默认使用设备通讯地址进行对应，可以在规约特征中修改对应关系。
-
不新建转发设备
我们回到采集通道下的子设备管理，确保通讯地址对应平台分配的设备编号，其余属性保持原来的参数不变；
-
新建了转发设备
新增一个转发设备，自定义设备名称，确保通讯地址对应平台分配的设备编号，其余属性保持原来的参数不变；
新建测点¶
如果在上一步中新建了转发设备，那么在刚刚新建的转发设备下，批量添加需要转发的测点，此时不添加不转发，转发测点的属性均保持默认；
如果未新建转发设备，那么需要配置采集测点的是否上传属性，选择是(默认)则转发，选择否不转发；
如下图，物模型标识对应平台的测点ID。
数据模拟协议¶
云端配置¶
新建通道¶
新建一个采集通道，协议选择数据模拟驱动，主参数中，协议类型无需选择，本驱动是在内存模拟生成数据，不涉及数据通信，其它参数如无特殊要求保持默认即可；
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写设备地址，其余参数留空即可。
新建测点¶
如下是功能码为递增(递减)测点的例子，模拟生成初始值为1，递增且偏移步长为1，上限为100的数据测点。
提示
系数：取1代表生成递增数据，取-1代表生成递减数据。 偏移：代表生成递增(递减)数据的步长。
提示
初始值：代表测点模拟数据的初始值。
提示
高高限：模拟生成递增数据时代表数据上限制，模拟生成递减数据时代表数据下限，到达数据界限，测点数据变为初始值继续生成。
如下是功能码为随机数据测点的例子，模拟生成上限100(包含)，下限-100(包含)区间范围内的数据。
提示
系数：代表模拟生成数据的上限值(含)。 偏移: 代表模拟生成数据的下限值(含)。
如下是功能码为正(余)弦测点的例子，模拟生成正弦数据，测点偏移为0.1，测点初始值为0。
提示
系数：取1代表生成正弦数据，否则代表生成余弦数据。 偏移：测点自变量每次偏移的步长，即sin(x)或者cos(x)中x的偏移步长。
提示
初始值：对应sin(x)或者cos(x)中x的初始值。
本地配置¶
新建通道¶
新建一个采集通道，协议选择数据模拟驱动，主参数中，协议类型无需选择，本驱动是在内存模拟生成数据，不涉及数据通信，其它参数如无特殊要求保持默认即可；
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写设备地址，其余参数留空即可。
新建测点¶
如下是功能码为递增(递减)测点的例子，模拟生成初始值为1，递增且偏移步长为1，上限为100的数据测点。
提示
系数：取1代表生成递增数据，取-1代表生成递减数据。 偏移：代表生成递增(递减)数据的步长。
提示
初始值：代表测点模拟数据的初始值。
提示
高高限：模拟生成递增数据时代表数据上限制，模拟生成递减数据时代表数据下限，到达数据界限，测点数据变为初始值继续生成。
如下是功能码为随机数据测点的例子，模拟生成上限100(包含)，下限-100(包含)区间范围内的数据。
提示
系数：代表模拟生成数据的上限值(含)。 偏移: 代表模拟生成数据的下限值(含)。
如下是功能码为正(余)弦测点的例子，模拟生成正弦数据，测点偏移为0.1，测点初始值为0。
提示
系数：取1代表生成正弦数据，否则代表生成余弦数据。 偏移：测点自变量每次偏移的步长，即sin(x)或者cos(x)中x的偏移步长。 初始值：对应sin(x)或者cos(x)中x的初始值。
ftp_gpfx¶
云端配置说明¶
- 1、 新建一个采集通道，协议选择“ftp光谱文件分析”，主参数中，按照实际情填写FTP服务器的IP的地址和端口号，根据需要配置交互频率。交互频率决定读取文件周期。每帧间隔影响两次ftp操作之间的时间间隔；
- 2、编辑规约特征配置，主要配置登录ftp服务器时的用户名、密码以及文件获取路径。下图是一个在window上部署的ftp可匿名访问的服务器的配置的例子。
新建设备¶
设备的参数中通信地址填写需要下载及分析的光谱文件名，其他参数自定义或保持默认即可。
新建测点¶
新建一个测点，功能码选实时值,配置其采集分组属性，该值表示该测点取第几行数据。配置地址属性，表示第几个数据，数据类型无需配置，其他参数按需配置。如下2图是测点及对应文件中的数据，取值是第三个数据中第一列数据,。
提示
数据个数数和列数都是从0开始，从规约参数配置中的分析文件末尾行数选项中确定取最新几个数据，本例中配置的是6，故取6个数据。本协议中把时间行和数据行作为一个结果来分析。
本地配置说明¶
- 1、 新建一个采集通道，协议选择“ftp光谱文件分析”，主参数中，按照实际情填写FTP服务器的IP的地址和端口号，根据需要配置交互频率。交互频率决定读取文件周期。每帧间隔影响两次ftp操作之间的时间间隔；
- 2、编辑规约特征配置，主要配置登录ftp服务器时的用户名、密码以及文件获取路径。下图是一个在window上部署的ftp可匿名访问的服务器的配置的例子。
新建设备¶
设备的参数中通信地址填写需要下载及分析的光谱文件名，其他参数自定义或保持默认即可。
新建测点¶
新建一个测点，功能码选实时值,配置其采集分组属性，该值表示该测点取第几行数据。配置地址属性，表示第几个数据，数据类型无需配置，其他参数按需配置。如下2图是测点及对应文件中的数据，取值是第三个数据中第一列数据,。
提示
数据个数数和列数都是从0开始，从规约参数配置中的分析文件末尾行数选项中确定取最新几个数据，本例中配置的是6，故取6个数据。本协议中把时间行和数据行作为一个结果来分析。
济中能源电梯采集¶
云端配置¶
新建通道¶
新建一个采集通道，协议选择济中能源-电梯采集，主参数中，串口名称按照网关实际的接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，波特率9600bps，8位数据位，1位停止位，无校验位，其它参数如无特殊要求保持默认即可；
新建设备¶
新建一个设备，自定义设备名称，设备通讯地址填写终端分机地址，其余参数无需考虑。
新建测点¶
进入采集测点管理，新增测点，根据电梯控制柜通讯协议，按照电梯运行数据的数据序号，填写地址，按照位序号，在高级设置中，勾选按位取值，填写起始位终止位，所有测点的数据类型都要选择8位无符号。
电梯运行数据参考¶
举例：
如需查询楼层信息，查表得知数据序号为1，地址填写1，数据类型选择8位无符号，楼层信息不用按位取值。如果想修改楼层最低的值，可以修改偏移的值。
如需查询下行数据，查表得知数据序号为2，位序号为0，地址填写2，数据类型选择8位无符号，在高级设置中勾选按位取值，起始位写0，终止位写0。
特别的，协议中电梯故障数据为0时表示故障，为1表示不故障。如果想在故障时，测点数据值显示1，我们可以将系数改为-1，偏移改为1。
本地配置¶
新建通道¶
新建一个采集通道，协议选择济中能源-电梯采集，主参数中，串口名称按照网关实际的接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，波特率9600bps，8位数据位，1位停止位，无校验位，其它参数如无特殊要求保持默认即可；
新建设备¶
进入任务树的采集通道，新建一个设备，自定义设备名称，设备通讯地址填写终端分机地址，其余参数无需考虑。
新建测点¶
进入创建的设备中，添加测点，根据电梯控制柜通讯协议，按照电梯运行数据表的数据序号、位序号，分别填写寄存器地址、是否按位取值和取值起始终止位，数据类型选择8位无符号。
举例：
如需查询楼层信息，查表得知数据序号为1，寄存器地址填写1，数据类型选择8位无符号，无需按位取值。如果想修改楼层最低的值，可以修改偏移B的值。
如需查询下行数据，查表得知数据序号为2，位序号为0，寄存器地址填写2，数据类型选择8位无符号，按位取值选择是，取值起始位写0，取值终止位写0。
电梯故障数据想要取反表示时，系数写-1，偏移写1。
中深电力微机通信¶
云端配置¶
新建通道¶
新建一个采集通道，协议选择中深电力ZBLP600微机保护，串口名称按照网关实际的接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，波特率9600bps，8位数据位，1位停止位，偶校验位，其它参数如无特殊要求保持默认即可；
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写设备地址。
新建测点¶
提示
数据地址从0开始，所有数据顺序对应填写地址时需要减1。
遥测数据¶
如需查询T1(温度信号1)，查看图表得知数据顺序位置为1，那么地址填写0，数据类型选择16位有符号，读写属性选择只读。其他数据根据顺序填写地址即可。
对于有功电度、无功电度，查看图表得知这两种数据分为高低位,有功电度需要填写地址为28,无功电度对需要填写寄存器地址为29，数据类型选择32位无符号,高低位顺序选择1234。
遥信数据¶
提示
遥信数据格式选择21，数据类型为16位无符号，需要按位取值。
如需查询BI0开入输入量-断路器位置，查看图表得知开关输入量数据顺序位置为第33个数据，对应地址填写32，读写属性选择只读，数据类型选择16位无符号，断路器位置的数据位于开关输入量的第0位，在高级设置中，勾选按位取值,起始位写0，终止位写0。
遥控数据¶
提示
继电器号为16进制数，需要转化为10进制数填写寄存器地址。继电器号11/22/33/44/55/66对应跳闸/合闸/逻辑跳闸/告警/事故/备用。
如需遥控跳闸指令,功能码选择遥控,跳闸指令对应继电器号(16进制数)为11，对应填写地址(10进制数)为17，数据类型选择位
云端暂不支持直接下发遥控指令。
本地配置¶
新建通道¶
新建一个采集通道，协议选择中深电力ZBLP600微机保护，主参数中，串口名称按照网关实际的接线情况选择对应的COM口(COM1对应A1、B1，以此类推)，波特率9600bps，8位数据位，1位停止位，偶校验位，其它参数如无特殊要求保持默认即可；
新建设备¶
进入任务树的采集通道，新建一个设备，自定义设备名称，设备通讯地址填写设备地址，其余参数无需考虑。
新建测点¶
进入创建的设备中，添加测点，按照协议中的循呼数据报文(图中灰色部分)中的数据顺序位置，填写寄存器地址、是否按位取值和取值起始终止位，数据类型选择16位有符号，读写属性选择只读。
提示
数据地址从0开始，所有数据顺序对应填写寄存器地址时需要减1。
举例¶
遥测数据¶
如需查询T1(温度信号1)，查看图表得知数据顺序位置为1，那么寄存器地址填写0，数据类型选择16位有符号，读写属性选择只读。其他数据根据顺序填写寄存器地址即可。
对于有功电度、无功电度，查看图表得知这两种数据分为高低位,有功电度需要填写寄存器地址为28,无功电度对需要填写寄存器地址为29，数据类型选择32位无符号,高低位顺序选择1234。
遥信数据¶
提示
遥信数据高低位顺序选择21，数据类型为16位无符号，需要按位取值。
如需查询BI0开入输入量-断路器位置，查看图表得知开关输入量数据顺序位置为第33个数据，对应寄存器地址填写32，读写属性选择只读，数据类型选择16位无符号，断路器位置的数据位于开关输入量的第0位，按位取值选择是,取值起始位写0，取值终止位写0。
遥控数据¶
提示
继电器号为16进制数，需要转化为10进制数填写寄存器地址。继电器号11/22/33/44/55/66对应跳闸/合闸/逻辑跳闸/告警/事故/备用。
如需遥控跳闸指令,采集功能码选择遥控,跳闸指令对应继电器号(16进制数)为11，对应填写寄存器地址(10进制数)为17，数据类型选择位。
在监测时右键测点数据，选择遥控，点击遥控选择再点击遥控执行即为下发遥控指令。
hongwaibao¶
云端配置(红外宝采集)¶
注意
在配置采集通道之前，zigbee网关应该已经添加了zigbee设备。该操作需要通过zigbee网关厂家提供的软件来完成，不属于本协议范围。
新建通道¶
新建一个采集通道，协议选择红外宝，主参数中，IP地址和端口号填写需要zigbee网关对应的值，交互频率建议配大一点，如15000，其它参数如无特殊要求保持默认即可；
提示
因为从与zigbee网关读取设备数据时，zigbee网关再从设备获取数据并返回需要耗费的会比较长，所以交互频率不宜配置的太小。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写要采集的zigbee设备的短地址.endpoint，其余参数留空即可。
提示
目前已经实现了2种zigbee设备的数据采集:红外宝(fnb56模块),计量插座(SmartPlug)。不同的设备在配置测点时，可以选择的功能码是不一样的，不能混用。
新建测点¶
在配置采集测点时，对于不同类型的设备，功能码只能选择对应设备的，不能选错。
红外宝(fnb56模块)可选功能码：版本号,码组匹配,功能控制,码组学习,删除操作码,退出匹配或学习。
计量插座(SmartPlug)可选功能码:读计量插座,计量插座开关。
注意
如果采集的是红外宝(fnb56模块)，必须配置一个功能码是版本号的测点，因为该设备的其他操作都依赖于版本号信息。
测点地址的配置要求也因要采集的设备不同而不同。红外宝(fnb56模块)的采集测点地址配置会被忽略，故可以不配置。计量插座(SmartPlug)的测点地址需要正确配置才能正常通讯，具体见下表。
| 数据项 | 地址配置形式 | 配置值 |
|---|---|---|
| 用电量 | clustreID.attrID | 702.0 |
| 功率 | clustreID.attrID | b04.50b |
| 开关控制 | 开关序号 | 1 |
举例建一个读取计量插座的测点，则新建一个读计量插座功率测点，地址按clustreID.attrID形式配置，系数按实际需要填写。
本地配置(红外宝采集)¶
新建通道¶
注意
在配置采集通道之前，zigbee网关应该已经添加了zigbee设备。该操作需要通过zigbee网关厂家提供的软件来完成，不属于本协议范围。
新建通道¶
新建一个采集通道，协议选择红外宝，主参数中，IP地址和端口号填写需要zigbee网关对应的值，交互频率建议配大一点，如15000，其它参数如无特殊要求保持默认即可；
提示
因为从与zigbee网关读取设备数据时，zigbee网关再从设备获取数据并返回需要耗费的会比较长，所以交互频率不宜配置的太小。
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写要采集的zigbee设备的短地址.endpoint，其余参数留空即可。
提示
目前已经实现了2种zigbee设备的数据采集:红外宝(fnb56模块),计量插座(SmartPlug)。不同的设备在配置测点时，可以选择的功能码是不一样的，不能混用。
新建测点¶
在配置采集测点时，对于不同类型的设备，功能码只能选择对应设备的，不能选错。
红外宝(fnb56模块)可选功能码：版本号,码组匹配,功能控制,码组学习,删除操作码,退出匹配或学习。
计量插座(SmartPlug)可选功能码:读计量插座,计量插座开关。
注意
如果采集的是红外宝(fnb56模块)，必须配置一个功能码是版本号的测点，因为该设备的其他操作都依赖于版本号信息。
测点地址的配置要求也因要采集的设备不同而不同。红外宝(fnb56模块)的采集测点地址配置会被忽略，故可以不配置。计量插座(SmartPlug)的测点地址需要正确配置才能正常通讯，具体见下表。
| 数据项 | 地址配置形式 | 配置值 |
|---|---|---|
| 用电量 | clustreID.attrID | 702.0 |
| 功率 | clustreID.attrID | b04.50b |
| 开关控制 | 开关序号 | 1 |
举例建一个读取计量插座的测点，则新建一个读计量插座功率测点，地址按clustreID.attrID形式配置，系数按实际需要填写。
美仪仪表云¶
云端配置(美仪仪表云HTTP采集)¶
新建通道¶
新建一个采集通道，协议选择美仪仪表云HTTP采集，IP/域名保持默认的https://link-i.supmea.com，端口号保持默认；
注意
通道的交互频率不宜过短，建议60000ms(1分钟)以上，否则会导致流量消耗过大。
仪表云的app Token以及私钥，填写在规约特征中，公钥无需填写。
新建设备¶
新建一个设备，设备通讯地址填写仪表的上云码，其它参数默认即可；
新建测点¶
举例读取刚刚添加的设备的参数1温度，那么新建一个测点，功能码选择读实时数据，地址填温度，其余参数保持默认即可。
本地配置(美仪仪表云HTTP采集)¶
新建通道¶
新建一个采集通道，协议选择美仪仪表云HTTP采集，IP/域名保持默认的https://link-i.supmea.com，端口号保持默认；
注意
通道的交互频率不宜过短，建议60000ms(1分钟)以上，否则会导致流量消耗过大。
仪表云的app Token以及私钥，填写在规约特征中，公钥无需填写。
新建设备¶
新建一个设备，设备通讯地址填写仪表的上云码，其它参数默认即可；
新建测点¶
举例读取刚刚添加的设备的参数1温度，那么新建一个测点，功能码选择读实时数据，地址填温度，其余参数保持默认即可。
SUNTREE-50KTL¶
云端配置(SUNTREE-50KTL)¶
新建通道¶
要采集SUNTREE逆变器数据，协议选择SUNTREE-50KTL，串口名称根据实际情况选择，其余参数通常保持默认即可；
新建设备¶
新建一个设备，设备通讯地址即为逆变器从机地址；
新建测点¶
举例新建一个采集测点， 功能码根据实际情况选择，比如采集散热器温度，那么功能码选择读逆变器参数，地址为0（地址为逆变器文档中所示地址减去7以后除以2得到），数据类型为16位有符号，数据格式选择12；
本地配置(SUNTREE-50KTL)¶
新建通道¶
要采集SUNTREE逆变器数据，协议选择SUNTREE-50KTL，串口名称根据实际情况选择，其余参数通常保持默认即可；
新建设备¶
新建一个设备，设备通讯地址即为逆变器从机地址；
新建测点¶
举例新建一个采集测点， 功能码根据实际情况选择，比如采集散热器温度，那么功能码选择读逆变器参数，地址为0（地址为逆变器文档中所示地址减去7以后除以2得到），数据类型为16位有符号，数据格式选择12；
三川智慧水表http采集¶
云端配置(三川智慧水表http采集)¶
新建通道¶
本驱动以http GET的方式，接受json内容数据，新建一个采集通道，协议选择三川智慧水表http采集，交互频率即为数据上传的间隔，然后填写ip地址和端口号(以实际情况为准)；
新建设备¶
举例新建一个采集设备device_1，那么它的通讯地址填写表号（例如3621033530000635），公共地址填写用户号（例如tjjtcqfl_admin），其余参数默认即可；
新建测点¶
举例新建一个采集测点，地址对应json数据的key，其余参数自行填写即可。
json数据格式
地址和接收到的json数据对应表
本地配置(三川智慧水表http采集)¶
新建通道¶
本驱动以http GET的方式，接受json内容数据，新建一个采集通道，协议选择三川智慧水表http采集，交互频率即为数据上传的间隔，然后填写ip地址和端口号(以实际情况为准)；
新建设备¶
举例新建一个采集设备device_1，那么它的通讯地址填写表号（例如3621033530000635），公共地址填写用户号（例如tjjtcqfl_admin），其余参数默认即可；
新建测点¶
举例新建一个采集测点，地址对应json数据的key，其余参数自行填写即可。
io_virtual¶
云端配置(IO虚拟运算通道)¶
新建通道¶
新建一个采集通道，协议选择IO运算虚拟，本驱动用于对网关自身的IO功能(DI,DO,AO,AI)的采集和控制。通道的其他参数不用配置，在本驱动中他们无效。
设备型号对应的IO支持功能如下表，未列出的型号不支持：
| 序号 | IO类型 | PBox8628 | PBox848F |
|---|---|---|---|
| 0 | DI | 8 | 16 |
| 1 | DO | 4 | 10 |
| 2 | AI | 4(4-20mA和0-5V二选一) | 无 |
| 3 | PT100 | 2(暂不可用) | 无 |
| 4 | AO | 1(暂不可用) | 无 |
新建设备¶
新建一个采集设备，设备参数无需修改。
新建测点¶
警告
同一个IO通道，只能配置一种信号类型。如AI通道1已经配置了4-20mA，AI通道1就不允许再配置一个0-5V的信号了，否则会出错。
提示
IO的通道号是从1开始，如DI支持8个通道，那么它的通道号就是1-8,超过合法范围通道号将不处理；
无需手动配置，可以点击下方下载点表模板即可导入：
含AIAO功能的点表(8路DI、4路DO、4路AI、1路AO)：IO默认点表(含AIAO).xls
仅含DIDO的点表(16路DI、10路DO)：IO默认点表(仅DIDO).xls
根据实际需要配置测点，根据具体的IO类型选择合适的功能码，地址上填写相应的通道号。如下图所示配置了一个AI通道，信号类型是4-20mA。
本地配置(IO虚拟运算通道)¶
新建通道¶
新建一个采集通道，协议选择IO运算虚拟，本驱动用于对网关自身的IO功能(DI,DO,AO,AI)的采集和控制。通道的其他参数不用配置，在本驱动中他们无效。
设备型号对应的IO支持功能如下表，未列出的型号不支持：
| 序号 | IO类型 | PBox8628 | PBox848F |
|---|---|---|---|
| 0 | DI | 8 | 16 |
| 1 | DO | 4 | 10 |
| 2 | AI | 4(4-20mA和0-5V二选一) | 无 |
| 3 | PT100 | 2(暂不可用) | 无 |
| 4 | AO | 1(暂不可用) | 无 |
新建设备¶
新建一个采集设备，设备参数无需修改。
新建测点¶
警告
同一个IO通道，只能配置一种信号类型。如AI通道1已经配置了4-20mA，AI通道1就不允许再配置一个0-5V的信号了，否则会出错。
提示
IO的通道号是从1开始，如DI支持8个通道，那么它的通道号就是1-8,超过合法范围通道号将不处理；
无需手动配置，可以点击下方下载点表模板即可导入：
含AIAO功能的点表(8路DI、4路DO、4路AI、1路AO)：IO默认点表(含AIAO).xls
仅含DIDO的点表(16路DI、10路DO)：IO默认点表(仅DIDO).xls
根据实际需要配置测点，根据具体的IO类型选择合适的功能码，地址上填写相应的通道号。如下图所示配置了一个AI通道，信号类型是4-20mA。
AGVC配置¶
云端配置(AGVC)¶
新建通道¶
本协议不建议在云端配置。此节略过。
新建设备¶
本协议不建议在云端配置。此节略过。
新建测点¶
本协议不建议在云端配置。此节略过。
本地配置(AGVC)¶
新建通道¶
新建一个采集通道，协议选择AGVC，通道的其他参数不用配置，在本驱动中他们无效。
提示
AGVC通道需要额外授权才能使用。
新建设备¶
新建一个采集设备，设备参数无需修改。
新建测点¶
AGVC测点需要按照特定规则创建，不建议手动创建。可以联系我司技术支持索要AGVC点表，直接导入即可。
导入后的效果如下:
算法配置¶
AGVC测点需要创建算法，与其他采集通道的逆变器绑定才能正确的执行群控群调功能。下面将需要创建算法的测点汇总如下。
| 序号 | 测点名 | 算法说明 |
|---|---|---|
| 1 | AGC_全站有功实时值 | 把逆变器的有功实时值累加起来 |
| 2 | AVC_发电单元无功实时值 | 把逆变器的无功实时值累加起来 |
| 3 | AGVC_功率因素实时值 | 把逆变器的功率因数实时值累加起来，然后做平均值 |
| 4 | AGVC_运行额定功率 | 把正常运行的逆变器的额定功率累加起来(每个逆变器取运行或并网信号乘以逆变器额定功率) |
| 5 | AGVC_可调节PV数量 | 把正常运行的逆变器(每个逆变器取运行或并网信号)累加起来 |
| 6 | AGC_有功目标值 | 配置群调算法，关联每个逆变器的有功调节测点 |
| 7 | AVC_无功目标值 | 配置群调算法，关联每个逆变器的无功调节测点 |
| 8 | AVC_功率因素目标值 | 配置群调算法，关联每个逆变器的功率因数调节测点 |
| 9 | AVC_电压目标值 | 配置群调算法，关联每个逆变器的无功调节测点 |
| 10 | AVC_PV总阶梯控制无功量 | 配置群调算法，关联每个逆变器的无功调节测点 |
群调说明¶
在配置群调时，要关注逆变器上相应调节点调节的是实际值调节还是比例调节。如果调节的是实际值调节，则群调算法选择群调(平均)；如果调节的是比列调节，则群调算法选择群调(相等)，并且在相应调节测点上的地址上配置/AGVC_运行额定功率来把调度下发的目标值转换成比例值调节下去。
比例条件的配置示例:
另外，如果在逆变器上调节的比列范围是0-100，还需要在群调点的系数上配置0.01，把计算出来的(0-1)的比例转成0-100.
提示
功率因素调节本质是-1到1的一个比例值。所以功率因数调节要选群调(相等 )。
阳光平台采集协议¶
云端配置(阳光平台采集协议)¶
新建通道¶
新建一个采集通道，协议选择阳光平台数据采集，在通道参数中交互频率和每帧间隔按需要配置。IP地址和端口一般不需要修改。
提示
阳光平台API调用频率存在限制：每个appkey每小时此时不超过7200次，3秒内不能超过10次。因此通道的每帧间隔若小于1000ms，就会强制作为1000ms处理。此外因为阳光平台上的数据刷新时间时5分钟左右，交互频率也建议配置到60秒以上。
规约参数：
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 3 | 用户名 | 必须配置 |
| 4 | 密码 | 必须配置 |
| 5 | appKey | 必须配置 |
| 6 | access_key | 必须配置 |
| 4 | 电站信息刷新周期 | 电站信息的期望刷新周期 |
警告
本协议规约参数必须配置，否则将不会工作。
新建设备¶
新建一个采集设备，如果该设备用于采集逆变器等具体的设备，则需要在设备通讯地址上配置该设备对应的device_sn属性。
如果改设备用于读取电站本身数据，则需要在保留0上配置该设备对应的电站名称。
提示
目标只支持逆变器设备类型读取。
新建测点¶
根据实际需要配置测点，根据测点对应的设备类型选择合适的功能码，有两类测点。
逆变器测点¶
地址按照阳光平台API说明中的附录10：常用遥测测点枚举来填写。
如逆变器设备测点枚举节选如下图所示，具体定义需要客户自行去阳光平台查看。
下图是一个读取逆变器日发测点的配置。
电站信息测点¶
地址填写阳光平台API说明电站列表信息查询API返回的key值中的"pageList"之后部分。
如下图测点是读取key是result_data.pageList.total_energy.value的值，该测点地址配置的是：total_energy.value.
本地配置(阳光平台采集协议)¶
新建通道¶
新建一个采集通道，协议选择阳光平台数据采集，在通道参数中交互频率和每帧间隔按需要配置。IP地址和端口一般不需要修改。
提示
阳光平台API调用频率存在限制：每个appkey每小时此时不超过7200次，3秒内不能超过10次。因此通道的每帧间隔若小于1000ms，就会强制作为1000ms处理。此外因为阳光平台上的数据刷新时间时5分钟左右，交互频率也建议配置到60秒以上。
规约参数：
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 3 | 用户名 | 必须配置 |
| 4 | 密码 | 必须配置 |
| 5 | appKey | 必须配置 |
| 6 | access_key | 必须配置 |
| 4 | 电站信息刷新周期 | 电站信息的期望刷新周期 |
警告
本协议规约参数必须配置，否则将不会工作。
新建设备¶
新建一个采集设备，如果该设备用于采集逆变器等具体的设备，则需要在设备通讯地址上配置该设备对应的device_sn属性。
如果改设备用于读取电站本身数据，则需要在保留0上配置该设备对应的电站名称。
提示
目标只支持逆变器设备类型读取。
新建测点¶
根据实际需要配置测点，根据测点对应的设备类型选择合适的功能码，有两类测点。
逆变器测点¶
地址按照阳光平台API说明中的附录10：常用遥测测点枚举来填写。
如逆变器设备测点枚举节选如下图所示，具体定义需要客户自行去阳光平台查看。
下图是一个读取逆变器日发测点的配置。
电站信息测点¶
地址填写阳光平台API说明电站列表信息查询API返回的key值中的"pageList"之后部分。
如下图测点是读取key是result_data.pageList.total_energy.value的值，该测点地址配置的是：total_energy.value.
串口服务器¶
云端配置(串口服务器)¶
本驱动的作用是把串口数据转发到多个TCP服务器上。
新建通道¶
新建一个采集通道，协议选择串口服务器，并配置正确的串口参数。
警告"
串口服务器必须独占串口，不允许和其他通道共享串口。
规约参数：
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 注册帧 | TCP客户端连接到服务器时，发送的首帧数据，可为空 |
新建设备¶
新建一个采集设备，本驱动中采集设备无实际意义。故设备参数可以无需特意修改。
新建测点¶
新建测点，选择功能码，然后在测点地址上配置TCP服务器的IP地址和端口即可，如果需要转发给多个服务器，每个服务器都建一个测点即可。
本地配置(串口服务器)¶
新建通道¶
新建一个采集通道，协议选择串口服务器，并配置正确的串口参数。
警告"
串口服务器必须独占串口，不允许和其他通道共享串口。
规约参数：
| 序号 | 参数描述 | 说明 |
|---|---|---|
| 0 | 注册帧 | TCP客户端连接到服务器时，发送的首帧数据，可为空 |
新建设备¶
新建一个采集设备，本驱动中采集设备无实际意义。故设备参数可以无需特意修改。
新建测点¶
新建测点，选择功能码，然后在测点地址上配置TCP服务器的IP地址和端口即可，如果需要转发给多个服务器，每个服务器都建一个测点即可。
Ended: 私有协议
CAN协议 ↵
can_ecc¶
云端配置(工商业储能系统协议)¶
新建通道¶
新建一个采集通道，协议选择工商业储能系统协议，主参数中，串口名称按照网关实际的接线情况选择对应的CAN口(只有一个CAN口时选择CAN1),波特率按照实际配置，如500k就选择500000，其它参数如无特殊要求保持默认即可；
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写CAN通讯设备地址,兼容平台选择涂鸦智能OS，设备类型选择需要采集的设备类型，如BMS,其余参数留空即可。
新建测点¶
测点配置规则: 根据点表文件进行配置。主要分成2部分进行配置:
- Msg ID部分 最高2位决定功能码类型，如0x17XXXXXX开头的，功能码选择读数据(0x17)功能码。次高2位决定测点的采集分组属性，如Msg ID为0xXX01XXXX的数据，采集分组要配置未01。
- 数据解析部分 这部分根据起始字节来配置测点的寄存器，信号长度来配置测点的数据类型，如长度8的配置为8位无符号,长度16的配置为16位无符号,长度32的配置为32位无符号。长度小于8位的数据类型选择8位无符号，并进行按位取值配置高级设置里勾选按位取值。
举例新建一个测点采集BMS的BMS系统故障表中的一级放电电流过大信号，已知该信号来自"电池族BMS数据"的故障代码，故其Msg ID为0x170D01F3，起始字节为2，Bit范围是2-3，当Bit[2,3]=1时，该信号为1。
提示
因为本协议数据采用Intel格式，低位在前。16位类型数据需要配置字节顺序为21。32位类型数据需要配置字节顺序为4321。
提示
8位类型数据字节顺序配置无意义，故可以任意。
注意
由于EMS参数配置中的充电时段类型测点的时，分需要被组合成一个测点上传到云平台，故在采集配置时需要把它们合并成一个测点，数据类型必须选择16位BCD,如下图所示；
本地配置(工商业储能系统协议)¶
新建通道¶
新建一个采集通道，协议选择工商业储能系统协议，主参数中，串口名称按照网关实际的接线情况选择对应的CAN口(只有一个CAN口时选择CAN1),波特率按照实际配置，如500k就选择500000，其它参数如无特殊要求保持默认即可；
新建设备¶
新建一个设备，自定义设备名称，通讯地址填写CAN通讯设备地址,兼容平台选择涂鸦智能OS，设备类型选择需要采集的设备类型，如BMS,其余参数留空即可。
新建测点¶
测点配置规则: 根据点表文件进行配置。主要分成2部分进行配置:
- Msg ID部分 最高2位决定功能码类型，如0x17XXXXXX开头的，功能码选择读数据(0x17)功能码。次高2位决定测点的采集分组属性，如Msg ID为0xXX01XXXX的数据，采集分组要配置未01。
- 数据解析部分 这部分根据起始字节来配置测点的寄存器，信号长度来配置测点的数据类型，如长度8的配置为8位无符号,长度16的配置为16位无符号,长度32的配置为32位无符号。长度小于8位的数据类型选择8位无符号，并进行按位取值配置高级设置里勾选按位取值。
举例新建一个测点采集BMS的BMS系统故障表中的一级放电电流过大信号，已知该信号来自"电池族BMS数据"的故障代码，故其Msg ID为0x170D01F3，起始字节为2，Bit范围是2-3，当Bit[2,3]=1时，该信号为1。
提示
因为本协议数据采用Intel格式，低位在前。16位类型数据需要配置字节顺序为21。32位类型数据需要配置字节顺序为4321。
提示
8位类型数据字节顺序配置无意义，故可以任意。
注意
由于EMS参数配置中的充电时段类型测点的时，分需要被组合成一个测点上传到云平台，故在采集配置时需要把它们合并成一个测点，数据类型必须选择16位BCD,如下图所示；
Ended: CAN协议
光伏发电 ↵
雷乐逆变器¶
云端配置(雷乐逆变器)¶
新建通道¶
新建一个采集通道，协议选择雷乐逆变器，主参数中，串口名称按照网关实际的接线情况选择对应的COM口，其它参数如无特殊要求保持默认即可；
新建设备¶
新建一个采集设备，自定义设备名称参数，设备通信地址填写ADDR【从机(模块电源)地址】，其他参数保持默认即可。
新建测点¶
新建一个测点。功能码选择查询；地址根据”kind.地址“的格式填写；测点名称、系数、数据类型以及数据格式等参数根据具体需求填写。
协议帧结构格式说明如下（来自广东雷乐RSG-10K-60K 光伏并网逆变器协议）：
本地配置(雷乐逆变器)¶
新建通道¶
新建一个采集通道，协议选择雷乐逆变器，主参数中，串口名称按照网关实际的接线情况选择对应的COM口，其它参数如无特殊要求保持默认即可；
新建设备¶
新建一个采集设备，自定义设备名称参数，设备通信地址填写ADDR【从机(模块电源)地址】，其他参数保持默认即可。
新建测点¶
新建一个测点。功能码选择查询；地址根据”kind.地址“的格式填写；测点名称、系数、数据类型以及数据格式等参数根据具体需求填写。
协议帧结构格式说明如下（来自广东雷乐RSG-10K-60K 光伏并网逆变器协议）：
Ended: 光伏发电
Ended: 驱动帮助
二次开发 ↵
LUA公开函数 ↵
0.函数一览¶
说明¶
智能网关集成的Lua版本为5.1.5。
您可以：
1、使用Lua编写简单的计算、统计公式，将结果赋值到计算点中；
2、使用Lua编写群控群调等控制方法；
函数声明¶
1.GetTagValue¶
函数声明¶
| C | |
|---|---|
-
描述：
通过测点名称，得到一个测点的实时值。
-
参数：
szTagName:目标测点名称的字符串。 -
返回值：
返回目标测点的实时值，如果失败，返回0。
-
示例：
| Lua | |
|---|---|
提示
本函数自下位机软件版本≥1.3.26后，实时值精度从float升级为double。
更多例子参考取得、设置实时值。
2.SetTagValue¶
函数声明¶
| C | |
|---|---|
-
描述：
设置目标测点的实时值。
-
参数：
szTagName:目标测点名称的字符串；fValue:要写入的实时值。 -
返回值：
无。
-
示例：
| Lua | |
|---|---|
提示
本函数自下位机软件版本≥1.3.26后，实时值精度从float升级为double。
更多例子参考取得、设置实时值。
3.GetTagValueAndQos¶
函数声明¶
| C | |
|---|---|
-
描述：
通过测点名称，得到一个测点的实时值和质量。
-
参数：
szTagName:目标测点名称的字符串。 -
返回值：
返回目标测点的实时值与质量。
-
示例：
| Lua | |
|---|---|
提示
本函数自下位机软件版本≥1.3.26后，实时值精度从float升级为double。
更多例子参考取得、设置实时值。
| 质量值 | 说明 |
|---|---|
| 0 | 好 |
| 50 | 初始化中 |
| 100 | 坏 |
4.TxPacket¶
函数声明¶
| C | |
|---|---|
-
描述：
向”chnName”指定的通道，发送”packet”指定的报文。
-
参数：
szTagName:目标通道名称的字符串。Packet:要发送的报文。报文支持通配符，通配符如下：
报文通配符 说明 $year 系统年份的十位和个位 $mon 系统月份 $day 系统日期 $hour 系统小时 $min 系统分钟 $sec 系统秒值 $crc 对应通道所属协议的CRC校验字段 -
返回值：
无。
-
示例：
| Lua | |
|---|---|
5.GetDevTagValue¶
函数声明¶
| C | |
|---|---|
-
描述：
通过设备名称和测点描述(又称测点物模型标识)，得到一个测点的实时值。
-
参数：
szDevName:目标测点所在的设备名称的字符串；szTagDesc:目标测点的描述(又称测点物模型标识)的字符串。 -
返回值：
返回目标测点的实时值，如果失败，返回0。
-
示例：
| Lua | |
|---|---|
提示
请自行留意同一网关下设备名称不能重复，同一个设备下测点描述(又称测点物模型标识)也不能重复，它们区分大小写；
本函数要求下位机软件版本≥1.3.28。
更多例子参考取得、设置实时值。
6.SetDevTagValue¶
函数声明¶
| C | |
|---|---|
-
描述：
通过设备名称和测点描述(又称测点物模型标识)，向一个测点写入值。
-
参数：
szDevName:目标测点所在的设备名称的字符串；szTagDesc:目标测点的描述(又称测点物模型标识)的字符串；fValue:要写入的实时值。 -
返回值：
无。
-
示例：
| Lua | |
|---|---|
提示
请自行留意同一网关下设备名称不能重复，同一个设备下测点描述(又称测点物模型标识)也不能重复，它们区分大小写；
本函数要求下位机软件版本≥1.3.28。
更多例子参考取得、设置实时值。
7.SetTagValue2¶
函数声明¶
| C | |
|---|---|
-
描述：
目标测点的当前值与fValue不相等时，设置目标测点的实时值为fValue。
-
参数：
szTagName:目标测点名称的字符串；fValue:要写入的实时值。 -
返回值：
无。
-
示例：
| Lua | |
|---|---|
提示
本函数自下位机软件版本≥1.3.26后，实时值精度从float升级为double。
更多例子参考取得、设置实时值。
Ended: LUA公开函数
LUA使用范例 ↵
例1¶
| Lua | |
|---|---|
-
说明：
“直流电压1”是一个采集点，“直流电压2”是一个虚拟的计算点，上述脚本将采集到的值，赋值到了一个计算点里；如果有需要，还可以取得测点的质量，参照第3行，value3为“直流电压3”的实际值，qos3即为“直流电压3”这个采集点的质量。
质量值 说明 0 好 50 初始化中 100 坏
| Lua | |
|---|---|
-
说明：
“Psum”是一个采集点，总有功功率，“Ppv”是一个虚拟的计算点，直流功率，上述脚本将采集到的值，赋值到了一个计算点里；
本例和例1的应用场景不同，当设备数量较多，而测点名称没有规律时，宜采用本例的方式进行批量操作。
2.简单四则运算¶
例1¶
| Lua | |
|---|---|
-
说明：
取得三路支路的直流电流的值，累加后，赋值到计算点“总直流电流”中。
运算符 符号 相加运算符 + 相减运算符 - 相乘运算符 * 相除运算符 / 取余运算符 % 乘幂运算符 ^
3.循环四则运算¶
例1¶
| Lua | |
|---|---|
-
说明：
采集到了5台逆变器的输出功率，其测点名称分别为INV1_P、INV2_P、INV3_P、INV4_P和INV5_P，上述脚本将这5台逆变器的输出功率累加，并将结果赋值到中间测点“TotalPower”中。
4.条件判断¶
例1¶
| Lua | |
|---|---|
-
说明：
首先取得“水温”这个测点的实时值，然后判断其是否超过目标限值80，如果超过了，给计算点“高温报警”赋值1，否则赋值0。
运算符 符号 判断相等运算符 == 判断不等运算符 ~= 逻辑与运算符 and 逻辑或运算符 or 逻辑非运算符 not
5.复杂条件判断¶
例1¶
-
说明：
当使用“电压≤50认为设备断电”这个条件来判断设备是否断电时，存在一个情况：
就是当设备通讯中断时或网关刚上电尚未采集到数据时会产生误判，误将通讯中断的0或初始值0当做采集到的数值，从而产生错误的报警，使用上述脚本即可解决这个问题；
“通道1_设备1_TXZD”是一个通讯中断点，“通道1_设备1_DDBJ”是一个计算点，“通道1_设备1_Ua”是一个采集点，
脚本结合该设备的通讯状态和测点质量两个数据综合判断，解决误报问题。
6.随机数¶
例1¶
-
说明：
先置随机数种子，然后再取随机数；
上述脚本生成了19.80~20.09之间的随机数作为三相线电压的值，再经过计算赋值给相电压。
7.延时控制¶
例1¶
-
说明：
在进行分合闸控制时，要求先对继电器写1，延迟3秒后，写0，如此完成一次控制；
YK0为合闸实际点，YK1为分闸实际点，YK2为分合闸计算点(手动创建)，YK3为分合闸上一次的值计算点(手动创建)，上述脚本，接收到主站的分合闸控制命令以后，先对继电器写入1，然后进行3秒延迟，再对继电器写入0，完成一次控制。
8.方差、标准差、离散率¶
例1¶
-
说明：
有两个逆变器分别为device1和device2，要分别计算各自支路电流（其测点物模型标识分别为Ipv1、Ipv2...）的离散率，先调用calculate_average函数计算平均值，再调用calculate_standard_deviation函数计算标准差，然后将标准差除以平均值来计算离散率，最后将离散率写入到各自设备下物模型标识为result的计算点中。
-
附：
上述脚本中用到的自定义函数。
Ended: LUA使用范例
Python公开函数 ↵
0.函数一览¶
说明¶
智能网关集成的Python环境版本为3.11.5，含众多第三方库，下位机软件版本≥1.4.02后支持，需要额外安装Python环境后使用，
Python和网关内置程序通过ctypes交互，ctypes官方说明链接。
您可以：
1、使用python编写简单或复杂的计算、统计公式，将结果赋值到计算点中；
2、使用python编写PID控制、自适应控制、预测控制等闭环控制方法；
3、使用python个性化定制，开发自己的采集驱动与转发驱动，而不用等待研发开发；
4、使用vs code远程调试开发，精确定位代码bug；
5、使用python进行高级计算任务开发，例如矩阵计算、向量计算、线性代数计算、傅里叶变换、卷积、滤波、算法优化等。
部分源码¶
| Python | |
|---|---|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 | |
示例¶
1.py_load_so¶
函数声明¶
-
描述：
将C语言编译的动态链接库函数加载到Python中。
-
参数：
无。
-
返回值：
无。
-
示例：
2.global_init¶
函数声明¶
| C | |
|---|---|
-
描述：
使用动态库时，必须在c4py.py_load_so()函数之后就调用，C语言会进行一系列的初始化操作。
-
参数：
无。
-
返回值：
无。
-
示例：
3.global_release¶
函数声明¶
| C | |
|---|---|
-
描述：
使用动态库时，必须在程序退出时调用，尽管程序退出时系统会自动回收程序资源。
-
参数：
无。
-
返回值：
无。
-
示例：
4.clog_info¶
函数声明¶
| C | |
|---|---|
-
描述：
打印信息到日志文件中。
-
参数：
msg:要打印的信息字符串。 -
返回值：
无。
-
示例：
提示
必须调用py_load_so、global_init函数后，再调用clog_info，否则会导致程序崩溃。
5.get_tag_value¶
函数声明¶
| C | |
|---|---|
-
描述：
根据测点名称取出测点的实时值，请勿传入错误的测点名称，这将导致函数返回0。
-
参数：
tag_name:测点的名称。 -
返回值：
返回测点的实时值。
-
示例：
| Python | |
|---|---|
6.set_tag_value¶
函数声明¶
| C | |
|---|---|
-
描述：
根据测点名称写入测点的实时值。
-
参数：
tag_name:测点的名称；value:要写入的实时值。 -
返回值：
返回TRUE(值1)为成功，返回FALSE(值0)失败，找不到目标测点。
-
示例：
7.get_tag_desc¶
函数声明¶
| C | |
|---|---|
-
描述：
根据测点名称取出测点的物模型标识(测点描述)，请勿传入错误的测点名称，这将导致函数返回NULL。
-
参数：
tag_name:测点的名称。 -
返回值：
返回测点的物模型标识(测点描述)。
-
示例：
| Python | |
|---|---|
8.get_chl_param¶
函数声明¶
| C | |
|---|---|
-
描述：
根据通道名称，得到通道的配置。
-
参数：
chl_name:目标通道的名称；type:要得到的参数类型，1主参数，2备参数；p_param_info:用来接收数据的结构体指针，传入串口结构体(UartInfo)指针或者TCP结构体指针都可以。 -
返回值：
成功返回1，失败返回0。
提示
串口通道传入串口参数结构体，TCP通道传入TCP参数结构体。
- 示例1：
- 示例2：
9.get_dev_count¶
函数声明¶
| C | |
|---|---|
-
描述：
根据通道名称，取得目标通道下设备的数量。
-
参数：
chl_name:目标通道的名称。 -
返回值：
返回设备的数量。
-
示例：
| Python | |
|---|---|
10.get_dev_array¶
函数声明¶
| C | |
|---|---|
-
描述：
根据通道名称，取得目标通道下设备的信息。
-
参数：
chl_name:目标通道的名称。 -
返回值：
成功返回1，失败返回0。
-
示例：
提示
请勿传入空指针或长度过小的数组，否则会导致程序崩溃。
| Python | |
|---|---|
11.get_tag_count¶
函数声明¶
| C | |
|---|---|
-
描述：
根据设备名称，取得目标设备下测点的数量。
-
参数：
dev_name:目标设备的名称。 -
返回值：
返回测点的数量。
-
示例：
12.get_tag_array¶
函数声明¶
| C | |
|---|---|
-
描述：
根据设备名称，取得目标设备下测点的信息。
-
参数：
dev_name:目标设备的名称。 -
返回值：
成功返回1，失败返回0。
-
示例：
提示
请勿传入空指针或长度过小的数组，否则会导致程序崩溃。
13.set_chl_status¶
函数声明¶
| C | |
|---|---|
-
描述：
根据通道名称，设置通道的状态。
-
参数：
chl_name:目标通道的名称；status:要设置的状态。 -
返回值：
成功返回1，失败返回0。
-
示例：
| Python | |
|---|---|
-
参数说明：
名称 说明 c4py.RUN_STAT_INIT 正在初始化中，网关刚启动时的默认状态 c4py.RUN_STAT_NORMAL 正常工作状态 c4py.RUN_STAT_FAULT 异常状态 c4py.RUN_STAT_STOP 正常停止状态(例如其它进程打开了串口调试,那么本通道会临时暂停) c4py.RUN_STAT_UPDATE 正在升级中(本通道正在对下属子设备进行固件升级)
14.set_dev_status¶
函数声明¶
| C | |
|---|---|
-
描述：
根据设备名称，设置设备的状态。
-
参数：
dev_name:目标设备的名称；status:要设置的状态。 -
返回值：
成功返回1，失败返回0。
-
示例：
| Python | |
|---|---|
-
参数取值：
名称 说明 c4py.RUN_STAT_INIT 正在初始化中，网关刚启动时的默认状态 c4py.RUN_STAT_NORMAL 正常工作状态 c4py.RUN_STAT_FAULT 异常状态 c4py.RUN_STAT_STOP 正常停止状态(例如其它进程打开了串口调试,那么本设备所属的通道会临时暂停) c4py.RUN_STAT_UPDATE 正在升级中(本设备正在固件升级)
15.dset_tag_value1¶
函数声明¶
| C | |
|---|---|
-
描述：
根据设备名称+测点物模型标识，写入测点的实时值。
-
参数：
dev_name:目标设备的名称；tag_desc:目标测点的物模型标识；value:要写入的实时值。 -
返回值：
返回TRUE(值1)为成功，返回FALSE(值0)失败，找不到目标测点。
-
示例：
提示
使用该函数时应保证一个设备下测点的物模型标识唯一不重复。
16.dset_tag_value2¶
函数声明¶
| C | |
|---|---|
-
描述：
根据设备名称+测点寄存器地址，写入测点的实时值。
-
参数：
dev_name:目标设备的名称；tag_addr:目标测点的寄存器地址；value:要写入的实时值。 -
返回值：
返回TRUE(值1)为成功，返回FALSE(值0)失败，找不到目标测点。
-
示例：
提示
使用该函数时应保证一个设备下测点的寄存器地址唯一不重复。
17.dset_tag_qos1¶
函数声明¶
| C | |
|---|---|
-
描述：
根据设备名称+测点物模型标识，写入测点的质量戳。
-
参数：
dev_name:目标设备的名称；tag_desc:目标测点的物模型标识，可传空字符串，此时设置目标设备下所有的测点；qos:要写入的测点的质量；reset_value:是否清零测点的实时值，传1则清零。 -
返回值：
返回TRUE(值1)为成功，返回FALSE(值0)失败，找不到目标测点。
-
示例：
提示
使用该函数时应保证一个设备下测点的物模型标识唯一不重复。
-
qos参数取值：
名称 说明 c4py.TAG_QUALITY_GOOD 测点质量戳好 c4py.TAG_QUALITY_BAD 测点质量戳坏 c4py.TAG_QUALITY_SET 测点质量戳为人工置数 c4py.TAG_QUALITY_INVALID 测点质量戳无效,即没有初始化过
18.dset_tag_qos2¶
函数声明¶
| C | |
|---|---|
-
描述：
根据设备名称+测点寄存器地址，写入测点的质量戳。
-
参数：
dev_name:目标设备的名称；tag_addr:目标测点的寄存器地址，可传空字符串，此时设置目标设备下所有的测点；qos:要写入的测点的质量；reset_value:是否清零测点的实时值，传1则清零。 -
返回值：
返回TRUE(值1)为成功，返回FALSE(值0)失败，找不到目标测点。
-
示例：
提示
使用该函数时应保证一个设备下测点的寄存器地址唯一不重复。
-
qos参数取值：
名称 说明 c4py.TAG_QUALITY_GOOD 测点质量戳好 c4py.TAG_QUALITY_BAD 测点质量戳坏 c4py.TAG_QUALITY_SET 测点质量戳为人工置数 c4py.TAG_QUALITY_INVALID 测点质量戳无效,即没有初始化过
Ended: Python公开函数
Python使用范例 ↵
源码¶
-
说明：
使用ptvsd库来进行python远程调试，上位机IDE为Visual Studio Code，按F9将断点打在print所在行，安装完python插件后，按F5即可启动调试。
下面是vsCode的launch.json示例：
| JSON | |
|---|---|
2.响应程序退出消息¶
源码¶
3.实现modbusrtu采集¶
说明¶
举例现在有三个仪表需要采集，协议为modbusrtu协议，地址分别为1、2、3，功能码03，寄存器地址从0开始，数据类型为16位无符号；
接下来我们用python来实现数据的采集。
创建采集工程¶
- 新建通道：
首先我们需要创建一个采集通道，驱动选择python采集，通道类型选择串口，并配置相应的串口参数。
- 新建设备：
在刚刚的采集通道下，新建一个设备，设备名称自定义，通讯地址填1(对应仪表的通讯地址)。
- 新建测点：
在刚刚的采集设备下，新建5个采集测点(按需配置测点数量)，寄存器地址分别为3、5、7...，步长为2递增；
采集测点新建完后，我们将采集设备复制出来2份，通讯地址配置为2和3。
加载工程参数¶
取通道参数¶
使用get_chl_param函数，通过通道名称来获取通道的主参数，并使用serial库来设置串口参数，并打开目标串口，如下述片段所示：
提示
通过get_chl_param函数获取到的参数，需要经过转换，才可以被serial.Serial识别，建议根据实际情况在调用serial.Serial函数时直接将入参写死。
取设备参数¶
首先使用get_dev_count函数得到通道下的设备数量，然后创建相应数量的设备数组，再使用get_dev_array函数取得设备参数。
| Python | |
|---|---|
采集与解析¶
构造请求报文¶
通过设备的通讯地址、功能码、寄存器起始地址、测点个数，来构造请求报文，可以根据实际情况精简传入的参数；
然后通过ser.write函数写到目标串口去。
读取报文并解析¶
使用ser.read函数读取仪表返回到串口上的报文，然后对报文的合法性进行校验，例如长度校验、从站地址校验、CRC校验等，按需精简或者加入更多校验；
报文合法性校验通过以后，即可对报文中的数据解析，并置入目标测点。
打印出来的报文如下图：
其它优化¶
1、可以根据parse_read_buff函数的返回值，来设置设备的通讯状态。
| Python | |
|---|---|
2、出现异常时，可以设置测点的质量戳，也可以选择是否清零测点的实时值。
3、注册系统信号处理函数，来接收程序退出消息，以释放资源。
Serial参数说明¶
完整源码¶
| Python | |
|---|---|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 | |
4.实现modbustcp采集¶
说明¶
举例现在有三个仪表需要采集，协议为modbustcp协议，地址分别为1、2、3，功能码03，寄存器地址从0开始，数据类型为16位无符号；
接下来我们用python来实现数据的采集。
创建采集工程¶
- 新建通道：
首先我们需要创建一个采集通道，驱动选择python采集，通道类型选择tcp/ip，并配置相应的ip参数。
- 新建设备：
在刚刚的采集通道下，新建一个设备，设备名称自定义，通讯地址填1(对应仪表的通讯地址)。
- 新建测点：
在刚刚的采集设备下，新建5个采集测点(按需配置测点数量)，寄存器地址分别为3、5、7...，步长为2递增；
采集测点新建完后，我们将采集设备复制出来2份，通讯地址配置为2和3。
加载工程参数¶
取通道参数¶
使用get_chl_param函数，通过通道名称来获取通道的主参数，并打开目标端口，如下述片段所示：
提示
通过get_chl_param函数获取到参数，建议根据实际情况将IP_PORT参数写死。
取设备参数¶
首先使用get_dev_count函数得到通道下的设备数量，然后创建相应数量的设备数组，再使用get_dev_array函数取得设备参数。
| Python | |
|---|---|
采集与解析¶
构造请求报文¶
通过设备的tcp序号，通讯地址、功能码、寄存器起始地址、测点个数，来构造请求报文，可以根据实际情况精简传入的参数；
然后通过ser.write函数写到目标串口去。
读取报文并解析¶
使用ser.read函数读取仪表返回到串口上的报文，然后对报文的合法性进行校验，例如长度校验、从站地址校验、CRC校验等，按需精简或者加入更多校验；
报文合法性校验通过以后，即可对报文中的数据解析，并置入目标测点。
打印出来的报文如下图：
其它优化¶
1、可以根据parse_read_buff函数的返回值，来设置设备的通讯状态。
| Python | |
|---|---|
2、出现异常时，可以设置测点的质量戳，也可以选择是否清零测点的实时值。
3、注册系统信号处理函数，来接收程序退出消息，以释放资源。
tcp序号高低位参数说明¶
| Python | |
|---|---|
完整源码¶
| Python | |
|---|---|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 | |
5.实现mqtt转发¶
说明¶
举例现在有两个通道需要转发，协议为任意两个采集协议，转发为mqtt转发，功能码为实时数据。
接下来我们用python来实现数据的转发。
创建转发工程¶
提示
通过python转发将不再创建通道。但需在代码中配置IP，端口参数。
配置mqtt转发IP,PORT参数¶
使用paho-mqtt模块，使用mqtt_connect定义连接服务器参数。
提示
根据需要，自行按照mqttClient.tls_set()函数添加证书。添加证书后必须执行mqttClient.tls_insecure_set(True)语句。
加载工程参数¶
选择需转发的采集通道¶
创建一个列表，列表中输入需要转发的通道名称，要求字符串格式，并用逗号隔开。根据实际情况自行添加，示例为两个采集通道。如下述片段所示：
| Python | |
|---|---|
取设备参数¶
首先使用get_dev_count函数得到通道下的设备数量，然后创建相应数量的设备数组，再使用get_dev_array函数取得设备参数。
取测点参数¶
首先使用get_tag_count函数得到通道下的设备数量，然后创建相应数量的设备数组，再使用get_tag_array函数取得设备参数。
转发¶
构造转发报文¶
通过mqtt接口文档构造消息体。示例中需要的参数有"tp","sn","tm","chl_name","dev"。实际根据所用mqtt的数据格式自行修改。
用mqtt.fx连接服务器后订阅到的消息如下图：
其它优化¶
1、原本读取到的质量为好时值为0，质量坏时值为100。现改成好为1，坏为0.
| Python | |
|---|---|
2、注册系统信号处理函数，来接收程序退出消息，以释放资源。
完整源码¶
| Python | |
|---|---|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 | |
6.实现SQL server转发¶
说明¶
举例现在有两个通道需要转发，协议为任意两个采集协议，转发为SQL server转发。
接下来我们用python来实现数据的转发。
构造转发工程¶
提示
通过python转发将不再创建通道。但需在代码中配置服务器，端口，数据库，用户名以及密码参数。
配置SQL server转发参数¶
使用pymssql模块，使用pymssql.connect()函数连接服务器参数。服务器名称和数据库名称根据实际情况自行修改。
| Python | |
|---|---|
建表¶
连接数据库后创建表结构，实际表结构根据实际需求创建，示例如下述片段所示：
| Python | |
|---|---|
建表后，表结构如下图所示：
获取转发测点参数¶
取设备参数¶
首先使用get_dev_count函数得到通道下的设备数量，然后创建相应数量的设备数组，再使用get_dev_array函数取得设备参数。
取测点参数¶
首先使用get_tag_count函数得到通道下的设备数量，然后创建相应数量的设备数组，再使用get_tag_array函数取得设备参数。
转发¶
整理数据写入表中¶
根据创建表时的字段名获取相应的参数，并用sql语句插入数据。
转发成功后数据库表中数据如下图：
其它优化¶
1、注册系统信号处理函数，来接收程序退出消息，以释放资源。
2、可以根据需要自行添加定时任务，如定时删除数据等。只需增加一个线程即可。
完整源码¶
7.实现sqlite历史数据存储¶
说明¶
举例现在有两个通道两个设备需存储数据，协议为任意两个采集协议。
接下来我们用python来实现数据存储。
构造数据存储脚本¶
创建sqlite数据库并连接¶
使用python自带的sqlite3模块，使用sqlite3.connect()函数连接数据库。数据库名称根据需要自行修改。
提示
连接时一定要把check_same_thread参数设置为False。防止数据库执行操作时线程冲突
| Python | |
|---|---|
建表¶
连接数据库后创建表结构，示例中按设备名创建表，测点名为字段名。实际表结构根据实际需求创建，示例如下述片段所示：
建表后，表结构如下图所示：
获取转发测点参数¶
取设备参数¶
首先使用get_dev_count函数得到通道下的设备数量，然后创建相应数量的设备数组，再使用get_dev_array函数取得设备参数。
取测点参数¶
首先使用get_tag_count函数得到通道下的设备数量，然后创建相应数量的设备数组，再使用get_tag_array函数取得设备参数。
数据操作¶
数据写入¶
获取测点字段名和测点的值，一一对应分别放入两个列表。保证测点名与测点值对应。
存储成功后数据库表中数据如下图：
数据删除¶
清除过期的历史数据。sql_delete参数中，DATETIME()函数可以写入参数，'-1 day'为一天前，可以根据需要自行修改删除几天前的数据。
其它优化¶
系统信号处理¶
注册系统信号处理函数，来接收程序退出消息，以释放资源。
定时任务¶
示例中定每天00：30开始清理过期数据。运用schedule模块完成定时。具体代码如下：
| Python | |
|---|---|
多线程¶
数据存储和删除为两个线程。所以用threading模块定义两个线程。
主线程：
| Python | |
|---|---|
第二线程：
| Python | |
|---|---|
创建线程
| Python | |
|---|---|
完整源码¶
| Python | |
|---|---|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 | |
8.实现redis转发¶
说明¶
举例现在有两个通道两个设备需转发，协议为任意两个采集协议。
接下来我们用python来实现redis数据存储。
获取转发测点参数¶
取设备参数¶
首先使用get_dev_count函数得到通道下的设备数量，然后创建相应数量的设备数组，再使用get_dev_array函数取得设备参数。
取测点参数¶
首先使用get_tag_count函数得到通道下的设备数量，然后创建相应数量的设备数组，再使用get_tag_array函数取得设备参数。
构造转发数据¶
连接redis数据库¶
使用python的redis模块，使用redis.Redis()函数连接数据库。数据库名称根据需要自行修改。
| Python | |
|---|---|
构造转发数据¶
提示
redis是非关系型数据库，由key，value组成一个数据表。转发数据用hash格式写入。
设备名为表的key值：
hash格式表结构如下图所示：
数据操作¶
历史数据写入¶
获取测点名和测点值，整理数据后用字符串形式写入：
存储成功后数据库表中数据如下图：
其它优化¶
系统信号处理¶
注册系统信号处理函数，来接收程序退出消息，以释放资源。
完整源码¶
9.实现http转发¶
说明¶
举例现在有两个通道需要转发，协议为任意两个采集协议，转发为http转发。
接下来我们用python来实现数据的转发。
创建转发工程¶
提示
通过python转发将不再创建通道。但需在代码中配置IP，端口参数。
配置http转发IP,PORT参数¶
使用socket模块，定义连接服务器。
| Python | |
|---|---|
加载工程参数¶
选择需转发的采集通道¶
创建一个列表，列表中输入需要转发的通道名称，要求字符串格式，并用逗号隔开。根据实际情况自行添加，示例为两个采集通道。如下述片段所示：
| Python | |
|---|---|
取设备参数¶
首先使用get_dev_count函数得到通道下的设备数量，然后创建相应数量的设备数组，再使用get_dev_array函数取得设备参数。
取测点参数¶
首先使用get_tag_count函数得到通道下的设备数量，然后创建相应数量的设备数组，再使用get_tag_array函数取得设备参数。
转发¶
构造转发报文¶
集合通道设备测点信息构造json格式消息体，具体构造可按需求更改。
其它优化¶
1、原本读取到的质量为好时值为0，质量坏时值为100。现改成好为1，坏为0.
| Python | |
|---|---|
2、注册系统信号处理函数，来接收程序退出消息，以释放资源。
完整源码¶
Ended: Python使用范例
Ended: 二次开发
常见问题 ↵
云端问题 ↵
问题描述¶
添加网关时，提示网关编号和密码不匹配，或者提示已存在该记录。
排查解决¶
1)核对网关编号和密码¶
新增时，请核对网关周身贴的条形码上的编号与密码是否输入错误；
2)网关是否已经联网¶
如果编号和密码正确，那么请先插入SIM卡，并将网关上电，稍等3分钟左右待网关联网后，再次尝试添加；
提示数据库中已存在该记录时，请询问同事是否已经添加了该网关，网关只能被添加一次，可以删除后重新添加；
若问题仍旧得不到解决，请联系管理员。
2.下发命令超时¶
问题描述¶
无法配置和查看网关信息，或者无法查看实时数据，或者频繁上下线，网关的最后更新时间显示红色。
排查解决¶
1)网关是否联网¶
-
拨号上网
请确认网关是否插了SIM卡，SIM卡是否插反，SIM卡状态是否正常，是否有欠费、锁卡的情况；
请确认网关所在地，使用的SIM卡的所属运营商信号良好；
-
有线上网
2)是否正确设置ping参数¶
当网关使用拨号上网时，会定时通过ping命令来检测当前网络是否连通，当ping命令参数设置错误，就会导致明明网络正常，但是无法操作网关或网关频繁上下线，请参考云端无线配置或本地APN配置，设置正确的ping命令参数。
Ended: 云端问题
本地问题 ↵
问题描述¶
点击网关管理工具的刷新按钮，搜索不到网关。
排查解决¶
1)网关是否上电？¶
请接通网关的电源，并检查网关的PWR灯或者RUN灯是否闪烁或常亮。
2)网线是否正确连接？¶
请检查电脑的网卡配置是否有红叉，也可以右键单击网卡，先禁用、再启用目标网卡；
请检查网关网口处两盏小灯，黄灯是否常亮，绿灯是否闪烁。
请确认电脑和网关处于同一网络下，连接的是同一个路由器或者交换机，或者通过网线直连网关和电脑，
并且电脑的网卡配置了和网关相同网段(不同网段也可以搜索到，配置相同网段便于排查问题)的IP地址，通常情况下网关的默认IP地址为192.168.11.177，
配置正确时，能够使用电脑的ping命令ping通192.168.11.177。
提示
如果网关有多个网卡，那么从NET1(或eth0)开始，依次为192.168.11.177、192.168.12.177、192.168.13.177...
如果是x86的机架式管理机(例如6220A)，那么从NET1(或eth0)开始，依次为192.168.0.177、192.168.1.177、192.168.2.177...
4)防火墙是否关闭？¶
如果能ping通网关，但是仍旧无法搜索到网关，那么请关闭系统防火墙后再试。
5)电脑是否有多个网卡？¶
当电脑有2个或以上的网卡时，请配置与网关相连的网卡的自动跃点数为10后再试(跃点数越小，优先级越大)。
6)使用添加网关功能¶
如果还是无法搜索到网关，请点击添加按钮，输入网关的默认IP地址后点击确定，选中刚刚添加的IP，点击基本信息按钮，尝试获取网关信息。
7)重置网关IP¶
如果仍旧无法添加网关，那么在网关上电状态下，找到网关周身的Reset键，用取卡针短按(单击)Reset键，即可将网关的IP地址临时重置为默认的192.168.11.177；
长按Reset键5秒以上，然后松开，即可恢复出厂设置，此时网关会清除原有的一切配置，并自动重启，也可以恢复默认IP。
提示
短按功能需要网关出厂时间在2021-10-26后支持，长按功能需要网关出厂时间在2021-05-01后支持；
Reset键(重置键)通常在网关(导轨式)的上方，标记为Reset或RST等，机架式管理机无Reset键。
2.软件无法运行¶
问题描述¶
双击桌面快捷方式，没有任何反应，软件无法运行。
排查解决¶
1)JAVA环境是否安装¶
软件依赖JAVA环境运行，打开cmd命令行窗口，输入java -version命令，查看是否输出版本号，如果JAVA环境出现异常，请参考运行环境。
2)系统禁用了脚本的执行¶
旧有的快捷方式是通过bat批处理命令执行的，有些系统可能无法正常运行批处理文件，
此时请右键单击桌面旧有的快捷方式->打开文件位置，在新弹出的文件夹窗口中直接双击后缀为.jar的文件，若能够正常打开，则删除旧有的快捷方式，右键.jar文件发送到桌面快捷方式，后续通过新创建的快捷方式打开即可。
如果双击.jar文件是以压缩包的形式打开的，那么右键.jar文件，属性->打开方式，更改为java后再试。
3)非windows系统¶
MAC系统可以直接双击.jar文件运行，
其它linux系统使用命令行java -jar ./PBoxMgrTool.jar运行。
Ended: 本地问题
Ended: 常见问题
版本发布 ↵
更新日志¶
V1.4.18¶
-
发布日期
网关软件已于2024-11-04发布新版本，版本号V1.4.18。
-
新增改动
1、x86机型新增Python远程调试支持；
2、增加在云平台下发工程失败时，发送错误原因的功能；
-
错误修复
1、修复"实时监视工具"在配置某些协议的采集时，不显示实时值的问题(1.4.10≤受影响版本≤1.4.16)；
2、修复双机冗余功能下，待机网关切换到采集状态时，不显示实时值的问题；
3、修复在云平台出现的网关能上线，但无法操控的问题；
4、优化json相关驱动的数值上传时，出现的精度问题；
5、修复x86机型配置DNS失效的问题。
V1.4.16¶
-
发布日期
网关软件已于2024-09-27发布新版本，版本号V1.4.16。
-
新增改动
1、本地监视软件显示的小数点位数限制为6位；
2、群调增加指令补发功能；
3、增加正泰逆变器可升级的子设备类型；
4、公式计算时间粒度从1秒改成10ms；
-
错误修复
1、修复Pbox8628,PBox6117,PBox6140时区配置不生效的问题；
2、修复Pbox6220A/B有线网卡设置为DHCP时，DNS配置不生效的问题；
3、修复Pbox6140H不支持NTP对时的问题；
4、修复在特定场景下写值会导致采集卡死的问题；
5、修复VPN因服务器配置修导致的连不上的问题；
6、修复部分x86机型因系统版本过旧导致的动态库依赖问题。
V1.4.12¶
-
发布日期
网关软件已于2024-08-10发布新版本，版本号V1.4.12。
-
新增改动
1、本地监视增加测点时间戳读取功能；
2、modbus采集协议增加IV曲线扫描支持；
3、新增若干驱动；
4、公式计算测点上限增加到512个;
5、新增CAN接口类型;
6、新增数据类型:24位整形。
7、磁盘容量超过1G的日志文件上限增加到4M。
-
错误修复
1、驱动类bug修复；
2、修复本地监视软件通道监测卡顿、以及报文重复发送的问题；
3、修复群调时逆变器剔除算法的错误；
4、针对5G模组RG200U的拨号流程进行了优化；
5、拨号网络探测去掉了自动填充的探测测试目标。
-
其它说明
警告
x86架构的管理机，出货时间为2022年及以前的(网关编号开头四位数为年份)，请勿升级到此版本，应当选择最新版本升级;
如果您不知道如何判断的，请勿升级或请联系我们的工程师处理。
V1.4.10¶
-
发布日期
网关软件已于2024-07-01发布新版本，版本号V1.4.10。
-
新增改动
1、增加子设备升级功能；
2、拨号增加对ec600k的支持；
3、新增若干驱动；
4、逆变器群调增加出力弱逆变器剔除功能;
5、支持syslog、snmp、agent探针采集与网安管理平台接入;
6、完善对国密SM2算法的支持。
-
错误修复
1、驱动类bug修复；
2、cfgserver在某些型号下NTP对时周期错误的问题；
3、修复在广播群调且多个采集通道时，会遗漏掉某些通道的前置写处理的问题；
4、字符串类型表达时计算增加质量码的处理；
5、优化goose协议栈，解决处理首次接收的指令慢的问题。
-
其它说明
警告
x86架构的管理机，出货时间为2022年及以前的(网关编号开头四位数为年份)，请勿升级到此版本，应当选择最新版本升级;
如果您不知道如何判断的，请勿升级或请联系我们的工程师处理。
V1.4.08¶
-
发布日期
网关软件已于2024-04-30发布新版本，版本号V1.4.08。
-
新增改动
1、日志打印去掉文件路径；
2、增加白名单设置功能；
3、新增若干驱动；
-
错误修复
1、驱动类bug修复；
2、修复Pbox6218E模组复位问题；
3、修复备用通道参数不生效时依然被使用的问题；
4、修复测点开启数值转换时写值处理的错误；
-
其它说明
1、 cfgserver优化掉多余日志打印。
V1.4.06¶
-
发布日期
网关软件已于2024-03-01发布新版本，版本号V1.4.06。
-
新增改动
1、新增AGC/AVC调节功能(部分高性能型号支持)；
2、新增若干驱动；
3、精简部分低性能型号的升级包与出厂包；
4、新增保存升级固件操作记录；
5、新增5G多合一终端型号，支持流量转发配置，适配调度加密104转发；
-
错误修复
1、驱动类bug修复；
2、修复隐藏的wifi无法连接的问题；
3、修正网页取反配置不生效；
-
其它说明
无。
V1.4.02¶
-
发布日期
网关软件已于2023-11-01发布新版本，版本号V1.4.02。
-
新增改动
1、支持OpenSSL3.0，取消对旧版本的OpenSSL的支持；
2、支持python远程编程功能(部分高性能型号支持)；
3、支持扩展插件下载；
4、新增若干驱动；
5、支持部署到docker了；
6、优化对群控群调功能的支持；
7、新增5G拨号时可切换5G优先、5G-SA优先、5G-NSA优先模式了；
-
错误修复
1、驱动类bug修复。
-
其它说明
1、今后(2023-11-01)将不再主动维护1.3.xx版本的驱动了，如需体验最新功能，请升级到1.4.02及以上；
2、现在所有型号的设备打开串口会以TIOCGRS485方式打开了。
V1.3.66¶
-
发布日期
网关软件已于2023-07-14发布新版本，版本号V1.3.66。
-
新增改动
1、新增海德汉CNC采集、兄弟CNC采集、CAN采集、涂鸦OS、SQL Server转发等通讯协议；
2、完善公式计算功能；
3、1120E型号新增进入故障模式；
4、优化modbusrtu采集，写值后读取返回值的调度逻辑；
5、dlt645-2007协议，支持读取历史了；
6、E文件生成与解析的后缀从.DT改为.txt了，以适配南瑞的反向隔离；
-
错误修复
1、修复8628型号串口调试手动发报文乱码；
2、修正工程中存在无效通道或设备，在查看实时数据时，通道和设备的状态会显示异常。
V1.3.58¶
-
发布日期
网关软件已于2023-04-21发布新版本，版本号V1.3.58。
-
新增改动
1、新增若干通讯协议；
2、公式计算支持混合运算了；
3、和远MQTT(新)新增告警触发方式；
4、本地配置时，支持二进制读写文件了；
5、优化群控群调功能；
6、本地配置时新增网安模式；
-
错误修复
1、修正104转发协议在不联网的情况下偶发的不响应数据；
2、修正配置了某些驱动的情况下，下发工程自动升级驱动时，总是升级失败；
V1.3.56¶
-
发布日期
网关软件已于2023-02-14发布新版本，版本号V1.3.56。
-
新增改动
1、新增若干通讯协议；
2、优化了两个网关之间双机冗余的功能，现在支持两个网关配置相同的业务IP了；
3、积分模块清零逻辑优化；
4、新增群控群调功能，目前仅本地配置软件可配置；
5、本地软件命令行调试新增打开、关闭风险端口支持；
6、电表2007协议支持监听模式了；
7、表达式功能新增对求余计算%的支持；
8、iec61850现在支持人工置数了；
-
错误修复
1、修正LS型号与x86机器停止应用的脚本调用失败导致重启网关的时间过长；
2、修正json打印时保留小数位数函数遇到极小值的科学计数法时处理错误；
3、修正低性能网关检测sqlite历史存储空间时过于宽松导致磁盘存满；
V1.3.52¶
-
发布日期
网关软件已于2022-11-29发布新版本，版本号V1.3.52。
-
新增改动
1、新增若干通讯协议；
2、新增了两个网关之间双机冗余的功能，在其中一个网关异常时另一个网关可以启动工作；
3、一网两串设备新增兼容LORA版本；
4、新增新型号3568硬件适配；
5、网关最近重启操作功能优化断电描述，"断电重启"->"外部断电"；
6、E文件传输协议支持遥控遥调的选择、执行命令了；
7、本地通道监测新增当自己做tcp server时单独查看某一client报文的功能；
8、现在在使用本地配置软件时，可以对质量戳为bad的测点进行人工置数了；
9、61850系列采集驱动功能完善；
-
错误修复
1、修正x86架构的机器下发工程时总是升级驱动，即使驱动是最新版本；
2、修正x86架构的机器在104转发点数超过1W点数时，发送变位数据的情况下响应总召唤出错的bug；
3、修正西门子200PPI协议浮点值写值异常的bug；
4、修正华云104登录超时计算错误；
5、modbus监听协议现在能区分功能码了；
V1.3.48¶
-
发布日期
网关软件已于2022-09-19发布新版本，版本号V1.3.48。
-
新增改动
1、x86架构设备支持iec61850相关协议了；
2、新增1120A型号软件适配；
3、modbus监听增加0x10功能码解析；
4、新增珠海格力驱动转发；
5、104采集增加遥测变化超限过滤；
6、新耀新增大功率逆变器上传；
7、优化三菱PLC扩展串口、欧姆龙PLC串口通信协议；
8、新增DNP3.0网络协议；
9、新增其它若干私有协议；
10、当计算点质量为bad时，也会断电存储了；
11、云端远程维护进程改为多线程处理了；
-
错误修复
1、修正涂鸦MQTT转发，写值格式不对；
2、修正串口CDT转发异常，以太网CDT采集异常；
3、修正新耀MQTT转发，系数处理了两次；
4、修正带wifi型号的设备重启应用无效；
5、优化磁盘统计算法；
6、修复本地配置软件总是无法增量升级驱动的bug(受影响版本:1.3.46)；
7、修正低性能网关无法读取日志的bug(1.3.40≤受影响版本≤1.3.46)；
-
其它说明
1、今后(2022-08-08)出厂的设备，支持链路层LLDP设备发现协议了，上位机(windows)如需使用此功能，需要安装npcap驱动，驱动下载链接；
2、现在所有型号的设备打开串口会以TIOCGRS485方式打开了。
V1.3.46¶
-
发布日期
网关软件已于2022-07-16发布新版本，版本号V1.3.46。
-
新增改动
1、x86架构设备支持iec61850相关协议了；
2、本地配置软件配置时，下位机默认自带出厂密码(abc123)了，没有密码无法下载和监视工程；
3、正泰物联MQTT支持服务器下发读底下子设备某个测点；
4、万能采集协议增加监听固定报文头处理；
5、新增若干协议；
-
错误修复
1、修正CSC2000转发，变位遥信未处理扩展地址；
2、修正有线上网、拨号上网同时存在时，DNS探测偶然出现的是否联网的误判；
3、深瑞103错误修复；
4、修复正向隔离TCP采集协议，质量戳无效；
5、数能物联MQTT错误修复；
V1.3.44¶
-
发布日期
网关软件已于2022-05-18发布新版本，版本号V1.3.44。
-
新增改动
1、通讯中断点可以取反了，将系数改为-1即可；
2、适配csc2000转发地址＞255的情况；
3、计算点、表达式支持测点名称为中文了，现在可以做BOOL类型运算了；
4、现在开关量点可以取反了；
5、处理了2007电表回复的报文中无效值的情况；
6、新增医苑两个采集协议；
7、本地配置时新增工程密码功能；
-
错误修复
1、修正断电重启偶尔未被记录；
2、修正本地配置软件下发工程总是升级驱动的问题；
V1.3.42¶
-
发布日期
网关软件已于2022-04-28发布新版本，版本号V1.3.42。
-
新增改动
1、longshine协议新增环境记录仪上传；
2、新增串口CDT转发、以太网CDT转发；
3、新增陀曼MQTT；
4、新增新耀MQTT；
-
错误修复
1、修正拨号时偶尔出现的AT指令异常，导致首次拨不上号；
警告
自版本号1.3.40(含)后，云端升级包均为精简包，从低版本(≤1.3.38)升级上来的，在升级完成重新上线后，需要手动下发一次工程。
V1.3.40¶
-
发布日期
网关软件已于2022-03-21发布新版本，版本号V1.3.40。
-
新增改动
1、新增驱动增量升级的模式；
2、新增电工所http驱动；
3、新增树根互联3.0MQTT写值；
4、新增锦浪科技MQTT；
5、新增网口桥接功能；
-
错误修复
1、修正钉电云上传PCS设备数据错位；
2、修正goose双点信息错误；
3、修正华云104历史数据存储时间戳溢出；
-
其它说明
由于驱动数量越来越多，导致升级包趋于臃肿，而大多数驱动实际根本用不到，从此版本(1.3.40)开始，发布的云端升级包均为精简包，精简包内仅含如下驱动：
104主站采集(IEC)、104从站转发(IEC)、南瑞103采集、南自103采集、串口103采集、MODBUS-RTU采集、MODBUS-RTU转发、MODBUS-TCP采集、MODBUS-TCP转发、DLT645-1997、DLT645-2007、DLT698.45-2017、钉电云上传协议、华云104从站转发、阿里云IoT、通用MQTT转发、LongShine上传协议、三水智能MQTT、裕乾电子tcjh-202109、树根互联4.0MQTT、万能采集协议、济中能源http转发、济中能源MQTT转发；
不在上述列表中的驱动，仍旧可以正常配置与使用，云端在工程下发时，会自动将所需驱动一起打包下发(此功能在≥1.3.40版本支持)；
或者参照升级指南->增量升级进行操作。
警告
升级前(版本号≤1.3.36)，请务必使用df(查看网关磁盘占用)功能，确认rootfs的Avail剩余大小≥22M，再进行升级，否则请联系管理员进行升级。
V1.3.36¶
-
发布日期
网关软件已于2022-02-19发布新版本，版本号V1.3.36。
-
新增改动
1、驱动新增版本控制；
2、完善发那科CNC采集；
3、VPN功能现在允许配置开机自动运行了；
4、modbusrtu和tcp支持64位整型采集了；
5、取消了开启串口流控；
6、现在所有型号都默认不会开启代理了，节省流量；
7、modbustcp转发支持自定义客户端空闲时长了；
8、新增公共建筑能耗监测-温州；
9、完善串口CDT采集；
10、新增济中能源webservice采集；
11、新增华云信通MQTT；
-
错误修复
1、修复modbus监听协议异常；
2、修复串口103遥控异常，非连续变位SOE解析异常；
3、修复光伏扶贫上传协议历史数据过多时上传异常；
4、修正西门子PLC采集偶发的CPU过高；
-
已知问题
无。
-
其它说明
无。
V1.3.34¶
-
发布日期
网关软件已于2022-01-13发布新版本，版本号V1.3.34。
-
新增改动
1、DLT645-2007电表控制分合闸支持自定义功能码；
2、新增公共建筑能耗监测(温州)驱动；
3、新增厦门宇电AIBUS驱动；
4、涂鸦智能MQTT更新为Link SDK2.0版本；
-
错误修复
1、修复部分MQTT转发在替换测点名称前缀时失败；
2、ftp_slave改进了文件名获取；
-
已知问题
1、当下位机设置了默认网关，上位机和该网关不在同一网段，使用本地配置软件搜索不到；
2、modbus监听协议无法使用，请升级1.3.34的补丁包1.3.35以解决此问题；
-
其它说明
无。
V1.3.32¶
-
发布日期
网关软件已于2021-12-21发布新版本，版本号V1.3.32。
-
新增改动
1、完善许继串口103采集；
2、修复通用MQTT转发写值无效；
3、新耀longshine上传协议，新增自定义虚拟mac地址；
4、和远mqtt(新)新增告警相关功能；
5、csc2000规约新增2字节地址解析；
-
错误修复
1、修复modbustcp和modbusrtu转发浮点数失效；
2、修复许继104经常断开时CPU过高；
3、修复济中能源http转发整点上传异常；
4、修复通用MQTT转发写值无效；
5、修复modbusrtu和modbustcp采集，写值时精度丢失；
-
已知问题
1、部分MQTT转发驱动在替换测点名称前缀时，替换失败；
-
其它说明
无。
V1.3.30¶
-
发布日期
网关软件已于2021-11-30发布新版本，版本号V1.3.30。
-
新增改动
1、使罗克韦尔(AB PLC)的采集驱动的规约特征生效；
2、修复济中能源http上传开启历史续传后可能存在的内存泄漏；
3、新增SQL Server采集；
4、系统点新增网关CPU负载百分比和已用内存；
-
错误修复
1、修复modbustcp和modbusrtu转发大值(超10亿)时精度丢失；
2、修复华云104断连后重连失败；
3、修复从DHCP切换到静态IP时，静态IP设置需要重启生效的问题；
-
已知问题
1、modbusrtu和modbustcp读字符串会出现乱码，将在下一版本修复；
2、modbusrtu和modbustcp的遥信量采集，数据类型错误的选择为16位有/无符号、32位有/无符号时，会导致LUA脚本GetTagValue函数取不到值，将遥信量数据类型改为位即可；
3、modbusrtu和modbustcp用单精度浮点数转发，值总是为0；
-
其它说明
无。
V1.3.28¶
-
发布日期
网关软件已于2021-11-16发布新版本，版本号V1.3.28。
-
新增改动
1、现在联通MQTT可以上传多个设备了；
2、中自光伏云新增上传时间段控制；
3、新增恒创MQTT；
4、LUA新增根据设备名称和物模型标识读写测点数据；
5、gdb3000将功率改成了有符号数；
6、天信流量计增加CPU卡流量计协议；
-
错误修复
1、修复数能mqtt转发，sysId相关处理错误；
2、修复本地软件监测时，设备数量过多导致监测失败；
-
已知问题
1、以太网103采集，从站断开连接时采集会假死，请升级到1.3.28版本后，再升级1.3.28的补丁(补丁版本号1.3.29)以修复此问题；
2、带有历史存储功能的mqtt转发协议，在开启了历史存储后，当转发测点数量过多(1000点以上)且需要上传历史时会出现CPU异常偏高的情况，请升级到1.3.28版本后，再升级1.3.28的补丁(补丁版本号1.3.29)以修复此问题；
-
其它说明
1、本次以及今后的升级包中，型号为1120-4G的设备重新添加了天信流量计协议；
2、型号为ASDU-LS、1121A-4G的1.3.29版本为完整包。
V1.3.26¶
-
发布日期
网关软件已于2021-11-05发布新版本，版本号V1.3.26。
-
新增改动
1、新增罗克韦尔(AB)PLC的DF1串口采集协议；
2、现在四方csc2000采集，可以配置LON网地址了；
3、新增ftp文件转发协议；
4、正泰物联mqtt转发中，响应召读单个设备的测点；
5、数能物联MQTT转发的dev字段取值从设备名称改为设备描述了，现在会存储sysId字段了；
6、华云104现在支持断网补传了，优化了断线检测；
7、433无线模块驱动现在能解析加密报文了；
8、钉电云上传驱动新增多个设备的上传；
9、新增济中能源MQTT以及HTTP断网补传功能；
-
错误修复
1、修复modbusrtu和modbustcp协议，设备通讯中断点显示不正确；
2、修复计算点使用表达式时偶尔跳0的问题；
3、修复四方csc2000采集多个组的遥脉量时串数据的问题；
-
已知问题
1、104主站采集，仅首次启动会总召唤，后续不总召，请升级到1.3.26版本后，再升级1.3.26的补丁(补丁版本号1.3.27)以修复此问题；
2、南瑞103采集，双点遥信类型204解析错误，请升级到1.3.26版本后，再升级1.3.26的补丁(补丁版本号1.3.27)以修复此问题；
3、数能mqtt，召唤历史数据时，版本号错误，sysId未传；
V1.3.24¶
-
发布日期
网关软件已于2021-10-26发布新版本，版本号V1.3.24。
-
新增改动
1、完善西门子200PPI协议；
2、新增数能物联mqtt；
3、完善华云104转发协议；
4、modbus-rtu和tcp支持双精度浮点数(double)类型采集；
5、双4G型号新增休眠配置；
6、新增BACnetIP采集驱动；
7、使树根互联4.0MQTT、百度blink协议、和远mqtt协议转发系数生效；
8、三水智能mqtt支持选择物模型转发了；
-
错误修复
1、修复正泰物联MQTT写值错误；
2、修复三菱Q协议读数据测点分组错误；
3、远程维护进程的心跳周期从3分钟改到6分钟了；
4、修复罗克韦尔(AB)PLC读数据测点分组错误；
5、修复telnet测试时填写域名无效；
6、修复偶尔出现的DNS获取异常；
-
已知问题
1、modbusrtu和modbustcp协议，设备通讯中断点在云端查看时不生效，仅仅显示的有问题，实际该点的状态是正确的；
2、出现计算点使用表达式计算时，值偶尔跳0的情况，使用lua脚本则不会有这个问题，有用到表达式功能的请升级新版本或改为使用lua脚本计算；
3、四方csc2000采集多个组的遥脉量时，出现串数据的情况；
4、104主站采集，仅首次启动会总召唤，后续不总召；
5、南瑞103采集，双点遥信类型204解析错误；
-
其它说明
1、本次以及今后的升级包中，暂时移除了长期不用或使用较少的驱动，如果在旧版本中有用到下述驱动的，请勿升级，或联系管理员以获取完整包。
提示
下述未列出的型号与驱动，默认驱动全部可用。
-
所有型号移除了如下驱动：
济中能源http转发V4.0、MPPT控制器(爱庞德)、电池BMS系统(富邦成)、麦杰HTTP采集、昊美数据上传、中自水务MQTT、MODBUS-RTU(安华源转发)、复变时空MQTT转发、晶熠ENERGYCC协议、晶熠数据上传、PES微机保护(普尔盾)、塑壳断路器、XPH气象站、榆林能耗MQTT、公共建筑能耗监测(成都)、mysql转发协议；
-
1120-4G、1121-4G在版本号1.3.08(不含)以后移除了如下驱动：
IEC61850客户端、IEC61850服务器、Goose转发、E文件解析协议、E文件生成协议、串口101(无锡凯杰)、串口101转发、威远102采集、南瑞103采集、NZB系列103采集、以太网103采集、103采集、金智103采集、南自103采集、以太网103转发、安轩光伏清扫机器人、CDT7采集(正泰自动化)、BMS通讯协议-2019、BMS通讯协议-2020、188B瑞泉电子水表、四方CSC2000采集、四方CSC2000转发、鼎控MQTT、沣泰MQTT、正向隔离TCP转发(Client)、正向隔离TCP采集(Server)、方竹MQTT、杭电数据上传、涂鸦智能MQTT、超声波局放仪、RedSolar云平台、GDB3000、HJ212-2017(转发)、HZG-7120、金风MQTT(亚马逊)、科华UPS、领祺HTTP采集、济中能源http转发、科诺伟业http转发、天信流量计、万马MQTT、振华电气MQTT、SUNTREE-50KTL、环境数采、LUX-MODBUS、能源管理MODBUS、OPC_UA(Client)、OPC_UA(Server)、休普433无线模块；
2、6217-4G在此版本及以后默认不开启代理以节省流量；
3、今后(2021-10-26)出厂带reset复位键的设备，支持单击临时恢复IP了(192.168.11.177)。
-
升级指南¶
远程升级¶
通过云端配置升级，请参考升级软件进行操作；
升级过程视升级包大小不同，越大等待时间越长，重新上线的时间也越长，通常需要3分钟左右，部分型号≥5分钟。
本地升级¶
通过本地配置升级，请参考固件升级进行操作；
如果网关通过拨号上网，那么条件允许时，建议使用本地升级，不消耗网关本身流量；
升级过程视升级包大小不同，越大等待时间越长，通常需要3分钟左右，部分型号≥5分钟，升级过程中建议在电脑端CMD使用ping [网关ip地址] -t命令，来测试是否升级完成。
增量升级¶
云端在工程下发时，会自动将需要但是没有的驱动文件一起打包下发，已经存在的驱动如需升级也会一并下发，此功能在≥1.3.40版本支持；
本地的驱动增量升级功能同云端一致，这需要依赖电脑的网络，如果调试时没有网络的，可以预先准备完整包或者驱动升级包，它们是带ioserver_bin字样的压缩包，使用本地配置软件的下装功能，选择目标升级包，下装后重启网关，即升级成功；
固件(软件)升级包下载见设备云平台左侧菜单版本管理->版本列表，选择目标网关型号进行下载；
驱动升级包下载见设备云平台左侧菜单版本管理->驱动管理，勾选自己用到的驱动进行下载；
或者在下方进行型号搜索然后跳转：
提示
自动跳转的主版本默认为4，适配网关软件版本为1.4.xx，若网关软件版本为1.3.xx的请自行修改主版本为3。
Ended: 版本发布
导出PDF ↵
导出PDF¶
说明¶
-
导出单页文档内容，请在单页操作；
-
导出全部文档内容，点击此处访问全量网页，注意，网页非常大，请耐心等待加载完成，建议在有线网络环境下通过电脑访问；
谷歌Chrome浏览器、微软Edge浏览器¶
- 右键浏览器页面->打印->另存为PDF，保存到本地。
火狐Firefox浏览器¶
- 右上角菜单，打印->另存为PDF，保存到本地。
Ended: 导出PDF
关于文档 ↵
关于¶
作者¶
@xusl、@sundh、@zhangh、@qinb、@chenyz、@qiujj、@zengc、@dujx、@fangxy。
非常感谢各位对本文档做出的贡献。
构建¶
本文档由MkDocs构建。
License¶
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.