This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Livewire

This section covers the integration with Livewire/Axia devices by Telos Alliance:

  • LWRP – GPIO control of Axia consoles and xNodes via the Livewire Routing Protocol.
  • Telos VX – control of Telos VX phone systems via the Livewire Control Protocol (LWCP).

1 - LWRP

The Axia GPIO TCP/IP Direct Interface (LWRP) connects mAirList to an Axia console or xNode via the Livewire Routing Protocol. It uses the virtual GPIO ports of the device, so no physical GPIO wiring is required.

Configuration

In the configuration app or Control Panel, go to Remote Control and add an interface of type Axia GPIO TCP/IP Direct Interface (LWRP) (Livewire category).

On the Connection tab, enter the Host name or IP of the device. The default port is 93 (LWRP).

Players

On the Players tab, select the playlist and player, and enter the GPIO Number (port 1 to 24) that is assigned to the console channel of that player.

mAirList uses the standard Axia GPIO pin assignment for console channels:

  • Pin 4 (channel ON) starts the player.
  • Pin 5 (channel OFF) stops the player.
  • Pin 3 (PFL) switches the PFL of the player, if Automatic PFL switch is enabled.

Options:

  • Automatic PFL switch: Pin 3 switches the PFL of the player on and off.
  • Use PAUSE/STOP: When the channel is switched off, the player is paused rather than stopped.

GPO Events

The GPO Events tab lists all GPIO ports and pins. For each pin, you can enter a remote control command to execute when the pin goes High and Low.

Actions

The Set GPI action (Livewire category) sets the state of the pins of a GPIO port. For each of the five pins, select H (high), L (low), or x (no change).

2 - Telos VX (LWCP)

This interface connects mAirList to a Telos VX broadcast phone system via the Livewire Control Protocol (LWCP). It allows scripts to monitor the state of the phone lines and to control calls, e.g. to build a custom call screener interface.

Configuration

In the configuration app or Control Panel, go to Remote Control and add an interface of type Telos VX LWCP (Livewire category).

  • Host name or IP and Port: The address of the VX engine. The default port is 20518.
  • Authentication: The User and Password for the VX engine.
  • Studio ID or name: The studio to select after logging in, either by its numeric ID or its name.

The Monitor tab displays the communication with the VX engine, which is helpful for troubleshooting.

Scripting

This interface does not execute any commands by itself. It is controlled by background scripts.

To control the phone lines, use the following methods of VXLWCPRemote(<index>):

  • CallNumber(Line, Number) – dial a number on a line,
  • TakeCall(Line) – take a call,
  • HoldCall(Line, Ready) – put a call on hold,
  • DropCall(Line) – drop a call,
  • SelectStudio(Value) – select a different studio.

Changes of the line states are reported through the following event handler:

procedure OnVXLineEvent(Remote: IVXLWCPRemote; Line, Hybrid: integer;
  Comment, State, CallState: string; Time, Cause: integer;
  Busy: boolean; RemoteNumber, CallerID, Direction: string);

In addition, all LWCP messages received from the VX engine (including line events) are passed to the OnLWCPCommand(Remote, Command, ObjectName, Data) event handler.