目录
1. 前言
2. 产品与 OPC 通讯方案概述
3. 前期环境准备与设备入网校验
4. WITLINE 客户端 OPC 项目创建配置(OPC-DA/OPC-UA 双协议)
5. WITLINE OPC Server 客户端部署与登录配置
6. 组态王对接 OPC 服务详细配置步骤
7. PLC 变量地址映射规范(M/Q/DB 区)
8. 在线联调与数据验证
9. 常见故障排查指南
10. 附录(参数附表、错误码清单、兼容组态软件清单、版本履历)
第 1 章 前言
1.1 编写目的
本文档标准化说明WITLINE CLOUD-BOX 云远程模块通过 OPC DA/OPC-UA 协议对接第三方组态软件(组态王为主,兼容力控、MCGS、Kepware 等)全流程操作规范,统一配置逻辑、参数定义、异常处理标准,解决远程跨网 PLC 数据上组态软件需求,替代传统现场网线直连 PLC 方案,实现公网远程穿透采集控制。
1.2 适用范围
1. 硬件产品:辰控智能云组态远程网关 (对接西门子 S7-1200 PLC)
2. 配套软件:WITLINE 云组态客户端 V5.0 及以上、Tranlink.OPC.DA/OPC-UA 服务程序、组态王 6.55/7.5 版本
3. 通讯协议:OPC DA(COM 传统 OPC)、OPC UA(IEC62541 标准化协议)
4. 应用场景:工厂异地多站点 PLC 集中上 SCADA、MES 对接设备数据、远程运维数据监控。
1.3 术语与缩略语定义(首次出现标注全称)
术语全称 | 缩写 | 释义说明 |
OLE for Process Data(过程数据对象链接嵌入) | OPC DA | 传统 COM 架构 OPC 协议,Windows 组态主流对接协议 |
OPC Unified Architecture(OPC 统一架构) | OPC UA | 跨平台标准化工业 OPC 协议,支持跨 Windows/Linux 系统访问 |
CLOUD-BOX | 云远程模块 | 辰控 WITLINE 系列远程穿透网关,实现 PLC 数据上云转发 OPC |
AppID | 项目应用编号 | WITLINE 平台 OPC 项目唯一身份标识,OPC 客户端登录鉴权参数 |
ProjectKey | 项目密钥 | OPC 项目加密密钥,与 AppID 配对校验,禁止明文外泄 |
SN 码 | 设备序列号 | 单台 CLOUD-BOX 硬件唯一编码,绑定云平台终端 |
1.4 安全须知
⚠️ 注意事项
1. 项目密钥(ProjectKey)属于设备私密鉴权参数,禁止对外泄露,密钥泄露需在 WITLINE 后台重置 OPC 项目;
2. OPC 服务部署 PC 建议关闭不必要端口,生产环境 OPC-UA 开启账号密码鉴权;
3. PLC 关键控制点(输出 Q 区)启用 OPC 写权限前,务必现场确认设备安全,避免误触发设备动作。
第 2 章 产品与 OPC 通讯方案概述
2.1 WITLINE CLOUD-BOX 产品简介
WITLINE 云远程模块(CLOUD-BOX)通过以太网对接现场 S7-1200 PLC,将 PLC 内部M 中间寄存器、Q 输出寄存器、DB 数据块数据加密上传至辰控 WITLINE 云端;WITLINE 客户端从云端拉取终端变量数据,内置 OPC 项目管理功能,导出 OPC 服务鉴权信息,配套独立 OPC Server 程序对外提供 OPC DA/UA 数据服务,第三方组态软件通过标准 OPC 协议读取 / 下发 PLC 变量数据。
2.2 OPC 整体组网架构
现场S7-1200PLC ↔ 网线 ↔ WITLINE CLOUD-BOX网关 → 4G/以太网公网上云 ↔ WITLINE云端服务器 ↔ WITLINE本地客户端 ↔ OPC Server服务端 ↔ 本地PC组态王
2.3 OPC 协议能力清单
1. OPC-DA:适配组态王、力控、Kepware 等传统 Windows 组态软件,支持 Bool 离散量、Int 整型、Real 浮点型变量读写;
2. OPC-UA:支持跨系统(Windows/Linux)客户端接入,兼容 MES、Python 客户端、工业大数据平台;
3. 单 OPC 项目支持绑定多台 CLOUD-BOX 终端,集中汇总数十~数百路 PLC 点位统一对外 OPC 发布;
4. 变量修改热更新:WITLINE 客户端新增 / 修改变量后,支持热推送刷新 OPC 地址空间,无需重启模块。
2.4 已预置 PLC 点位对照表(S7-1200 示例)
序号 | 变量名称 | PLC 物理地址 | 数据类型 | 读写属性 | 对应 OPC 标签地址 |
1 | 启动 | M30.1 | Bool(0/1) | 读写 | 786482813979f66d.1 |
2 | 输出 | Q0.1 | Bool(0/1) | 只读 | 786482813979f66d.2 |
3 | 启动 2 | M30.2 | Bool(0/1) | 读写 | 786482813979f66d.3 |
4 | 输出 2 | Q0.2 | Bool(0/1) | 只读 | 786482813979f66d.4 |
5 | 启动运算 | M30.3 | Bool(0/1) | 读写 | 786482813979f66d.5 |
6 | 浮点数 1 | DB1.0 | Real (32 位浮点) | 读写 | 786482813979f66d.6 |
7 | 浮点数 2 | DB1.8 | Real (32 位浮点) | 读写 | 786482813979f66d.7 |
8 | 浮点结果 | DB1.12 | Real (32 位浮点) | 读写 | 786482813979f66d.8 |
9 | 整数 1 | DB1.20 | Int16 (16 位整型) | 读写 | 786482813979f66d.9 |
10 | 整数 2 | DB1.24 | Int16 (16 位整型) | 读写 | 786482813979f66d.10 |
备注:项目最多支持 221 个自定义变量,OPC 标签地址由系统自动生成。 |
第 3 章 前期环境准备与设备入网校验
3.1 硬件前置校验
1. CLOUD-BOX 远程模块上电,网口与 S7-1200 PLC 以太网口正常接线,PLC 网口 IP 与模块内网 IP 同网段;
2. CLOUD-BOX 接入 4G / 有线宽带,设备指示灯在线,WITLINE 云端平台查询终端 SN(707D95025)状态为【在线】;
3. PLC 取消 DB 块【优化的块访问】,保证 DB1.0、DB1.8 等偏移地址寻址有效(浮点读取异常高频诱因)。
3.2 WITLINE 客户端软件校验
1. PC 安装 WITLINE 云组态客户端,登录企业账号,在【终端监控】界面可实时读取全部 PLC 变量数值;
2. 变量变更规则:WITLINE 客户端新增、修改 PLC 绑定变量后,二选一生效:① 点击【变量热更新推送】;② 重启 CLOUD-BOX 远程模块,OPC 地址空间同步刷新。
3.3 OPC 服务部署 PC 环境要求
配置项 | 最低配置 | 推荐配置 |
操作系统 | Win7 SP1 64 位 | Win10/WinServer2019 64 位 |
.NET 环境 | .NET Framework4.6.2 | .NET Framework4.8(OPC-DA 运行依赖) |
组态软件 | 组态王 6.53 | 组态王 7.5 |
网络 | PC 可访问外网(OPC 服务鉴权需联网校验云端) | PC 稳定公网 / 局域网 |
3.4 安装 OPC 服务端程序
解压 OPC 安装包,目录核心运行文件清单:
文件名 | 用途 |
Tranlink.OPC.DA.exe | OPC-DA 服务主程序(组态王对接核心) |
Tranlink.OPC.DA.dll | OPC 服务底层驱动 |
WtOPCSvr.dll | OPC 通讯动态链接库 |
System.Text.Json.dll | 鉴权报文解析依赖库 |
第 4 章 WITLINE 客户端 OPC 项目创建配置
4.1 新建 OPC 项目操作步骤
1. 打开 WITLINE 客户端,左侧菜单栏进入【OPC 项目管理】→【新建 OPC 项目】;
2. 填写项目参数:
○ 项目名称:自定义(示例:测试)
○ 项目描述:按需备注项目站点(示例:产线 1 远程采集)
3. 保存项目,系统自动生成AppID、项目密钥(ProjectKey),妥善记录(OPC 客户端登录必填);
示例参数:AppID=2024051317194600010;项目密钥 = ISBLL2F70DAAXKQDN47DLQ8H40XAG8 |
4. 进入【关联终端】页面,点击【添加终端】,通过 SN 码 / 虚拟 ID 绑定目标 CLOUD-BOX(示例 SN:707D95025,虚拟 ID:786482813979f66d);
5. 支持多终端添加:同一 OPC 项目批量绑定多台 CLOUD-BOX 网关,实现多站点 PLC 数据汇总 OPC 发布;
6. 绑定完成后点击【刷新变量】,系统自动同步该终端下全部已配置 PLC 变量至 OPC 变量清单;
7. 按需勾选【下载 OPC-DA 配置】【下载 OPC-UA 配置】,云端同步 OPC 项目参数。
4.2 OPC 变量管理
在【数据表单】页查看全量变量:设备 ID、标签名称、PLC 地址、数据类型、读写权限,可单独禁用某变量 OPC 发布权限(用于安全管控)。
第 5 章 WITLINE OPC Server 客户端部署与登录配置
5.1 启动 OPC 服务程序
双击Tranlink.OPC.DA.exe启动 OPC 服务主程序,进入登录界面。
5.2 OPC 服务鉴权登录
1. 录入从 WITLINE 客户端 OPC 项目页面获取的AppID、项目密钥;
2. 点击【连接登录】,页面状态栏显示【连接中】= 云端鉴权成功、OPC 服务就绪;
3. 登录成功后界面关键信息说明:
字段 | 示例值 | 说明 |
设备 ID | QBYBED7GW... | 绑定的 CLOUD-BOX 标识 |
云平台状态 | 连接中 | 云端通讯正常 |
变量总数 | 221 | 当前 OPC 发布变量数量 |
运行时长 | 0 天 00 时 XX 分 | OPC 服务在线时长 |
OPC 连接数 | 0 | 已接入组态客户端数量 |
⚠️ 登录失败排查:核对 AppID / 密钥、PC 外网连通性、WITLINE 项目未被禁用。 |
5.3 OPC-UA 额外配置(如需跨平台对接)
1. 在 OPC 服务软件切换【OPC-UA 配置】标签;
2. 自定义 UA 服务端口(默认 opc.tcp://[127.0.0.1:4840/WITLINE](127.0.0.1:4840/WITLINE)_OPC);
3. 启用账号密码认证,配置访问用户名 / 密码,保存后重启 OPC 服务生效。
第 6 章 组态王对接 OPC 服务详细配置步骤(以组态王 KingView 为例)
6.1 组态王新建 OPC 通讯驱动
1. 打开组态王工程管理器,新建 / 打开目标工程,进入【设备】→【新建】;
2. 驱动分类选择:OPC 服务器 → CloudOPC 服务器 → 确定,生成 OPC 通讯链路;
3. 设备命名(示例:VM-02\Cloud.OPC.Server),OPC 服务节点默认本机 [127.0.0.1](127.0.0.1)。
6.2 组态王 IO 变量创建(分离散 Bool、整型 Int、浮点 Real 三类)
6.2.1 离散型变量(Q0.2,输出点位,Bool)
1. 进入【数据词典→新建变量】,参数配置:
○ 变量名:Q02;变量类型:I/O 离散;连接设备:VM-02\Cloud.OPC.Server;
○ 寄存器:填写 OPC 标签地址786482813979f66d.4;采集频率:1000ms;
○ 数据类型:Bit;读写属性:按需勾选只读 / 读写;
2. 初始值、最大最小值默认,保存变量。
6.2.2 16 位整型变量(DB1.20,整数 1,Int16)
1. 新建 I/O 实型 / 整型变量,寄存器:786482813979f66d.9;
2. 数据类型:Short (16 位整型),匹配 PLC DB1.20 数据格式。
6.2.3 32 位浮点变量(DB1.0,浮点数 1,Real)
1. 新建 I/O 实型变量,寄存器:786482813979f66d.6;
2. 数据类型:Float(32 位浮点)。
规则:OPC 标签地址严格与 WITLINE 客户端【数据表单】标签一一对应,地址填写错误无法采集数据。 |
6.3 组态画面绑定变量
1. 新建组态监控画面,添加【文本控件】;
2. 控件右键【动画连接】:
○ 离散点位 (Q02/M30.1):勾选离散值输入、离散值输出,关联变量 Q02;配置表达式真 = 打开、假 = 关闭;
○ 浮点 / 整型点位 (DB1.0/DB1.20):勾选模拟值输入、模拟值输出,绑定对应实型变量;
3. 保存画面。
6.4 工程运行
点击组态王【运行系统】,启动工程,查看画面变量实时刷新数值。
第 7 章 PLC 变量地址映射规范
7.1 PLC 分区 OPC 映射规则
1. M 区(中间存储区,Bit):M30.X → Bool 型,OPC 只下发 0/1;
2. Q 区(输出线圈,Bit):Q0.X → Bool 型,多数现场配置只读,防止 OPC 误写输出;
3. DB 数据块
○ DB1.X(X=0/8/12):S7 Real (4 字节浮点,保留 3 位小数),组态王选用 Float;
○ DB1.X(X=20/24):S7 Int16 (2 字节有符号整数),组态王选用 Short;
7.2 新增变量扩展规则
1. WITLINE 客户端新增 PLC 变量→刷新变量→热更新推送;
2. OPC 服务自动识别新标签,组态王仅需新建对应寄存器变量,无需修改 OPC 服务与项目配置。
第 8 章 在线联调与数据验证
8.1 三层数据校验
1. 第一层:WITLINE 客户端:终端监控查看变量实时值(基准数据源);
2. 第二层:OPC 服务软件:OPC 内置变量监控面板查看点位数值;
3. 第三层:组态王运行画面:对比前两层数据,数值一致 = 通讯正常。
8.2 写值测试(仅读写权限点位)
1. 组态画面手动修改 M30.1(启动)数值 1→确认;
2. WITLINE 客户端 + PLC 程序内对应 M30.1 状态同步变为 1,写通讯链路正常。
第 9 章 常见故障排查指南(华为文档标准格式:故障现象→原因→处理方案)
序号 | 故障现象 | 故障根因 | 处理方案 |
1 | OPC 客户端登录提示鉴权失败 (401) | 1.AppID/ 密钥填写错误;2.WITLINE 后台 OPC 项目被删除 / 禁用;3.PC 无法访问外网 | 1. 重新从 WITLINE 客户端复制项目鉴权参数;2. 后台重建 OPC 项目;3. 排查 PC 网络,放行外网出站 |
2 | OPC 显示在线,组态王变量全部为 0 不刷新 | 1.WITLINE 终端离线;2.PLC DB 块开启优化块访问;3.OPC 标签地址填写错误 | 1. 检查 CLOUD-BOX 供电、联网;2.PLC 取消 DB 优化访问;3. 对照数据表单核对寄存器地址 |
3 | 组态王只读点位可读取,写点位无法下发 PLC | 1.OPC 变量后台被设置只读;2.PLC 程序内部逻辑强制赋值覆盖 OPC 写入值 | 1.WITLINE 数据表单修改变量读写属性;2. 检查 PLC 梯形图,解除寄存器强制赋值 |
4 | 新增变量后 OPC 无法搜到新标签 | 未执行变量热更新推送,OPC 地址空间未刷新 | WITLINE 客户端执行【热更新推送】或重启远程 CLOUD-BOX 模块,重启 OPC 服务 |
5 | OPC 服务启动报错缺少 dll 文件 | 缺少.NET 运行环境 / 依赖库缺失 | 安装.NET Framework4.8,重新解压完整 OPC 安装包 |
第 10 章 附录
附录 A:OPC 全量错误码表
错误编码 | 故障描述 | 解决措施 |
E001 | 项目鉴权信息错误 | 核对 AppID、ProjectKey,后台重置密钥 |
E002 | 终端设备离线 | 排查 CLOUD-BOX 硬件与网络 |
E003 | 变量 ID 不存在 | OPC 标签地址错误,核对数据表单 |
E004 | 云端服务异常 | 联系辰控技术支持排查平台服务 |
附录 B:兼容第三方组态软件清单
组态王、力控 FC、MCGS 昆仑通态、Intouch、Kepware、亚控 KingSCADA。






