Common Scripting Use Cases
Refer to scripting instructions for examples of using primary scripting instructions, including generate, repeat/end repeat, wait, and clear.
Single Waveform (one-shot/finite generation)
script singleWfmExample
generate wfm01
end script
This script generates wfm01 and then stops. When generation stops, the last sample of wfm01 is held at the output.
Generating Waveforms with Markers
script wfm01MarkersExample
generate wfm01 marker0 (0, 20)
end script
This script generates the entire wfm01 waveform and generates a Marker event at samples 0 (the start of the waveform) and 20.
Sequence of Multiple Waveforms
script upWfm01DownExample
generate countUp
generate wfm01
generate countDown
end script
Conditional Branching — If/Else
script branchingExample
repeat forever
generate wfm01
if scripttrigger0 then
generate wfm02
else
generate wfm03
end else
end repeat
end script
The following diagram illustrates the preceding script behavior:
Generating Waveform Subsets
script wfm01SubsetExample
generate wfm01 subset (20, 60)
end script
This script generates 60 samples from wfm01, starting at sample 20.
 |
Note The subset beginning sample number must be an integer multiple of 4. The subset number of samples must also be an integer multiple of 4. |
Finite Repetition (N Times)
script up3Wfm01DownExample
generate countUp
repeat 3
generate wfm01
end repeat
generate countDown
end script
Conditional Repetition — Repeat until Trigger
script upWfm01UntilTrigDownExample
generate countUp
repeat until scripttrigger0
generate wfm01
end repeat
generate countDown
end script
Continuous Generation — Repeat Forever
script upThenUpAndDownForeverExample
generate countUp
repeat forever
generate countUpAndDown
end repeat
end script
Waiting for Triggers
script upWaitWfm01DownExample
generate countUp
wait until scripttrigger0
generate wfm01
generate countDown
end script
The following diagrams illustrate the preceding script behavior:
or
script upWaitWfm01DownExample
generate countUp
clear scripttrigger0
wait until scripttrigger0
generate wfm01
generate countDown
end script
These two scripts are similar, but a script received during generation of countUp causes the first script to move to wfm01 after the smallest possible delay. By adding a clear instruction, you can ignore any triggers received before the wait instruction.
Finite Wait
script upWait32DownExample
generate countUp
wait 32
generate countDown
end script
Stepping Through Multiple Waveforms
script stepThroughUpAllZerosDownExample
repeat forever
generate countUp
clear scripttrigger0
wait until scripttrigger0
generate allZeros
clear scripttrigger0
wait until scripttrigger0
generate countDown
clear scripttrigger0
wait until scripttrigger0
end repeat
end script
Bursting through Multiple Waveforms
script burstThroughUpDownThenZerosOnesExample
repeat forever
repeat until scripttrigger0
generate countUp
generate countDown
end repeat
repeat until scripttrigger0
generate allZeros
generate allOnes
end repeat
end repeat
end script