User manual

Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual
13-80 3700S-901-01 Rev. C / July 2008
channel.setpole()
Remarks
An error message is generated for the following reasons:
An empty parameter string is specified.
The value parameter is an invalid setting for the specified channel.
The specified channel does not exist for the card installed in a slot.
The channel is for an empty slot.
The value parameter 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 can contain 'slotX', where X equals 1 to 6, or
'allslots'.
Command processing stops as soon as an error is detected and no pole settings are
modified. Only with no errors are the poles setting changed on the specified channels.
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.setimage() (on page 13-63) and
channel.pattern.snapshot() (on page 13-66)).
You manipulate the analog backplane relays for the desired pole setting by using the
channel.setbackplane() (on page 13-70) function for channels. For channels,
as the pole setting changes, their analog backplane relays, specified by
channel.setbackplane() (on page 13-70), get cleared. Therefore, after a pole
setting change, you need to add the desired analog backplane relays for desired pole
setting by using channel.setbackplane() (on page 13-70).
The analog backplane relays get manipulated based on the DMM configuration
assigned to a channel when the channel used with the dmm.close() (on page 13-
123) command. When clearing the backplane channels, this involves 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 changing the poles setting on Channel 1 to 4, the backplane
channels for Channels 1 and 21 are cleared. Likewise, they both are 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.
For digital I/O, DAC, and totalizer channels, only a value of 1 is accepted.
Also see
channel.getbackplane() (on page 13-45)
channel.getpole() (on page 13-55)
channel.setbackplane() (on page 13-70)
Example
Set Channels 1 and 3 on Slot 5 to four-pole:
channel.setpole("5001, 5003", channel.POLES_FOUR)