Trigger.model.setblock() - Trigger.block_Branch_Counter - Keithley DMM7510 Reference Manual

Section 8: TSP command reference
trigger.model.setblock() — trigger.BLOCK_BRANCH_COUNTER
This function defines a trigger model block that branches to a specified block a specified number of times.
Type TSP-Link accessible
Function Yes
Usage
trigger.model.setblock(blockNumber, trigger.BLOCK_BRANCH_COUNTER, targetCount,
branchToBlock)
blockNumber
targetCount
branchToBlock
Details
This command defines a trigger model building block that branches to another block using a counter
to iterate a specified number of times.
Counters increment every time the trigger model reaches them until they are more than or equal to
the count value. At that point, the trigger model continues to the next building block in the sequence.
The counter is reset to 0 when the trigger model starts. It is incremented each time trigger model
execution reaches the counter block.
If you are using remote commands, you can query the counter. The counter is incremented
immediately before the branch compares the actual counter value to the set counter value. Therefore,
the counter is at 0 until the first comparison. When the trigger model reaches the set counter value,
branching stops and the counter value is one greater than the setting.
Example
trigger.model.setblock(4, trigger.BLOCK_BRANCH_COUNTER, 10, 2)
print(trigger.model.getbranchcount(4))
When the trigger model reaches this block, the trigger model returns to block 2. This repeats 10 times.
An example of the return if the trigger model has reached this block 5 times is:
5
Also see
trigger.model.getbranchcount()
trigger.model.setblock() — trigger.BLOCK_RESET_BRANCH_COUNT
8-304
Model DMM7510 7½ Digit Graphical Sampling Multimeter Reference Manual
Affected by Where saved
Restore configuration Configuration script
Instrument reset
Power cycle
The sequence of the block in the trigger model
The number of times to repeat
The block number of the trigger model block to execute when the counter is
less than the targetCount value
(on page 8-285)
Default value
Not applicable
(on page 8-324)
DMM7510-901-01 Rev. B / May 2015