How to setup a BI-Beacon

Setup BI-Beacon via Wifi

You can setup a BI-Beacon using a mobile or desktop device that connects to the Beacons own setup web page.

  1. Plugin your BI-Beacon (it turns blue)
  2. Disable mobile network (if on mobile device)
  3. Wait up to 30 seconds until BI-Beacon starts shifting in slowly between blue and green (it means setup mode is active)
  1. Connect to WiFi “BI-Beacon-A1B2C3” (A1B2C3 is unique for your lamp)
  1. Browse to BI-Beacon’s Setup Page:

  2. Enter details

    a. WiFi name: the WiFi lamp should connect to (SSID) b. WiFi password: password of WiFi to connect to (empty if no password) c. Systemid: the string identifier controlling the beacon state (see API)

  1. Wait for green
    1. It will first turn blue which means it is connecting to router
    2. Then it will turn purple which means it is connecting to state server
    3. Then it will turn green when connected

If you have any issues, please refer to troubleshooting.


To reset or reconfigure a BI-Beacon, reboot it whilst it cannot connect to the router. E.g by doing any of the following:

  1. Change SSID or password on the router
  2. Turn off the router temporarily
  3. Move the BI-Beacon far away from the router

When you plug it in again, BI-Beacon will try to connect and fail. It will then go into setup mode again.

Setup BI-Beacon via USB

You can also setup a BI-Beacon using a USB data cable, however this requires that you are on a Linux machine with a user in the dialout usergroup.

Clone the cli repo (see Repositories).

Then, in a terminal of your choice,

$ python <ssid> <password> <systemid>