Series 3700A System Switch/Multimeter Reference Manual
Section 11: TSP command reference
3700AS-901-01 Rev. D/June 2018
11-315
scan.create()
This function deletes the existing scan list and creates a new list of channels and channel patterns to scan.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function
Yes
Usage
scan.create(
channelList
)
scan.create(
channelList
,
dmmConfig
)
channelList
String specifying channels to add
dmmConfig
The DMM configuration to use with items in the
channelList
Details
The existing scan list is lost after calling this function.
The items in the channel list are scanned in the order listed.
Each channel or channel pattern configuration is used unless the optional
dmmConfig
parameter is
specified (see
dmm.setconfig()
and
dmm.getconfig()
). Specifying the
dmmConfig
parameter
temporarily overrides the configuration associated with the channel or channel pattern. Specifying
dmmConfig
does not modify the assigned configuration of a channel or channel pattern.
If a forbidden channel is included in a range of channels or slot parameter (such as slot 1), the
forbidden channel is ignored and no error is generated. If a forbidden channel is individually specified
in the channel list, an error is generated.
If an error occurs, the scan list of channels or channel patterns is cleared, even though no new scan
list is created.
The function
scan.reset()
clears the list. To clear the scan list without performing a scan reset,
send an empty string for the
channelList
parameter.
Example 1
scan.create("1001:1010")
Replaces the active scan list with an empty
scan list.
Adds channels 1 through 10 on slot 1. Uses
the existing DMM configuration
(
dmm.setconfig()
).
Example 2
scan.create()
for chan = 1001, 1010 do
scan.add("" .. chan)
end
Replaces the active scan list with an empty
scan list.
Loops through channels 1001 to 1010, and
then adds 10 channels to the scan list. The
parameter (
"" .. chan
) converts the
channel number to a string.
The scan list now has, in order, channels 1
through 10 on slot 1.
Uses the existing DMM configuration
(
dmm.setconfig()
).
