Section 7: Command reference
Models 707B and 708B Switching Matrix Reference Manual
7-142
707B-901-01 Rev. A / August 2010
scan.add()
This function adds a scan step to the scan list.
Type
TSP-Link accessible
Affected by
Where saved
Default value
Function Yes
Usage
scan.add(channelList)
channelList
String specifying channels to add using normal channel list syntax
Details
Use this function to add channels and channel patterns to the present scan list. If the scan list does not exist, it
also creates a scan list. See
scan.create()
for information about creating a scan list.
Channels and channel patterns added using the
scan.add()
function are added to the end of the present list
(appended) in the same order as specified in
channelList
. Specifying multiple channels in
channelList
adds multiple steps to the scan.
If an error is encountered as channels are added to the list, subsequent channels in that channel list will not be
added.
Example 1
scan.create()
for column = 1,5 do
scan.add(channel.createspecifier(1,1,colum
n))
end
Replaces the active scan list with an empty
scan list.
Loops through columns 1 to 5.
Adds five channels to the scan list using the
channel.createspecifier()
command.
The scan list now has row 1, columns 1 to 5
on slot 1 as the first five steps.
Example 2
scan.create("1A01:1A08")
scan.add("1A10")
scan.add("1A09")
Replaces the active scan list with an empty
scan list, and then adds row A, columns 1 through 8 on slot
1 to the new scan list.
Adds row A, column 10 on slot 1 to the end of the scan list.
Adds row A, column 9 on slot 1 to the end of the scan list.
Scan list now includes channels 1A01 through 1A10, with
channels 1A01 through 1A08 in order, followed by channel
1A10, and then channel 1A09.
