Section 8: TSP command reference
Model DMM7510 7½ Digit Graphical Sampling Multimeter Reference Manual
8-304
DMM7510-901-01 Rev. B / May 2015
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
Affected by
Where saved
Default value
Function
Yes
Restore configuration
Instrument reset
Power cycle
Configuration script
Not applicable
Usage
trigger.model.setblock(
blockNumber
, trigger.BLOCK_BRANCH_COUNTER,
targetCount
,
branchToBlock
)
blockNumber
The sequence of the block in the trigger model
targetCount
The number of times to repeat
branchToBlock
The block number of the trigger model block to execute when the counter is
less than the
targetCount
value
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()
(on page 8-285)
trigger.model.setblock() — trigger.BLOCK_RESET_BRANCH_COUNT
(on page 8-324)