bb-eco config

Read or write device configuration

Usage

bb-eco config <device> [<key> [<value>]] [options]

Arguments

Name	Description
<device>	IP address, MAC address, or device name
<key>	Configuration key to filter (e.g. 'network', 'io.lines')
<value>	Value to set for the configuration key

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
-?, -h, --help	Show help and usage information

Examples

Read a device's full configuration (an ED-549, 8-channel analogue input):

bb-eco config 192.168.0.63

identity.mac              : 00:0A:4F:06:4A:EE
identity.ip               : 192.168.0.63
identity.model            : ED-549
identity.firmwareVersion  : 8.25
identity.firmwareType     : T
identity.firmwareDate     : 26/06/2023
network.dhcp              : false
network.subnet            : 255.255.252.0
network.gateway           : 192.168.0.254
network.dns               :
network.webPort           : 80
network.upnp              : true
device.name               : ED-549
device.location           : jim
device.checkConnectivity  : false
security.adminUsername    :
security.userUsername     :
security.adminPasswordSet : false
security.userPasswordSet  : false
security.authentication   : Basic
security.resetProtection  : Everybody
io.protocol               : ASCII
io.dconAddress            : 1
io.dconTcpPort            : 9500
io.maxConnections         : 8
...
io.gatewayBaudRate        : 9600
io.commandTimeout         : 200
io.lines[0].index         : 0
io.lines[0].name          : AIn 0
io.lines[0].lineType      : analogInput
io.lines[0].enabled       : true
io.lines[0].unit          : V
io.lines[0].sensorType    : +/-10V
...

(Output trimmed — the full listing continues through every IO line.)

Write a single setting using the same key the read displays:

bb-eco config 192.168.0.63 device.location jim

Set 'device.location' = 'jim' on 192.168.0.63.

Per-line IO values use the same key scheme (io.lines[<slot>].<field>, slots ordered outputs first — the numbering shown on the device's own IO settings page). Set an output's power-on state, or an input's debounce time:

bb-eco config 192.168.0.77 io.lines[0].powerOnValue 1

Set 'io.lines[0].powerOnValue' = '1' on 192.168.0.77.

bb-eco config 192.168.0.77 io.lines[4].debounce 50

Set 'io.lines[4].debounce' = '50' on 192.168.0.77.

The quick-stop trigger pair is device-wide: io.eStopLine (a digital-input number, 255 = disabled) and io.eStopDirection (0 falling, 1 rising).

Read the configuration as JSON — the same shape used by template export:

bb-eco config 192.168.0.63 --json

{
  "identity": {
    "mac": "00:0A:4F:06:4A:EE",
    "ip": "192.168.0.63",
    "model": "ED-549",
    "modelVariant": null,
    "firmwareVersion": "8.25",
    "firmwareType": "T",
    "firmwareDate": "26/06/2023"
  },
  "network": {
    "dhcp": false
  }
}

(JSON trimmed to the first two sections.)

note

Device name, location and IO line names are limited to 10 characters by the device firmware — longer values are rejected before they reach the device.

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.