Livewire Routing Protocol (LWRP)

This connection type implements the Livewire Routing Protocol (LWRP).

Supported Devices and Prerequisites

We can connect to all devices that support LWRP, for example any kind of Axia xNode, or the Livewire Driver. The exact capabilities depend of the device and are queried from the device during configuration (see below).

Configuration

General Tab

First, enter IP/hostname and Port (usually 93) of your Livewire device, plus optionally the password if one is set on the device.

In the next step, various properties of the device must be determined:

• The number of Livewire sources and destinations.
• The number of GPIs and GPOs.
• The number of mixpoints.
• The number of inputs.

While you can edit these fields manually, the most convenient method is to click Retrieve from Device - BTConnect will briefly connect to the device and issue a VER command, which returns all the required numbers.

Additional settings:

• GPIO High = false: Livewire uses the value “High” to indicate an inactive GPIO state. This option - enabled by default - will use true for “High” and false for “Low”, so it is integrated more natural with the rest of the BTConnect system.
• Writeable GPIs: On physical devices like xNodes, GPI pins are typically read only (as they report the electrical state of the physical port); but on other devices, most notably the Livewire Driver, GPIs can be written to from the software. Check this option if you want your GPIs to be writeable. If unchecked, GPI pins will become read-only parameters.
• LPSTAT polling: Some devices, in particular xNodes, support an LPSTAT command that returns additional status information about the device, e.g. the uplink status of the ethernet port, or the status of the power supplies. This information can only be retrieved via polling, which you can enable here.

Level Detection Tab

Some Livewire devices (e.g. xNodes) support integrated silence and clip detection for all inputs and outputs.

The availability of this feature, or the number of inputs/outputs it supports, can not be queried with the VER command, so it is offered in the configuration regardless of the device you are using; please refer to the device documentation to find out if it supports level detection at all.

For each input/output, you can set the target levels (dBFS) and the number of milliseconds after which the event should be reported.

Parameters

LWRP connections provide the following parameters:

General information

• device/name (string, read-only) - The name of the device.
• device/product (string, read-only) - The product name of the device.
• device/model (string, read-only) - The model of the device.
• device/version (string, read-only) - The software version of the device.

Status information

Note: only available if LPSTAT polling is enabled

• status/temperature (integer, read-only) - temperature of the unit in celsius.
• status/psu (boolean, read-only) - The status of the internal power supply.
• status/poe (boolean, read-only) - The status of PoE power supply.
• status/net0 (boolean, read-only) - The status of the first Ethernet port.
• status/net1 (boolean, read-only) - The status of the second Ethernet port.

Livewire sources

• source/<id>/name (string, read/write) - The name of the source.
• source/<id>/enabled (boolean, read/write) - Is the source enabled?
• source/<id>/address (string, read/write) - The address of the soure.
• source/<id>/sendaddress (string, read-only) - The current effective RTP multicast address.
• source/<id>/channels (integer, read-only) - The number of channels (2 or 8).
• source/<id>/gain (float, read/write) - The volume gain in dB.

Livewire destinations

• destination/<id>/name (string, read/write) - The name of the destination.
• destination/<id>/up (boolean, read-only) - Is the destination up and running?
• destination/<id>/address (string, read/write) - The source address of the destination.
• destination/<id>/receiveaddress (string, read-only) - The current effective RTP address.
• destination/<id>/channels (integer, read/write) - The number of channels (2 or 8).
• destination/<id>/gain (float, read/write) - The volume gain in dB.

GPIO

• gpi/<number>/pin/<number> (boolean, read-only) - the state of the specified GPI and pin (each GPI has five pins).
• gpo/<number>/pin/<number> (boolean, read/write) - the state of the specified GPO and pin (each GPO has five pins).

Mixer

• mixer/<output>/<input> (float, read-write) - the matrix mixer crosspoint, specified as a dB value in the range -1000 (off) to 0.

Level Detection

• input/<id>/silence/left (boolean, read-only) - silence status of the left channel of the input.
• input/<id>/silence/right (boolean, read-only) - silence status of the right channel of the input.
• input/<id>/silence/any (boolean, read-only) - silence status of any channel of the input (logical OR of left and right).
• input/<id>/silence/both (boolean, read-only) - silence status of both channels of the input (logical AND of left and right).
• input/<id>/clip/left (boolean, read-only) - clipping status of the left channel of the input.
• input/<id>/clip/right (boolean, read-only) - clipping status of the right channel of the input.
• input/<id>/clip/any (boolean, read-only) - clipping status of any channel of the input (logical OR of left and right).
• input/<id>/clip/both (boolean, read-only) - clipping status of both channels of the input (logical AND of left and right).
• output/<id>/silence/left (boolean, read-only) - silence status of the left channel of the output.
• output/<id>/silence/right (boolean, read-only) - silence status of the right channel of the output.
• output/<id>/silence/any (boolean, read-only) - silence status of any channel of the output (logical OR of left and right).
• output/<id>/silence/both (boolean, read-only) - silence status of both channels of the output (logical AND of left and right).
• output/<id>/clip/left (boolean, read-only) - clipping status of the left channel of the output.
• output/<id>/clip/right (boolean, read-only) - clipping status of the right channel of the output.
• output/<id>/clip/any (boolean, read-only) - clipping status of any channel of the output (logical OR of left and right).
• output/<id>/clip/both (boolean, read-only) - clipping status of both channels of the output (logical AND of left and right).

Input Status

• input/<id>/aessync (boolean, read-only) - sync status of the AES input (dynamic parameter, will only appear for AES inputs)