
Model 2461 Interactive SourceMeter® Instrument Reference Manual
Section 8: TSP command reference
2461-901-01 A/November 2015
8-281
trigger.model.setblock() — trigger.BLOCK_BRANCH_ONCE
This function causes the trigger model to branch to a specified building block the first time it is encountered in the
trigger model.
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_ONCE,
branchToBlock
)
blockNumber
The sequence of the block in the trigger model
branchToBlock
The block number of the trigger model block to execute when
the trigger model first encounters this block
Details
The branch-once building block branches to a specified block the first time trigger model execution
encounters the branch-once block. If it is encountered again, the trigger model ignores the block and
continues in the normal sequence.
The once block is reset when trigger model execution reaches the idle state. Therefore, the
branch-once block always executes the first time the trigger model execution encounters this block.
Example
trigger.model.setblock(2, trigger.BLOCK_BRANCH_ONCE, 4)
When the trigger model reaches block 2, the trigger model goes to block 4 instead of going in the default
sequence of block 3.
Also see
(on page 3-121)
trigger.model.setblock() —
trigger.BLOCK_BRANCH_ONCE_EXCLUDED
This function defines a trigger model block that causes the trigger model to go to a specified building block every
time the trigger model encounters it, except for the first time.
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_ONCE_EXCLUDED,
branchToBlock
)
blockNumber
The sequence of the block in the trigger model
branchToBlock
The block number of the trigger model block to execute when
the trigger model encounters this block after the first encounter