Developer Information
94
Blackmagic Videohub Ethernet Protocol v2.2
Summary
The Blackmagic Videohub Ethernet Protocol is a text based protocol that is accessed by connecting to
TCP port 9990 on a Videohub Server. Integrated Videohub Servers and Videohub Server computers are
supported by the protocol.
The Videohub Server sends information in blocks which each have 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.
Upon connection, the Videohub Server sends a complete dump of the state of the device. After the initial
status dump, status updates are sent every time the Videohub status changes.
To be resilient to future protocol changes, clients should ignore blocks they do not recognize, up to the
trailing blank line. Within existing blocks, clients should ignore lines they do not recognize.
Protocol Preamble
The first block sent by the Videohub Server is always the protocol preamble:
PROTOCOL PREAMBLE:
↵
Version: 2.2
↵
↵
The version field indicates the protocol version. When the protocol is changed in a compatible way, the
minor version number will be updated. If incompatible changes are made, the major version number will
be updated.
Device Information
The next block contains general information about the connected Videohub device. If a device is connected,
the Videohub Server will report the attributes of the Videohub:
VIDEOHUB DEVICE:
↵
Device present: true
↵
Model name: Blackmagic Smart Videohub
↵
Video inputs: 16
↵
Video processing units: 0
↵
Video outputs: 16
↵
Video monitoring outputs: 0
↵
Serial ports: 0
↵
↵
This example is for the Smart Videohub which is a 16x16 router.
Legend
↵
carriage return
…
and so on
Version 2.2 of the Blackmagic Videohub Ethernet Protocol
was released with Videohub 4.7 software.