Developer Information
17
Blackmagic Videohub Ethernet Protocol v2.3
Summary
Blackmagic MultiView 16 is compatible with the Blackmagic Videohub Ethernet Protocol. It is text
based and is accessed by connecting to your Blackmagic MultiView 16's IP address and TCP port 9990.
The multi view 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.
Lines sent to the Blackmagic MultiView 16 can be terminated with line feed, carriage return or both.
Upon connection, the multi view sends a complete dump of the state of the device. After the initial
status dump, status updates are sent every time the multi view 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 multi view is always the protocol preamble:
PROTOCOL PREAMBLE:↵
Version: 2.3↵
↵
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 Blackmagic MultiView 16 device.
If a device is connected, the multi view will report the attributes of the Blackmagic MultiView 16:
MULTIVIEW DEVICE:↵
Device present: true↵
Model name: Blackmagic MultiView 16↵
Video inputs: 16↵
Friendly name:
Unique ID:
Video processing units: 0↵
Video outputs: 16↵
Video monitoring outputs: 0↵
Se ria l Por ts:
↵
This example is for the Blackmagic MultiView 16 which has 16 sources and 18 views including solo
which is view 16 and audio which is view 17, referred to here as outputs.
Legend
↵ line feed
… and so on
Version 2.3 of the Blackmagic Videohub Ethernet Protocol
was released with Videohub 4.9.1 software.
Developer Information