Blackmagicdesign Teranex 2D Processor, Installation And Operation Manual

Page: 223 / 969

Connection
The Blackmagic Teranex Ethernet Server listens on TCP port 9800. In a Telnet session, type in
“telnet” and a space, followed by the IP address of your Teranex, another space and “9800”.
For example: telnet 192.168.90.236 9800
Connection Response
Upon connection, the Teranex Server sends a complete dump of the state of the device.
The Teranex Server sends information in blocks, with each having an identifying header in
all-caps, followed by a full-colon. A block spans multiple lines and is terminated by a blank line.
Each line in the protocol is terminated by a newline character.
The protocol preamble block is always the first block sent by the Teranex Server, followed by
the device block:
PROTOCOL PREAMBLE:
↵
Version: 1.13
↵
↵
TERANEX DEVICE:
↵
Model name: Teranex 2D
↵
↵
After the initial status dump, status updates are sent each time the status changes in the Teranex device.
Command Syntax
To initiate a change, the user should send the appropriate block header, followed by a full-colon and
LF, which is then followed by the specific command requested, a full-colon, the value required, a LF,
followed by a blank line. For example, to change the output video format to 1080i59.94, the user
should send the following block of commands:
VIDEO OUTPUT:
↵
Video mode: 1080i5994
↵
↵
Response Syntax
If the command is accepted by the Teranex Server, it will respond with an ACK message. If the
request was not understood, it will respond with a NACK message.
After a positive response, the user should expect to see a status update from the Teranex Server
showing the status change. This is likely to be the same as the command that was sent, sometimes
followed by other blocks providing data specific to the change. For the above example, the following
response might be displayed:
VIDEO OUTPUT:
↵
Video mode: 1080i5994
↵
↵
Legend
↵ carriage return
…
and so on
Orange text Client generated
Grey Text Server generated
223 223
デベロッパーの皆様へ