Teledyne LeCroy PETrainer Scripting Language Reference Manual - Manual (Page 55)

Teledyne LeCroy PETrainer Scripting Language
50
7 Wait Command
This command yields script execution until condition specified is true or timeout expires.
Parameter
Values Default Comment
Timeout 0 Timeout in nanoseconds. 0 means infinite timeout.
Display Any string literal Message displayed during the waiting in status bar
Count 1: 65535 1 Repeats wait specified number of times.
Note: Setup of wait condition for Summit Z2 and Summit Z3 Trainers during script execution may take
tens of microseconds. The Summit Z2 and Summit Z3 trainers will miss events that are coming
during wait condition setup.
7.1 Wait = TLP
This command waits for a TLP that matches the defined condition. Only TLP Header fields can be
specified. All parameters from Packet = TLP command (see Page 3) are valid, except PSN, ECRC,
LCRC and Payload parameters.
TLP Header fields can be masked using the following format:
0x0XAXX For hexadecimal values
0b0001XX For binary values
Example:
This command waits infinitely for a Configuration Write request to registers from 0x1000 to 0x1FFF.
Wait = TLP {
TLPType = CfgWr
Register = “0x1XXX”
Timeout = 0
}
Note: When using wait commands in the Z3 script keep in mind that it takes time for the command to be
configured in the Bus Engine. Thus when running a script that starts with a wait on a packet command,
the DUT should not issue the packet within at least 100 microseconds. However, when the DUT issues
its TLP as a response to the TLP in the script, the Z2/Z3 takes care of properly setting up the wait
condition prior to issuing it's TLP, so the wait would always work properly for a construct like this:
packet=TLP
{
...
}
wait=TLP ; send as the response to the TLP from the script
{
...
}