9.561 RX-LineSettings-CDB-DBonly

The RX-LineSettings-CDB logical device controls the basic parameters of an IRD and an input switch for the IRD which selects frequency band and polarization. The device complements the TX-LineSettings-CDB logical device which provides a similar function for transmit chains.

This is a special version of the device, which provides only access to the database.

Heart of the RX-LineSettings-CDB device is a central database (CDB) storing the line settings for all satellite channels used in the system. In a NMS environment the database is located in the NMS server, providing an synchronization mechanism which creates local (read-only) copies of the database for offline operation of the VLCs. In a NMS environment, the sat-nms client software looks up the channel lists directly at the NMS database server which significantly reduces the amount of data which has to be exchanged between NMS and VLC. In a M&C environment the CDB is located at the M&C server, no synchronization is required in this case.

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 (database edit)

With this page of the device window of the RX-LineSettings-CDB device channel definitions are edited, copied or deleted. All RX-LineSettings devices in a sat-nms NMS share one common channel database located at the NMS server. The VLC containing the RX-LineSettings-CDB device requires an online connection to the NMS central database in order to make any changes to the database. Selecting channels at this page or changing any channel parameters do not change the receiver settings.

Local database copy

The following paragraph only applies to NMS installations. M&C installation manage their CDB locally at the M&C server and do not require a local copy of the data.

sat-nms VLCs may be operated locally by connecting an M&C client directly to the VLC. This may be used as a backup operation mode in cases where the NMS server is down or unreachable. To uphold the RX-LineSettings-CDB functionality even in this backup case, the VLC maintains a local copy of the channel database. This copy is used if the CDB at the NMS is unreachable. You cannot edit the channels in this local backup copy, but you can apply stored channels to the IRD.

There are two ways to update the local copy of the channel database at the VLC:

  1. At the "Database" page of the device window of a RX-LineSettings-CDB device click "VLC UPD". This requests the complete database contents from the NMS server and stores it locally.
  2. Administrators may configure a VLC to update the local database copy in regular intervals. To make a VLC upadate it's local database copy automatically, add a line cdb.channels.syncInterval=#.# to the file vlc.properties and restart the VLC. '#.#' is the time interval in hours.

EBU DREAMS channel list import

The channel database is capable to import channel lists from the EBU DREAMS software. The DREAMS channel lists are distributed as two CSV tables, on for RX and one for TX. In the sat-nms channel database these lists get merged. EBU channels are marked "read-only" in the database, they only may be changed by importing a new EBU channel list.

To import a pair of EBU channel lists, click the "IMPORT" button at the "Database" page of the RX-LineSettings-CDB device's device screen. This opens a new window where the names of the files to import must be entered. The small buttons beside the file name entry fields open a file select dialog which lets you select the file names fom the directory.

After you have set the file names, click "READ". The software reads and parses the CSV files. It also matches corresponding RX and TX channels, because the sat-nms channel database stores only one entry for each channel containing both, the RX and TX parameters.

The software reports the number channels read from each file and the number of channels matched. Sometimes the numbers slightly differ, e.g. if the original channel names in the RX and TX lists are not really identical. You have to edit and repair the original files if you want to fix this.

If you are satisfied with the parsing result, click "IMPORT". This imports the channel definitions to the sat-nms database. All existing EBU channel definitions are deleted and replaced by the new ones. The user defined channels in the database remain unchanged by this.

Please note, that this procedure copies the EBU channels directly from the client PC to the NMS server, the RX-LineSettings-CDB device is not involved in this and does not recognize the new channels immediately. This happens with the next regular update of the channel list, max 5 minutes later.

Configuration parameters

Just leave the configuration parameters empty.

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.fecId TEXT SAVE SETUP StringRange
config.symbolRateId TEXT SAVE SETUP StringRange
config.dvbModeId TEXT SAVE SETUP StringRange
config.irdLockFaultId TEXT SAVE SETUP StringRange
config.filterBySatellite CHOICE SAVE SETUP EnumRange (NO YES)
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 TEXT R/O StringRange R/O
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)
channel CHOICE EnumRange (@@@channels.m)
reset TEXT StringRange
locked BOOLEAN SAVE BooleanRange (true false)
edit.channel CHOICE EnumRange (@@@channels)
edit.satellite TEXT StringRange
edit.chanid TEXT StringRange
edit.rxpol CHOICE EnumRange (X Y L R)
edit.rxfreq FLOAT DoubleRange (0.000 .. 0.000)
edit.txpol CHOICE EnumRange (X Y L R)
edit.txfreq FLOAT DoubleRange (0.000 .. 0.000)
edit.symbolRate FLOAT DoubleRange (0.0000 .. 0.0000)
edit.bitRate FLOAT DoubleRange (0.0000 .. 0.0000)
edit.useSymbolRate CHOICE EnumRange (SYMBOLRATE BITRATE)
edit.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)
edit.modulation CHOICE EnumRange (BPSK QPSK OQPSK 8PSK 16PSK 16QAM 64QAM 256QAM 16APSK 32APSK)
edit.packetSize CHOICE EnumRange (188 204)
edit.rollOff CHOICE EnumRange (0.02 0.05 0.10 0.15 0.20 0.25 0.35)
edit.dvbMode CHOICE EnumRange (DVBS DVBS2 NS3 NS4)
edit.frameSize CHOICE EnumRange (SHORT NORMAL)
edit.pilots CHOICE EnumRange (OFF ON)
edit.videoRate FLOAT DoubleRange (0.0000 .. 0.0000)
edit.videoRateAuto CHOICE EnumRange (FIXED AUTO)
edit.profile CHOICE EnumRange (MPEG2-MP@ML-420 MPEG2-MP@LL-420 MPEG2-HP@ML-422 MPEG2-HP@LL-422 MPEG2-SP@LL-420 MPEG2-SP@ML-420 MPEG2-MP@H14-420 MPEG2-MP@HL-420 MPEG2-HP@H14-422 MPEG2-HP@HL-422 MPEG2-HP@HL-420 MPEG2-HP@H14-420 MPEG2-HP@ML-420 MPEG4-BP@L2-420 MPEG4-BP@L3-420 MPEG4-BP@L4-420 MPEG4-MP@L3-420 MPEG4-MP@L4-420 MPEG4-MP@L4.2-420 MPEG4-HP@L3-420 MPEG4-HP@L4-420 MPEG4-HP@L4.2-420 MPEG4-HP@L3-422 MPEG4-HP@L4-422 MPEG4-HP@L4.2-422)
edit.eirp FLOAT DoubleRange (0.00 .. 0.00)
edit.reducedEirp FLOAT DoubleRange (0.00 .. 0.00)
edit.autoLineUp CHOICE EnumRange DIS (OFF ON)
edit.audioRate CHOICE EnumRange (DISABLED 64k 96k 128k 160k 192k 224k 256k 320k 384k)
edit.audio2Rate CHOICE EnumRange (DISABLED 64k 96k 128k 160k 192k 224k 256k 320k 384k)
edit.audio3Rate CHOICE EnumRange (DISABLED 64k 96k 128k 160k 192k 224k 256k 320k 384k)
edit.audio4Rate CHOICE EnumRange (DISABLED 64k 96k 128k 160k 192k 224k 256k 320k 384k)
edit.audioChannels CHOICE EnumRange (1 2 3 4)
edit.comment TEXT StringRange
edit.user TEXT StringRange
edit.brEnable TEXT R/O StringRange R/O
edit.srEnable TEXT R/O StringRange R/O
edit.vrEnable TEXT R/O StringRange R/O
edit.ar2Enable TEXT R/O StringRange R/O
edit.ar3Enable TEXT R/O StringRange R/O
edit.ar4Enable TEXT R/O StringRange R/O
edit.store TEXT StringRange
edit.delete TEXT StringRange
edit.read TEXT StringRange
edit.sync TEXT StringRange
display TEXT R/O StringRange R/O
dispColor TEXT R/O StringRange R/O
cdbState TEXT R/O StringRange R/O
faults.01 ALARM R/O AlarmFlagRange R/O (IRD lock)
faults.02 ALARM R/O AlarmFlagRange R/O (Config file)