Data Retrieval Commands - Keithley 3700A Series Reference Manual

Series 3700A System Switch/Multimeter Reference Manual Section 9: Introduction to TSP operation

Data retrieval commands

You can send data retrieval commands that return a comma-delimited string. For example,
channel.getcount(channelList) returns a count for each item passed to it through its
parameter, channelList.
The comma-delimited string that is returned starts with the lowest channel and goes to the highest
channel on Slot 1. It then lists each subsequent slot until the highest slot is reached. After the
channels are listed, the analog backplane relays are listed, starting with Bank 1 followed by each
subsequent bank.
For example, assume there is a Model 3720 card installed in slot 4, returning 72 comma-delimited
values. Send the following command:
print(channel.getclose("slot4"))
The first 60 values returned are the closed channel specifiers, starting with 1 and increasing to 60.
The next six values are for analog backplane relays in Bank 1 (starting at 1 and increasing to 6). The
final six values are for analog backplane relays in Bank 2 (starting at 1 and increasing to 6).
If the command was channel.getstate() instead of channel.getclose(), 72 zero (0) or one
(1) values would be returned, with a 0 indicating that the channel or backplane is open, and a 1
indicating that it is closed. The first 60 values are for Channels 1 to 60 (starting at 1 and increasing to
60). The last 12 values are the backplane relays (starting with Bank 1, Relay 1, and increasing to
Bank 2, Relay 6).
If a channel is paired for 4-wire operation by its pole setting, the paired channel state is returned in
parenthesis () after the primary channel. For example, if the card in Slot 4 is a Model 3720 and has
the 4-pole attribute for all channels set, querying for the states of "slot4" returns 72 zero (0) and
one (1) values, with the first 60 shown as the primary channel state (paired channel state); the 12
backplane relays follow.
Sample code and output:
channel.setpole("slot4", 4)
print(channel.getstate("slot4"))
Output from above code:
0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),
0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),0(0),
0,0,0,0,0,0,0,0,0,0,0,0
The Model 3721 card has three additional backplane relays for commonside ohms functionality. Use
"slotX" or "allslots" to query settings on this card to return information for channels 1 to 40,
911 to 917, 921 to 928. In the response message, there will be three additional commonside ohms
backplane relays listed based on bank location. For model 3721, 917 is listed with bank 1, and 927
and 928 are listed with bank 2 after the backplane relays.
3700AS-901-01 Rev. D/June 2018 9-3