beautypg.com

NewTek TriCaster Advanced Edition Automation and Integration Guide User Manual

Page 29

background image

17 |

P a g e

The entry for a given GPI control device must contain an IP address and port, password, and custom name,
entered as follows:

< device name="name " ip="###.###.###.###" port="##" password=" "/>

At the time of writing, the xml ‘element name’ signified above by the placeholder device should be
“jlcooper”, without the quotation marks. The value for the “name” attribute that follows is a custom name
of your choosing.

Hint: Normally, connected GPI devices are identified by unique names in this file; otherwise (if GPI devices share
a single name) GPI commands are issued to them simultaneously.

The remaining configuration attributes (“ip”, “port” and “password”) are set at the external hardware
device (refer to the vendor’s documentation for details); the corresponding values need only be transferred
into the XML configuration file. A typical entry might look like this:

L

ISTENING FOR

GPI

T

RIGGERS

Just like keyboard shortcuts, control surface and MIDI button operations described earlier, properly
configured and connected GPI devices can trigger macros. To assign a GPI trigger to a macro, simply click a
‘gesture field’ in the Shortcuts group at the bottom of the Macro Configuration panel (Figure 13); then send
the desired external GPI trigger to the system. The ‘listening’ control will recorded the GPI signal, and a
suitable shortcut entry will be displayed.

S

ENDING

GPI

C

OMMANDS

A special macro command allows you to send GPI signals to external devices and systems via network-
connected GPI interface devices (such as the eBOX™ from JLCooper Electronics). GPI macro entries are
formatted as shown below:

Delay (ms) Shortcut Value Key 1

Value 1 etc.

####

gpi

name GPI_pin# boolean

Delay – the interval, in milliseconds, between the time when the command on the prior line (if any)
was issued to the system, and execution of this line.

Shortcut – Use the entry “gpi” in this field to send a GPI signal.

Value – The shortcut value is the name of the GPI device (defined earlier in gpi_setup.xml) that you
want the signal defined on this line to address.

Key # (0 – n) – The value you enter in this field identifies a target pin on the external DVI device to
receive a signal defined in the following field.
The entry should be formatted as “pin#” (e.g., “pin1”, without quotation marks).

Value # (0 – n) – This value controls the contact closure state (on or off) for the GPI device pin
identified by the preceding key. The value can be entered variously as “1” or “0” , “on” or “off”,
“true” or “false” (without quotations).