协议选择界面 (/ui/connect/connect) — 44 个卡片
这是用于添加新 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，hidden） | MOTOR_SENSE | /ui/connect/motor-sense | 电机传感 |
部分卡片旁标注 （计划中 / 未支持） 的，表示 UI 已存在但驱动实现仍为 placeholder 或依赖外部组件（PROFINET / BACnet / CAN / KNX 等）。经过 PoC 阶段并正式支持后，将补充相应指南页面。
3. 该选择哪个卡片 — 决策指南
步骤 1：PLC 厂商 / 型号是什么？
韩国·日本工业现场：大多为 LS / 三菱 / 欧姆龙 / 松下 / FATEK — 在上文 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） |
| 自动启动 | 勾选后开机自动开始采集 |
| 异步 | 勾选后以异步方式 read（推荐用于大量 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 指南