BaiFi Central

One binary for every board at every site. The WiFi name, the WiFi password and the controller address are typed into the board itself from a phone, and the board asks the controller for its own secret — so there is nothing to edit before flashing and no per-board build.

Works on NodeMCU v3 and Wemos D1 mini. Includes the thermal printer and push-button kiosk mode.

How to flash it

1. Flash baifi-coin.bin at offset 0x00000 (esptool, NodeMCU Flasher, or coin-bridge/flash.sh). Erase the flash first — a board that keeps an old secret talks to a controller that no longer knows it.
2. On your phone, join the network the board raises: BaiFi-Setup-XXXX — no password. Any page you open lands on the setup form.
3. Pick the shop's WiFi. The password box appears only if that network has one, and the controller is found on the network by itself — there is nothing else to fill in.
4. Approve the board in the dashboard under Vendo List. It picks up its secret within five seconds and the coin slot opens.

Download firmware

The whole controller on one disk image: the portal, RADIUS, billing, vouchers, payments and the cloud link. Write it to the mini PC's disk and it comes up configured — there is no installer to sit through.

First boot generates this machine's own keys and shows its address on the console. Default console login baifi / baifi, and the boot screen keeps saying so until you change it.

How to write it

1. Decompress and write to the target disk — balenaEtcher, Rufus, or xzcat baifi-os-*.img.xz | dd of=/dev/sdX bs=4M status=progress.
2. Boot the mini PC. It grows its own filesystem and starts.
3. Read the address off the boot screen and open http://<address>:8080/admin.
4. Add the MikroTik under Network → Routers and press Provision. It configures the router, RADIUS, CoA and the captive portal itself.

Download image

The captive portal, served by the router itself. Provisioning pushes these automatically; this copy is for uploading by hand, or for a router being set up before its controller is on site.

Every page is local and every link is relative — a captive portal browser will load what the hotspot hands it and will not follow a redirect anywhere else.

How to install it by hand

1. Unzip. Delete any existing baifi-hotspot folder in Winbox → Files first, or MikroTik adds login_1.html beside the old one and keeps serving the old one.
2. Drag the baifi-hotspot folder into Files.
3. /ip hotspot profile set <profile> html-directory=baifi-hotspot

Download portal files