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.1.107 00:0A:4F:05:28:DB ES-522 Brainboxes ES-522 Ethernet to Serial 4.69 ES en0 WiFi
192.168.1.101 00:0A:4F:06:4A:EE ED-549 ED-549 8.25 ED en0 WiFi
192.168.1.100 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.