bb-eco
BB Eco — discover, monitor, and configure Brainboxes devices
Usage
bb-eco [command] [options]
Options
| Option | Description |
|---|---|
--csv | Output in CSV format |
--json | Output in JSON format |
--timeout <timeout> | Override default timeout in milliseconds |
--verbose | Enable verbose/debug output |
--version | Show version information |
-?, -h, --help | Show help and usage information |
Subcommands
| Command | Description |
|---|---|
config <device> <key> <value> | Read or write device configuration |
diagnostics | Collect system and network diagnostic information |
discover | Discover Brainboxes devices on the network |
features | Show the app-capability compatibility matrix per device class |
firewall | Inspect or configure host firewall rules for bb-eco |
firmware | Inspect firmware state on Brainboxes devices |
list | List saved Brainboxes devices |
locate <device> | Flash the device's status LED to physically locate it |
products | Browse the Brainboxes product catalogue |
reboot <device> | Reboot a Brainboxes device |
reset | Delete all app data — saved devices, template/drift history, and logs. Keeps the firmware cache. |
scan <cidr> | Scan a subnet for network devices (TCP port probe + HTTP enrichment) |
soak | Roulette-flash random compatible firmware onto every device in an inventory file, repeatedly. DESTRUCTIVE bench tool — requires BB_ECO_SOAK_ITERATIONS. |
telemetry <action> | Opt in to or out of anonymous firmware-update diagnostics shared with Brainboxes, or inspect what is sent. |
template | Manage device configuration templates |
upgrade <device> <firmware-file> | Upgrade firmware on a Brainboxes device |
Examples
A typical first session — find every Brainboxes device on the network, save the results, then check one device's firmware:
bb-eco discover
bb-eco list
bb-eco firmware status 192.168.0.63
Model: ED-549
Current Version: 8.25
Update Available: No
Every command accepts --json or --csv for machine-readable output, --verbose for diagnostic detail, and --timeout <ms> to bound network waits — see the option tables on each command page.
This page is auto-generated from the live CLI help text. Do not edit by hand - re-run node scripts/gen-cli-reference.mjs after changes. Example sections are maintained in docs/cli-examples/ in the bb-eco repo.