9.346 Matrix-Site-Switch

The Matrix-Site-Switch device supports an antenna 1:1 redundancy setup by controlling a number matrix switch in case of a redundancy switchover. The idea behind this device is simple:

Assume the ports of both antennas are routed to inputs of the switch matrix. appliances like IRDs are connected to the matrix outputs. They are routed to get a signal from one of the antennas. When an antenna switchover happens, all appliances connected to a particular port of the (faulty) antenna shall be switched to the corresponding port of the backup antenna.

Input correspondence lists

For this the device maintains lists of corresponding inputs. There are two of these list, one for switching from primary to backup and one for the opposite direction. The lists contain pairs of input settings which address the corresponding signals on both antennas.

The first list is the 'primaryToBackup' list, it contains an arbitrary number of elements, separated by comma characters. Each element has the form 'XX:YY' where 'XX' is the 2-digit input number selecting the signal from the primary antenna 'YY' is the input number which selects the same signal from the backup antenna. In case of a switchover, the device checks the settings of all outputs addressed by this device if they match one of the 'XX' settings in the list and switches such an output to the corresponding 'YY' input.

The second list, the 'backupToPrimary' list, works exactly the same way, but for backup to primary switch over. This second list is required as switch from one antenna to another is not necessarily invertible.

ETL NGM30 input redundancy

The sat-nms device driver for the ETL NGM30 Matrix is capable to do a redundancy switching for inputs, triggered by the fault flags of the individual matrix inputs. The Matrix-Site-Switch device allows for this redundancy switching and temporarily inhibits this during a site switchover. For the configuration of the Matrix-Site-Switch this means, that both redundant inputs must be mapped to the primary input at the other antenna. This gives the protection switching built into the ETL NGM30 Matrix driver to switch to the redundant signal after the site switch if the matrix input reads a fault.

Example:

input signal input redundancy antenna redundancy
01 11L primary input primary antenna
02 11L backup input primary antenna
03 11H primary input primary antenna
04 11H backup input primary antenna
05 12L primary input primary antenna
06 12L backup input primary antenna
07 12H primary input primary antenna
08 12H backup input primary antenna
09 11L primary input backup antenna
10 11L backup input backup antenna
11 11H primary input backup antenna
12 11H backup input backup antenna
13 12L primary input backup antenna
14 12L backup input backup antenna
15 12H primary input backup antenna
16 12H backup input backup antenna

The translation tables for the above configuration would be:

primaryToBackup: 01:09,02:09,03:11,04:11, ... 07:15,08:15 backupToPrimary: 09:01,10:01,11:03,12:03, ... 15:07,16:07

Always there are both, the primary and the backup input of the 'from' antenna mapped to the primary input for this signal at the 'to' antenna.

Device window pages

The following table shows which device window pages are available with this individual device type. Tool-bar functions not mentioned here are described at the general description of device windows .

Configuration parameters

At the maintenance page of the device window there are a couple of configuration parameter which must be set to interconnect the Matrix-Site-Switch device with the devices it shall monitor and control.

parameter description
locationId The message ID of the parameter to monitor in order to detect the switchover between the primary and the backup antenna.
primaryValue The value expected from the parameter addressed by 'locationId' when the primary antenna is selected.
backupValue The value expected from the parameter addressed by 'locationId' when the backup antenna is selected.
matrixName The device name of the switch matrix to control. Although this device has been developed to work specifically with an ETL-NGM30 switch matrix, it can be used with any switch matrix driver which provides 'output.01' ... 'output.nn' parameter to select the signals routes to each output and an 'input.outputs' parameter which reports the number of outputs available with this particular device.
primaryToBackup Must be configured to the primary to backup input match list. The format is 'XX:YY,XX:YY,XX:YY,...XX:YY', a comma separated of pairs of input numbers. When switching from primary to backup, all outputs set to an XX input in this list are switched to the corresponding YY input.
backupToPrimary Must be configured to the backup to primary input match list. The format is 'XX:YY,XX:YY,XX:YY,...XX:YY', a comma separated of pairs of input numbers. When switching from backup to primary, all outputs set to an XX input in this list are switched to the corresponding YY input.
outputList The list of outputs of the switch matrix which shall be controlled by this device. The format is 'AA,BB,CC, ... ,ZZ', listing the 2-digit output numbers to control in a comma separated list. 'outputList' may be left empty, the device then controls all outputs of the switch matrix.

Variables defined by this device driver

name type flags range
info.driver TEXT R/O StringRange R/O
info.type TEXT R/O StringRange R/O
info.frame TEXT R/O StringRange R/O
config.matrixMode CHOICE SAVE SETUP EnumRange (DISTRIBUTIVE COMBINING)
config.matrixName TEXT SAVE SETUP StringRange
config.locationId TEXT SAVE SETUP StringRange
config.primaryValue TEXT SAVE SETUP StringRange
config.backupValue TEXT SAVE SETUP StringRange
config.primaryToBackup TEXT SAVE SETUP StringRange
config.backupToPrimary TEXT SAVE SETUP StringRange
config.outputList TEXT SAVE SETUP StringRange
config.inputList TEXT SAVE SETUP StringRange
forceSwitch CHOICE NOPRESET EnumRange (PRIMARY BACKUP)
position TEXT R/O StringRange R/O