1.554 RX-Channel-ActivationBased

The RX-Channel-ActivationBased logical device controls the basic parameters of an IRD and an input switch for the IRD which selects antenna, frequency band and polarization. RX-Channel-ActivationBased replaces the RX-Channel device in ACTIVATION-BASED workflow mode on modern M&C systems which store the channel data in a central SQL database.

Although all individual IRD parameters are directly accessible with the device, the typical way to operate the device is to select a satellite channel from the list and to select the proper input signal for the IRD. The RX-Channel-ActivationBased device assists the operator in this task with the following functions:

The device implements the ACTIVATION-BASED operation mode of the RX-Channel device. This combines the 'first select the the satellite channel' paradigm of the FILTER-BY-CHANNEL mode with an advancement of the locking mechanism of the FILTER-BY-SATELLITE mode and adds a number of additional function to this. Here the most important one is, that the device is capable to select automatically an antenna which is suitable to receive the selected satellite channel. 'Activation' in this context means to select and point an antenna for the satellite channel to receive, to connect the IRD to this signal and finally lock the resources used to prevent other instances of the RX-Channel-ActivationBased device from changing parameters which would interrupt the reception.

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 .

Operation

The typical work flow for operating this device is as follows:

  1. Select the desired satellite channel from the list.
  2. Set the antenna select mode either to MANUAL, AUTO or AUTO-NO-FIXED. The latter mode skips (typically small) antennas with fixed pointing when selecting the antenna.
  3. With manual antenna select mode select the antenna to be used
  4. Click the "ACTIVATE" button.

With automatic antenna selection, the device searches for a suitable antenna and select this automatically. It selects the antenna with this priority (highest first):

  1. A fixed pointing antenna receiving the selected satellite
  2. A motor driven antenna which already is pointed to the selected satellite
  3. A motor driven antenna which actually is pointed to another satellite but not in use.

If more than one antenna is available in one of these search steps, the antenna with the larger diameter is used. The AUTO-NO-FIXED mode skips the first search step.

Configuration parameters

At the maintenance page of the device window there are a couple of configuration parameters which must be set to interconnect the RX-Channel-ActivationBased device with the IRD and the input switch.

parameter description
switchId Enter the message identifier here of the parameter which shall receive the switch setting, e.g. "MATRIX.12.position". Look at the list of device driver variable definitions to see correct name of this setting at the device type you are using.
configFile The name of the configuration file, the RX-Channel-ActivationBased device reads the matrix input assignments from. You may use a common configuration file for all RX-Channel-ActivationBased devices in the system or an individual file. The file format is described at the end of this chapter.
frequencyId The parameter with the message ID entered receives the receive frequency setting from the device.
fecId The message ID for setting the FEC
symbolRateId The message ID for setting the symbol rate
dvbModeId The message ID for setting the DVB-S/DVB-S2 mode. For most IRDs use the 'dvbMode' parameter for this. For the Scopus IRD2900 please read it's driver documentation for this parameter.
nlcModeId The message ID for setting the NLC mode.
rollOffId The message ID for settings the roll off
modulationId The message ID for setting the modulation mode (QPSK, 8PSK etc.)
decoderInputId The message ID to switch the IRD's decoder input between SAT/IP/ASI
bissKeyId The message ID for setting the BISS key (session word) at the IRD. Please note, that this parameter is only used in ACTIVATION-BASED mode and should only be set if you do not intend to use the sat-nms BISS key CDB device for setting the encryption parameters of the IRD.
bissInjectedIdId The message ID for setting the BISS injected ID at the IRD. Please note, that this parameter is only used in ACTIVATION-BASED mode and should only be set if you do not intend to use the sat-nms BISS key CDB device for setting the encryption parameters of the IRD.
bissModeId The message ID for setting the BISS mode. Please note, that this parameter is only used in ACTIVATION-BASED mode and should only be set if you do not intend to use the sat-nms BISS key CDB device for setting the encryption parameters of the IRD.
ipTypeId The message ID for selecting the IP protocol family (UNICAST/MULTICAST) at the IRD.
ipProtocolId The message ID for selecting the IP protocol (UDP, RTP, etc.) at the IRD.
srcIpAddressId The message ID for setting the IP source or multicast address at the IRD.
srcIpPortId The message ID for setting the IP port at the IRD.
ipFecId The message ID for enabling / disabling the IP FEC
decPhysInterfaceId The message ID for selecting the physical network interface number at the IRD
irdLockFaultId The message ID for the lock fault flag of the IRD.

To make the RX-Channel-ActivationBased device work, at least the frequencyId and symbolRateId fields must be set to the message IDs of the corresponding IRD parameters. If some other parameters are not supported by the IRD, leave the message ID fields empty, the same applies to the lock fault if a lock fault signalling in the RX-Channel-ActivationBased device is not desired.

The configuration file format

The RX-Channel's configuration file is a plain text file which defines the matrix / switch input assignments. As this is a system wide assignment, you usually will edit one common configuration file for all RX-Channel-ActivationBased devices connected to one input matrix.

In the file all empty lines and lines starting with a '#' character are ignored. All other lines are treated as table rows where the cells are separated by space characters. Each row describes one matrix input as follows:

column contents remark
1 switch position / matrix input If the input numbering starts at one or at zero, depends on the matrix / switch device driver.
2 antenna name The antenna name must not contain spaces, commas ot pipe characters.
3 polarization A one letter code, one of the follwing: X for horizontal Y for vertical P if the antenna must turn the feed in order to change the polarization
4 LNB LO frequency for this port The LO frequency must be given as a decimal number (MHz) with a decimal point (no commas, no thousand's separators are allowed)
5 < or > If this column contains ' < ', the switch position is used for frequencies below the limit contained in the next column. ' < ' works the other way round.
6 frequency limit for this port The frequency limit must be given as a decimal number (MHz) with a decimal point (no commas, no thousand's separators are allowed)

Example:


#  Example configuration file for a RX-Channel-ActivationBased device
#
#
#  input no.    polarization       freq. limit [MHz]
#  |            |                  |
#  |   antenna  |  LO freq. [MHz]  |
#  |   |        |  |               |

  01   ARD      X  9750.0        < 11800.0 
  02   ARD      Y  9750.0        < 11800.0
  03   ARD      X  10600.0       > 11800.0 
  04   ARD      Y  10600.0       > 11800.0 

  05   NDR      X  9750.0        < 11800.0 
  07   NDR      X  10600.0       > 11800.0 

  17   SNGR     X  9750.0        < 11800.0 
  18   SNGR     Y  9750.0        < 11800.0 
  19   SNGR     X  10600.0       > 11800.0 
  20   SNGR     Y  10600.0       > 11800.0 
   
  09   EBU      X  10000.0       < 11800.0   
  10   EBU      Y  10000.0       < 11800.0   

  11   W1       X  9750.0        < 11800.0 
  12   W1       Y  9750.0        < 11800.0 
  23   W1       X  10600.0       > 11800.0 
  24   W1       Y  10600.0       > 11800.0  

  13   ASTRA    X  9750.0        < 11800.0   
  14   ASTRA    Y  9750.0        < 11800.0   
  15   ASTRA    X  10600.0       > 11800.0   
  16   ASTRA    Y  10600.0       > 11800.0  
    
  21   EB_12V   Y  10600.0       > 11800.0   

  22   W1_V     Y  10000.0       < 11800.0   

  

The RX-Channel-ActivationBased device parses this file on startup and when it receives a new name for the configuration file. So when you change the configuration file in the running M&C system, the best way is to restart the M&C server process to make all devices read the configuration file again.

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.switchId TEXT SAVE SETUP StringRange
config.configFile TEXT SAVE SETUP StringRange
config.frequencyId TEXT SAVE SETUP StringRange
config.frequency.min FLOAT SAVE SETUP DoubleRange (0.000 .. 0.000)
config.frequency.max FLOAT SAVE SETUP DoubleRange (0.000 .. 0.000)
config.fecId TEXT SAVE SETUP StringRange
config.symbolRateId TEXT SAVE SETUP StringRange
config.dvbModeId TEXT SAVE SETUP StringRange
config.nlcModeId TEXT SAVE SETUP StringRange
config.rollOffId TEXT SAVE SETUP StringRange
config.modulationId TEXT SAVE SETUP StringRange
config.decoderInputId TEXT SAVE SETUP StringRange
config.bissKeyId TEXT SAVE SETUP StringRange
config.bissInjectedIdId TEXT SAVE SETUP StringRange
config.bissModeId TEXT SAVE SETUP StringRange
config.ipTypeId TEXT SAVE SETUP StringRange
config.ipProtocolId TEXT SAVE SETUP StringRange
config.srcIpAddressId TEXT SAVE SETUP StringRange
config.srcIpPortId TEXT SAVE SETUP StringRange
config.ipFecId TEXT SAVE SETUP StringRange
config.decPhysInterfaceId TEXT SAVE SETUP StringRange
config.irdLockFaultId TEXT SAVE SETUP StringRange
antenna CHOICE EnumRange (unknown)
satellite CHOICE EnumRange (unknown)
input CHOICE EnumRange (unknown)
fec CHOICE EnumRange (AUTO 1/2 1/3 1/4 2/3 3/4 2/5 3/5 4/5 5/6 6/7 7/8 8/9 9/10)
polarization CHOICE EnumRange (X Y)
comment TEXT SAVE StringRange
rxFrequency FLOAT DoubleRange (0.000 .. 0.000)
symbolRate FLOAT DoubleRange (0.0000 .. 0.0000)
dvbMode CHOICE EnumRange (DVBS DVBS2 NS3 NS4)
nlcMode CHOICE EnumRange (OFF ON)
rollOff CHOICE EnumRange (0.02 0.05 0.10 0.15 0.20 0.25 0.35)
modulation CHOICE EnumRange (BPSK QPSK OQPSK 8PSK 16PSK 16QAM 64QAM 256QAM 16APSK 32APSK)
bissMode CHOICE EnumRange (CLEAR BISS-1 BISS-E)
bissKey TEXT StringRange
bissInjectedId TEXT StringRange
decoderInput CHOICE EnumRange (SAT IP ASI)
ipType CHOICE EnumRange (UNICAST MULTICAST)
ipProtocol CHOICE EnumRange (UDP RTP TCP ZIXI)
srcIpAddress TEXT StringRange
srcIpPort INTEGER IntegerRange (0 .. 65535)
ipFec CHOICE EnumRange (OFF ON)
decPhysInterface INTEGER IntegerRange (1 .. 4)
channel CHOICE EnumRange (@@@channels.m)
reset TEXT StringRange
antennaSelect CHOICE EnumRange (AUTO AUTO-NO-FIXED MANUAL)
locked BOOLEAN BooleanRange (true false)
reserved CHOICE SAVE EnumRange (NO YES)
locked.save TEXT SAVE StringRange
rfLocked BOOLEAN R/O BooleanRange R/O (true false)
ipLocked BOOLEAN R/O BooleanRange R/O (true false)
copyFrom CHOICE EnumRange (?)
name TEXT StringRange
remote.channel TEXT StringRange
remote.antenna CHOICE EnumRange (MANUAL unknown)
remote.antennaSelect CHOICE EnumRange (AUTO AUTO-NO-FIXED MANUAL)
remote.locked BOOLEAN BooleanRange (true false)
remote.lockResult TEXT R/O StringRange R/O
remote.name TEXT StringRange
remote.bissMode CHOICE EnumRange (CLEAR BISS-1 BISS-E)
remote.bissKey TEXT StringRange
remote.bissInjectedId TEXT StringRange
local.locked BOOLEAN R/O BooleanRange R/O (true false)
local.reserved BOOLEAN R/O BooleanRange R/O (true false)
display TEXT R/O StringRange R/O
dispColor TEXT R/O StringRange R/O
cdbState TEXT R/O StringRange R/O
actState TEXT R/O StringRange R/O
eventDescription TEXT SAVE StringRange
faults.01 ALARM R/O AlarmFlagRange R/O (IRD lock)
faults.02 ALARM R/O AlarmFlagRange R/O (Config file)
faults.03 ALARM R/O AlarmFlagRange R/O (Wrong antenna)
faults.04 ALARM R/O AlarmFlagRange R/O (Wrong band)
faults.05 ALARM R/O AlarmFlagRange R/O (Wrong polatization)
faults.06 ALARM R/O AlarmFlagRange R/O (Database access)