User manual

Series 3700 System Switch/Multimeter Reference Manual Section 13: Instrument Control Library (ICL)
3700S-901-01 Rev. C / July 2008 13-57
channel.getstate()
Remarks
Use this command to query for the state of channels in the system. Each bit in the
state represents a different indicator. Therefore, multiple indicators can be present
(there values are OR‟ed bitwise). Any state or state latch commands behave in this
manner.
Different channel types support different state information (indicators). The optional
state indicator mask can be used to only return certain indicators. If there is no
indicator mask, then all indicators are returned.
The following status indicators are defined:
channel.IND_CLOSED
channel.IND_OVERLOAD
channel.IND_MATCH
channel.IND_OVERFLOW
Indicators can be latched or unlatched depending on other system settings. Latched
indicators indicate that the condition has occurred since the last reset (or power cycle).
Unlatched indicators indicate that the condition has occurred when the
channel.getstate() command was issued. The Overflow and Overload indicators
default to latched.
For switch channels, the only state information is an indicator of relay state
(channel.IND_CLOSED).
For digital I/O channels, the state information includes an indicator for the state of auto
protection and whether the match value has been matched
(channel.IND_OVERLOAD and channel.IND_MATCH).
For totalizer channels, the state information includes an indicator for overflow and
whether the match value has been matched (channel.IND_OVERFLOW and
channel.IND_MATCH).
For DAC channels, the state information includes an indicator for the state of auto
protection (channel.IND_OVERLOAD).
For more specific information on the overload and overflow indicators, refer to the
documentation for the specific card on which the specified channel resides.
Also see
channel.getclose() (on page 13-46)
channel.setmatch() (on page 13-76)
channel.setstatelatch() (on page 13-81)