Skip to main content

bb-eco discover

Discover Brainboxes devices on the network

Usage

bb-eco discover [command] [options]

Options

OptionDescription
--allAlso show generic neighborhood devices (non-Brainboxes)
--continuousStream devices as they are discovered until cancelled
--csvOutput in CSV format
--jsonOutput in JSON format
--mdnsUse mDNS/DNS-SD protocol
--ssdpUse SSDP/UPnP protocol
--timeout <timeout>Discovery timeout in seconds [default: 10]
--timeout <timeout>Override default timeout in milliseconds
--verboseEnable verbose/debug output
--ws-discoveryUse WS-Discovery protocol
-?, -h, --helpShow help and usage information

Subcommands

CommandDescription
add <ip>Manually add a Brainboxes device by IP address

Examples

Discover all Brainboxes devices on the local network (10-second listen by default):

bb-eco discover
IP             MAC                Model   Name                                  Firmware  Update  Family  Interface  Network
------------- ----------------- ------ ------------------------------------ -------- ------ ------ --------- -------
192.168.2.97 00:0A:4F:05:28:DB ES-522 Brainboxes ES-522 Ethernet to Serial 4.69 ES en0 WiFi
192.168.0.63 00:0A:4F:06:4A:EE ED-549 ED-549 8.25 ED en0 WiFi
192.168.0.89 00:0A:4F:05:AF:E5 ED-588 ED-588 8.33 ED en0 WiFi

Found 3 device(s).

The Update column is filled in when a newer firmware version is available for the model. Discovered devices are saved, so bb-eco list can show them later without another network sweep.

Keep listening and print devices as they announce themselves (useful while power-cycling a device):

bb-eco discover --continuous

Get the results as JSON for scripting:

bb-eco discover --json

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.