Skip to content

WiFi and web UI

WiFi is off by default. Turn it on in Settings, under the WiFi group.

Set wifi_mode to one of:

  • sta: join an existing network. Set wifi_ssid and wifi_pass.
  • ap: host a hotspot. Set ap_ssid and, for a protected network, an 8 character or longer ap_pass. An empty password makes it open.
  • off: WiFi disabled.

Reboot after changing the mode. The serial log prints the IP address when the link comes up. The WiFi icon in the sidebar reflects the state.

When WiFi is up and web_enabled is on, the badge serves a web interface on its IP address.

  • / is a settings form. It lists every setting, grouped, and writes changes back to the badge. It is the same schema the on-device Settings app uses, so the two stay in sync.
  • /diag shows the diagnostics: node id, radio config, peer count, packet counters, and the last signal.
  • /import backs up and restores the configuration.
  • /update flashes new firmware over the air.

Radio changes made in the web form take effect after a reboot.

The form prefills current values, including passwords, so treat the badge’s network as trusted. If you host an open hotspot, anyone who joins can read and change settings.

Open /import to download a badge-config.json of every setting, or to paste one back to restore it. The download includes the channel key and WiFi password so the file can clone a badge; use the “without secrets” link to leave those out. A restore validates each value and reports how many it applied, skipped, rejected, or did not recognise. Reboot afterwards for radio and WiFi changes to take effect.

Open /update, choose a had-badge-mod application binary built for this board, and the badge writes it to the spare flash slot and reboots into it. If the new image fails to start cleanly, the bootloader rolls back to the previous one on the next reset.

Over-the-air updates rely on the dual-slot partition layout, which a normal build already uses. The first time you move a badge onto that layout you must flash once over USB, because a partition-table change cannot be delivered over the air. See Build and flash for the details.