BluFi

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. It brings an unprovisioned ESP32 DUT onto the network as part of a test.

Syntax

lager blufi COMMAND [ARGS] [OPTIONS]

Every subcommand accepts --box BOX (Lager Box name or IP; uses the default box if omitted). All commands except scan take a DEVICE_NAME argument identifying the target BluFi device.

Commands

Command	Description
`scan`	Scan for BluFi-capable BLE devices
`connect`	Connect to a BluFi device and retrieve version and status
`provision`	Provision WiFi credentials to a BluFi device
`wifi-scan`	Scan for WiFi networks via a BluFi device
`status`	Get WiFi connection status from a BluFi device
`version`	Get firmware version from a BluFi device

Command Reference

`scan`

Scan for BluFi-capable BLE devices.

Option	Default	Description
`--timeout`	`10.0`	Total time (seconds) the box spends scanning
`--name-contains`		Filter 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

Option	Default	Description
`--timeout`	`20.0`	BLE connection timeout (seconds)

`provision`

Provision WiFi credentials to a BluFi device.

lager blufi provision ESP32-DEVICE --ssid HomeNet --password secret123 --box my-lager-box

Option	Default	Description
`--ssid`	(required)	WiFi network SSID to provision
`--password`	(required)	WiFi network password
`--timeout`	`20.0`	BLE connection timeout (seconds)

`wifi-scan`

Scan for WiFi networks via a BluFi device.

lager blufi wifi-scan ESP32-DEVICE --box my-lager-box

Option	Default	Description
`--timeout`	`20.0`	BLE connection timeout (seconds)
`--scan-timeout`	`15.0`	WiFi 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

Option	Default	Description
`--timeout`	`20.0`	BLE connection timeout (seconds)

`version`

Get the firmware version from a BluFi device.

lager blufi version ESP32-DEVICE --box my-lager-box

Option	Default	Description
`--timeout`	`20.0`	BLE 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

Lager Box Management

Configuration

Power & Simulation

Measurement

I/O & Communication

Development

Utilities

Syntax

Commands

Command Reference

`scan`

`connect`

`provision`

`wifi-scan`

`status`

`version`

Typical Flow

See Also

​Syntax

​Commands

​Command Reference

​scan

​connect

​provision

​wifi-scan

​status

​version

​Typical Flow

​See Also

Syntax

Commands

Command Reference

`scan`

`connect`

`provision`

`wifi-scan`

`status`

`version`

Typical Flow

See Also