bb-eco upgrade all
Update every discovered ED/ES device to its latest cached firmware, one device at a time.
Usage
bb-eco upgrade [<device> [<firmware-file>]] all [options]
Arguments
| Name | Description |
|---|---|
<device> | IP address, MAC address, or device name |
<firmware-file> | Path to the .efw firmware file |
Options
| Option | Description |
|---|---|
--allow-factory-reset | Include images that reset the device to factory settings (skipped otherwise). |
--csv | Output in CSV format |
--devices <devices> | Device inventory file (test-devices.json schema) instead of network discovery. |
--discovery-seconds <discovery-seconds> | How long to listen for devices before planning. [default: 5] |
--dry-run | Rehearse the batch without touching any device: simulated flashes, no sockets, no CGI. |
--dry-run-fail <dry-run-fail> | With --dry-run: script failures, e.g. 00:0A:4F:..=committed,00:0A:4F:..=notStarted,00:0A:4F:..=connections. |
--force | Skip the typed CONFIRM prompt. |
--json | Output in JSON format |
--on-failure <on-failure> | What to do when a device fails: pause (ask y/N; the default), continue, or stop. Pause degrades to stop when stdin is redirected or --json is set. [default: pause] |
--timeout <timeout> | Override default timeout in milliseconds |
--verbose | Enable verbose/debug output |
-?, -h, --help | Show help and usage information |
Examples
Bring every discovered ED and ES device up to the latest cached firmware, one device at a time. The plan is shown first and nothing is flashed until you type CONFIRM. On Linux, prefix the command with sudo; Windows and macOS need no elevation:
bb-eco upgrade all
3 device(s) to update, 2 skipped.
Model IP MAC Current Target Action
ED-588 192.168.0.63 00:0A:4F:05:F7:CA 8.25 8.33 Update
ED-549 192.168.0.64 00:0A:4F:06:4A:EE 8.25 8.33 Update
ES-522 192.168.0.70 00:0A:4F:05:28:DB 4.69 7.02 Update
ED-560 192.168.0.65 00:0A:4F:05:B1:10 8.33 - Skip: AlreadyLatest - already on 8.33
ED-004 192.168.0.66 00:0A:4F:05:E0:FF 8.30 - Skip: ThirdPartyConnections - 192.168.0.9:9500, 0, 00:12:40, Modbus
Type CONFIRM to update 3 device(s): CONFIRM
[1/3] ED-588 00:0A:4F:05:F7:CA: starting (about 5 min left)
[1/3] ED-588 00:0A:4F:05:F7:CA: BootloaderUpgrade 12%
...
Devices that another host is using, or whose update would reset them to factory settings, are skipped and the reason is printed. For a script, skip the prompt and carry on past failures:
bb-eco upgrade all --force --on-failure continue --json
Exit code 0 means every device was updated or skipped, 1 means at least one failed or was not reached, and 2 means nothing was eligible. Rehearse the whole batch without touching a device:
bb-eco upgrade all --dry-run --force
See Update firmware on every device at once for the desktop equivalent and the report it produces.
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.