Skip to content

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)
   [Anchor B]          [Anchor C]
       ●                  ●
        \      Tag       /
         \   ⬤ ─ Person /
          \            /
           \          /
            ●────────●
       [Anchor A]   [Anchor D]

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:

  1. Hold the board's button while plugging in power
  2. The screen shows:
    SETUP
    WiFi: UWB-Anchor-XXXX
    PW:   00000000
    URL:  http://192.168.4.1
    
  3. On your phone, join Wi-Fi UWB-Anchor-XXXX with password 00000000
  4. Open the browser and go to http://192.168.4.1
  5. 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
  1. 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.mp4 or .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.