Description Go to top

Stream modulator device contains a set of functions and variables for controlling various models of stream modulators. There are different types of supported modulators that can be used in the RT-RKs BBT system:

All listed modulators generate RF signal in a different frequency ranges.

Typical usage scenarios of the Stream modulators are described on following pages:

 

DVB-T stream modulator (UT-100) Go to top

 

Device info Go to top

In order to initialize the device properly, several parameters must be set. The following example shows the example of proper definition of device instance inside the test_env.ini (test environment description) configuration file:

//Stream player UT100B
[device]
alias = StreamPlayer
name = UT100B
config = StreamPlayer_UT100B.ini
Path = \\streamsrv\streams

Details about the parameters that need to be set in order to correctly configure “UT-100 DVB-T modulator” device from the manufacturer HiDes are provided here:

  • alias – is a tag name which will be used in the test case or in the API.
  • name – presents a unique identifier for the device driver (DLL) and MUST be set to UT100B.
  • config – is the name of the file which contains additional configuration (macro commands) related to the stream modulator device (this parameter is optional but desirable).
  • Path – is used to define default path to the folder with streams (this parameter is optional but desirable).

These parameters present a device configuration and they are described in the Configuration & Macros (Anatomy of Configuration file) section.

 

Device parameters Go to top

For the proper functioning of each device, following parameters should be set. Some of the basic parameters for DVB-T stream modulator device are:

  • InputFile – is used to set the input stream file. The path to the file or only a file name (if a file is placed in the working directory) should be written as an input value.
  • Frequency – is used to set the carrier frequency. Possible input value is in [42 MHz– 1002 MHz] range. The default value is 474 MHz.
  • Bandwidth – is used to set the frequency bandwidth. Possible input value could be 2MHz, 2.5MHz, 3MHz, 4MHz, 5MHz, 6MHz, 7MHz or 8MHz. The default value is 8MHz.
  • Constellation – is used to set the constellation. Possible input value could be QPSK, QAM16 or QAM64. The default value is QAM64.
  • ConvolutionalRate – is used to set the convolutional rate. Possible input value could be 1/2, 2/3, 3/4, 5/6, 7/8. The default value is 7/8.
  • GuardInterval – is used to set the guard interval. Possible input value could be 1/4, 1/8, 1/16 or 1/32. The default value is 1/32.
  • TransmissionMode – is used to set the transmission mode. Possible input value could be 2KB, 4KB or 8KB. The default value is 8KB.
  • outputRFLevel – is used to set the output level of the RF signal (Range: +6/-25dB, step size 1dB).  The default value is 0.
  • BitRate – is used to set the streaming bit rate. Possible input value is in [0 – 31700000] range. NOTE: If a value is not set by the user, the bit rate will be automatically set according to the stream.
  • Play – is used to start streaming. Input value should be 1.
  • Stop – is used to stop streaming. Input value should be 1.
  • Path – is used to define the default absolute path to the folder with streams.
 

Device usage Go to top

Each of previously listed device parameters may be separately set within the test script, but this approach leads to scripts that are less readable and often too large, which makes them very complicated for maintenance. To avoid those problems, macros are used.

One example of the macro that can be used by the DVB-T stream modulator device is given here:

[DVBT_MPEG2_AC3_48khz192kbits] "InputFile AUDIO_DECODING\AC3Stereo1KHz3KHz48KHz192Kbps_LCN500.ts 100" "ModulationType DVBT 100" "Constellation QAM64 100" "GuardInterval 1/4 100" "Frequency 474 100" "Bandwidth 8MHz 100"  "ConvolutionalRate 7/8 100" "TransmissionMode 8K 100"

You can note here the following:

  • A stream that should be streamed with the stream modulator is located at the <Path>\AUDIO_DECODING\AC3Stereo1KHz3KHz48KHz192Kbps_LCN500.ts, where the Path variable was previosly set in the Configuration. After setting the parameter to the stream modulator device, a delay of 100ms is introduced, while the command gets executed. This is defined with the parameter "InputFile AUDIO_DECODING\AC3Stereo1KHz3KHz48KHz192Kbps_LCN500.ts 100"
  • Constellation is set to QAM64. After setting the parameter to the stream modulator device, a delay of 100ms is introduced, while the command gets executed. This is defined with the parameter "Constellation QAM64 100"
  • Guard interval is set to 1/4. After setting the parameter to the stream modulator device, a delay of 100ms is introduced, while the command gets executed. This is defined with the parameter "GuardInterval 1/4 100"
  • Frequency is set to 474 MHz. After setting the parameter to the stream modulator device, a delay of 100ms is introduced, while the command gets executed. This is defined with the parameter "Frequency 474 100"
  • Bandwidth is set to 8 MHz. After setting the parameter to the stream modulator device, a delay of 100ms is introduced, while the command gets executed. This is defined with the parameter "Bandwidth 8MHz 100"
  • Convolution rate is set to 7/8. After setting the parameter to the stream modulator device, a delay of 100ms is introduced, while the command gets executed. This is defined with the parameter "ConvolutionalRate 7/8 100"
  • Transmission mode is set to 8K. After setting the parameter to the stream modulator device, a delay of 100ms is introduced, while the command gets executed. This is defined with the parameter "TransmissionMode 8K 100"

From the test script, a macro is simply called in a following way:

TEST_CREATION_API.stream_play("[DVBT_MPEG2_AC3_48khz192kbits]")

 

DVB-T2 stream modulator Go to top

 

Device info Go to top

Mandatory parameters used to initialize the DVB-T2 stream modulator device are same as in case of DVB-T stream modulator. Following example shows how to setup device instance within the test_env.ini (test environment description) configuration file:

[device]
alias  = StreamPlayer
name   = DTA107
name   = DTA
config = StreamPlayer.ini
Path = D:\Streams\

Details about the parameters that need to be set in order to correctly configure the “DTA modulator” device from the manufacturer DekTec are provided here:

  • alias – is a tag name which will be used in the test case or in the API.
  • name – presents a unique identifier for the device and must be set to DTA.
  • config – is the name of the file which contains additional configuration (macro commands) related to the stream modulator device (this parameter is optional but desirable).
  • Path – is used to define default path to the folder with streams (this parameter is optional but desirable).

These parameters present a device configuration and they are described in the Configuration & Macros (Anatomy of Configuration file) section.

 

Device parameters Go to top

DVB-T2 stream modulator device has much wider set of parameters than the DVB-T modulator device. A full list of device parameters and commands that can be set or read is provided below.

  • InputFile – is used to set the input stream file. Path to the file or only a file name (if file is placed in working directory) should be written as an input value. It doesn’t return any value.
  • DeviceSN – is used to set the serial number of a DekTec device user wants to control. When this variable is set streaming stops, currently used device is detached from the system and the device with this serial number is attached, initialized and opened for use.
  • GetConfig – is used to get the information about current configuration. No input value is needed. Return value is a string containing current values of stream bit-rate, carrier frequency, transmit mode, modulation type, convolution rate, frequency bandwidth, constellation, guard interval, interleaving, transmission mode, DVB-H signalling, DVB-H cell ID and J.83 annex parameters.
  • Play – is used to start streaming. No input value needed. It doesn’t return any value.
  • Stop – is used to stop streaming. No input value needed. It doesn’t return any value.
  • Pause – is used to pause streaming. No input value needed. It doesn’t return any value.
  • BitRate – is used to set the streaming bit rate. Possible input value is in [0 – 31700000] range. Default value is 0. It doesn’t return any value.
  • Frequency – is used to set the carrier frequency. Possible input value is in [400 – 862] range. Default value is 400. It doesn’t return any value.
  • TransmitMode – is used to set the transmit mode. Possible input value could be 188:0, 188:1, ADD16:0, ADD16:1, 204:0, 204:1, RAW:0 or RAW:1. Default value is 188:0. It doesn’t return any value.
  • ModulationType – is used to set the modulation type. Possible input value could be DVBT, QAM16, QAM32, QAM 64,QAM128 or QAM256. Default value is DVBT. It doesn’t return any value.
  • ConvolutionalRate – is used to set the convolution rate. Possible input value could be 1/2, 2/3, 3/4, 5/6, 7/8. Default value is 1/2. It doesn’t return any value.
  • Bandwidth – is used to set the frequency bandwidth. Possible input value could be 5MHz, 6MHz, 7MHz or 8MHz. Default value is 8MHz. It doesn’t return any value.
  • Constellation – is used to set the constellation. Possible input value could be QPSK, QAM16 or QAM64. Default value is QAM64. It doesn’t return any value.
  • GuardInterval – is used to set the guard interval. Possible input value could be 1/4, 1/8, 1/16 or 1/32. Default value is 1/32. It doesn’t return any value.
  • Interleaving – is used to set the interleaving. Possible input value could be NATIVE or INDEPTH. Default value is NATIVE. It doesn’t return any value.
  • TransmissionMode – is used to set the transmission mode. Possible input value could be 2KB, 4KB or 8KB. Default value is 8KB. It doesn’t return any value.
  • DVB-H – is used to set the DVB-H signalling. Possible input value could be ENA4849, DIS4849, S48_OFF, S48, S49_OFF or S49. Default value is ENA4849. It doesn’t return any value.
  • Cell – is used to set the DVB-H cell ID. Possible input value is in [0 – 4294967295] range. Default value is 0. It doesn’t return any value.
  • J83Annex – is used to set new. Possible input value could be A, B or C. Default value is A. It doesn’t return any value.
  • TapsNumber – is used to set the Taps number for ATSC modulation. Valid values are 2, 4, 8, 16, 32, 64, 128 and 256. Default value is 32.
  • InterleavingMode – is used to set the interleaving mode for QAM-B modulation. Parameter can have these values: CW0001_I128_J1, CW0011_I64_J2, CW0111_I16_J8, CW0101_I32_J4, CW1001_I8_J16, CW0000_I128_J1, CW0010_I128_J2, CW0100_I128_J3, CW0110_I128_J4, CW1000_I128_J5, CW1010_I128_J6, CW1100_I128_J7 and CW1110_I128_J8. Default value is CW0001_I128_J1.
  • VSBConstellation – is used to set the VSB constellation for ATSC modulation. Valid values are VSB8 and VSB16. Default value is VSB8.
  • ignore_stop – is used for ignoring the stop command after test execution. Stop command is implemented for purpose of stopping card to generate signal after end of test execution.
  • output – is used for switching between ASI and RF output. This switch can be performed only if DTA card contains both ASI and RF. Default output is RF.
  • MISO – is used to control the MISO DVB-T2 parameter. MISO can be switched OFF or work in TX1, TX2, TX1TX2, SUM, or BOTH modes. Default value is OFF.
  • NumT2Frames – is used to set the number of T2 frames, parameter of DVB-T2 modulation. Default value is 0.
  • QAMRotation – is used to enable/disable the constellation rotation for DVB-T2 modulation. Default value is 1 (enabled).
  • FECType – sets the FEC type parameter for DVB-T2 modulation.
  • TimeILType – is used to set the time IL type parameter for DVB-T2 modulation. Types can be 0 or 1. Default value is 0.
  • FEFLength – is used to set the FEF length parameter for DVB-T2 modulation. Default value is 0.
  • FEFInterval – is used to set the FEF Interval parameter for DVB-T2 modulation. Default value is 0.
  • FEFS1 – is used to set the FEF S1 parameter for DVB-T2 modulation. Default value is 2.
  • FEFS2 – is used to set the FEF S2 parameter for DVB-T2 modulation. Default value is 1.
  • FEFSignal – is used to set the FEF signal parameter for DVB-T2 modulation. Values can be ZERO, 1kOFDM852 and 1kOFDM384. Default value is ZERO.
  • TimeILLength – is used to set the time IL length parameter for DVB-T2 modulation. Default value is 3.
  • HEM – is used to enable/disable high efficiency mode parameter for DVB-T2 modulation. Default value is 1 (enabled).
  • ISSYEnabled – is used to enable/disable ISSY parameter for DVB-T2 modulation. Default value is 0 (disabled).
  • Modulation – is used to set the PLP modulation parameter for DVB-T2 modulation. Values can be QPSK, QAM16, QAM64 and QAM256. Default value is QAM256.
  • PLP-ID – is used to set the PLP ID for DVB-T2. Default value is 0.
  • PLP-GroupID – is used to set the PLP Group ID for DVB-T2. Default value is 1.
  • PLP-Type – is used to set the PLP Type for DVB-T2. Default value is Type1.
  • PilotPattern – is used to set the Pilot pattern for DVB-T2. Default value is PP1.
  • outputRFLevel – is used to change the output level of RF signal (-38dB to -3dB).
  • remultiplex – is used to re-multiplex the input stream during playing. Default value is 0.
  • BandwidthExtension – is used to set the bandwidth extension flag for DVB-T2. This flag can be switched ON/OFF. Default value is ON.
  • NumOfBlocks – is used to set the number of blocks parameter for DVB-T2. Default value is 202.
  • NumDataSymbol – is used to set the number of data symbol parameter for DVB-T2. Default value is 202.
  • PAPR – is used to set the PAPR DVB-T2 parameter. Valid PAPR values are None, ACE, TR and ACE & TR. Default value is None.
  • Interpolation – is used to set the interpolation parameter. Valid values are OFDM and QAM. Default is OFDM.
  • SampleRate – is used to set the sample rate. Default value is 9200000.
  • FEFEnabled – is used to enable/disable FEF DVB-T2 parameters. Default value is 0 (disabled).
  • FEFType – is used to set the FEF type DVB-T2 parameter. Default value is 0.
  • FileBitRate – is used to specify the file bit rate. DTA driver will try to calculate file bit-rate automatically if this variable set to 0, otherwise it will use user specified value.

Other advanced device parameters available for the DVB-T2 stream modulator device are:

  • AttachToSerial – is used to attach a device object to the device hardware, based on the serial number of the device. Input value is serial number of the device. Default value is an empty string. It doesn’t return any value.
  • AttachToSlot – is used to attach a device object to a PCI Bus device, based on PCI-bus number and slot number. Input value is PCIbus:SlotNumber string. Default value is an empty string. It doesn’t return any value.
  • AttachToType – is used to attach a device object to the device hardware, based on the type number of the device. Input value is deviceType:deviceNumber string. Default value is an empty string. It doesn’t return any value.
  • DetachDevice – is used to detach a device object from device hardware. No input value needed. It doesn’t return any value.
  • IsDeviceAttached – is used to get the information about device attachment status. No input value needed. Information is returned as a string value.
  • GetDriverVersion – is used to get the device-driver version information. No input value needed. Information is returned as a string value.
  • GetFirmwareVersion – is used to get the version number of the firmware loaded on the device. No input value needed. Information is returned as a string value.
  • GetRefClkFreq – is used to get the frequency of the on board reference clock. No input value needed. Information is returned as a string value.
  • GetRefClkCnt – is used to get a sample of the reference-clock counter on the device. No input value needed. Information is returned as a string value.
  • VpdDelete – is used to delete a Vital-Product Data (VPD) item from the VPD read/write section in the serial EEPROM on the device. Input value is string that represents VPD item name. Default value is an empty string. It doesn’t return any value.
  • VpdRead – is used to read a Vital-Product Data (VPD) item from the EEPROM on the device. Input value is string that represents VPD item name. Default value is an empty string. It returns string representing VPD item value.
  • AttachOutput – is used to attach the output-channel object to a hardware function hosted by a particular device. Input value is index:ProbeOnly or index:NoProbe string. Default value is an empty string. It doesn’t return any value.
  • AttachOutputToPort – is used to attach the output-channel object to a hardware function hosted by a particular device port. Input value is port:ProbeOnly or port:NoProbe string. Default value is an empty string. It doesn’t return any value.
  • DetachOutput – is used to detach the output channel object from a hardware function and free resources allocated for the output channel, such as DMA buffers. Input value is INSTANT_DETACH or WAIT_UNTIL_SENT string. Default value is an empty string. It doesn’t return any value.
  • IsChannelAttached – is used to get information about output channel attachment status. No input value needed. Information is returned as a string value.
  • SetTxControl – is used to set the output channel’s transmit-control state. Input value is IDLE, HOLD or SEND string. Default value is an empty string. It doesn’t return any value.
  • GetTxControl – is used to get the output channel’s transmit-control state. No input value needed. Information is returned as a string value.
  • SetTsRateBps – is used to set the output channel’s Transport-Stream rate. Input value is integer in [0 – 31700000] range. Default value is 0. It doesn’t return any value.
  • GetTsRateBps – is used to get the output channel’s Transport-Stream rate. No input value needed. Information is returned as an integer value.
  • SetTxMode – is used to set the output channel’s transmit mode. Input value is 188:0, 188:1, ADD16:0, ADD16:1, 204:0, 204:1, RAW:0 or RAW:1 string. Default value is empty string. It doesn’t return any value.
  • GetTxMode – is used to get the channel’s current transmit mode. No input value needed. Information is returned as an integer value.
  • SetRfControl – is used to set up-converter parameters for devices with on board RF up-converter. Input value is integer in [400 – 862] range. Default value is 0. It doesn’t return any value.
  • GetRfControl – is used to Get up-converter parameters for devices with on board RF up-converter. No input value needed. Information is returned as a string value.
  • SetModControl – is used to set the modulation control parameters. Input value is DVBT,Convolutional rate, Bandwidth, Modulation type,Guard interval, Interleaving, Transmissionmode, DVB-H signalling, DVB-H cell ID or QAMxyz, J.83 annex string, where xyz=16,32,64,128,256, or their combination (use ||). The default value is an empty string. It doesn’t return any value.
  • GetModControl – is used to get the modulation-control parameters for the Transport-Stream output channels. No input value needed. Information is returned as a string value.
  • ResetOutputChannel – is used to reset the output channel. Input value is FIFO_RESET or FULL_RESET string. The default value is an empty string. It doesn’t return any value.
  • Write – is used to write data bytes to the output channel. Input value is integer in [0-4294967295] range. It represents number of buffer blocks to be written to the transmit FIFO. The default value is 0. It doesn’t return any value.
  • WriteDirect – is used to write data bytes to the output channel. Works without DMA. It’s slower then Write function. It is used for testing purposes. Input value is integer in [0-4294967295] range. It represents the number of buffer blocks to be written to the transmit FIFO. The default value is 0. It doesn’t return any value.
  • ClearFifo – is used to clear contents of the transmit FIFO and set transmit control to idle state. No input value needed. It doesn’t return any value.
  • GetFifoLoad – is used to get the current load of the channel’s Transmit FIFO. No input value needed. The information is returned as an integer value.
  • SetFifoSize – is used to set the size of the transmit FIFO on the device to a specified value (in bytes). The input value is integer in [0-4294967295] range. The default value is 0. It doesn’t return any value.
  • GetFifoSize – is used to get the current size of the transmit FIFO on the device. No input value needed. The information is returned as an integer value.
  • SetFifoSizeMax – is used to set the size of the transmit FIFO on the device to a maximum value. No input value needed. It doesn’t return any value.
  • GetMaxFifoSize – is used to get the maximum size of the transmit FIFO on the device. No input value needed. The information is returned as an integer value.
  • SetRfMode – is used to set special modes for devices with on-board RF up-converter. The input value is CW, MUTE, NORMAL, CW, SPECINV, MUTE, SPECINV, NORMAL, SPECINV, or their combination (use ||) The default value is an empty string. It doesn’t return any value.
  • ClearFlags – is used to clear latched status flag(s). The input value is FIFO_UFL, READBACK_ERR, SYNC_ERR, TARGET_ERR or their combination (use ||). For example: FIFO_UFL||READBACK_ERR||SYNC_ERR. The default value is an empty string. It doesn’t return any value.
  • GetFlags – is used to get the status flags of the output channel. No input value needed. The information is returned as a string value.
 

Device usage Go to top

Just as in case of the DVB-T modulator, macros are used to make code more readable and maintainable. One example of the macro that sets-up playback of the specific transport stream and modulation using specific parameters by the DVB-T2 stream modulator is given here:

[PLAY_ZDF_DVB_T2] "InputFile ZDF(epg+sub+ttx)_ac3_2min_2010-12-10.ts 100" "Frequency 474 100" "ModulationType DVBT2 100" "TransmissionMode 32K 100" "GuardInterval 1/128 100" "NumDataSymbols 59 100" "MISO OFF 100" "PAPR None 100" "NumT2Frames 2 100" "BandwidthExtension ON 100" "Bandwidth 8MHz 100" "PilotPattern PP7 100" "Constellation QAM64 100" "PLP-ID 0 100" "PLP-GroupID 0 100" "PLP-Type Type1 100" "Modulation QAM256 100" "ConvolutionalRate 5/6 100" "FECType 64K-LDPC 100" "QAMRotation 0 100" "NumOfBlocks 201 100" "TimeILType 0 100" "TimeILLength 3 100" "HEM 1 100" "ISSY DTAPI_DVBT2_ISSY_NONE 100" "TransmitMode 188:1" "remultiplex 0 100" "BitRate 38015280 100" "Play 1 100"

You can see here that the file with the name specified with the InputFile is prepared for the frequency of 474 MHz with the DVB-T2 modulation and the streaming started with the parameter "Play 1 100". To invoke the macro in the test script, the following line of code is used:

TEST_CREATION_API.stream_play("[PLAY_ZDF_DVB_T2]")
 

DVB-S stream modulator Go to top

 

Device info Go to top

Parameters for basic initialization of the DVB-S stream modulator device are the same as in case of DVB-T and DVB-T2 modulators. An example below shows configuration of the device instance within the test_env.ini (test environment description) configuration file:

[device]
alias  = StreamPlayer
name   = DTA107
name   = DTA
config = StreamPlayer.ini
Path = D:\Streams\

Details about the parameters that need to be set in order to correctly configure “DTA-107 modulator” device from the manufacturer DekTec are provided here:

  • alias – is a tag name which will be used in the test case or in the API.
  • name – presents a unique identifier for the algorithm and must be set to DTA107.
  • config – is the name of the file which contains additional configuration (macro commands) related to the stream modulator device (this parameter is optional but desirable).
  • Path – is used to define the default path to the folder with streams (this parameter is optional but desirable).

These parameters represent a device configuration and they are described in the Configuration & Macros (Anatomy of Configuration file) section.

 

Device parameters Go to top

A complete list of the device parameters/commands available for the DVB-S stream modulator is provided here:

  • InputFile – is used to set the input stream file. Path to the file or only a file name (if file is placed in working directory) should be written as an input value.
  • GetConfig – is used to get the information about current configuration. No input value needed. Return value is a string containing current values of stream bit-rate, carrier frequency, transmit mode, modulation type, convolution rate, frequency bandwidth, constellation, guard interval, interleaving, transmission mode, DVB-H signalling, DVB-H cell ID and J.83 annex parameters.
  • Play – is used to start streaming. No input value needed.
  • Stop – is used to stop streaming. No input value needed.
  • Pause – is used to pause streaming. No input value needed.
  • BitRate – is used to set the streaming bit rate. Possible input value is in [0 – 72500000] range. The default value is 22000000.
  • Frequency – is used to set the carrier frequency. Possible input value is in [950 – 2150] range. The default value is 1000.
  • ModulationType – is used to set the modulation type. Possible input value is DVBS. The default value is DVBS.
  • ConvolutionalRate – is used to set the convolution rate. Possible input value could be 1/2, 2/3, 3/4, 5/6, 7/8. The default value is 3/4.
  • Constellation – is used to set the constellation. Possible input value could be QPSK. The default value is QPSK.
  • DeviceSN – is used to set the serial number of a DekTec device user wants to control. When this variable is set, streaming stops, currently used device is detached from the system and the device with this serial number is attached, initialized and opened for use.
  • ignore_stop – is used for ignoring the stop command after test execution. Stop command is implemented for purpose of stopping card to generate signal after end of test execution.
  • output – defines the output channel. Possible values can be “RF”. The default value is RF.
  • remultiplex – re-multiplex of the input stream. Possible input values are 0 and 1. This feature is active if the input value is 1. The default value is 0.

Other advanced device parameters available for the DVB-S stream modulator device are:

  • AttachToSerial – is used to attach a device object to the device hardware, based on the serial number of the device. The input value is the serial number of the device. The default value is an empty string. It doesn’t return any value.
  • AttachToSlot – is used to attach a device object to a PCI Bus device, based on PCI-bus number and slot number. The input value is PCIbus:SlotNumber string. The default value is an empty string. It doesn’t return any value.
  • AttachToType – is used to attach a device object to the device hardware, based on the type number of the device. The input value is deviceType:deviceNumber string. The default value is an empty string. It doesn’t return any value.
  • DetachDevice – is used to detach a device object from the device hardware. No input value needed. It doesn’t return any value.
  • IsDeviceAttached – is used to get the information about the device attachment status. No input value needed. The information is returned as a string value.
  • GetDriverVersion – is used to get the device-driver version information. No input value needed. The information is returned as a string value.
  • GetFirmwareVersion – is used to get the version number of the firmware loaded on the device. No input value needed. The information is returned as a string value.
  • GetRefClkFreq – is used to get the frequency of the on board reference clock. No input value needed. The information is returned as a string value.
  • GetRefClkCnt – is used to get a sample of the reference-clock counter on the device. No input value needed. The information is returned as a string value.
  • VpdDelete – is used to delete a Vital-Product Data (VPD) item from the VPD read/write section in the serial EEPROM on the device. The input value is a string that represents the VPD item name. The default value is an empty string. It doesn’t return any value.
  • VpdRead – is used to read a Vital-Product Data (VPD) item from the EEPROM on the device. The input value is a string that represents the VPD item name. The default value is an empty string. It returns a string representing the VPD item value.
  • AttachOutput – is used to attach the output-channel object to a hardware function hosted by a particular device. The input value is index:ProbeOnly or index:NoProbe string. The default value is an empty string. It doesn’t return any value.
  • AttachOutputToPort – is used to attach the the output-channel object to a hardware function hosted by a particular device port. The input value is port:ProbeOnly or port:NoProbe string. The default value is an empty string. It doesn’t return any value.
  • DetachOutput – is used to detach the output channel object from a hardware function and free resources allocated for the output channel, such as DMA buffers. The input value is INSTANT_DETACH or WAIT_UNTIL_SENT string. The default value is an empty string. It doesn’t return any value.
  • IsChannelAttached – is used to get the information about the output channel attachment status. No input value needed. The information is returned as a string value.
  • SetTxControl – is used to set the output channel’s transmit-control state. The input value is IDLE, HOLD or SEND string. The default value is an empty string. It doesn’t return any value.
  • GetTxControl – is used to get the output channel’s transmit-control state. No input value needed. Information is returned as a string value.
  • SetTsRateBps – is used to set the output channel’s Transport-Stream rate. The input value is integer in [0 – 31700000] range. The default value is 0. It doesn’t return any value.
  • GetTsRateBps – is used to get the output channel’s Transport-Stream rate. No input value needed. The information is returned as an integer value.
  • SetTxMode – is used to set the output channel’s transmit mode. The input value is 188:0, 188:1, ADD16:0, ADD16:1, 204:0, 204:1, RAW:0 or RAW:1 string. The default value is an empty string. It doesn’t return any value.
  • GetTxMode – is used to get the channel’s current transmit mode. No input value needed. The information is returned as an integer value.
  • SetRfControl – is used to set the up-converter parameters for devices with on board RF up-converter. The input value is an integer in [400 – 862] range. The default value is 0. It doesn’t return any value.
  • GetRfControl – is used to get the up-converter parameters for devices with on board RF up-converter. No input value needed. The information is returned as a string value.
  • SetModControl – is used to set the modulation control parameters. The input value is DVBT,Convolutional rate, Bandwidth||Modulation type, Guard interval, Interleaving, Transmissionmode, DVB-H signalling, DVB-H cell ID or QAMxyz, J.83 annex string, where xyz=16,32,64,128,256, or their combination (use ||). The default value is an empty string. It doesn’t return any value.
  • GetModControl – is used to get the modulation-control parameters for the Transport-Stream output channels. No input value needed. The information is returned as a string value.
  • ResetOutputChannel – is used to reset the output channel. The input value is FIFO_RESET or FULL_RESET string. The default value is an empty string. It doesn’t return any value.
  • Write – is used to write data bytes to the output channel. The input value is an integer in [0-4294967295] range. It represents the number of buffer blocks to be written to the transmit FIFO. The default value is 0. It doesn’t return any value.
  • WriteDirect – is used to write data bytes to the output channel. Works without DMA. It’s slower then the Write function. It is used for testing purposes. The input value is an integer in [0-4294967295] range. It represents the number of buffer blocks to be written to the transmit FIFO. The default value is 0. It doesn’t return any value.
  • ClearFifo – is used to clear contents of the transmit FIFO and set the transmit control to the idle state. No input value needed. It doesn’t return any value.
  • GetFifoLoad – is used to get the current load of the channel’s Transmit FIFO. No input value needed. The information is returned as an integer value.
  • SetFifoSize – is used to set the size of the transmit FIFO on the device to a specified value (in bytes). The input value is an integer in [0-4294967295] range. The default value is 0. It doesn’t return any value.
  • GetFifoSize – is used to get the current size of the transmit FIFO on the device. No input value needed. The information is returned as an integer value.
  • SetFifoSizeMax – is used to set the size of the transmit FIFO on the device to a maximum value. No input value needed. It doesn’t return any value.
  • GetMaxFifoSize – is used to get the maximum size of the transmit FIFO on the device. No input value needed. The information is returned as an integer value.
  • SetRfMode – is used to set special modes for devices with on-board RF up-converter. The input value is CW, MUTE, NORMAL, CW, SPECINV, MUTE, SPECINV or NORMAL, SPECINV string, or their combination (use ||). The default value is an empty string. It doesn’t return any value.
  • ClearFlags – is used to clear latched status flag(s). The input value is FIFO_UFL, READBACK_ERR, SYNC_ERR, TARGET_ERR or their combination (use ||). For example: FIFO_UFL||READBACK_ERR||SYNC_ERR. The default value is an empty string. It doesn’t return any value.
  • GetFlags – is used to get status flags of the output channel. No input value needed. The information is returned as a string value.
  • lastError – contains info about last occurred error
 

Device usage Go to top

One example of the macro that is typically used to set the transport stream file, modulation and streaming parameters is shown below:

[Welcome_Screen_Language_Selection] "InputFile TEST_STREAM\11015_28888.ts 100" "ModulationType DVBS 100" "Constellation QPSK 100" "Frequency 1265 100" "ConvolutionalRate 3/4 100" "BitRate 39933412 100" "remultiplex 0 100" "outputRFLevel -30 0"

You can see here that the file with the name specified with the InputFile parameter is prepared for a given frequency with the DVB-S modulation.

A macro is invoked from within the script code using the following function:

TEST_CREATION_API.stream_play("[Welcome_Screen_Language_Selection]")