User manual

Section 13: Instrument Control Library (ICL) Series 3700 System Switch/Multimeter Reference Manual
13-68 3700S-901-01 Rev. C / July 2008
channel.read()
Remarks
The width parameter is optional and defaults to 1. The reading buffer parameter is
optional. A width does not have to be specified in order to specify a reading buffer.
However, if both are specified, the width must be first in the argument list.
For digital I/O channels, only a width of 1, 2, 3, or 4 is supported. Any information (bits)
greater than the specified width is returned as zero. For example, if Channels 1 and 2
are both 255, a reading with a width of 1 returns 255 and a width of 2 returns 65535.
Values read from outputs reflect their current setting. If the read channel is in the
overload state, the read value is indeterminate.
Totalizer and DAC channels do not support a width other than 1 and result in an error
if specified.
Switch and backplane channels are not supported.
For widths greater than 1, the specified channel occupies the least significant byte. For
example, reading the value of 0xff00ff00 from Channel 1 with a width of 4 indicates
Channel 1 is 0x00, Channel 2 is 0xff, Channel 3 is 0x00, and Channel 4 is 0xff.
Reading the value of 0x00000000 from Channel 1 with a width of 1 indicates Channel
1 is 0x00 and other channels are not included.
For a channel with a power state of OFF, the returned value is DISABLED. The value
into the reading buffer is indeterminate.
Example
Reading the count from the first totalizer channel (Channel 6) in Slot 1:
count = channel.read("1006")
channel.reset()
Function
Resets the channel aspects of the system to factory default settings.
Usage
channel.reset(<ch_list>)
ch_list: A string list items to reset. Items can include channels, backplane relays, and
channel patterns.