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.
Legend
↵
...
Orange text
Grey Text
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 ↵
↵
carriage return
and so on
Client generated
Server generated
949
949