Summary

Ethernet-based control protocol for Blackmagic SmartView and SmartScope video monitors. Text-based protocol accessed via TCP port 9992, similar in structure to Videohub protocol. Device sends full state dump on connection, then asynchronous state changes.

Transport

protocols:
  - tcp
addressing:
  port: 9992
auth:
  type: none  # inferred: no auth procedure in source

Traits

- queryable  # inferred: device sends complete state dump on connection
- levelable  # inferred: brightness, contrast, saturation commands present
- routable   # UNRESOLVED: input routing not present in excerpt

Actions

- id: set_brightness
  label: Set Brightness
  kind: action
  params:
    - name: value
      type: integer
      description: Brightness 0-255 (0-100%)

- id: set_contrast
  label: Set Contrast
  kind: action
  params:
    - name: value
      type: integer
      description: Contrast 0-255 (zero-centered at 127)

- id: set_saturation
  label: Set Saturation
  kind: action
  params:
    - name: value
      type: integer
      description: Saturation 0-255 (zero-centered at 127)

- id: set_border
  label: Set Border Color
  kind: action
  params:
    - name: color
      type: enum
      values: [RED, GREEN, BLUE, WHITE, NONE]

- id: identify
  label: Identify Monitor
  kind: action
  params:
    - name: enable
      type: boolean
      description: Enable white border for 15 seconds

- id: set_network_dynamic_ip
  label: Enable DHCP
  kind: action
  params:
    - name: enabled
      type: boolean

- id: set_static_network
  label: Set Static IP
  kind: action
  params:
    - name: address
      type: string
    - name: netmask
      type: string
    - name: gateway
      type: string

- id: set_device_name
  label: Set Device Name
  kind: action
  params:
    - name: name
      type: string
- id: set_scope
  label: Set Scope Mode
  kind: action
  params:
    - name: monitor
      type: string
      description: Monitor identifier (e.g. A or B)
    - name: scope
      type: enum
      values: [AudioDbfs, AudioDbvu, Histogram, ParadeRGB, ParadeYUV, Picture, Vector100]

- id: set_audio_channels
  label: Set Audio Channels
  kind: action
  params:
    - name: monitor
      type: string
      description: Monitor identifier for audio metering display
    - name: channels
      type: UNRESOLVED
      description: Audio channel selection; mapping values not enumerated in source

Feedbacks

- id: device_info
  label: Device Info
  type: object
  properties:
    - name: model
      type: string
    - name: hostname
      type: string
    - name: name
      type: string
    - name: monitors
      type: integer
    - name: inverted
      type: boolean

- id: network_status
  label: Network Status
  type: object
  properties:
    - name: dynamic_ip
      type: boolean
    - name: static_address
      type: string
    - name: static_netmask
      type: string
    - name: static_gateway
      type: string
    - name: current_address
      type: string
    - name: current_netmask
      type: string
    - name: current_gateway
      type: string

- id: display_settings
  label: Display Settings
  type: object
  properties:
    - name: brightness
      type: integer
    - name: contrast
      type: integer
    - name: saturation
      type: integer
    - name: border
      type: enum
      values: [RED, GREEN, BLUE, WHITE, NONE]
    - name: identify
      type: boolean

Variables

# UNRESOLVED: network configuration variables stated but block structure implies
# these are set via action blocks rather than independent variables

Events

# UNRESOLVED: source describes asynchronous state changes but does not enumerate
# specific event types

Macros

# None documented in source

Safety

confirmation_required_for: []
interlocks:
  - Changing name or network settings causes IP connection drop; device restarts networking
# UNRESOLVED: no safety warnings or interlock procedures for power-on sequencing

Notes

Protocol similar to Videohub text-based format. Block structure: header colon, multi-line content, blank line terminator. Clients should ignore unrecognized blocks and lines for forward compatibility. Border colors (RED/GREEN/BLUE/WHITE/NONE) can be overridden by hardware tally at DB-9 input. SmartScope models support audio metering scopes (AudioDbfs, AudioDbvu, Histogram, ParadeRGB, ParadeYUV, Vector100).

Provenance

source_domains:
  - documents.blackmagicdesign.com
  - blackmagicdesign.com
  - github.com
source_urls:
  - "https://documents.blackmagicdesign.com/UserManuals/SmartViewManual.pdf?_v=1722841210000"
  - https://documents.blackmagicdesign.com/UserManuals/SmartViewManual.pdf
  - https://www.blackmagicdesign.com/products/smartview/techspecs
  - https://www.blackmagicdesign.com/developer
  - https://github.com/jscissr/smartview-client
retrieved_at: 2026-05-05T01:53:54.252Z
last_checked_at: 2026-06-02T21:54:37.762Z

Verification Summary

verdict: verified
checked_at: 2026-06-02T21:54:37.762Z
matched_actions: 10
action_count: 10
confidence: medium
summary: "All 10 spec actions traced to SmartView protocol v1.4. Transport on port 9992 confirmed. (8 unresolved item(s) noted in Known Gaps.)"

Known Gaps

- "scope visualization features not fully documented in source excerpt"
- "input routing not present in excerpt"
- "network configuration variables stated but block structure implies"
- "source describes asynchronous state changes but does not enumerate"
- "no safety warnings or interlock procedures for power-on sequencing"
- "SmartScope-specific scope selection commands not fully documented"
- "audio channel selection parameters not documented"
- "firmware version compatibility not stated in source"

From the AI4AV catalog (https://ai4av.net) · ODbL-1.0