![background image](http://html1.mh-extra.com/html/keithley/3700-series/3700-series_reference-manual_3931523191.webp)
Series 3700 System Switch/Multimeter Reference Manual
Section 9
:
Instrument Control Library (ICL)
Document Number: 3700S-901-01 Rev. A / August 2007
9-47
channel.setpole
Remarks
An error message will be generated for the following reasons:
An empty parameter string.
The value is an invalid setting for the specified channel.
The specified channel doesn‘t exist for the card installed in a slot.
The channel is for an empty slot.
The value is invalid for command
– parameter out of range error.
Parameter syntax error such as incorrect format for ch_list.
A channel pattern or analog backplane relay was specified.
The parameter string may contain ―slotX‖, where X equals 1 to 6, or ―allslots‖.
Command processing will stop as soon as an error is detected and no pole settings will
be modified. Only with no errors, will the specified channels have their poles setting
changed.
Recall channel patterns do not have a pole setting associated with them. For channel
patterns, the analog backplane relays must be specified when creating the pattern (see
channel.pattern.set and channel.pattern.snapshot).
The user manipulates the analog backplane relays for the desired pole setting by using
the channel.setbackplane function for channels. For channels, as the pole setting
changes, their analog backplane relays, specified by channel.setbackplane, get cleared.
Therefore, after a pole setting change, the user needs to add the desired analog
backplane relays for desired pole setting by using
channel.setbackplane
(on page 9-42).
The analog backplane relays get manipulated based on the DMM configuration
assigned to a channel when the channel used with the dmm.close command. When
clearing the backplane channels, this may involve clearing the paired channel whether
pairing or unpairing channels. For example, on a 40-channel card, channels 1 and 21
are paired when the poles for Channel 1 is set to 4. Therefore, when setting the poles
setting on Channel 1 to 4 will clear the backplane channels for channels 1 and 21.
Likewise, they both will be cleared when the poles setting is set back to 2 on Channel 1.
Calling this function on an existing channel involved in scanning invalidates the existing
scan list.
Also see
channel.getbackplane
(on page 9-25)
channel.getpole
(on page 9-32)
channel.setbackplane
(on page 9-42)
Example
Set channels 1 and 3 on Slot 5 to four-pole:
channel.setpole("5001, 5003", channel.POLES_FOUR)