프로토콜 선택 화면 (/ui/connect/connect) — 44 개 카드
새 PLC / 디바이스 연결을 추가하기 위한 프로토콜 picker 화면 입니다. 클릭한 카드의 프로토콜 별 등록 폼으로 이동합니다.
홈 카드 프로토콜 연결 하기 → 클릭, 또는 직접 /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 로 이동 — 여러 PLC / 태그를 한 번에 CSV 로 등록 |
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 (외부에서 send) | 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 / 미쓰비시 / 옴론 / 파나소닉 / 파텍 — 위 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 (default 1000) |
| 자동 시작 | 체크 시 부팅 후 자동 수집 시작 |
| 비동기 | 체크 시 read 비동기 (대량 PLC 추천) |
프로토콜별 추가 옵션
자세한 옵션은 PLC 종류별 가이드 의 각 페이지 참고.
5. CSV 일괄 업로드 (대안 경로)
PLC 가 많거나 (50+ 태그) 외부 도구(Excel) 에서 정의된 태그 시트를 import 하고 싶으면 CSV 일괄 업로드 사용.
[📥 CSV 일괄 업로드] → /ui/connect/csv
CSV 컬럼 순서: tag_id, tag_name, plc_address, data_type, format, fomula, description
(헤더 첫 줄 필수)
OPC 자체는 별도로 먼저 등록 한 후, 그 OPC 안의 태그를 CSV 로 일괄 추가하는 흐름. 태그 등록 참고.
6. 자주 빠지는 함정
| 증상 | 원인 / 해결 |
|---|---|
| 클릭한 카드의 폼이 404 | 그 프로토콜이 예정 / 미지원 일 가능성 — JSP 만 있고 백엔드 컨트롤러가 비어있는 경우. 운영팀 문의 |
| 같은 PLC 를 두 카드로 등록 | OPC ID 가 중복되면 두 번째 등록이 첫 번째를 덮어씀. OPC ID 는 고유하게 |
| CSV 업로드 후 태그가 0 건 | 컬럼 순서 / 헤더 누락 / 인코딩(UTF-8 BOM 없음). 태그 등록 의 CSV 절 참고 |
| 카드 그리드에서 일부 로고가 깨짐 | 정적 자산 캐시. Ctrl+Shift+R 로 강제 새로고침 |
| MOTOR SENSE 카드가 안 보임 | JSP 의 display:none 으로 숨김 처리됨 (전용 사이트 외 사용 안 함). 직접 URL /ui/connect/motor-sense 접근 가능 |
7. 더 알아보기
- 등록 절차 (시작 전 준비 + 단계별): 새 PLC 연결 추가
- 태그 등록 / CSV 업로드: 태그 등록
- 등록 후 모니터링: 연결 목록 / 태그 목록
- 각 PLC 별 옵션 / 주소 형식: PLC 종류별 가이드