协议选择
这是添加新 PLC / 设备连接的协议选择器屏幕。点击卡片后，将跳转到对应协议的注册表单。
通过首页卡片连接协议 → 点击，或直接访问 /ui/connect/connect。
关于按标签注册的流程 / 开始前的准备工作，请参阅新增 PLC 连接。本页面专注于应选择哪个协议卡片的决策。
1. 屏幕组成
연결할 PLC 또는 프로토콜을 선택하십시오. [← 목록] [📥 CSV 일괄 업로드]
┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐
│ LS 로고 │ │MITSUBISHI│ │ SIEMENS │ │ROCKWELL │
│ LS [XGT]│ │ [MC] │ │ [S7] │ │ [LOGIX] │
└─────────┘ └─────────┘ └─────────┘ └─────────┘
... (총 20 카드, 4 컬럼 그리드) ...
右上角按钮：
| 按钮 | 操作 |
|---|---|
| ← | 转到 /ui/connect/list （连接列表） |
| 📥 CSV 批量上传 | 转到 /ui/connect/csv — 通过 CSV 一次性注册多个 PLC / 标签 |
2. 卡片列表（44 种）
下表是 PLC 类型 → 协议 → 网关内部代码 的映射。同时显示点击每个卡片后跳转的表单 URL。
2.1 韩国 / 日本 PLC
| 卡片 | 协议 | 网关代码 | 表单 URL | 指南 |
|---|---|---|---|---|
| LS [XGT] | LS XGT FEnet | LS | /ui/connect/ls | LS 产电 |
| MITSUBISHI [MELSEC] | MELSEC MC Protocol (Q/L/iQ-R) | MELSEC | /ui/connect/melsec | 三菱 MELSEC |
| OMRON [FINS] | OMRON FINS | FINS | /ui/connect/fins | （待定） |
| PANASONIC [MEWTOCOL] | Panasonic FP MEWTOCOL | MEWTOCOL | /ui/connect/mewtocol | （待定） |
| FATEK | FATEK FACON | FATEK | /ui/connect/fatek | （待定） |
2.2 全球 PLC
| 卡片 | 协议 | 网关代码 | 表单 URL | 指南 |
|---|---|---|---|---|
| SIEMENS [S7] | Siemens S7comm | S7 | /ui/connect/s7 | 西门子 S7 |
| ROCKWELL [LOGIX] | Rockwell ControlLogix CIP | LOGIX | /ui/connect/logix | （参考 EIP 指南） |
| ALLEN BRADLEY [AB-ETH] | AB Micro 800 / SLC500 / PLC5 | AB-ETH | /ui/connect/ab-eth | （待定） |
| GE [SRTP] | GE Fanuc SRTP | GE | /ui/connect/ge | （待定） |
| EMERSON [DELTA-V] | Emerson DeltaV | DELTAV | /ui/connect/deltav | （待定） |
| TwinCAT [ADS] | Beckhoff TwinCAT ADS | ADS | /ui/connect/ads | （待定） |
2.3 工业标准协议
| 卡片 | 协议 | 网关代码 | 表单 URL | 指南 |
|---|---|---|---|---|
| OPC-UA | OPC-UA (Eclipse Milo) | OPCUA | /ui/connect/opcua | OPC-UA |
| MODBUS/TCP | Modbus TCP | MODBUS | /ui/connect/modbus | Modbus TCP |
| ETHERNET/IP | Allen-Bradley EtherNet/IP CIP | EIP | /ui/connect/eip | AB EtherNet/IP |
| PROFINET | Siemens Profinet IO | PROFINET | /ui/connect/profinet | （待定 / 未支持） |
| CAN | CANopen | CANOPEN | /ui/connect/canopen | （待定 / 未支持） |
| BACnet/IP | BACnet/IP (楼宇) | BACNET | /ui/connect/bacnet | （待定 / 未支持） |
| KNXnet/IP | KNX/IP (楼宇) | KNXNET | /ui/connect/knxnet | （待定 / 未支持） |
| Open Protocol | Atlas Copco Open Protocol (拧紧扭矩) | OP | /ui/connect/op | （待定） |
2.4 非 PLC 数据源
| 卡片 | 协议 | 网关代码 | 表单 URL | 指南 |
|---|---|---|---|---|
| HTTP | HTTP push (外部发送) | HTTP | /ui/connect/http | HTTP 推送 |
| MOTOR SENSE | Motor Sense (经由 OPC-UA，隐藏) | MOTOR_SENSE | /ui/connect/motor-sense | 电机传感 |
部分卡片旁标注了 （待定 / 未支持） ，表示界面存在但驱动实现为 占位符 或依赖外部 (PROFINET / BACnet / CAN / KNX 等)。经 PoC 阶段后正式支持时，会补充指南页面。
3. 应选择哪个卡片 — 决策指南
步骤 1: PLC 制造商 / 型号是什么？
韩国·日本工业现场：通常是 LS / 三菱 / 欧姆龙 / 松下 / 台达 — 在上述 2.1 节 中直接选择。
全球 / 进口 PLC：在上述 2.2 节 中选择。
步骤 2: 如果找不到对应的卡片
如果 PLC 提供自己的 OPC-UA 服务器，则选择 OPC-UA 卡片 — 通过 Kepware / Ignition / 自有 OPC 服务器连接的所有 PLC 均可集成。
如果 PLC 支持 Modbus 主/从模式，则选择 MODBUS/TCP 卡片。
步骤 3: 非 PLC 数据源
| 场景 | 卡片 |
|---|---|
| 外部系统通过 HTTP 向我们推送 | HTTP |
| 电机振动/温度传感器 | MOTOR SENSE |
| 装配线拧紧（如电动螺丝刀等）扭矩 / 次数 | Open Protocol |
| 楼宇自动化（HVAC / 照明） | BACnet/IP 或 KNXnet/IP |
| 无 PLC 的环境（测试 / 演示） | 外部 plantpulse-simulator 或测试标签 |
4. 点击卡片后 — 注册表单
每个卡片 → 跳转到协议专属专用表单。表单由公共部分 + 协议特定选项组成：
公共（所有协议）
| 字段 | 含义 |
|---|---|
| OPC ID | 唯一标识符（例如：OPC_LS_01） |
| OPC 名称 | 用户自定义显示名称 |
| 描述 | 自由备注 |
| 站点 ID | 从 app.properties 的 site.id 自动填充 |
| PLC IP / 端口 | TCP 连接地址 |
| 采集周期 | ms（默认 1000） |
| 自动启动 | 勾选后开机自动开始采集 |
| 异步 | 勾选后读取异步（推荐用于大量 PLC） |
协议特定附加选项
详细选项请参考 PLC 类型指南 中的各页面。
5. CSV 批量上传（替代路径）
当 PLC 数量较多（50+ 标签）或想要导入外部工具（Excel）中定义的标签表时，请使用 CSV 批量上传。
[📥 CSV 일괄 업로드] → /ui/connect/csv
CSV 컬럼 순서: tag_id, tag_name, plc_address, data_type, format, fomula, description
(헤더 첫 줄 필수)
流程是：事先单独注册 OPC，然后通过 CSV 批量添加该 OPC 内的标签。请参阅 标签注册。
6. 常见陷阱
| 症状 | 原因 / 解决方法 |
|---|---|
| 点击的卡片表单显示 404 | 该协议可能为 待定 / 未支持 — 仅有 JSP 而后端控制器为空。请联系运营团队 |
| 同一个 PLC 注册了两个卡片 | 如果 OPC ID 重复，第二次注册会覆盖第一次。OPC ID 必须唯一 |
| CSV 上传后 标签数为 0 | 列顺序 / 表头缺失 / 编码（无 UTF-8 BOM）。请参阅标签注册 中的 CSV 部分 |
| 卡片网格中部分 Logo 显示异常 | 静态资源缓存。使用 Ctrl+Shift+R 强制刷新 |
| MOTOR SENSE 卡片不可见 | 通过 JSP 的 display:none 隐藏（除专用站点外不使用）。可直接访问 URL /ui/connect/motor-sense |
7. 了解更多
- 注册流程（开始前准备 + 分步）：新增 PLC 连接
- 标签注册 / CSV 上传：标签注册
- 注册后监控：连接列表 / 标签列表
- 各 PLC 的选项 / 地址格式：PLC 类型指南