User's Manual

223
Developer Information
Blackmagic SmartView Ethernet

Protocol v1
.
3
Summary
The Blackmagic SmartView Ethernet Protocol is a text-based status and control protocol, very
similar in structure to the Videohub protocol, that is accessed by connecting to TCP port 9992 on
a SmartView or SmartScope device.
Upon connection, the SmartView or SmartScope device sends a complete dump of the state
of the device. After the initial dump, state changes are sent asynchronously.
The device sends information in blocks which have an identifying header, followed by a colon.
Ablock can span multiple lines and is terminated by a blank line.
To be resilient to future protocol changes, clients should ignore blocks they do not recognize, up
to the trailing blank line. Within recognized blocks, clients should ignore lines they do not recognize.
Version 1.3 of the Blackmagic SmartView Ethernet
Protocol was released with SmartView 1.3 software.
Protocol Preamble
The first block sent by the SmartView Server is always the protocol preamble:
PROTOCOL PREAMBLE:↵
Version: 1.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 SmartView or SmartScope device.
SMARTVIEW DEVICE:↵
Model: SmartView Duo↵
Hostname: stagefront.studio.example.com↵
Name: StageFront↵
M on itors: 2↵
Inverted: false↵
↵
This example shows the output for a SmartView Duo device, which has two LCDs. The INVERTED
flag indicates whether the device has detected that it has been mounted in an inverted configuration
to optimize LCD viewing angle.
Legend
↵ carriage return
…
and so on