9.664 TX-LineSettings-CDB

The TX-LineSettings-CDB logical device controls some parameters of an encoder / modulator / power amplifier transmit chain from a common channel database. The device complements the RX-LineSettings-CDB logical device which provides a similar function for receive chains.

TX-LineSettings-CDB supersedes the TX-ChannelSelect-CDB device, which no longer should be used for new applications. The TX-LineSettings-CDB device supports a larger number of parameters, may be used in M&C and in NMS environments and it supports an alternative operation mode / work flow. The name TX-LineSettings-CDB reflects that the set of parameters managed by the device extend the standard channel parameters.

Heart of the TX-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 (channel select)

The TX-LineSettings-CDB device supports two different operation modes / work flow settings which are selected by the 'filterBySatellite' configuration parameter.

With 'filterBySatellite=NO' (the default mode) the 'channel' field always shows all line settings data records. The auto-filter mode of the drop down box helps to find the desired satellite channel. Selecting a channel means to set all transmit parameters, the polarization switch and (if configured) also the antenna pointing from the satellite name stored with the selected data record. This operation mode may be used in M&C and NMS environments as well.

With 'filterBySatellite=YES', the 'channel' field only shows the channels of the satellite the antenna actually is pointed to. To move the antenna to another satellite, either the 'satellite' field in the TX-LineSettings-CDB's device screen may me used or the antenne may be controlled via it's own screen. Changing the antenna pointing automatically changes the subset of satellite channels displayed in the 'channels' field. This operation mode is only possible in M&C environments.

The TX-LineSettings-CDB device manages a number of transmit parameters, sets these parameters at the encoder, modulator etc. when a channel is selected. The following parameter may be managed by the TX-LineSettings-CDB device:

Please note, that the TX-LineSettings-CDB device neither controls the TX-ON state of the equipment. The operator is responsible to switch off the transmission before applying a satellite channel data record and also to perform the line up procedure as specified. The LineUp-Control logical device may be used to support the operator with this task. With the LineUp-Control device, the nominal and reduced eirp values from the database are set at this device rather than at the equipment itself. The operator then easily can set the transmit power values required during the line up procedure.

Instead of selecting the satellite and channel you also may enter the transmit parameters at the fields of the device screen. The TX-LineSettings-CDB device forwards these settings to the ancillary devices.

Video profiles

The line settings database contains a parameter called "profile" which controls the basic video encoding mode for the encoder device. This profile contains the MPEG-2 / MPEG-4 selection, the MPEG profile/level and the 4.2.0/4.2.2 color subsampling setting.

Most video encoders don't provide a single parameter to set these values, but use several settings which may differ in name and values they offer to select. To overcome these differences, the TX-LineSettings-CDB device can use special device presets to set the profile parameter in a way individually specialized for the type of video encoder.

To use this feature, store device presets for the profiles you need. Each preset must be named exactly as the profile selection in the channel database (e.g. 'MPEG4-MP@HL-420'). The presets stored for this purpose should be edited in a way, that all parameters which could interfere with other database settings are removed, leaving only the parameters in the preset which set the profile properties.

Then configure the TX-LineSettings-CDB device to route the profile parameter ('profileId' configuration parameter) to the 'applyPreset' parameter of the encoder (e.g. 'ENC.applyPreset'). The TX-LineSettings-CDB device will apply the appropriate device preset when a channel from the database ist selected.

Operation (database edit)

With the second page of the device window of the TX-LineSettings-CDB device channel definitions are edited, copied or deleted. All TX-LineSettings-CDB devices in a sat-nms NMS share one common channel database located at the NMS server. The VLC containing the TX-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 requirement 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 TX-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 TX-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 update 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 TX-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 TX-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

At the maintenance page of the device window there are a couple of configuration parameters which must be set to interconnect the TX-LineSettings-CDB device with the transmit equipment.

parameter description
frequencyId The message ID to set the transmit frequency.
fecId The message ID to set the FEC. If the modulator provides a combined modulation/FEC parameter, leave this field empty.
symbolRateId The message ID to set the symbol rate. Modulators expecting the symbol rate in 'Msps' and in 'sps' are supported. The symbol rate is only set, if the line settings parameter 'useSymbolRate' is set to SYMBOLRATE.
bitRateId The message ID to set the bit rate. Modulators expecting the bit rate in 'Mbps' and in 'bps' are supported. The bit rate is only set, if the line settings parameter 'useSymbolRate' is set to BITRATE.
dvbModeId The message ID to set the DVB-S/DVB-S2 mode.
pilotsId The message ID to switch pilots ON/OFF.
rollOffId The message ID to set the roll-off parameter.
modulationId The message ID to set the modulation scheme (e.g. QPSK)
modulationFecId Some modulator devices provide a combined modulation FEC parameter instead of separate parameters. For such a device enter the message ID of the combined parameter here and leave the modulationId / fecId fields empty.
packetSizeId The message ID of the modulator packet size parameter (188/204)
frameSizeId The message ID of the MPEG frame size parameter (short/normal)
videoRateId The message ID to receive the video data rate (Mbit/s). The device sends this parameter only if the line settings data record has the video data rate marked as FIXED.
profileId The message ID of the video coding profile or the 'applyPreset' parameter of the encoder if the profile shall be set using device presets.
eirpId The message ID of the parameter to receive the nominal EIRP value for the selected line setting. In most cases this will be the 'nominalEirp' parameter of the LineUp-Control device complementing this device.
reducedEirpId The message ID of the parameter to receive the reduced (line up) EIRP value for the selected line setting. In most cases this will be the 'reducedEirp' parameter of the LineUp-Control device complementing this device.
audioRateId The message ID of the encoder audio bitrate parameter (first audio channel).
audio2RateId The message ID of the encoder audio bitrate parameter (second audio channel). The value is only set if the 'audioChannels' parameter in the actual line settings is 2 or higher.
audio3RateId The message ID of the encoder audio bitrate parameter (third audio channel). The value is only set if the 'audioChannels' parameter in the actual line settings is 4 or higher.
audio4RateId The message ID of the encoder audio bitrate parameter (fourth audio channel). The value is only set if the 'audioChannels' parameter in the actual line settings is to 4.
satelliteId The parameter ID of the 'satellite' parameter of the Antenna-Pointing device of the antenna which is used for transmission.
txFaultId You may specify the message ID of a fault signal here which is reported as "TX Chain" fault by the device. If you don't want any fault monitoring, leave the field empty.
polarizationId The message ID to set the transmit polarization. The device sends X / Y from the channel definition to this ID. With a waveguide switch for pol select you may us a Choice-Translator logical device to translate X/Y into the proper switch positions.
txLoFrequency You may set a BUC LO frequency here, e.g. if the transmit equipment is not capable to compute the modulator output frequency by itself. If your equipment is configured to set the transmit frequency in terms of true RF frequency at the antenna, then leave the field empty or set the LO frequency explicitly to 0.
filterBySatellite Selects the workflow / operation mode of the device. "NO" selects the standard, unfiltered mode: The 'channel' parameter always offers all line settings records stored in the database. "YES" switch to filtered mode, the 'channel' parameter shows only the channel matching the actual satellite addressed by 'satellite'.

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.frequencyId TEXT SAVE SETUP StringRange
config.fecId TEXT SAVE SETUP StringRange
config.symbolRateId TEXT SAVE SETUP StringRange
config.bitRateId TEXT SAVE SETUP StringRange
config.dvbModeId TEXT SAVE SETUP StringRange
config.pilotsId TEXT SAVE SETUP StringRange
config.rollOffId TEXT SAVE SETUP StringRange
config.modulationId TEXT SAVE SETUP StringRange
config.modulationFecId TEXT SAVE SETUP StringRange
config.txFaultId TEXT SAVE SETUP StringRange
config.polarizationId TEXT SAVE SETUP StringRange
config.packetSizeId TEXT SAVE SETUP StringRange
config.frameSizeId TEXT SAVE SETUP StringRange
config.videoRateId TEXT SAVE SETUP StringRange
config.profileId TEXT SAVE SETUP StringRange
config.eirpId TEXT SAVE SETUP StringRange
config.reducedEirpId TEXT SAVE SETUP StringRange
config.audioRateId TEXT SAVE SETUP StringRange
config.audio2RateId TEXT SAVE SETUP StringRange
config.audio3RateId TEXT SAVE SETUP StringRange
config.audio4RateId TEXT SAVE SETUP StringRange
config.satelliteId TEXT SAVE SETUP StringRange
config.txLoFrequency FLOAT SAVE SETUP DoubleRange (0.000 .. 0.000)
config.filterBySatellite CHOICE SAVE SETUP EnumRange (NO YES)
satellite TEXT StringRange DIS
fec CHOICE EnumRange DIS (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)
txFrequency FLOAT DoubleRange DIS (0.000 .. 0.000)
polarization CHOICE EnumRange DIS (X Y L R)
comment TEXT SAVE StringRange
symbolRate FLOAT DoubleRange DIS (0.0000 .. 0.0000)
bitRate FLOAT DoubleRange DIS (0.0000 .. 0.0000)
dvbMode CHOICE EnumRange DIS (DVBS DVBS2 NS3 NS4)
rollOff CHOICE EnumRange DIS (0.02 0.05 0.10 0.15 0.20 0.25 0.35)
pilots CHOICE EnumRange DIS (OFF ON)
modulation CHOICE EnumRange DIS (BPSK QPSK OQPSK 8PSK 16PSK 16QAM 64QAM 256QAM 16APSK 32APSK)
packetSize CHOICE EnumRange DIS (188 204)
frameSize CHOICE EnumRange DIS (SHORT NORMAL)
videoRate FLOAT DoubleRange DIS (0.0000 .. 0.0000)
profile CHOICE EnumRange DIS (UNKNOWN)
eirp FLOAT DoubleRange DIS (0.00 .. 0.00)
reducedEirp FLOAT DoubleRange DIS (0.00 .. 0.00)
audioRate CHOICE EnumRange DIS (DISABLED 64k 96k 128k 160k 192k 224k 256k 320k 384k)
audio2Rate CHOICE EnumRange DIS (DISABLED 64k 96k 128k 160k 192k 224k 256k 320k 384k)
audio3Rate CHOICE EnumRange DIS (DISABLED 64k 96k 128k 160k 192k 224k 256k 320k 384k)
audio4Rate CHOICE EnumRange DIS (DISABLED 64k 96k 128k 160k 192k 224k 256k 320k 384k)
reloadProfiles TEXT StringRange
channel CHOICE EnumRange (@@@channels)
reset TEXT StringRange
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 (TX Chain)