본 문서는 GrowSpace UWB 시스템에서 태그 및 앵커 데이터를 수집하고,
MQTT 프로토콜을 통해 실시간으로 외부 서버 또는 클라우드와 연동하기 위한
게이트웨이(Gateway) 설정 절차 및 운영 방법을 안내합니다.
개요
게이트웨이는 UWB 태그와 앵커 간 거리 데이터를 수집하여 MQTT 방식으로 서버에 전송하는 장치입니다.
리스너와 유사한 기능을 수행하지만, LAN 또는 Wi-Fi 기반 전송을 통해 보다 넓은 영역의 데이터를 안정적으로 처리할 수 있습니다.
✅ 대규모 공간, 클라우드 연동, 앱 연동이 필요한 환경에서는 리스너보다 게이트웨이 사용을 권장합니다.
게이트웨이 작동 흐름
- 전원 연결 및 부팅
- 전원 공급 시 내부 시스템 자동 실행
- LED2(초록), LED3(빨강) 순차 점멸 → 정상 부팅 상태
- 무반응 시 전원 연결 상태 확인
- UWB 장비 자동 연결
- 태그 및 앵커 설정 완료 시, 자동 검색 후 거리 데이터 수신 시작
- 설정값 확인 (MQTT 정보 등)
- 설정값 없을 경우, LED3(빨강)이 지속 점멸하며 대기 상태 유지
- 설정은 시리얼 명령어 또는 웹 설정 도구를 통해 입력
- 네트워크 연결 시도 (LAN → Wi-Fi)
- LAN 연결 우선 시도 → 실패 시 Wi-Fi 전환
- Wi-Fi는 2.4GHz만 지원, 5GHz 미지원
- MQTT 서버 연결 및 데이터 전송 시작
- 설정된 MQTT 브로커로 실시간 데이터 송신
- 게이트웨이 상태 정보(IP, 연결 상태 등)도 주기적 전송
- 네트워크 오류 감지 및 자동 복구
- 연결 해제 시 자동 재시도 → 재연결 시 데이터 송신 재개
LED 상태 안내
게이트웨이 전면 또는 측면에 위치한 3개의 LED를 통해 동작 상태를 확인할 수 있습니다.
LED | 색상 | 역할 | 동작 상태 |
---|---|---|---|
LED1 | 초록 | 전원 확인 | 상시 점등 (전원 공급 중) |
LED2 | 초록 | 데이터 전송 | MQTT 데이터 송신 시 점멸 |
LED3 | 빨강 | 설정/네트워크 오류 | 설정값 미입력 또는 네트워크 오류 시 점멸 |
⚠ LED3 점멸 지속 시 → MQTT 정보 미설정 또는 Wi-Fi 연결 실패 가능성 확인 필요
LED1. 초록 LED2. 초록 LED3. 빨강
⚠ LED3 점멸 지속 시 →
MQTT 정보 미설정 또는 Wi-Fi 연결 실패 가능성 확인 필요
웹 설정 도구 접속
GrowSpace 게이트웨이는 별도의 설치 없이 웹 브라우저만으로 설정 가능합니다.
Google Chrome을 통해 다음 URL에 접속합니다:
🔗 https://growspace-uwb.web.app
API 키 생성
게이트웨이 설정 및 MQTT 통신을 위해서는 고유 API 키가 필요합니다.
생성 절차:
- 접속 후 [API 키 생성] 버튼 클릭

- 회사명 또는 프로젝트명을 입력

- 자동 생성된 API 키 확인 및 외부 저장 필수
중요! 이 API 키는 창을 닫으면 다시 확인할 수 없습니다.
꼭 복사해서 별도로 저장해 주세요!
웹 설정 도구 구성
API 키로 로그인한 뒤 아래 항목들을 설정할 수 있습니다:

항목 | 설명 |
---|---|
1. 좌측 장치 목록 | 연결된 태그/앵커 목록 확인 |
2. Grid 보기 | 공간 내 장치 배치 상태 시각화 |
3. 흔들림 보정 | 태그 움직임에 대한 필터 조정 (1에 가까울수록 보정 강도 ↑) |
4. 이미지 업로드 | 도면 또는 평면도 이미지 등록 후 장치 위치 시각화 |
5. 게이트웨이 설정 | MQTT 서버 주소, 포트, Wi-Fi SSID/PW 등 입력 후 저장 |
게이트웨이 설정 절차

- [게이트웨이 설정] 메뉴 클릭
- 장치 연결 → COM 포트 선택 → [연결]
- 설정 항목 입력 (MQTT 브로커 주소, 포트, Wi-Fi 정보 등)
- [저장] 클릭 → 설정 저장 및 자동 재부팅
❗ Wi-Fi는 반드시 2.4GHz SSID로 설정할 것 (5GHz 미지원)
설치 시나리오 예시
예시 환경: 100m × 60m 공간
구성 요소 | 권장 배치 기준 |
---|---|
앵커 | 15~20m 간격, 벽면 균등 배치 |
게이트웨이 | 최대 25m 간격, 네트워크 연결 용이한 구역 중심 설치 |
가능한 경우 벽면을 따라 설치하면 신호 안정성과 유지보수 효율이 향상됩니다.
설정 점검 체크리스트
- 전원 연결 후 LED1 점등 여부 확인
- LED3 점멸 시 → MQTT 및 Wi-Fi 설정 입력 여부 확인
- 게이트웨이와 MQTT 서버 간 연결 성공 여부 확인
- 태그 위치 데이터가 실시간으로 서버에 도착하는지 확인
- 위치 시각화 또는 로그 수신 정상 여부 확인
📝 결론
GrowSpace 게이트웨이는 UWB RTLS 시스템의 데이터 허브 역할을 수행합니다.
정확한 설정과 안정적인 네트워크 연결을 통해 다음과 같은 환경을 구현할 수 있습니다:
- 실시간 위치 추적 데이터 수집
- 클라우드 서버 연동
- 대규모 공간의 안정적 운영
- 모바일 앱 및 분석 시스템과의 연동