Unigraf UCD-240, User Manual

Page: 75 / 78

UCD Console for UCD-340 User Manual | Unigraf Oy
75.
Source = ‘UCD-323 [1234C567]: HDMI Reference Source’;
.output = ‘HDMI-1’;
Sink = ‘UCD-323 [4321C876]: HDMI Reference Sink’;
.input = ‘HDMI-1’;
This will create two device aliases “ Source ” and “ Sink ”, with “ Source ” using the HDMI-1
output port, and “ Sink ” using the HDMI-1 input port.
Writing a script for TSI_TST_RunTest
The intention of script given to this function is to configure a test before running it. The script
can also change device settings if necessary.
The script provided for TSI_TST_RunTest is used to configure test parameters. This can be
done by assigning each configuration item one by one, or by loading a
TD-file (Test
Description file). The TD-Files can be saved from UCD-Console.
To load a TD-File from a script, use ‘.loadtd’ key, and assign the TD-File name to it. Example:
.loadtd = ‘C:\my_td_files\Test 1.td’;
Important: The TSI_TST_RunTest function will not run the test defined in the TD file. It will
load the test settings from it, but it will run the test identified by the TestID parameter.
Alternatively, the test settings can be done one-by-one by assigning (one or more)
configuration items. The following example sets the audio test parameters:
TSI_EXPECTED_SAMPLE_RATE = 96000;
TSI_EXPECTED_AUDIO_FREQUENCY = 1000;
TSI_AUDIO_FREQUENCY_TOLERANCE = 1;
TSI_AUDIO_GLITCH_DETECT_TRESHOLD = 250000;
TSI_AUDIO_GLITCHES_ALLOWED = 0;
Important: You can also refer to configuration items by their ID code number, not just their
names. This can be useful, in case there is some kind of problem with identifying a
configuration item by name.
Writing a script for TSI_TST_RunScript
The intention of script given to this function is to extend the functionality of the scripts.
The script provided for TSI_TST_RunScript is intended to be used for device control and
status checking. The TSI_TST_RunScript has additional parameters that enable 32 bit data
words to be returned from the scripts. These scripts can also load TD-Files, same way as
scripts provided to TSI_TST_RunTest.
To read 32-bit data and return it out of the script, use ‘.read’ key, and assign the configuration
item ID to read. See below for an example:
.read = TSI_R_INPUT_WIDTH;
.read = TSI_R_INPUT_HEIGHT;
The above script would return two 32-bit integer values through the oIntTable pointer. The
32-bit word at index 0 would contain the current x-resolution, and the 32-bit word at index 1
would contain the current y-resolution.
Any actions based on the returned data must be decided on the TestStand side. This scripting
system is very simple, and has no flow control or other advanced features.