콘텐츠로 이동

빠른 시작 — 5단계로 첫 위치 표시까지

Wi-Fi 공유기 설정처럼 단순하게 따라가실 수 있어요.

처음 한 번만 거치면 됩니다. 한 번 설정한 값은 앵커가 기억하므로, 다음에 전원만 켜도 자동 시작됩니다.

준비물 체크

준비물 개수 메모
앵커 보드 + 전원 (USB-C 어댑터) 3개 이상 4~6개를 권장
태그 (위치를 알고 싶은 대상에 휴대) 1개 이상
스마트폰 1대 앵커 설정용 (Wi-Fi 가능)
PC 또는 노트북 1대 대시보드 앱 실행용
Wi-Fi 공유기 (인터넷 연결) 1대 공장/매장의 사내 Wi-Fi도 가능

📷 [이미지 자리] 박스 개봉 후 모든 구성품이 가지런히 놓인 사진. 파일명: assets/quickstart_unbox.png

1단계 · 앵커 설치 위치 정하기

천장이나 벽 높은 곳에 3개 이상 부착합니다. 다음 두 가지만 지키면 됩니다.

  • ✅ 앵커들이 서로 다른 방향에서 같은 공간을 바라보도록 배치 (삼각형, 사각형 모양)
  • ✅ 앵커와 태그 사이 시야가 트이도록 (큰 금속, 두꺼운 벽 가능한 한 피함)
   [앵커 B]            [앵커 C]
       ●                  ●
        \      태그       /
         \   ⬤ ─ 사람   /
          \            /
           \          /
            ●────────●
        [앵커 A]   [앵커 D]

각 앵커의 (X, Y) 좌표를 줄자로 측정해서 종이에 적어두세요. 나중에 대시보드에 입력합니다.

2단계 · 앵커마다 ID(번호) 다르게 설정

여러 앵커가 헷갈리지 않도록 각 앵커에 0, 1, 2, 3 ... 번호를 부여합니다. 보드 위 작은 DIP 스위치로 설정합니다.

📷 [이미지 자리] 보드 위 DIP 스위치 위치를 빨간 동그라미로 표시한 캡처. 파일명: assets/quickstart_dip_position.png

앵커 번호 SW1 SW2 SW3 SW10 (역할)
0번 (A0) OFF OFF OFF ON (Anchor)
1번 (A1) ON OFF OFF ON
2번 (A2) OFF ON OFF ON
3번 (A3) ON ON OFF ON
4번 (A4) OFF OFF ON ON

번호를 더 늘리려면 SW1~SW6을 이진수처럼 조합. 자세한 매핑은 DIP 스위치 안내 참조.

같은 번호 두 개 있으면 위치 계산이 망가집니다. 각 앵커마다 번호가 모두 다르게 해주세요.

3단계 · 앵커를 Wi-Fi와 MQTT에 연결

앵커마다 한 번씩 다음 절차를 반복합니다.

  1. 앵커 보드의 버튼을 누른 채 전원 어댑터 꽂기
  2. 앵커 화면에 다음과 같이 뜸: 
    SETUP
WiFi: UWB-Anchor-XXXX
PW:   00000000
URL:  http://192.168.4.1
  3. 폰 Wi-Fi 목록에서 UWB-Anchor-XXXX 선택, 비밀번호 00000000 입력
  4. 폰 브라우저에서 http://192.168.4.1 접속
  5. 화면 폼에 다음 입력:
항목 입력값 (예시)
MQTT Host broker.hivemq.com (테스트용 공용 브로커)
MQTT Port 1883
MQTT User / Password 비워둠 (공용 브로커는 인증 불필요)
Topic prefix uwb/range
WiFi SSID 인터넷 가능한 Wi-Fi 이름
WiFi Password Wi-Fi 비밀번호
  1. 맨 아래 Save & Reboot 버튼

자동 재부팅되면서 앵커가 Wi-Fi에 접속하고 MQTT로 측정값 보내기 시작합니다.

📷 [이미지 자리] 폰에서 본 SETUP 페이지 + Save & Reboot 버튼 화면. 파일명: assets/quickstart_setup_page.png

⚠️ 공용 브로커는 시연용입니다. 실제 운영에선 사내 MQTT 서버를 쓰세요. 공용은 누구나 같은 토픽을 들을 수 있습니다.

4단계 · 대시보드 앱 실행

PC/노트북에서 대시보드 앱을 켭니다. 자세한 사용법은 대시보드 앱 가이드 참조.

첫 실행 시 연결 폼:

필드 입력값 (예시)
Host broker.hivemq.com
Port 1883 (PC) 또는 8884 + TLS ON (웹브라우저)
Topic uwb/range/+ ← + 표시 필수

연결되면 상단 상태바가 녹색으로 바뀝니다.

5단계 · 앵커 좌표 등록 후 태그 보기

대시보드 화면 우상단 📍 (지도 핀) 아이콘 → 앵커 추가:

src idx X Y
A0 0 (1단계 측정값) (1단계 측정값)
A1 1 ... ...
A2 2 ... ...

앵커 3개 등록되면 자동으로 태그 위치 계산이 시작됩니다.

태그를 켜고 공간을 돌아다녀 보세요. 지도 위 점이 따라옵니다. 🎉

🎥 [동영상 자리] 4단계 + 5단계까지 끝낸 후 태그를 손에 들고 천천히 걷는 동안 화면 위 점이 따라가는 모습 (10~15초). 파일명: assets/quickstart_demo.mp4 또는 .gif

잘 안 되면

증상 확인할 것
폰 Wi-Fi 목록에 UWB-Anchor-XXXX 가 안 보임 버튼 누른 채 전원 다시 꽂기. 앵커 화면에 SETUP 떠야 정상
Save 후 앵커가 MQTT에 안 붙음 Wi-Fi SSID/PW 오타, 5GHz 전용 Wi-Fi (앵커는 2.4GHz만 지원)
대시보드에 tags = 0 앵커가 publish 중이 아님. 앵커 화면 / MQTT 토픽 확인
tags ≥ 1 인데 positioned = 0 등록한 앵커 3개 미만, 또는 앵커 좌표 단위 불일치

각 단계에서 더 자세한 안내는 상세 설정 페이지에 있습니다.