Hot-Connect — 组管理 (可选从站)
Hot-Connect (热连接) 允许从站在主站运行期间动态接入或离线, 主站启动时不强求所有从站全部在线。常用于工具更换、模块化设备、可拆卸单元、维护停机等场景。
本能力符合 ETG.1000.4 Hot-Connect 标准。
功能概览
| 能力 | 说明 |
|---|---|
| 可选从站 | 从站不在线也能让主站正常进入 OP, 到位即自动加入 |
| 分组管理 | 同一组内的从站使用相同的别名 (Alias) 与 Vendor/Product 模板, 便于位置无关识别 |
| 状态实时刷新 | GUI 实时显示组当前是 Present (在线) / Absent (离线) / Unknown (未知) |
| 热插拔事件 | 从站接入或离线时主站发出事件, GUI 与 SDK 同时通知 |
快速开始
- 在主界面打开 Hot-Connect Tab
- 顶部开关 启用 Hot-Connect 模式 打开
- 扫描总线, GUI 把识别到的可热拔从站建议归入新组; 也可以手工创建空组、再把从站拖入
- 在组列表中填写每组的 Alias / Vendor / Product / Revision / 期望位置
- 启动主站, 离线的可选组在拓扑视图中以虚线占位框显示, 主站正常进入 OP
- 现场接入从站后, GUI 状态列从 Absent 变为 Present, 拓扑实线高亮

组列表字段
| 字段 | 含义 |
|---|---|
| Group ID | 组编号, 自动递增, 唯一标识一个可选组 |
| Alias | 组别名 (Configured Station Alias), 用于位置无关识别同型号从站 |
| Vendor ID | 模板厂商 ID, 用于校验接入从站是否匹配 |
| Product Code | 模板产品码, 配合 Vendor ID 双重校验 |
| Revision | 模板修订号 (可选), 留空表示不校验 |
| 期望位置 | 该组在拓扑中的预期插入点 (上游从站编号 / 端口号) |
| 状态 | Present / Absent / Unknown |

操作:
- 新增组 — 工具栏 + 新增组, 弹出对话框填写后即时生效
- 从扫描结果建组 — 拓扑视图右键某个从站, 选择 加入新建 Hot-Connect 组, 工具自动用该从站的 Vendor/Product/Alias 填充模板
- 修改组 — 双击组行进入编辑对话框, 修改后立即生效
- 删除组 / 清空所有组 — 工具栏 删除 / 清空 按钮, 删除前会弹出二次确认
注意: Alias 通过从站本体的 EEPROM 写入, 请先用 写 Alias 工具把目标从站的 EEPROM 别名设置好, 再在组里引用同一个值。
实时查看组状态
启用 Hot-Connect 后, 组列表的 状态 列实时刷新:
| 状态 | 含义 | 显示颜色 |
|---|---|---|
| Present | 组对应的从站当前在线, PDO 数据正常 | 绿色 |
| Absent | 组对应的从站当前不在线, 主站继续运行其他从站 | 灰色 |
| Unknown | 主站尚未完成首次扫描或接入校验 | 黄色 |

切换到 拓扑视图, 离线的可选组以虚线占位框显示在期望位置; 在线时实线高亮。
热插拔事件订阅
GUI 的 Hot-Connect 事件 面板按时间顺序记录每次接入 / 离线事件:
| 字段 | 说明 |
|---|---|
| 时间 | 事件发生时刻 (ms 级) |
| 组 ID | 触发事件的组 |
| 事件类型 | Joined (接入) / Left (离线) / MismatchRejected (校验不通过被拒绝) |
| 从站位置 | 实际接入位置 |
| 备注 | 校验失败时记录原因 (Vendor 不匹配 / Product 不匹配 / Alias 不匹配) |
事件支持: 按组 / 事件类型筛选, 导出 CSV 供事后追溯, 清空当前会话事件历史。
典型场景
| 场景 | 用法 |
|---|---|
| 工具更换 — 末端执行器 (夹爪 / 焊枪) 更换 | 把末端执行器整组加入 Hot-Connect 组, 更换工具时主站不停机 |
| 模块化设备 — 不同站位插入可选模块 | 每个可选模块定义为独立组, 按订单配置上线 |
| 维护停机 — 单个从站离线送修 | 临时把对应从站归组, 离线送修期间主站继续运行其他设备 |
| 总线扩展 — 现场后期追加从站 | 预留 Hot-Connect 组, 新设备到货后接入即自动识别 |
与导出代码的关系
Hot-Connect 组配置随 详细信息 Excel 导出, 包含组列表、模板字段、期望位置等, 便于现场布线、设备入网与运维核对。
代码导出层面, Hot-Connect 是 运行期 能力, 主程序无需为可选组写额外初始化代码 — 只要主站启用 Hot-Connect 模式, 配置就会随工程文件一同加载并生效。
标准引用
本功能遵循 ETG.1000.4 Hot-Connect 行为模型, 包括可选从站 (Optional Slave) 的定义与跳过策略、接入校验 (Identification Check) 流程、主站状态机在接入 / 离线时的过渡。详细规范请参考 ETG 官方文档。