User manual

Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL)
3700S-901-01 Rev. C / July 2008 13-81
channel.setpowerstate()
Function
Sets the power state attribute on a channel.
Usage
channel.setpowerstate(<ch_list>, <state>)
ch_list: String specifying the channels to query, using normal channel list syntax.
state: A value representing the desired channel‟s power state.
Remarks
Channels with an OFF power state consume less power. When a channel previously
OFF is turned ON, the channel attributes are reset to their default values (except the
power state attribute).
The default value is dependent on the installed card. The following possible values are
supported:
channel.ON
channel.OFF
Changing the output setting impacts the power consumption of the card. The
instrument verifies that power is available before changing the mode. If an insufficient
power capability exists, the command generates an error.
Consult the specific card documentation for more detailed information on a channel‟s
power usage characteristics, including default state, possible warmup issues, and
effects on other channels.
When a channel with an OFF power state is used in a scan, results are undefined. No
error notification is issued.
For switch, backplane, and digital I/O channels, there is no valid power state attribute.
Setting the power state on a specific channel generates an error.
NOTE: On some cards for DAC channels, there can be a warmup time for
the DAC to reach full accuracy (see card-specific documentation).
On some cards for totalizer channels, setting the power state of a
single channel can affect the power state of other channels. If a
single totalizer channel is turned ON, then all totalizer channels are
reset to their defaults.
Also see
channel.getpowerstate() (on page 13-55)
Example
channel.setpowerstate("1010", channel.ON)
channel.setstatelatch()
Function
Sets the state indicators to either latching or non-latching.
Usage
channel.setstatelatch(<ch_list>, <state latch mask>)
ch_list: String specifying the channels to set, using normal channel list syntax.
state latch mask: A value specifying the indicators to latch.