안녕하세요, 최도선님. 사내망 서버(내부 서버)와 프리그로우 UWB 하드웨어 연동을 위해 필요한 준비 사항을 요청하신 대로 표가 아닌 텍스트 형태로 자세히 안내해 드리겠습니다.
Creator Kit Q1 기반의 UWB 시스템은 게이트웨이를 통해 MQTT 프로토콜로 데이터를 외부 시스템에 전송하므로, 사내망 연동의 핵심은 서버 측에 MQTT 브로커를 구축하고 게이트웨이를 이 브로커에 연결하는 것입니다.
1. 사내망 서버 환경 (MQTT 브로커) 구축 준비
UWB 위치 데이터를 수신하고 관리하기 위해서는 서버에 MQTT 브로커를 설치하고 네트워크 접근을 허용해야 합니다.
- MQTT 브로커 설치: 사내 서버에 Mosquitto와 같은 MQTT 브로커를 설치해야 합니다. MQTT는 사물인터넷(IoT) 환경에서 장치 간 실시간 메시지 송수신을 효율적으로 처리하는 경량 통신 프로토콜입니다.
- IP 주소 및 포트 확인: 브로커가 설치된 서버의 IPv4 주소를 확인하고, 이 주소를 게이트웨이 설정 시 사용해야 합니다.
- 방화벽 포트 개방: 게이트웨이의 접속을 허용하기 위해 서버의 방화벽에서 TCP 1883 포트에 대한 인바운드 규칙을 추가해야 합니다. 포트가 열려있지 않으면 게이트웨이가 데이터를 전송할 수 없습니다.
- 브로커 설정 조정: Mosquitto 설정 파일에서
listener 1883을 지정하여 외부 장비의 접속을 허용하고, 필요하다면allow_anonymous true를 설정하여 인증 없이도 접속할 수 있도록 허용해야 합니다. 이 설정을 통해 GrowSpace 게이트웨이와 같은 외부 장비가 브로커에 접속할 수 있게 됩니다.
2. 게이트웨이 네트워크 및 MQTT 연결 설정
게이트웨이 Q1 장치가 사내망 Wi-Fi에 접속하고, 구축된 사설 브로커로 데이터를 전송하도록 구성해야 합니다.
- Wi-Fi 연결 설정: 게이트웨이는 2.4GHz Wi-Fi만 지원하므로 (5GHz 미지원), 게이트웨이 설정 페이지(
https://uwb-gateway.web.app) 또는basicSetting=명령어를 통해 사내망 Wi-Fi 이름(SSID)과 비밀번호를 입력해야 합니다. - MQTT IP 설정: 게이트웨이가 데이터를 전송할 MQTT 브로커 서버의 IP 주소를
MQTT IP항목에 입력하거나, 시리얼 명령어로mqttIP=를 사용해 설정해야 합니다. - 접속 인증 정보: 브로커가 인증을 요구하는 경우,
mqttID=와mqttPW=명령어를 사용하여 접속 ID와 비밀번호를 설정할 수 있습니다. - 설정 적용: 모든 설정 변경 후에는 게이트웨이를
restart명령어로 재시작하거나, 웹페이지에서 설정을 저장하여 자동 재시작되도록 해야 변경 사항이 적용됩니다.
3. 데이터 수신 및 활용 준비
서버 측 클라이언트가 실시간 UWB 데이터를 구독하고 파싱할 수 있도록 준비해야 합니다.
- Topic 구독: 서버 애플리케이션 또는 테스트 도구(예: MQTT-Studio)는 게이트웨이에서 전송되는 세 가지 주요 토픽을 구독해야 합니다.
uwb/gateway/start/#: 게이트웨이 부팅 시 초기 상태 정보.uwb/gateway/config/#: 게이트웨이가 지속적으로 작동 중임을 알리는 생존 신호 (Heartbeat) 및 구성 정보.uwb/gateway/devices/#: 앵커 및 태그의 실시간 위치 데이터.
- 데이터 파싱: 게이트웨이에서 전송되는 위치 데이터는 JSON 형식이며, 태그 ID, x, y, z 좌표값 등으로 구성됩니다. 사내망 서버에 구축된 애플리케이션은 이 JSON 데이터를 분석(파싱)하여 실시간 위치 정보를 추출하고 활용해야 합니다.
- 활용 범위: 이 데이터를 실시간 위치 시각화 대시보드와 연동하거나, 지오펜스 구성을 통해 위험 구역 침입 경고 등을 구현할 수 있습니다.
이러한 단계들을 통해, UWB 시스템에서 수집된 정밀 위치 데이터를 사내망 서버에 통합하여 모니터링 및 제어 시스템을 구축할 수 있습니다.
그로우스페이스 관리자 Edited question