게이트웨이 설정 및 데이터 확인

본 문서는 GrowSpace UWB 시스템에서 태그 및 앵커 데이터를 수집하고,
MQTT 프로토콜을 통해 실시간으로 외부 서버 또는 클라우드와 연동하기 위한
게이트웨이(Gateway) 설정 절차 및 운영 방법을 안내합니다.


개요

게이트웨이는 UWB 태그와 앵커 간 거리 데이터를 수집하여 MQTT 방식으로 서버에 전송하는 장치입니다.
리스너와 유사한 기능을 수행하지만, LAN 또는 Wi-Fi 기반 전송을 통해 보다 넓은 영역의 데이터를 안정적으로 처리할 수 있습니다.

✅ 대규모 공간, 클라우드 연동, 앱 연동이 필요한 환경에서는 리스너보다 게이트웨이 사용을 권장합니다.


게이트웨이 작동 흐름

  1. 전원 연결 및 부팅
    • 전원 공급 시 내부 시스템 자동 실행
    • LED2(초록), LED3(빨강) 순차 점멸 → 정상 부팅 상태
    • 무반응 시 전원 연결 상태 확인
  2. UWB 장비 자동 연결
    • 태그 및 앵커 설정 완료 시, 자동 검색 후 거리 데이터 수신 시작
  3. 설정값 확인 (MQTT 정보 등)
    • 설정값 없을 경우, LED3(빨강)이 지속 점멸하며 대기 상태 유지
    • 설정은 시리얼 명령어 또는 웹 설정 도구를 통해 입력
  4. 네트워크 연결 시도 (LAN → Wi-Fi)
    • LAN 연결 우선 시도 → 실패 시 Wi-Fi 전환
    • Wi-Fi는 2.4GHz만 지원, 5GHz 미지원
  5. MQTT 서버 연결 및 데이터 전송 시작
    • 설정된 MQTT 브로커로 실시간 데이터 송신
    • 게이트웨이 상태 정보(IP, 연결 상태 등)도 주기적 전송
  6. 네트워크 오류 감지 및 자동 복구
    • 연결 해제 시 자동 재시도 → 재연결 시 데이터 송신 재개

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 키로 로그인한 뒤 아래 항목들을 설정할 수 있습니다:

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

게이트웨이 설정 절차

  1. [게이트웨이 설정] 메뉴 클릭
  2. 장치 연결 → COM 포트 선택 → [연결]
  3. 설정 항목 입력 (MQTT 브로커 주소, 포트, Wi-Fi 정보 등)
  4. [저장] 클릭 → 설정 저장 및 자동 재부팅

❗ Wi-Fi는 반드시 2.4GHz SSID로 설정할 것 (5GHz 미지원)


설치 시나리오 예시

예시 환경: 100m × 60m 공간

구성 요소권장 배치 기준
앵커15~20m 간격, 벽면 균등 배치
게이트웨이최대 25m 간격, 네트워크 연결 용이한 구역 중심 설치

가능한 경우 벽면을 따라 설치하면 신호 안정성과 유지보수 효율이 향상됩니다.

설정 점검 체크리스트

  • 전원 연결 후 LED1 점등 여부 확인
  • LED3 점멸 시 → MQTT 및 Wi-Fi 설정 입력 여부 확인
  • 게이트웨이와 MQTT 서버 간 연결 성공 여부 확인
  • 태그 위치 데이터가 실시간으로 서버에 도착하는지 확인
  • 위치 시각화 또는 로그 수신 정상 여부 확인

📝 결론

GrowSpace 게이트웨이는 UWB RTLS 시스템의 데이터 허브 역할을 수행합니다.
정확한 설정과 안정적인 네트워크 연결을 통해 다음과 같은 환경을 구현할 수 있습니다:

  • 실시간 위치 추적 데이터 수집
  • 클라우드 서버 연동
  • 대규모 공간의 안정적 운영
  • 모바일 앱 및 분석 시스템과의 연동

목차