HTTP 푸시 / 모터센스 (Motor Sense)
PLC 가 아닌 외부 IT 시스템 / 측정 솔루션 에서 값을 받아오는 두 가지 모드입니다.
| 모드 | 어떤 상황에 쓰나요 |
|---|---|
| HTTP 푸시 | 외부 시스템이 게이트웨이로 값을 “보내올” 때. 예: 사내 MES 가 배치명을 push, 바코드 스캐너가 값을 push |
| 모터센스 (MOTOR_SENSE) | KOPENS 모터센스 솔루션의 진동/상태 데이터를 polling 으로 가져올 때 |
HTTP 푸시 모드
게이트웨이가 PLC 에게 값을 “읽으러 가는” 게 아니라, 외부 시스템이 값을 밀어 넣는 (push) 방식입니다.
등록 폼 입력값
| 입력 칸 | 무엇을 적나요 |
|---|---|
| IP 주소 | (실제 사용 안 함, 식별용) — 예: 127.0.0.1 |
| 포트 | (실제 사용 안 함) — 예: 0 |
| 수집 주기 | 외부에서 push 한 값을 게이트웨이가 캐시에서 읽어 처리하는 주기 — 보통 1000 |
태그의 PLC 주소 표기
자유 키 문자열입니다. 외부 시스템이 값을 push 할 때 사용할 식별자입니다.
| 예 | 의미 |
|---|---|
temperature | 자유 이름 |
line/A/rpm | 슬래시 포함 가능 |
barcode.last | 점 포함 가능 |
외부에서 값 보내는 법
다음 형식의 HTTP 요청을 게이트웨이로 보냅니다.
POST http://<게이트웨이IP>/api/v1/tag/<태그ID>/value
Content-Type: application/json
{ "value": "25.7" }
또는 고급 — REST API 페이지의 “값 쓰기” 절을 참고.
값이 들어오면 다음 수집 주기에 그 값이 화면에 표시되고, 평소 PLC 와 마찬가지로 MQTT / Sparkplug 등으로 전송됩니다.
자주 쓰는 사례
| 사례 | 어떻게 |
|---|---|
| MES 가 배치명을 push | recipe.name 같은 태그 만들고 데이터 형식 String |
| 바코드 스캐너 결과 수집 | barcode.last, String |
| 외부 PLC (못 연결되는 PLC) 의 값 중계 | 그쪽 시스템에서 미리 변환된 값을 보내오기 |
| 외부 분석 결과 보내오기 | quality.score, Float |
모터센스 (Motor Sense)
KOPENS 모터센스 솔루션의 데이터를 가져오는 전용 모드입니다.
일반 PLC 와의 차이
| 항목 | 일반 PLC | 모터센스 |
|---|---|---|
| 화면 표시 | 태그 표 | 자산(에셋) 별 카드 (HEALTH INDEX / SIGNAL) |
| 태그 등록 | 사용자가 일일이 입력 | 자동 생성 (signals + health_index) |
| 갱신 주기 | 화면 5 초 | 1 초 백그라운드 갱신 |
| 데이터 형식 | 자유 | JSON 배열 (자산 여러 대 묶음) |
등록 폼 입력값
| 입력 칸 | 무엇을 적나요 |
|---|---|
| API KEY | KOPENS 가 발급한 API 키 |
| 고객 ID | KOPENS 가 발급한 고객 식별자 |
| 에셋리스트 URL | 자산 목록 조회 URL |
| 에셋시그널 URL | 자산 신호 데이터 URL |
| 에셋상태지수 URL | 자산 상태(건강 지수) URL |
| 파형/스펙트럼 로드 | 무거운 파형 데이터를 함께 받을지 여부 |
URL 들은 http:// 또는 https:// 로 시작해야 합니다.
자동 생성되는 태그
게이트웨이가 두 개의 태그를 자동으로 생성합니다.
| 태그 이름 | 의미 |
|---|---|
signals | 자산별 진동 / 온도 / 전압 등 신호 묶음 (JSON 배열) |
health_index | 자산별 건강 지수 (불균형 / 정렬 / 베어링 등, JSON 배열) |
각 자산의 데이터는 카드 형식으로 펼쳐집니다.
흔한 문제와 해결
HTTP 푸시 모드
| 증상 | 원인 | 해결 |
|---|---|---|
| 값이 안 들어옴 | 외부 시스템이 push 를 안 했거나, 태그 ID 오타 | 외부 시스템 로그 확인. POST /api/v1/tag/.../value 가 200 OK 인지 |
| 값이 늦게 갱신됨 | 수집 주기가 김 | PLC 등록의 [수집 주기] 줄이기 (예: 500ms) |
모터센스 모드
| 증상 | 원인 | 해결 |
|---|---|---|
| “drive 가 classpath 에 없다” | 모터센스 전용 jar 미설치 | 시스템 관리자에게 모터센스 jar 설치 요청 |
| 401 Unauthorized | API KEY / 고객 ID 오류 | KOPENS 발급 키 정확히 확인 |
| URL 거부 | http:// 또는 https:// 로 시작하지 않음 | URL 형식 점검 |
더 자세한 예제 / 자동화 등록
고급 — REST API 의 HTTP / 모터센스 예제를 참고하세요.