Unigraf UCD-240, User Manual

Page: 64 / 78

UCD Console for UCD-340 User Manual | Unigraf Oy
64.
currently available). Variables defined are global except - loops variables which are
nested (they vanish when - endloops is reached). If there is a nested and global
variable of the same name, the nested variable is evaluated in expressions. Variables
created using an initializer list such as -
var Name=N0,N1 will be named Name[0]
and Name[1] with values N0 and N1. Name itself is a variable and is the list SIZE
(two in this example). Values within braces can be variables and can be nested: -
var
Test=Skip[bool[1]],Skip[bool[0]].
•
-loops starts a command loop with the target number of loops. The target can also
be a Name=Number or Name=VarName (a variable name) expression. The name
can be used in -c commands within the -loops block. Looping is to the next (same
nesting level)
-endloops command option. Loops can be nested and there must be
the same number of -loops and -endloops command options.
•
- continue causes subsequent commands up to the -loops pairing -endloops to be
skipped.
• -endloops marks the end of a loop of the same nesting level started by the
previous - loops command option.
•
-skip is a no-operation and can be used with -ontrue .
• -exit exits scripting and prints a message (can be used with -ontrue, -if -else -endif ).
• -ontrue is a conditional operator: If the preceding .read with expression (required)
was true, the next command ( -option target) is run, else that following it is run. It
cannot be nested.
•
-timeout will set the timeout time milliseconds (default is 10000) for commands that
require them.
• -waiton will wait for a .read=Value.Expression to become true or a time out (a
device must be open). Can be used to wait for a DUT to be plugged in, for example.
Its main purpose though is making sure CI’s to be tested are in a proper state for
reading as setting CI’s are asynchronous (see 1.2.4.1 EXAMPLES below).
• -pic is used to capture and save a picture to a file. A device sink must be open and a
DUT source must be connected for this to succeed. The format output is a lossless
bitmap (*.bmp).
•
-beginhtml begins new html test report that receives output ONLY for tests ( - c
.loadtd= test.td). A device must be open. If the device is changed via a -d Dev
command, the file will be closed (equivalent to -endhtml ). The html output file will
be of the form < devsink>_20181008105224_log.html , where <devsink> is the
device name.
• -endhtml ends the current open html test report (a html file must be open).
• -wpdosink writes device sink PDO data (see
TSI_USBC_PWR_LOCAL_SINK_PDO ) to a file.
•
-rpdosink reads sink PDO data from a file and sets it on the open device.
• -wpdosource writes device source PDO data (see
TSI_USBC_PWR_SOURCE_SINK_PDO ) to a file.
• -rpdosource reads source PDO data from a file and sets it on the open device.
•
-h lists options and targets.
Examples
Looping colors spaces, patterns and timings (lastread below is a built-in global variable):
-timout 20000 #Wait on video signal
-d SourceDevice #defined in init.tsi
-c .read=TSI_R_PG_PREDEF_TIMING_COUNT;
-var SzT=lastread -pr "Timeing count is " -prvar SzT
-c .read=TSI_R_PG_PREDEF_PATTERN_COUNT;
-var SzP=lastread -pr "Pattern count is " -prvar SzP
-var dpix=10; #delta value for pixel width and height tests