Skip to content

quickstart.md

Latest commit

 

History

History
41 lines (27 loc) · 2.39 KB

quickstart.md

File metadata and controls

41 lines (27 loc) · 2.39 KB

Azimuth quick start

Short path from a fresh flash to head tracking in OpenTrack over Wi‑Fi.

Assumes firmware is already installed (the published web flasher build is the default XIAO image). Hardware paths and which build to flash: README, hardware-profiles.md. Deeper portal and OpenTrack detail: using-azimuth.md.

1. Join your home Wi‑Fi (first setup)

  1. Power the board on. On your phone or computer, connect to the Azimuth-Setup Wi‑Fi network.
  2. A setup page should open automatically, or open http://192.168.4.1/ in a browser.
  3. Enter your home Wi‑Fi name and password.
  4. Scroll to the bottom of the page and save (apply). The board will connect to your network and restart.

2. Tell the tracker where OpenTrack runs

Do this on the same computer where you use OpenTrack, on your home Wi‑Fi (not on Azimuth-Setup).

  1. Open http://azimuth.local:8080/ in a browser.
    If that fails, use http://<device-ip>:8080 (find the device in your router’s list). The address must end in :8080.
  2. Turn UDP to PC on if it is off.
  3. Click Fill address (the page fills in this PC’s address for you). If you don’t see that button, type this PC’s IPv4 (e.g. 192.168.1.x) in UDP address instead.
  4. Scroll down and save.

3. OpenTrack

  1. Input: UDP over network (wording may vary slightly by version).
  2. Port: match the UDP port in the portal (default 4242 unless you changed it).
  3. If Windows asks, allow the port through the firewall.

Move the tracker—you should see motion. Recenter in OpenTrack after things settle.

Firmware updates

On home Wi‑Fi, the portal may show a banner if a newer version is published on GitHub Pages (one check per boot). Follow the USB installer link and reflash from Chrome or Edge. The flasher page always lists the version it ships; your device’s version appears under Device on the portal.

More help