Skip to main content
Provision WiFi credentials to an ESP32 device over Bluetooth Low Energy using the BluFi protocol. Use it to scan for BluFi-capable devices, push SSID/password credentials, and read back connection status and firmware version — handy for bringing an unprovisioned ESP32 DUT onto the network as part of a test.

​
Syntax

lager blufi COMMAND [ARGS] [OPTIONS]
Every subcommand accepts --box BOX (Lagerbox name or IP; uses the default box if omitted). All commands except scan take a DEVICE_NAME argument identifying the target BluFi device.

​
Commands

CommandDescription
scanScan for BluFi-capable BLE devices
connectConnect to a BluFi device and retrieve version and status
provisionProvision WiFi credentials to a BluFi device
wifi-scanScan for WiFi networks via a BluFi device
statusGet WiFi connection status from a BluFi device
versionGet firmware version from a BluFi device

​
Command Reference

​
scan

Scan for BluFi-capable BLE devices.
OptionDefaultDescription
--timeout10.0Total time (seconds) the box spends scanning
--name-containsFilter to devices whose name contains this string
lager blufi scan --box my-lager-box
lager blufi scan --name-contains ESP --box my-lager-box

​
connect

Connect to a BluFi device and retrieve its version and status. 
lager blufi connect ESP32-DEVICE --box my-lager-box
OptionDefaultDescription
--timeout20.0BLE connection timeout (seconds)

​
provision

Provision WiFi credentials to a BluFi device. 
lager blufi provision ESP32-DEVICE --ssid HomeNet --password secret123 --box my-lager-box
OptionDefaultDescription
--ssid(required)WiFi network SSID to provision
--password(required)WiFi network password
--timeout20.0BLE connection timeout (seconds)

​
wifi-scan

Scan for WiFi networks via a BluFi device. 
lager blufi wifi-scan ESP32-DEVICE --box my-lager-box
OptionDefaultDescription
--timeout20.0BLE connection timeout (seconds)
--scan-timeout15.0WiFi scan duration on the device (seconds)

​
status

Get the WiFi connection status from a BluFi device. 
lager blufi status ESP32-DEVICE --box my-lager-box
OptionDefaultDescription
--timeout20.0BLE connection timeout (seconds)

​
version

Get the firmware version from a BluFi device. 
lager blufi version ESP32-DEVICE --box my-lager-box
OptionDefaultDescription
--timeout20.0BLE connection timeout (seconds)

​
Typical Flow

# 1. Find the device
lager blufi scan --name-contains ESP --box my-lager-box

# 2. Provision credentials
lager blufi provision ESP32-DEVICE --ssid HomeNet --password secret123 --box my-lager-box

# 3. Confirm it joined the network
lager blufi status ESP32-DEVICE --box my-lager-box

​
See Also

  • BLE — scan and connect to generic BLE devices
  • WiFi — manage the Lager Box’s own WiFi settings