AVPRO EDGE|MXNET USP|IP|3.20

Introduction

AVPro Edge MXNet USP is a driver developed by Janus Technology for configuring and controlling the MXNet AVoIP system from AVPro Edge.

MXNet provides scalable AVoIP distribution for systems ranging in size from small installations to very large deployments (hundreds of sources and displays), while also offering a rich feature set including video wall functionality. Although the MXNet system includes a web interface on its controller, it is not necessary to use it. The entire system can be fully configured from an RTI panel using the supplied ‘SampleFile’ Apex.

Driver Features

High-level overview of the driver’s features.

• Two-way TCP/IP communication

• Configuration setup

• Video routing

• Audio routing (Analog / HDMI)

• Volume control for encoders and decoders

• Video routing presets

• Video wall control and creation

• Advanced config for encoders and decoders

• CEC, RS232, and IR passthrough

• Hot plug status

• Dynamic generation of tags

Version History

Version 3. 20 – 30- January 2025

• Added Support for MXNet USP

Version 3.1 –08- Decemeber-2025

• Updated Mxnet 10G Support for ID 11 Tagging and Dynamic Generation

• Fixed issue causing crash when default values had not been changed from the config settings

Version 3.0 –17- Novemeber-2025

• Updated Support ID 11 Tagging and Dynamic Generation

Version 2.7 – 07-May-2025

• Added Input Extracted Audio volume

Version 2.6 – 17-August-2023

• Added Volume Support

• Updated to handle 10G/1G Differences

Version 2.5 – 31-May-2023

• Added Tiler support

Version 2.4 – 20-January-2023

• Added Events for Hotplugs Connected and Disconnected

Version 2.3 – 18-January-2023

• Added Hotplug Variables

• Added Hotplug Reset

Version 2.2 – 22-August-2022

• Split 10G/1G models into separate download folders

Version 2.1 – 25-July-2022

• Added Support for 10G Model

• Added Support for Video Wall Mosaic Layout Active

Version 2.0 – 18-December-2021

• Migrated to JSON API (port 24)

• Added support for setting Receiver Display to Stored Images

• Added support for sending arbitrary API commands

• Added Video Wall Layout recall

Version 1.4 – 11-October-2021

• Removed sending Set RS232 mode (caused device restart and loss of baud-rate settings)

Version 1.3 – 26-September-2021

• Fixed sending RS232 containing escaped characters

• Changed combined audio/video switch to use single command

Version 1.2 – 22-July-2021

• Added IR Output

Version 1.1 – 13-April-2021

• Fixed problem with Auto-Configuration when devices were already named with incorrect Custom Names containing apostrophe (')

Version 1.0 – 19-November-2020

• Initial Release

System Requirements & Prerequisites

RTI System Requirements

• Integration Designer: Apex ID11

• XP FW: 25.1.27 or later

Manufacturer’s Device Requirements

• MXNet 10G

Device Setup

The MXNet controller must be configured with a static IP address in the same range as the RTI processor in order for the two devices to communicate with each other.

In order to map between the physical MXNet devices, and virtual port numbers it is necessary to assign alias names to the devices. By convention these will be 'IN1', 'OUT1' etc., designating the input / output device and port number. They can optionally have a human-readable name as a suffix, for example: IN1-BluRay’.

Out of the box, the MXNet devices will not have these alias names configured, therefore it is necessary to configure these as a first step.

The following functions are provided in the driver to assist in configuration of the matrix, and made accessible from the supplied ‘SampleFile’ Apex:

Clear All Aliases - resets configuration names to factory default. Note: use with caution.

Auto-Configure Aliases - automatically configures aliases. If any devices already have valid alias names configured, then these will remain unaltered. All other devices will be assigned alias names in ascending sequence, filling in any gaps in the numbering sequence.

Rediscover Devices - forces rediscovery of devices

Set Device Light - sets state of LED indicators on specified devices

- On - normal operation, lights on

- Flash - lights flashing - useful for identifying physical devices

- Off - lights off, useful in situations where the light may be visible in a darkened room

Reboot Device - reboots specified input and output devices

Reboot All Devices - reboots all devices

Driver Configuration

The driver features a number of configuration properties that must first be completed. Note that the Serial Port Setting Types provide a way of defining the settings for a serial port, which can then be applied to the serial ports of multiple inputs and outputs.

System Config

• Connection Type: Network TCP

• IP Address: Network address of the MXNet control box

Switch Size

• Number of Inputs: Set the number of encoders in your system

• Number of Outputs: Set the number of decoders in your system

MultiSwitch Mode

• Select Outputs, then Input - selects the order of switching to be outputs first

• Select Input, then Outputs - selects the order of switching to be input first

Input Names

• Allows for custom naming of inputs. Changing the names here will modify them in the driver’s commands and tags too.

Output Names

• Allows for custom naming of outputs. Changing the names here will modify them in the driver commands and tags too.

Serial Port Settings type x

• Baud Rate - the baud rate in bits per second.

• Bits - the number of data bits.

• Parity - the parity bit setting.

• Stop Bits - the number of stop bits.

• Inputs - the inputs to which this setting type is to be applied, specified as a comma-separated ranged list e.g. 1,2, 3-6 (note, if none are required, enter “none” – do not just leave the field empty)

• Outputs - the outputs to which this setting type is to be applied – configured as per inputs

Dynamic Generation

Dynamic Generation will create tags and update the configuration, setting names to match your system’s alias names. There are 3 steps to this process.

First make sure you have entered the IP address of your MXNet Control Box into the config settings

Then run the command Query MXnet

This will obtain the configuration from the MXNet device and use it to populate the input and output name fields. Check that you are happy with the results and make any adjustments needed. Then, run the command Apply Name Changes.

Once this is completed you will see that functions and tags will have had their names updated and any video walls that you have on your existing system will now have their own functions.

There will also be tags created for these walls:

Driver Functions

Output Switching

Switch Output (AV)
Switches a specific input to a specific output using combined audio/video routing.
Parameters:

• Select Input – Input number (e.g. 1–16).

• Select Output – Output number (e.g. 1–16).

Switch Output (Breakaway)
Switches specific inputs to specific outputs independently for Video, Audio, and USB paths.
Parameters:

• Select Input (Video) – Input number for video.

• Select Input (Audio) – Input number for audio.

• Select Input (USB) – Input number for USB.

• Select Output – Output number (e.g. 1–16).

Clear Output Selection
Clears all currently selected outputs. Useful when performing multi-output switching or creating presets.

Select All Outputs
Selects all outputs for multi-switching or preset creation.

Select Output
Selects a specific output for multi-switching or preset creation.
Parameter:

Select Output – Output number (e.g. 1–16).

Toggle Output
Toggles the selection state (on/off) of an individual output for multi-switching or preset creation.
Parameter:

• Select Output – Output number (e.g. 1–16).

Select Input (AV)
Selects an input to route to previously selected outputs (combined AV switching).
Parameter:

• Select Input – Input number (e.g. 1–16).

Presets

Store Preset (All Outputs)
Saves the current configuration of all outputs as a preset.
Parameter:

• Preset ID – Choose preset slot (1–16).

Store Preset (Selected Outputs)
Saves the configuration of currently selected outputs as a preset.
Parameter:

• Preset ID – Choose preset slot (1–16).

Recall Preset Selection
Recalls a previously stored preset by ID.
Parameter:

• Preset ID – Preset slot (1–16).

Audio Controls

Volume Step
Adjusts the output volume up or down by one increment.
Parameters:

• Direction – “Up” or “Down”.

• Output - Target output (e.g. 1–16).

Set Volume
Sets the output volume to a specified level.
Parameters:

• Level (0–100) – Desired volume level.

• Output – Target output (e.g. 1–16).

Set Mute
Mutes or unmutes the selected output.
Parameters:

• Output – Target output (e.g. 1–16).

• Mute – “On” or “Off”.

Set Input Volume
Sets the extracted input audio volume to a specific level.
Parameters:

• Input – Input number (e.g. 1–16).

• Level (0–100) – Desired volume level.

Serial and IR Control

RS232 Output
Sends a serial string to defined inputs and/or outputs.
Parameters:

• Inputs – Input numbers or ranges (e.g. “1,2,3,4” or “1-4”). Use “0” if no inputs are used.

• Outputs – Output numbers or ranges (e.g. “1,2-4”). Use “0” if no outputs are used.

• String – ASCII or escaped binary string to send.

Supported Escape Sequences:
\r – Carriage Return (13)
\n – Line Feed (10)
\t – Tab (9)
\b – Bell (7)
\f – Form Feed (12)
\ – Backslash (\)
\x.. – Send character by hex code

Examples:
Hello\r\n
\x48\x65\x6c\x6c\x6f\x0d\x0a
He\x6c\x6co\r\n

IR Output
Sends an IR command to defined inputs and/or outputs.
Parameters:

Inputs – Input numbers or ranges (e.g. “1,2,3,4” or “1-4”).

• Outputs – Output numbers or ranges (e.g. “1,2-4”).

• Code – IR code in Pronto or Global Cache format.

Video Wall Control

Video Wall Create

Defines and creates a new video wall configuration.
Parameters:

• Wall Name – The name assigned to the video wall (required for other commands).

• Input – The input source to display on the wall.

• Size – Screen configuration (e.g. 2x2, 2x2 top-row inverted, 3x3).

• Outputs – Output numbers used to form the wall (must match the number required by the selected Size).

Select Input for Video Wall

Switches an existing video wall to a new input source.
Parameters:

• Wall Name – The wall to update.

• Input – The new input to display.

Video Wall Mosaic Layout Active

Recalls and applies a mosaic layout to a video wall.
Parameters:

• Wall Name – The wall to update.

• Layout – The mosaic layout to recall.

Wall Mode

Sets the operating mode for a video wall.
Parameters:

• Wall Name – The wall to configure.

• Wall Mode – Mode selection (e.g. Fast Switch).

Wall Ratio Mode

Sets the ratio/aspect mode for a video wall.
Parameters:

• Wall Name – The wall to configure.

• Wall Ratio Mode – Ratio mode selection (e.g. Source Aspect Ratio).

Wall Resolution

Sets the output resolution for a video wall.
Parameters:

• Wall Name – The wall to configure.

• Wall Resolution – Desired resolution (e.g. 1920×1080 (1080p) 50Hz).

Wall Rotation

Sets the output rotation for a video wall.
Parameters:

• Wall Name – The wall to configure.

• Wall Resolution – Desired rotation (e.g 0,90,180,270).

Device Configuration

Set Transmitter EDID
Configures the encoder (input) EDID setting.
Parameter:

• Input – Input number (e.g. 1–16).

Set Transmitter Audio Source
Selects the audio source for a transmitter (input).
Parameters:

• Input – Input number (e.g. 1–16).

• Source – Audio source type.

Set Receiver Resolution
Configures the decoder (output) resolution.
Parameters:

• Output – Output number (e.g. 1–16).

• Resolution – Desired resolution (e.g. 1080p, 4K).

Set Receiver ExAudioType
Configures the decoder (output) resolution.
Parameters:

• Output – Output number (e.g. 1–16).

• ExAudioType – Audio Type (e.g. Dante).

Set Receiver HDMI Audio Type
Configures the decoder (output) resolution.
Parameters:

• Output – Output number (e.g. 1–16).

• HDMI Audio Type – Type (e.g. Dante).

CEC Control

Send CEC Command
Sends a CEC command to specified outputs.
Parameters:

• Outputs – Output numbers or ranges (e.g. “1,2,3,4” or “1-4”).

• Control – CEC command to send.

Hotplug Reset

Output Hotplug Reset
Resets the hotplug signal on the specified output.
Parameter:

• Output – Output number.

• HDMI Type – Is this resetting the HDMI input or output port

Input Hotplug Reset
Resets the hotplug signal on the specified input.
Parameter:

• Input – Input number.

• HDMI Type – Is this resetting the HDMI input or output port

External Device Setup

Add External Device
Adds an external device into the system.
Parameter:

• ID – ID of the External device. Ensure this matches the format described in this document above for example IN10-CCTV where the number, in this case 10 is a unique number in the system.

• Model – Enter the model number of the device.

• URL – Enter the RTSP stream url e.g. 192.168.1.10/1

• Network Selection – Select if this device is on the Control Network or AV network.

External Device Security
Enable basic authentication on the external device, this can be sent in a macro after the add external device if required:

• ID – ID setup in the Add External device function.

• Enabled – Enable or disable authentication.

• Username – Username to access stream.

• Password – Password to access stream.

Remove External Device
Removes a external device from the system:

• ID – ID setup in the Add External device function.

Important Note

Due to a known Integration Designer bug, empty command parameters are ignored—non-empty parameters are shifted up, resulting in incorrect mapping.
To avoid this issue:

• Ensure all parameters contain non-empty values.

• For example, in RS232 Output, if you don’t intend to use inputs or outputs, set them to “0” or “none” (not blank). These invalid ports are safely ignored by the driver.

Regarding video walls, we recommend that installers use the RTI Driver to create the video walls. However, if this is not done, please ensure that any layouts created through Mentor have the layout name appended with “layout” to guarantee full functionality with the driver.

Driver Variables

Switch Data

Connection Status
Indicates whether the driver is currently connected to the hardware.
Type: Boolean
Example: True / False

Configuration Status
Reports the current configuration state of the system.
Type: String

Online Status
Displays the connection status of all connected devices.
Type: String

Outputs Current Input

Output X Current Input (integer)
Shows which input is currently routed to each output (by input number).
Type: Integer

Outputs Current Input Name

Output X Current Input (name)
Displays the name of the input currently routed to each output.
Type: String.

Input Extracted Audio Volume

Input X Volume
Shows the extracted audio volume level for each input.
Type: Integer
Range: 0–100

Output Volume

Output X Volume
Displays the audio output volume level for each output.
Type: Integer
Range: 0–100

Output Mute Status

Output X Muted
Indicates whether an output is currently muted.
Type: Boolean
Example: True = Muted, False = Unmuted

Output Names

Output X System Name
Displays the configured name for each output.
Type: String

Output Selection (for Current Remote)

Output X Selected
Indicates whether the specified output is currently selected for multi-switching or preset operations.
Type: Boolean

Input Selection (for Current Remote)

Input X Selected
Indicates whether the specified input is currently selected for multi-switching or preset creation.
Type: Boolean

Hot Plug Output Detected

Output X Hot Plug Detected
Indicates whether a connected display (sink) has triggered a hotplug event.
Type: Boolean

Hot Plug Input Detected

Input X Hot Plug Detected
Indicates whether a connected source has triggered a hotplug event.
Type: Boolean

Tags

This driver uses the following non-standard tags

Auto-Configure Aliases (F)

• Function usage: Will auto configure alias names for all encoders to INx and decoders to OUTx

CEC: Power Off (F)

• Function usage: Send CEC Power Off to TV connected to selected decoder

CEC: Power On (F)

• Function usage: Send CEC Power On to TV connected to selected decoder

Clear All Aliases (F)

• Function usage: Sets all encoder and decoder alias names back to their defaults

Clear Output Selection (F)

• Function usage: Clears the currently selected outputs that are used for switching or preset creation

Device: Light Flash (F)

• Function usage: Set lights to flash for a set of encoders and decoders

Device: Light Off (F)

• Function usage: Switch lights off for a set of encoders and decoders

Device: Light On (F)

• Function usage: Switch lights on for a set of encoders and decoders

Device: Reboot (F)

• Function usage: Reboots a set of encoders and decoders

Device: Reboot All (F)

• Function usage: Reboots all encoders and decoders in the system

Input Breakaway: Audio (F)

• Function usage: Sets an encoder to breakaway audio

Input Breakaway: USB (F)

• Function usage: Sets an encoder to breakaway USB

Input Breakaway: Video (F)

• Function usage: Sets an encoder to breakaway video

Input HotPlug Reset (F/V)

• Function usage: Resets The hotplug status on an encoder

• Variable usage: Reports the current hotplug status of an encoder

Input Volume (F/V)

• Function usage: Sets the volume on an encoder

• Variable usage: Reports the current volume of an encoder

Input Volume Down (F/V)

• Function usage: Decrements the input volume of an encoder by 1

Input Volume Up (F/V)

• Function usage: Increments the input volume of an encode by 1

Input: Friendly Name (x) (F)

• Function usage: Sets an decoder to the input associated with friendly name (x)

Output Current Input (V)

• Variable usage: Reports the input number that is currently selected on a decoder

Output Current Input Name (V)

• Variable usage: Reports the friendly name of the input that is currently selected on a decoder

Receiver: Resolution x (F)

Receiver: ExAudioType x (F)

• Function usage: Set Exaudio Type

Receiver: HdmiType x (F)

• Function usage: Set HDMI Type

Rediscover Devices (F)

• Function usage: Rediscovers all encoders and decoders on the system

Select All Outputs (F)

• Function usage: Selects all outputs ready for switching or preset creation

Select Input (AV) (F)

• Function usage: Selects input ready for switching

Select Output (F)

• Function usage: Select an output for switching or preset creation

Store Presets: All Outputs (F)

• Function usage: Stores the input/output selections for all decoders to a selected preset

Store Presets: All Outputs (F)

• Function usage: Stores the input/output selections for all decoders to a selected preset

Store Presets: Selected Outputs (F)

• Function usage: Stores the input/output selections for selected decoders to a selected preset

Toggle Output (F)

• Function usage: Toggles the selection state (on/off) of an individual output for switching or preset creation

Transmitter: Audio X (F)

• Function usage: Selects the audio source for a transmitter

Transmitter: EDID (F)

• Function usage: Configures the encoder (input) EDID setting.

Troubleshooting

The driver cannot control the MXNet system

Confirm the Ethernet switch used by the MXNet system is correctly uplinked to the same network as the RTI processor.

Confirm that the correct IP address is defined in the RTI driver properties for the MXNet control interface.

Switching commands are failing

Ensure that the device alias names are configured correctly – the configuration Status variable gives useful information. Read the section of this guide entitled "Configuration" for more information.

System Testing

Integration Designer: Version 11.13.2

XP Processor Model: XP-8v

XP Processor Firmware: 25.9.24

Device Model(s): MXNet USP