Developer Information
Controlling Blackmagic Audio Monitor 12G using Telnet
The Blackmagic Audio Monitor 12G Ethernet Protocol gives you the freedom to build your own
custom control solutions for your Blackmagic Audio Monitor 12G. For example, you can create your
own software application or web interface to control your Blackmagic Audio Monitor 12G via
Ethernet from your computer.
The first step is to connect your Blackmagic Audio Monitor 12G to your computer via Ethernet. You
can do this by connecting to the same network your computer is connected to, or you can connect
Blackmagic Audio Monitor 12G directly to your computer.
NOTE
If Blackmagic Audio Monitor 12G is connected directly to your computer, set your
computer to a manual static IP address. Set the first three blocks of numbers in the IP
address to match your Blackmagic Audio Monitor 12G and set the subnet mask to
255.255.255.0. You can leave the gateway or router setting blank as it will not be used in
a direct connection between your computer and Blackmagic Audio Monitor 12G.
If your network settings are set correctly, you can now open the Terminal application on macOS, or
enable Telnet command line utilities on Windows and enter Blackmagic Audio Monitor 12G Ethernet
Protocol commands. These commands can be programmed into your application and triggered by
related items on a custom user interface of your own design.
Using Telnet on macOS and Windows
1
On macOS, open the Terminal application which is located within the Applications >
Utilities folder.
To open the command prompt in Windows, click on the 'start' menu and type 'cmd' in the
search bar. Press 'enter'.
2
Type in "telnet" and a space followed by the IP address of your computer, then another
space and "9996", which is the default port number for Blackmagic Audio Monitor 12G.
For example:
telnet 192.168.25.253 9996
Press 'enter'. The Protocol Preamble screen will appear.
Blackmagic Audio Monitor 12G Ethernet Protocol V1.0
Summary
The Blackmagic Audio Monitor 12G Ethernet Protocol is a text based protocol that is accessed by
connecting to TCP port 9996 on a Blackmagic Audio Monitor 12G.
The Blackmagic Audio Monitor 12G 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 new line character.
Upon connection, the Blackmagic Audio Monitor 12G sends a complete dump of the state of the
device. After the initial status dump, status updates are sent every time the Blackmagic Audio
Monitor 12G status changes.
Developer Information
60