Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
通过 BLE 为 ESP32 配网（BluFi 协议）
lager blufi COMMAND [ARGS] [OPTIONS]
--box BOX（Lager Box 名称或 IP，省略时使用默认 Box）。除 scan 之外的所有命令都需要一个 DEVICE_NAME 参数，用于指定目标 BluFi 设备。
| 命令 | 说明 |
|---|---|
scan | 扫描支持 BluFi 的 BLE 设备 |
connect | 连接一台 BluFi 设备并获取版本和状态 |
provision | 向 BluFi 设备下发 WiFi 凭据 |
wifi-scan | 通过 BluFi 设备扫描 WiFi 网络 |
status | 从 BluFi 设备获取 WiFi 连接状态 |
version | 从 BluFi 设备获取固件版本 |
scan| 选项 | 默认值 | 说明 |
|---|---|---|
--timeout | 10.0 | Box 扫描的总时长（秒） |
--name-contains | 只保留名称包含该字符串的设备 |
lager blufi scan --box my-lager-box
lager blufi scan --name-contains ESP --box my-lager-box
connectlager blufi connect ESP32-DEVICE --box my-lager-box
| 选项 | 默认值 | 说明 |
|---|---|---|
--timeout | 20.0 | BLE 连接超时时间（秒） |
provisionlager blufi provision ESP32-DEVICE --ssid HomeNet --password secret123 --box my-lager-box
| 选项 | 默认值 | 说明 |
|---|---|---|
--ssid | （必填） | 要配置的 WiFi 网络 SSID |
--password | （必填） | WiFi 网络密码 |
--timeout | 20.0 | BLE 连接超时时间（秒） |
wifi-scanlager blufi wifi-scan ESP32-DEVICE --box my-lager-box
| 选项 | 默认值 | 说明 |
|---|---|---|
--timeout | 20.0 | BLE 连接超时时间（秒） |
--scan-timeout | 15.0 | 设备上的 WiFi 扫描时长（秒） |
statuslager blufi status ESP32-DEVICE --box my-lager-box
| 选项 | 默认值 | 说明 |
|---|---|---|
--timeout | 20.0 | BLE 连接超时时间（秒） |
versionlager blufi version ESP32-DEVICE --box my-lager-box
| 选项 | 默认值 | 说明 |
|---|---|---|
--timeout | 20.0 | BLE 连接超时时间（秒） |
# 1. 找到设备
lager blufi scan --name-contains ESP --box my-lager-box
# 2. 下发凭据
lager blufi provision ESP32-DEVICE --ssid HomeNet --password secret123 --box my-lager-box
# 3. 确认它已接入网络
lager blufi status ESP32-DEVICE --box my-lager-box