호퍼 LOCK 연동 전달사항

동신전장(ESP32 도어 컨트롤러) → 유비덤(MES 서버 · PDA)  |  서버 주소: svc1.ubidom.com/pda_mobile/AX/DONGSHIN_HOPER_LOCK/query.aspx

1. 요약

2. 컨트롤러 → 유비덤 (상태 전송)

2.1 요청 형식

HTTP GET, 포트 80, 쿼리스트링에 아래 4개 값을 담아 보냅니다. 한글과 공백은 UTF-8 URL 인코딩(%XX)을 합니다.

GET /pda_mobile/AX/DONGSHIN_HOPER_LOCK/query.aspx
    ?MACH_NAME=%ED%98%B8%ED%8D%BC%EB%9D%BD01          (호퍼락01)
    &UPD_DATE=2026-11-19%2021%3A48%3A45                (2026-11-19 21:48:45)
    &IP_ADDR=192.168.0.104
    &STATE=CLOSE
파라미터값
MACH_NAME호퍼락01 ~ 호퍼락05 (장비 번호 2자리). MACH_CODE는 보내지 않습니다.
UPD_DATE컨트롤러가 인터넷 시간(NTP)으로 맞춘 한국시간, 형식 YYYY-MM-DD HH:MM:SS. 문 상태가 바뀐 순간의 시각을 기록해 두었다가 보냅니다. 시간 동기화 전에는 전송하지 않습니다.
IP_ADDR컨트롤러가 공장 공유기에서 받은 현재 IP (DHCP, 바뀔 수 있음)
STATEOPEN(열림) 또는 CLOSE(닫힘·잠금). 이 두 값만 보냅니다.

2.2 전송 시점

시점STATE비고
문이 열리는 순간OPENPDA 명령, 함체 스위치 등 원인에 관계없이 전송
문이 닫히는(잠기는) 순간CLOSE자동 잠금 포함
1분마다현재 상태상태가 같아도 계속 전송 (IP 갱신, 생존 확인용)
부팅·WiFi 재연결로 IP가 바뀐 즉시현재 상태PDA가 바뀐 IP를 바로 알 수 있도록

3. PDA → 컨트롤러 (열기 명령)

3.1 요청

GET http://<설비IP>/door?action=open

3.2 응답

항목내용
성공 응답HTTP 302 (본문 없음, Location: /). 200~399를 모두 성공으로 처리해 주세요. 리다이렉트를 따라가면 컨트롤러 웹 화면(HTML)이 내려옵니다. 따라갈 필요는 없습니다.
동작요청을 받으면 즉시 잠금이 풀리고 표시등이 빨강으로 바뀝니다. 서버 기록 전송은 응답 후에 처리하므로 지연되지 않습니다.
이미 열려 있을 때다시 열기 요청을 받으면 자동 잠금 타이머가 처음부터 다시 시작됩니다. OPEN 기록이 중복으로 올라가지 않습니다.
자동 잠금컨트롤러 설정 시간(5 / 10 / 30초 또는 수동, 기본 10초) 후 자동으로 잠기고 CLOSE가 전송됩니다.
호출 불가 상태컨트롤러가 WiFi에 연결되지 않았거나 전원이 꺼져 있으면 연결 시간 초과가 납니다. 이때는 DB의 수정일자가 오래된 상태이니, PDA가 수정일자로 오프라인을 판단할 수 있습니다.

3.3 (참고) 컨트롤러 상태 조회

GET http://<설비IP>/status → JSON. "id"(장비 번호 1~5), "door"(open/locked)가 들어 있어, 열기 전에 올바른 설비인지 확인하는 데 쓸 수 있습니다. 필수는 아닙니다.

{"id":2,"name":"도어 컨트롤러 #2","door":"locked","lock":true,"lamp_blue":true,
 "lamp_red":false,"auto_lock":10,"open_sec":0,"remain_sec":0,
 "rssi":-39,"ip":"192.168.0.101", ... }

4. 유비덤에 부탁드리는 사항

① PDA는 "설비IP" 칸을 기준으로 호출해 주세요 현재 서버 현황표의 "PDA 제어 주소" 칸이 http://192.168.0.44/door?action=open ~ …48…로 예전 값 그대로이고, 컨트롤러가 IP_ADDR을 보내도 이 칸은 갱신되지 않습니다(설비IP 칸은 정상 갱신됩니다). 컨트롤러 쪽에서 이 칸을 채울 방법은 없습니다(서버가 받는 파라미터가 위 4개로 보임). 별도 파라미터가 필요하다면 이름을 알려 주세요.
② 요청 인코딩 확인 UPD_DATE의 공백과 한글 MACH_NAME은 UTF-8 URL 인코딩으로 들어옵니다. 서버에서 UPD_DATE 형식이 올바르지 않습니다가 나는 경우는 공백이 인코딩되지 않아 시각 부분이 잘렸을 때입니다. 컨트롤러 요청은 정상 처리되는 것을 확인했습니다.
③ 오프라인 판정 기준 컨트롤러는 1분마다 보고합니다. 수정일자가 3분(2회 연속 누락) 이상 갱신되지 않으면 오프라인으로 보는 것을 권장합니다.
④ 서버 부담 하루 약 7,200건의 주기 보고가 들어옵니다. 주기 조정(예: 5분)이나 "상태 변경 시에만 저장" 같은 정책이 필요하면 알려 주세요. 컨트롤러 주기는 펌웨어에서 바꿀 수 있습니다.

5. 설비 목록

장비 번호MACH_NAME유비덤 설비코드열기 명령 주소(IP는 가변)
1호퍼락01HPL01http://<설비IP>/door?action=open
2호퍼락02HPL02동일
3호퍼락03HPL03동일
4호퍼락04HPL04동일
5호퍼락05HPL05동일

컨트롤러는 MACH_NAME만 보내므로, 유비덤이 이름으로 설비코드를 찾는 방식에 의존합니다. 설비명을 바꾸시면 알려 주세요.

6. 작업장 확인 결과 (2026-11-19)

설비서버에 저장된 IP결과
호퍼락01192.168.0.91OK (OPEN/CLOSE 수신)
호퍼락02192.168.0.101OK (열림 → 10초 후 자동 잠금, OPEN/CLOSE 모두 반영)
호퍼락03192.168.0.102OK
호퍼락04192.168.0.103OK
호퍼락05192.168.0.104OK (1분 간격 보고 확인)
테스트 기록 안내2026-11-19 19:00~19:02에 PC에서 호퍼락01로 수동 테스트 요청을 보냈고(OPEN 1건, CLOSE 1건, 형식 오류 FAIL 1건), 그 흔적이 서버 요청 기록·CSV에 남아 있습니다. 서버 요청 목록의 다른 IP(180.70.45.117 등) 요청은 저희가 보낸 것이 아닙니다.

7. 현장 설치 시 일정·확인 사항