辰控智能WITLINE云组态设备迁移
1 前言
1.1 编写目的
为规范 WITLINE 云组态存量工程跨设备迁移作业，避免用户重复配置 PLC 采集变量、重复绘制组态监控画面，标准化采集配置一键复制 + 组态终端更换绑定两步迁移流程，参照华为设备配置迁移文档结构，统一操作、校验、故障处理规范，降低设备换新、硬件故障替换的工程工时。
1.2 适用范围
1. 硬件：全系列 WITLINE远程云网关
2. 软件平台：辰控 WITLINE 云端组态平台 V5.0 及以上版本
3. 应用场景：旧网关硬件损坏换新、产线设备改造更换远程模块、项目复制复用现有组态工程
4. 迁移内容：PLC 采集变量清单（寄存器地址、数据类型、读写属性、报警配置）+ 整套组态监控画面、数据联动逻辑。
1.3 名词术语定义
名词 | 释义 |
旧设备 ID | 原已组态完成、带成熟采集与画面的远程网关平台唯一 ID |
旧设备 KEY | 原设备鉴权密钥（采集导入必填参数） |
新设备 | 需要迁入组态配置的全新 WITLINE 远程网关（WITLINE-XBOX/CLOUD-BOX） |
导入表单 | 平台采集配置一键复制功能，将源设备全量采集点位同步至目标新设备 |
更改绑定 | 组态工程解除原有旧终端绑定，重新关联新设备，组态画面自动沿用原有变量标签 |
1.4 安全操作注意事项
⚠️ 重要须知
1. 迁移作业优先在旧设备保持在线状态下操作，保证配置数据完整读取；旧设备已离线仅可迁移云端已存配置，实时参数无法同步。
2. 设备 KEY 属于私密鉴权参数，禁止对外泄露，迁移完成后可按需重置旧设备密钥。
3. 生产设备迁移完成后，务必空载试运行 10min，确认点位采集、画面联动无误后再投入正式生产。
4. 批量多组态共用一台设备场景，逐个执行【更改绑定】，不可一次性批量替换多工程。
2 迁移整体方案概述
2.1 迁移实现原理
WITLINE 平台组态画面仅绑定虚拟变量 ID，不绑定硬件设备实体，因此仅需完成两层替换：
① 采集层：新设备复制旧设备全部 PLC 采集点位配置（M/Q/DB 寄存器、数据类型、报警、存储规则）；
② 组态层：原有组态工程从绑定旧硬件，改为绑定新硬件，画面控件、动画、联动逻辑全部沿用无需修改。
2.2 两步迁移总览
步骤序号 | 工作内容 | 对应页面 |
第一步 | 新设备导入旧设备采集表单（复制全部采集变量） | 设备管理→新设备→采集配置→导入表单 |
第二步 | 原有组态工程更改终端绑定，替换为新设备 | 组态管理→目标组态→关联终端→更改绑定 |
3 第一步：新设备一键导入旧设备采集变量配置（采集配置复制）
第一步：操作对应图图片：设备管理 - 导入表单弹窗 |
3.1 前置准备条件
1. 新 WITLINE-XBOX 网关上电联网，在【设备管理】列表中显示在线；
2. 提前从原旧设备【设备信息】页面，记录 2 项关键参数：目标设备ID（旧设备ID）、目标设备KEY（旧设备密钥）；
3. 旧设备在线优先，离线状态仅能同步云端已归档配置。
3.2 表单导入分步操作
1. 左侧【设备管理】列表，选中需要迁入配置的新设备（WITLINE-XBOX），点击右侧【采集配置】标签页；
2. 在采集配置界面顶部功能栏，点击绿色按钮【导入表单】，弹出「导入表单」弹窗；
3. 弹窗参数填写：
￮ *目标设备ID：填入原有旧设备的平台 ID（数据源设备 ID）
￮ *目标设备KEY：填入原有旧设备的设备密钥 KEY
说明：表单功能逻辑：从填写的旧设备拷贝全量采集配置到当前选中的新设备 |
4. 参数核对无误，点击弹窗右下角【保存】，平台自动后台同步全量采集变量；
5. 等待同步完成后，弹窗关闭，点击采集配置页面【热更新推送】，下发配置至新远程网关。
3.3 导入生效校验
1. 在新设备【采集配置 - 配置变量】列表，核对变量数量、PLC 寄存器地址、数据类型与旧设备完全一致；
2. 切换【实时数据】标签页，查看点位数值正常刷新，代表采集配置导入生效。
4 第二步：组态工程更改终端绑定（组态画面关联新设备）
第二步：操作对应图片：组态管理 - 关联终端 - 更改绑定弹窗 |
4.1 组态绑定前置说明
本步骤实现：原有整套组态画面（如示例【污水处理】组态）解绑旧硬件，挂载新设备，组态画面所有控件、动画、脚本逻辑无需修改任何内容。
4.2 组态更改绑定分步配置
1. 顶部切换标签至【组态管理】，在左侧组态目录，选中需要迁移的目标组态工程（示例：污水处理组态）；
2. 右侧功能区点击右上角【关联终端】按钮，进入设备绑定列表页面；
3. 绑定列表横向拖动滚动条至最右侧，找到原绑定旧设备条目后的【更改绑定】按钮并点击，弹出「更换采集终端」弹窗；
4. 弹窗参数逐项配置：
￮ *设备备注：自定义备注（如：污水处理_新 XBOX 网关，方便台账区分）
￮ 设备类型：下拉默认选择【官方设备】（WITLINE 原厂网关固定选型）
￮ 设备分组：按需选择项目所属分组（产线 / 站点分类）
￮ *设备名称：下拉菜单选中第一步已导入配置的全新在线设备（WITLINE-XBOX）
5. 全部参数填写完成，点击弹窗【保存】，系统自动解除旧设备绑定、组态切换绑定至新设备。
4.3 组态在线校验
1. 保存绑定后刷新组态页面，【关联终端】列表内原条目设备 ID 替换为新设备 ID；
2. 打开【组态编辑器】，预览运行组态画面，画面点位数据正常采集刷新。
5 迁移后全流程联调验证
5.1 三级校验规范
1. 网关采集校验：新设备【实时数据】页，全部 PLC 点位数值和原旧设备数值一致；
2. 组态画面校验：在线预览组态，开关、数值控件实时跟随 PLC 数据变化；
3. 控制写值校验：组态画面下发开关指令，PLC 寄存器同步变化，远程读写功能正常。
5.2 收尾操作
1. 确认全量点位无误后，可下线报废原有故障旧设备；
2. 如需安全管控，在原设备后台重置设备 KEY，防止密钥遗留风险。
6 故障排查指南（华为标准格式：故障现象→根因→处理方案）
序号 | 故障现象 | 故障根因 | 处理方案 |
1 | 导入表单保存提示鉴权错误 | 旧设备 ID/KEY 填写错误、密钥已重置 | 返回旧设备信息页重新复制 ID 和 KEY，核对字符无空格 |
2 | 导入成功但新设备实时数据全为空 | 1. 新设备离线；2. 未点击热更新推送下发配置；3.PLC 地址不匹配 | 1. 检查新网关 4G / 网线联网；2. 执行热更新推送；3. 核对新设备 PLC 通讯 IP 同现场 PLC 网段 |
3 | 更改绑定后组态无数据 | 组态绑定选错设备、新设备采集未生效 | 重新进入更改绑定，下拉选中正确在线新设备，重复第一步热更新 |
4 | 导入表单变量缺失部分点位 | 源旧设备离线，云端未归档最新采集配置 | 将旧设备临时上电联网，重新执行导入表单 |
7 附录
附录 A 关键参数说明
1. 设备 ID：平台分配设备唯一编码，设备信息页面查看；
2. 设备 KEY：设备专属密钥，仅设备详情页可见，迁移完成建议妥善保管；
3. 热更新推送：配置下发指令，新设备导入配置后必点，配置从云端同步至硬件网关。
