Model 2461 Interactive SourceMeter® Instrument Reference Manual
Section 8: TSP command reference
2461-901-01 A/November 2015
8-283
trigger.model.setblock() — trigger.BLOCK_CONFIG_NEXT
This function recalls the settings at the next index of a source or measure configuration list, or both a source and
measure configuration list.
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_CONFIG_NEXT,
configurationList
)
trigger.model.setblock(
blockNumber
, trigger.BLOCK_CONFIG_NEXT,
configurationList
,
optionalConfigList)
blockNumber
The sequence of the block in the trigger model
configurationList
A string that defines the source or measure configuration list to
recall
optionalConfigList
The name of the second configuration list to recall the index
from; must be the opposite type of list than the first; for
example, if the first configuration list is a measure list, the
second configuration list must be a source list
Details
If two configuration lists are specified with this command, they must not be of the same type. For
example, if the first configuration list is a measure configuration list, the second (optional)
configuration list must be a source configuration list. The order of the configuration lists does not
matter with this command, as long as they are of the opposite type.
When trigger model execution reaches a configuration recall next block, the settings at the next index
in the specified configuration list are restored if a single configuration list is specified. If both measure
and source configuration lists are specified, measure and source settings are recalled from the next
index in each list. The index numbers recalled may not match; it depends on the number of indexes in
each list and what index number each list is on.
The first time the trigger model encounters this block for a specific configuration list, the first index is
recalled if the list has not already had an index recalled by the recall block command in an earilier
trigger model block. If the configuration list has recalled an index with the recall block, the next index
in the list is called instead of the first. For example, the recall block recalls index 1 by default, so if the
trigger model uses a recall block before this one, the first time the set block is reached after that
recall, index 2 is recalled. See the second example below for an illustration of this. Each subsequent
time this block is encountered, the settings at the next index in the configuration list are recalled and
take effect before the next step executes. When the last index in the list is reached, it returns to the
first index.
The configuration lists must be defined before you can use this block.
Example 1
trigger.model.setblock(5, trigger.BLOCK_CONFIG_NEXT, "measTrigList")
Configure trigger block 5 to load the next index in the configuration list named
measTrigList
.
