1.335 MFM-IpEncoder

The MFM-IpEncoder logical device is part of the sat-nms MFM framework which interconnects a sat-nms VLC to the ND SatCom Media Fleet Manager.The MFM-IpEncoder is a so called translation device which interconnects the MFM-PlayList device to the sat-nms device driver of an IP encoder device.

Internally the Media Fleet Manager codes all equipment settings in binary enumerations (for choice parameters) and scaled integers for numeric values. The MFM-IpEncoder translation device takes these settings and translates them into the parameter representation expected by the sat-nms device drivers. For this, it inspects each parameter's range definition and matches the settings against the MFM encoding of the parameters.

Overview

The sat-nms MFM framework consists of the MFM-PlayList device and a number of so called translation devices. The MFM-PlayList device does the communication with the Media Fleet Manager using the proprietary protocol of this. It manages the sequence control of transmissions, even if there is no connection to the MFM.

MFM-PlayList.png

Beside this, there are translation devices which have to be configured with one instance for each DVB uplink or downlink chain, for each IP encoder or decoder. The task of translation devices is to translate the settings commanded by the media fleet manager in it's own format into the individual format each sat-nms device driver expects. The translation devices also check if parameters have been set properly and forward this information to the MFM-PlayList device.

Adding a translation device for a certain physical device to the configuration automatically makes this device known to the MFM. The following types of translation devices are available with the sat-nms MFM framework:

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 page 'Maintenance' the setup dialog contains some settings to configure this logical device.

parameter description
aliasName The alias name of the device reported to the Media Fleet Manager.
checkDelay After receiving a set of parameters from the MFM-Playlist and setting these parameters at the IRD, the MFM-IpEncoder device waits the time set here until it checks if all parameters have been set properly.
onAirFaultDelay After going on air, the device suppresses faults for the time configured here. This helps to avoid receiver lock faults/warnings for the first seconds after the signal is switched on.
encDevice The device name of the encoder. This is used to get the device summary fault, it's communications fault and it's OPERATING/OUT-OF-SERVICE setting.
bitrateId The message ID of the parameter controlling the transport stream bitrate.
ipBitrateId The message ID of the parameter controlling the maximum available ip bitrate for the stream.
transportTypeId The message ID of the parameter controlling the transport type (UDP/RTP).
streamingModeId The message ID of the parameter controlling the streaming mode (UNICAST/MULTICAST).
dstIpAddressId The message ID of the decoder parameter controlling the destination IP address.
dstPortNoId The message ID of the decoder parameter controlling the destination IP port number .
packetSizeId The message ID of the parameter controlling the packet size (188/204)
encryptModeId The message ID of the encoder parameter controlling the encryption mode (BISS-1/BISS-E).
session1WordId The message ID of the encoder parameter setting the BISS-1 session word.
sessionEWordId The message ID of the encoder parameter setting the BISS-E session word.
injectedIDId The message ID of the encoder parameter setting the BISS injected ID.
rasKeyId The message ID of the encoder parameter setting the RAS encryption key.
audioRateId The message ID of the encoder parameter setting the first audio channel bitrate.
audioRate2Id The message ID of the encoder parameter setting the second audio channel bitrate.
audio2EnableId The message ID of the encoder parameter enabling the second audio channel.
videoRateId The message ID of the encoder parameter setting the video bitrate.
streamingOnId The message ID of a parameter switching actually "streaming on".

All message ID settings above may be left empty. The MFM-IpEncoder device will not control a parameter with an empty ID setting and it will not check if it is set properly.

Session word and encryption key parameters are not read back and compared to the commanded values, as some devices do not support a readout of these values.

Video profiles

Encoder devices are handling encoding profile parameters in different ways, depending on vendor and / or encoder type. For this reason there is no direct translation possible from the MFM specific parameters selecting an encoding profile and the corresponding encoder parameters. Instead, the MFM-IpEncoder device calls a sat-nms device preset to configure these parameters.

To make this work, you have to store device presets for each particular encoder type you are using and the video encoding profiles used in your MFM equipment presets. The names of the presets called by the MFM-IpEncoder device follow a fixed scheme, resembling the combination of the "video coding standard" and "coding format" MFM parameters.

This is the list of all presets names recognized by the MFM-IpEncoder device:

    MPEG2-MP@ML-420     MPEG4-MP@ML-420         
    MPEG2-MP@LL-420     MPEG4-MP@LL-420
    MPEG2-HP@ML-422     MPEG4-HP@ML-422
    MPEG2-HP@LL-422     MPEG4-HP@LL-422
    MPEG2-SP@LL-420     MPEG4-SP@LL-420
    MPEG2-SP@ML-420     MPEG4-SP@ML-420
    MPEG2-MP@H14-420    MPEG4-MP@H14-420
    MPEG2-MP@HL-420     MPEG4-MP@HL-420
    MPEG2-HP@H14-422    MPEG4-HP@H14-422
    MPEG2-HP@HL-422     MPEG4-HP@HL-422
    MPEG2-HP@HL-420     MPEG4-HP@HL-420
    MPEG2-HP@H14-420    MPEG4-HP@H14-420
    MPEG2-HP@ML-420     MPEG4-HP@ML-420       

It is not necessary to create all of these presets, only these ones addressed by MFM transmission presets are required.

If the presets are created by the "preset store" function in the device window, they should be edited afterwards to remove all parameters from the preset which are set explicitly by the MFM-IpEncoder device. If such a parameter remains in the preset, it may overwrite the value actually commanded by the MFM-IpEncoder device. There is no fixed order in which preset contained parameters and explicitly commanded ones are processed by the encoder device driver.

Remarks

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.port TEXT R/O StringRange R/O
info.frame TEXT R/O StringRange R/O
config.aliasName TEXT SAVE SETUP StringRange
config.checkDelay INTEGER SAVE SETUP IntegerRange (0 .. 30)
config.onAirFaultDelay INTEGER SAVE SETUP IntegerRange (0 .. 30)
config.encDevice TEXT SAVE SETUP StringRange
config.bitrateId TEXT SAVE SETUP StringRange
config.ipBitrateId TEXT SAVE SETUP StringRange
config.transportTypeId TEXT SAVE SETUP StringRange
config.streamingModeId TEXT SAVE SETUP StringRange
config.dstIpAddressId TEXT SAVE SETUP StringRange
config.dstPortNoId TEXT SAVE SETUP StringRange
config.packetSizeId TEXT SAVE SETUP StringRange
config.encryptModeId TEXT SAVE SETUP StringRange
config.session1WordId TEXT SAVE SETUP StringRange
config.sessionEWordId TEXT SAVE SETUP StringRange
config.injectedIDId TEXT SAVE SETUP StringRange
config.rasKeyId TEXT SAVE SETUP StringRange
config.audioRateId TEXT SAVE SETUP StringRange
config.audioRate2Id TEXT SAVE SETUP StringRange
config.audio2EnableId TEXT SAVE SETUP StringRange
config.videoRateId TEXT SAVE SETUP StringRange
config.streamingOnId TEXT SAVE SETUP StringRange
set TEXT StringRange
check CHOICE R/O EnumRange R/O (IDLE PENDING SUCCESS FAILED)
errorCode INTEGER R/O IntegerRange R/O (0 .. 0)
onAir CHOICE EnumRange (OFFAIR ONAIR)
releaseCheckFault TEXT StringRange