Blackmagic SmartView SmartScope User Manual Developer Information
Blackmagic 2K Format – Overview
Blackmagic Design products support 3G-SDI video, which allows twice the data rate of traditional HD-SDI video. We thought it would be a really nice idea to add 2K film support, via 3G-SDI technology, so we could simplify feature film workflows. With the popularity of Blackmagic Design editing systems worldwide, now thousands of people can benefit from a feature film workflow revolution.
This information includes everything product developers need to know for building native 2K SDI equipment. Of course, all Blackmagic products can be updated, so if the television industry adopts an alternative SDI-based film standard, we can add support for that too!
Frame Structure
Transmitted at 23.98, 24 or 25 frames per second as a Progressive Segmented Frame.
Active video is 2048 pixels wide by 1556 lines deep.
Total lines per frame : 1650
Active words per line are 1535. One word consists of a 10-bit sample for each of the four data streams, i.e., a total of 40 bits. See the diagram named Blackmagic 2K Format - Data Stream Format.
Total active lines : 1556
Total words per line : 1875 for 23.98/24Hz and 1800 for 25Hz.
Fields per frame : 2, 825 lines each
Active lines located on lines 16-793 (field 1) and 841-1618 (field 2).
Transport Structure
Based on SMPTE 372M Dual Link mapping and SMPTE 425M-B support for mapping SMPTE 372M into a single 3 Gb/s link.
Timing reference signals, line number and line CRC insertion is the same as above.
During active video, 10-bit Red, Green and Blue data is sent in the following sequence:
Optional ancillary data is inserted into both virtual interfaces.
At present, only audio data is included: as per standard HD audio insertion (SMPTE S299M) the audio data packets are carried on data stream two and audio control packets are carried on data stream one.
Data stream 1: Green_1, Green_2, Green_3, Green_5...Green_2047
Data stream 2: Blue_1, Blue_2, Green_4, Blue_5...Green_2048.
Data stream 3: Red_1, Blue_3, Blue_4, Red_5...Blue_2048.
Data stream 4: Red_2, Red_3, Red_4, Red_6...Red_2048.
Blackmagic 2K Format – Vertical Timing Reference
This diagram shows the vertical timing details with line numbers and Field, Vertical and Horizontal bits for the Timing Reference Signal codes.
Field 1 | Active | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
F | 1 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 | 0 |
V | 1 | 1 | 1 | 1 | 1 | 1 | 0 | 0 | 0 | 0 | 1 | 1 |
LINE # | 1650 | 1 | 2 | ... | 14 | 15 | 16 | ... | 792 | 793 | ... | 825 |
Field 2 | Active | |||||||||||
F | 0 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 | 1 |
V | 1 | 1 | 1 | 1 | 1 | 1 | 0 | 0 | 0 | 0 | 1 | 1 |
LINE # | 825 | 826 | 827 | ... | 839 | 840 | 841 | ... | 1617 | 1618 | ... | 1650 |
Blackmagic 2K Format – Data Stream Format
This diagram shows the data stream formats around the optional ancillary data section of the horizontal line. Note that each active pixel takes up three samples.
Word# 25 PsF | Word# 23.98/24 PsF | Data Stream 4 | Data Stream 3 | Data Stream 2 | Data Stream 1 |
---|---|---|---|---|---|
1795 | 1870 | R2042 | R2041 | B2041 | G2041 |
1796 | 1871 | R2043 | B2043 | B2042 | G2042 |
1797 | 1872 | R2044 | B2044 | G2044 | G2043 |
1798 | 1873 | R2046 | R2045 | B2045 | G2045 |
1799 | 1874 | R2047 | B2047 | B2046 | G2046 |
1800 | 1875 | R2048 | B2048 | G2048 | G2047 |
1 | 1 | EAV(3FFh) | EAV(3FFh) | EAV(3FFh) | EAV(3FFh) |
2 | 2 | EAV(000h) | EAV(000h) | EAV(000h) | EAV(000h) |
3 | 3 | EAV(000h) | EAV(000h) | EAV(000h) | EAV(000h) |
4 | 4 | EAV(XYZh) | EAV(XYZh) | EAV(XYZh) | EAV(XYZh) |
5 | 5 | LN0 | LN0 | LN0 | LN0 |
6 | 6 | LN1 | LN1 | LN1 | LN1 |
7 | 7 | CRC0 | CRC0 | CRC0 | CRC0 |
8 | 8 | CRC1 | CRC1 | CRC1 | CRC1 |
9 | 9 | 200 | 040 | ANC/Audio Data | ANC/Audio Data |
… 260 | … 335 | … 200 | … 040 | ||
261 | 336 | SAV(3FFh) | SAV(3FFh) | SAV(3FFh) | SAV(3FFh) |
262 | 337 | SAV(000h) | SAV(000h) | SAV(000h) | SAV(000h) |
263 | 338 | SAV(000h) | SAV(000h) | SAV(000h) | SAV(000h) |
264 | 339 | SAV(XYZh) | SAV(XYZh) | SAV(XYZh) | SAV(XYZh) |
265 | 340 | R2 | R1 | B1 | G1 |
266 | 341 | R3 | B3 | B2 | G2 |
267 | 342 | R4 | B4 | G4 | G3 |
268 | 343 | R6 | R5 | B5 | G5 |
Blackmagic SmartView Ethernet Protocol v1.4
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.
Legend
↵ carriage return
… and so on
Version 1.4 of the Blackmagic SmartView Ethernet Protocol was released with SmartView 1.4 software.
Protocol Preamble
The first block sent by the SmartView Server is always the protocol preamble:
PROTOCOL PREAMBLE:↵
Version: 1.4 ↵
↵
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↵
Monitors: 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.
Network Configuration
The next block shows the TCP/IP networking configuration:
NETWORK:↵
Dynamic IP: true↵
Static address: 192.168.2.2↵
Static netmask: 255.255.255.0↵
Static gateway: 192.168.2.1↵
Current address: 192.168.1.101↵
Current netmask: 255.255.255.0↵
Current gateway: 192.168.1.1↵
↵
The network settings prefixed with CURRENT show the active TCP/IP settings, and are read-only. The CURRENT settings reflect either the DHCP or Static configuration, depending on the DYNAMIC IP flag.
Changing Networking Settings
The network can be configured to use either DHCP or a static configuration. To enable DHCP:
NETWORK:↵
Dynamic IP: true↵
↵
To set a fixed IP address, supply all static parameters, thus:
NETWORK:↵
Dynamic IP: false↵
Static address: 192.168.2.2↵
Static netmask: 255.255.255.0↵
Static gateway: 192.168.2.1↵
↵
The parameters with the CURRENT prefix are read-only, and show the active configuration, regardless of the static or dynamic setting.
Changing the device name, or any network settings, will cause the IP connection to be dropped. The device will restart its networking and advertise its new name on the network.
Changing Monitor Settings
The display settings for each monitor are specified individually. One or more parameters can be modified at the same time and multiple settings can be supplied in one block.
The valid range for numeric values is 0-255. The CONTRAST and SATURATION properties are zero-centered, so the normal value is 127, such that the displayed picture is the same as the original. A value greater than 127 in either channel will cause the contrast or saturation to be increased, and similarly a value less than 127 will cause a decrease.
For example, to set the brightness to 50% and desaturate the image to Black & White:
MONITOR A:↵
Brightness: 127↵
Saturation: 0↵
↵
Displaying SD in 16:9
The following command sets standard definition video to display in 16:9:
MONITOR A: ↵
WidescreenSD: ON↵
Displaying SD in 4:3
The following command sets standard definition video to display in 4:3:
MONITOR A: ↵
WidescreenSD: ON↵
Identification and Tally Settings
The Identify flag is transient, and will cause a white border to be displayed around the entire picture for a duration of 15 seconds, after which it will be reset. This feature is primarily aimed at identifying which monitor is currently being configured when it is mounted in a rack comprising multiple units. To turn on:
MONITOR A: ↵
Identify: true↵
↵
The IDENTIFY border will temporarily override any other border setting in effect.
The BORDER property can be used to programmatically set the soft Tally colored borders to one of the primary colors: RED, GREEN, BLUE, WHITE or NONE. This setting can be overridden by the electrical Tally signals at the DB-9 input on the device itself. For example, to set the soft Tally to green:
MONITOR B:↵
Border: green↵
↵
The hard wired tally will always override the soft tally. The full state report will always show the current valid border.
SmartScope Settings
On SmartScope Duo 4K, each monitor can be set to display a different scope. The values for activating specific scopes are mapped as follows:
AudioDbfs
AudioDbvu
Histogram
ParadeRGB
ParadeYUV
Picture (This is the same as Video Monitor)
Vector100
Vector75
WaveformLuma
MONITOR A: ↵
ScopeMode: Picture↵
↵
In the example above, Monitor A has been set as a video monitor.
Displaying SD in 16:9
The set Video Monitor mode to display standard definition video in 16:9:
MONITOR A: ↵
ScopeMode: Picture↵
WidescreenSD: ON↵
Displaying SD in 4:3
To set Video Monitor mode to display standard definition video in 4:3:
MONITOR A: ↵
ScopeMode: Picture↵
WidescreenSD: OFF↵
When setting one of SmartScope Duo 4K’s monitors to audio metering, you can also select which channels to show. The values for selecting which audio channels are mapped in the following way:
0: Channels 1 and 2
1: Channels 3 and 4
2: Channels 5 and 6
3: Channels 7 and 8
4: Channels 9 and 10
5: Channels 11 and 12
6: Channels 13 and 14
7: Channels 15 and 16
MONITOR B: ↵
ScopeMode: AudioDbvu↵
AudioChannel: 0↵
↵
In the example above, Monitor B has been selected to display Audio Metering in Dbvu with audio channels 1 and 2 selected for the phase meter.
Selecting LUTs for SmartView 4K
To select 3D LUTs using SmartView 4K:
Was this information helpful?