AC-MXNET-DANTE-CBOX-API

AC-MXNET-DANTE-CBOX API ~ V1.00 ~ 5/9/25

AC-MXNET-DANTE-CBOX API

Published Version: V1.00
Date Published: 5/9/2025
Download Link: https://avproglobal.egnyte.com/dl/wgfnjhLP7P

Requirements

  1. Dante CBOX
  2. RJ-45 cabling
  3. Personal Computer
  4. Terminal Client capable of establishing telnet/TCP sockets to devices, such as PuTTY

Getting Started With The API

Begin by establishing a network connection to the AC-MXNET-DANTE-CBOX. This can be done by gaining access to the web GUI of the CBOX first, to confirm active communication is established between a personal computer and the DANTE-CBOX.
Note: To save time, It is recommended to configure matrix input/output bindings via the web interface first, and then proceed to utilize the API for subscription making.

DHCP

  1. Connect the CBOX to power, either via 12V5A power supply, or Power over Ethernet via the AV/NETWORK port. 
  2. Connect one of the CBOX’s Control/MENTOR Ports (Ports 1-7) to a network serving DHCP leases. 
  3. Connect a personal computer to the same network mentioned above.
  4. On the front panel of the CBOX, push the “PRESS TO SCROLL PAGE” button for Status Monitor A twice, or until the CBOX’s current IPV4 scheme is displayed.
  5. On the personal computer, open a web browser and enter in the IPV4 address displayed within Status Monitor A, granting access to the web GUI of the CBOX. 

Point-To-Point

  1. Connect the AC-MXNET-CBOX-HA to a 12V5A power supply or Power over Ethernet via the AV/NETWORK port.
  2. Directly connect your personal computer’s RJ-45 port to any of the ports 1-7 on the back of the AC-MXNET-CBOX-HA. 
  3. The AC-MXNET-CBOX-HA is factory defaulted to search for a DHCP lease. On the front panel of the CBOX-HA, push the “PRESS TO SCROLL PAGE” button for Status Monitor A twice, or until the CBOX’s current IPV4 scheme is displayed.
  4.  Push and hold the “DHCP” button for 10 seconds. The IPV4 Address displayed within Status Monitor A will flicker and change to a 192.168.1.239/255.255.255.0 Static IP Address scheme. 
  5. On the personal computer, statically assign the Ethernet interface connected to the CBOX an IPV4 address of 192.168.1.200, and a subnet mask of 255.255.255.0. The default gateway/DNS fields are unnecessary for this connection process, and can be left blank.
         Note: Any IP address can be used on the computer, as long as it exists within the same subnet as the CBOX.
  6. Open a web browser and enter 192.168.1.239 within the URL field, accessing the web GUI of the CBOX.

Connecting to the API Server

Once communication is successfully established, open up a terminal client (PuTTY will be used in this scenario), and establish a TCP socket to port 24, using telnet as the communication method. For this scenario, the IPV4 address of the AC-MXNET-DANTE-CBOX is 192.168.0.128.

After the session is opened to port 24 of the Dante-CBOX, the API of the Dante-CBOX can now be utilized. The command "config get version" or "config get name" can be used to confirm that communication to the API server is properly established.

Example Dante API Command Scenarios


Scenario One: Establishing Matrix Port Bindings for Dante Channels

A device residing on the same Dante network as the Dante-CBOX has an ID (name) of "MDS53". This Dante device has two L/R input channels, named "Audio_L" for the left channel, and "Audio_R" for the right channel. It is desired to place both channels of audio into the matrix input port "IN1". This can be accomplished by using the command "dante bind {IN/OUTPortNumber} {Dante_MAC/ID} {Dante_ChannelName}"
With the information above, the following parameters can be inserted into the "dante bind" API command:
{IN/OUTPortNumber} becomes "IN1".
{DANTE_MAC/ID} becomes "MDS53".
{Dante_ChannelName} becomes "Audio_L".
  1. Note: The command will need to be sent twice, with "Audio_L" being replaced with "Audio_R"
The full API command then becomes "dante bind IN1 MDS53 Audio_L"
Example when the command is sent to the API server:

Both audio channels Audio_L and Audio_R that belong to the device MDS53 are now bound to the matrix input port IN1.

The same scenario can be applied on the decoder side with no structural changes to the API command. For example, a Dante decoder with the ID of DANTE-D-84486c has two L/R audio channels, named OUT-L and OUT-R. Both audio channels need to be bound to the matrix output port OUT1. The commands would then become dante bind OUT1 DANTE-D-84486c OUT-L, followed by dante bind OUT1 DANTE-D-84486c OUT-R.

Scenario Two: Creating & Removing Dante Subscriptions

This scenario will utilize the encoder/decoder channels bound to the matrix Input/Output ports IN1 and OUT1, described within Scenario One. Once the desired encoder/decoder channels are properly bound to matrix I/O ports, routing becomes a streamlined process when utilizing the API.
The Left and Right Audio channels for the Dante encoder bound to IN1, needs to be subscribed to the Dante decoder's L/R channels bound to OUT1.
To subscribe all channels within an input port, the API command dante as {INx} {OUTx} can be used. With the current scenario's system, the parameters {INx} {OUTx} becomes IN1 and OUT1, transforming the command into dante as IN1 OUT1.

To unsubscribe a decoder's current subscriptions, the API command dante unas OUT(x) can be used, and for this scenario, OUT(x) becomes OUT1.

    • Related Articles

    • MXNet 10G - API ~ V1.05

      The PDF file attached to this article contains available API commands for the MXNet 10G ecosystem. You can connect to the AC-MXNET-10G-CBOX using PuTTY (Connection Method: Telnet, use TCP Port 24) to execute the commands listed in the API ...

    • AC-MXNET-CBOX ~ V2.73 ~ 03/14/2025

      NOTICE: If your CBOX is reading firmware as a version of V4.XX, please navigate to this page here: https://support.avproedge.com/portal/en/kb/articles/ac-mxnet-cbox-b-firmware Note: Please update the CBOX first, before attempting updates on the ...

    • An Introduction Guide to the AC-MXNET-DANTE-CBOX

      An Introduction Guide to the AC-MXNET-DANTE-CBOX This article goes over the majority of features that are currently available for the AC-MXNET-DANTE-CBOX, such as configuring and monitoring devices, performing route subscriptions, and more. ...

    • How To: Using the MXNET API ~ V1.26.1

      Kevin Wang, Director of Product Management, goes through using the MXNET API to control and configure the MXNet CBOX Direct. Current API Version: V1.26.1 Control Box Version: V4.26 and above Instructions and API attached

    • AC-MXNET-CBOX-HA ~ V4.28 ~ 05/30/2025

      NOTE: If your CBOX is reading firmware with a version number of V2.XX, please navigate to this page here: https://support.avproedge.com/portal/en/kb/articles/ac-mxnet-cbox-firmware Please update the CBOX first, before attempting updates on the ...