bb-eco soak
Roulette-flash random compatible firmware onto every device in an inventory file, repeatedly. DESTRUCTIVE bench tool — requires BB_ECO_SOAK_ITERATIONS.
Usage
bb-eco soak [options]
Options
| Option | Description |
|---|---|
--allow-es | Include ES devices. ES bootloader recovery is validated on ES-522 only — other ES models flash at their own risk. |
--capture-iface <capture-iface> | tshark capture interface (defaults to BB_ECO_SOAK_CAPTURE_IFACE; required on Windows — Npcap has no "any"). |
--csv | Output in CSV format |
--devices <devices> (REQUIRED) | Device inventory file (test-devices.json schema). Every listed device that answers a ping gets flashed repeatedly. |
--firmwares <firmwares> (REQUIRED) | Root directory of the firmware pool; every parseable .efw underneath (recursive) joins the roulette. |
--force | Skip the typed CONFIRM prompt (the env-var gate still applies). |
--iterations <iterations> | Full passes over the device list. Overrides the BB_ECO_SOAK_ITERATIONS count, but the env var must still be set >0 — that's the friction gate. |
--journal <journal> | JSONL journal path (default: soak-journal.jsonl in the working directory). |
--json | Output in JSON format |
--pcap-dir <pcap-dir> | Directory for per-flash packet captures kept on failure (defaults to BB_ECO_SOAK_PCAP_DIR, else a temp dir). |
--seed <seed> | RNG seed for replaying a run (defaults to BB_ECO_SOAK_SEED, else random; always echoed). |
--timeout <timeout> | Override default timeout in milliseconds |
--verbose | Enable verbose/debug output |
-?, -h, --help | Show help and usage information |
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.