용어집
이 매뉴얼과 화면에서 자주 나오는 용어를 풀어서 설명합니다.
A — F
API
Application Programming Interface. 프로그램끼리 데이터를 주고받기 위한 약속. 이 게이트웨이는 REST API 를 통해 외부 시스템이 값을 조회 / 등록할 수 있도록 합니다.
bdSeq / seq
Sparkplug B 메시지의 일련 번호. 메시지 누락 / 순서를 검증하기 위한 표준 필드입니다. 일반 사용자가 신경 쓸 필요는 없습니다.
CIP
Common Industrial Protocol. EtherNet/IP 통신의 기본 규약입니다.
CPU 사용률
게이트웨이 PC 가 일을 얼마나 많이 하고 있는지를 % 로 표시. 80% 이상이 지속되면 자원이 부족한 상태.
Cassandra
이 게이트웨이가 사용하는 시계열 / 설정 저장소. 일반 사용자가 직접 다룰 일은 없습니다.
EtherNet/IP
Allen-Bradley / Rockwell 의 PLC 가 사용하는 산업 통신 규약. 표준 포트 44818.
FEnet
Fast Ethernet. LS ELECTRIC 의 PLC (XGI / XBC / XBM) 가 사용하는 통신 규약. 표준 포트 2004.
Formula (계산식, 공식, 포뮬라)
태그 값을 후처리하는 산술 수식. ${VALUE}*0.1 같은 형식으로 단위 변환 / 영점 보정 등에 사용.
다른 이름: 계산식 / 공식 / 포뮬라 — 동일한 기능을 가리킵니다. → 계산식 적용
G — N
Grafana
함께 설치되는 부속 대시보드 도구. 게이트웨이가 수집한 값을 그래프 / 게이지 / 알람으로 시각화. 기본 포트 3000.
HTTP 푸시
PLC 처럼 게이트웨이가 값을 “읽으러 가는” 게 아니라, 외부 시스템이 게이트웨이로 값을 “밀어 넣는” 방식.
MES
Manufacturing Execution System. 공장의 작업 지시 / 실적 관리 시스템.
MELSEC
미쓰비시 PLC 의 통신 규약 (MC 프로토콜). MELSEC = MELSEC Communication.
Modbus
가장 오래되고 널리 쓰이는 산업 통신 규약. 거의 모든 계측기 / 인버터가 지원합니다.
MQTT
경량 IoT 메시징 규약. 한 PLC 의 값을 여러 시스템에 동시에 보내는 데 적합. 표준 포트 1883.
Node-RED
함께 설치되는 부속 데이터 흐름 도구. 시각적으로 데이터 가공 / 외부 연동을 만들 수 있음. 기본 포트 1880.
NodeId
OPC-UA 의 태그 주소 표기. 예: ns=2;s=Channel1.Device1.Tag1.
O — S
OPC
OLE for Process Control. PLC 와 컴퓨터 사이의 표준 데이터 교환 규약. 옛날엔 OPC DA / HDA / AE 로 나뉘었으나 지금은 OPC-UA 로 통합 표준화되었습니다.
OPC-UA
OPC Unified Architecture. OPC 의 최신 표준 (IEC 62541). Kepware, Matrikon 등 대부분의 SCADA 가 지원합니다.
PLC
Programmable Logic Controller. 공장 자동화의 두뇌. 센서 / 액추에이터를 제어하는 산업용 컴퓨터입니다.
REST API
HTTP 기반의 API 형식. 이 게이트웨이의 v1 REST API 는 /api/v1/... 경로로 노출됩니다. → 고급 — REST API
SCADA
Supervisory Control and Data Acquisition. 공장 / 발전소 등의 운영을 감시 / 제어하는 시스템. Ignition, Wonderware 등이 대표적.
Sparkplug B
MQTT 위에 라이프사이클 / 메타데이터를 표준화한 산업용 메시지 규약. SCADA / MQTT 호환 시스템과 통신할 때 권장됩니다.
S7
지멘스 PLC 의 통신 규약. SIMATIC S7 시리즈에서 사용. 표준 포트 102.
T — Z, 한글
TCP / UDP
네트워크 통신의 기본 방식. 일반적으로는 TCP 가 신뢰성이 좋고 UDP 가 빠릅니다. PLC 통신은 대부분 TCP 를 사용합니다.
TIA Portal
지멘스 PLC 작성 / 관리 도구.
XG5000
LS ELECTRIC PLC 작성 / 관리 도구.
게이트웨이 (Gateway)
서로 다른 시스템 / 네트워크 사이를 연결해 데이터를 중계하는 장치 / 소프트웨어. 이 시스템은 “현장 PLC ↔ PlantPulse 클라우드” 사이의 게이트웨이입니다.
시계열 (Time Series)
시간 순서대로 기록된 데이터. PLC 값처럼 “언제 얼마였다” 를 시간 축으로 모은 것.
자동 시작 (auto_collect)
게이트웨이 재부팅 시 자동으로 PLC 수집을 다시 시작할지 여부.
태그 (Tag)
PLC 의 메모리 한 칸에 사람이 읽을 이름을 붙인 것. 예: D100 → “펌프1 회전수”.
폴링 (Polling) / 수집 주기
게이트웨이가 PLC 에게 “지금 값 줘봐” 라고 주기적으로 묻는 것. 보통 1 초 (1000ms).
헬스 인덱스 (Health Index)
설비의 건강 상태를 01 (또는 0100%) 로 표현한 지수. 모터센스 등 진단 솔루션이 주로 사용.
2026.05 컨테이너 배포 용어
컨테이너 모드 (Container Mode)
PlantPulse Edge 가 Docker 단일 이미지 (docker.kopens.io/pe/plantpulse-edge) 로 배포되는 형태. 2026.05+ 표준. systemctl is-active plantpulse-edge.service 가 active 면 컨테이너 모드.
Native 모드
2026.05 미만의 직접 설치 형태. /opt/kopens/plantpulse-edge/bin/{start,stop,restart}.sh 로 운영. 신규 배포는 컨테이너 모드 권장.
Image Tag / Build Date
컨테이너 이미지의 식별자 — <version>-<build_date> 형식 (예: 2026-20260523). build_date 가 OTA 비교의 기준. /api/v1/system/version 또는 cat /etc/kopens/version.env 로 확인.
OTA (Over-The-Air upgrade)
원격 업그레이드. 박스에서 upgrade.sh 가 META-INF/VERSION.JSON 의 새 build_date 감지 → docker pull → 자동 pre-snapshot → systemctl restart → 90s health probe → 실패 시 auto-rollback.
Pre-snapshot
OTA 업그레이드 직전 자동 생성되는 데이터 백업 (/data1/pp-backups/pe-backup-<ts>.tar.zst). 새 이미지가 데이터 손상 유발 시 restore.sh 로 복구 가능.
Pattern B (Signal File)
컨테이너 안에서 호스트 액션 (재시작/리부트/OTA) 을 요청하는 방식. 컨테이너가 /etc/kopens/upgrade.request 또는 host-action.request JSON 을 작성하면, 호스트의 inotify 가 감지해 처리. 대안 (Pattern A — /var/run/docker.sock 직접 사용) 대비 host root 등가 권한 회피.
cgroup limit
컨테이너의 메모리 / CPU 상한. systemd unit 의 MemoryMax=12G CPUQuota=600% TasksMax=8192. 8GB 박스 등 작은 메모리에선 systemd drop-in (override.conf) 으로 조정.
credentials.txt
박스마다 install.sh 가 1회 생성하는 random 비번 모음 (/etc/kopens/credentials.txt, chmod 0600). admin / mqtt / opcua / API key 포함. 출하 시 인쇄/저장 후 박스 봉인.
pe-* 도구
컨테이너 모드 운영 스크립트 8종 (/opt/kopens/install/bin/):
status.sh (상태), health.sh (exit code 헬스체크), logs.sh (컴포넌트 로그 tail),
shell.sh (컨테이너 안 bash), config.sh (app.properties 편집+재시작),
backup.sh/restore.sh (데이터 스냅샷/복구), doctor.sh (장애 escalation tarball).