Quick Start — From box to first dot in 5 steps¶
As simple as setting up a Wi-Fi router.
One-time setup. Once each anchor is configured, it remembers everything — power-cycle is enough next time.
What you need¶
| Item | Quantity | Note |
|---|---|---|
| Anchor board + USB-C power adapter | 3 or more | 4–6 is recommended |
| Tag (carried by the person/asset to track) | 1+ | |
| Smartphone | 1 | Used to configure each anchor |
| PC or laptop | 1 | Runs the dashboard app |
| Wi-Fi router (with internet) | 1 | Office / venue Wi-Fi works |
📷 [image placeholder] Unboxed contents laid out neatly. Filename:
assets/quickstart_unbox.png
Step 1 · Choose where to mount each anchor¶
Mount at least 3 anchors high on the ceiling or walls. Two rules:
- ✅ Anchors should look at the same area from different directions (form a triangle or rectangle around it)
- ✅ Try to keep line-of-sight between anchor and tag (avoid thick walls and big metal objects)
Measure each anchor's (X, Y) coordinates with a tape measure and write them down. You'll type them into the dashboard later.
Step 2 · Give each anchor a unique ID¶
Several anchors need different IDs (0, 1, 2, …) so the system can tell them apart. Set the ID using the small DIP switches on the board.
📷 [image placeholder] Photo of the board with the DIP switch block circled. Filename:
assets/quickstart_dip_position.png
| Anchor ID | SW1 | SW2 | SW3 | SW10 (role) |
|---|---|---|---|---|
| 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 |
For higher numbers, combine SW1–SW6 like binary digits. Full mapping is on the DIP Switch Reference.
Two anchors with the same ID will break positioning. Every anchor must have a unique ID.
Step 3 · Connect each anchor to Wi-Fi and MQTT¶
Repeat the following for each anchor:
- Hold the board's button while plugging in power
- The screen shows:
- On your phone, join Wi-Fi
UWB-Anchor-XXXXwith password00000000 - Open the browser and go to
http://192.168.4.1 - Fill the form:
| Field | Example value |
|---|---|
| MQTT Host | broker.hivemq.com (public test broker) |
| MQTT Port | 1883 |
| MQTT User / Password | leave empty (public broker = no auth) |
| Topic prefix | uwb/range |
| WiFi SSID | name of your Wi-Fi |
| WiFi Password | your Wi-Fi password |
- Press Save & Reboot at the bottom
The anchor reboots, joins your Wi-Fi, and starts publishing measurements over MQTT.
📷 [image placeholder] SETUP page on a phone with the Save & Reboot button visible. Filename:
assets/quickstart_setup_page.png⚠️ The public broker is for demo only. Use your own MQTT server in production — public means anyone can listen.
Step 4 · Open the dashboard¶
Run the dashboard app on your PC/laptop. Full guide: Dashboard App.
First-launch connection form:
| Field | Example value |
|---|---|
| Host | broker.hivemq.com |
| Port | 1883 (PC) or 8884 + TLS ON (web browser) |
| Topic | uwb/range/+ ← the + is required |
When connected, the top status bar turns green.
Step 5 · Register anchor coordinates → see your tag¶
Tap the 📍 (map pin) icon at the top-right and add each anchor:
| src | idx | X | Y |
|---|---|---|---|
A0 |
0 |
(from Step 1) | (from Step 1) |
A1 |
1 |
... | ... |
A2 |
2 |
... | ... |
Once 3 anchors are registered, position estimation kicks in.
Power up the tag and walk around. The dot on the map follows you. 🎉
🎥 [video placeholder] After Steps 4 + 5 are done, person walks slowly while the map dot tracks them (10–15 s). Filename:
assets/quickstart_demo.mp4or.gif
Something not working?¶
| Symptom | Check |
|---|---|
Phone Wi-Fi list doesn't show UWB-Anchor-XXXX |
Re-plug power while holding the button. Screen should say SETUP. |
| Anchor doesn't reach MQTT after Save | Wi-Fi SSID/PW typo, or 5 GHz-only Wi-Fi (anchors are 2.4 GHz only) |
Dashboard shows tags = 0 |
Anchor isn't publishing. Check the anchor screen / MQTT topic. |
tags ≥ 1 but positioned = 0 |
Fewer than 3 anchors registered, or coordinate-unit mismatch |
For deeper guidance see the Detailed Setup page.