channels

Usage

>> channels [ count | on | latency | readtime | minperiod | all ] 

Security

Description

A read-only command which returns general channel information for the logger. 

1. count is simply the number of channels installed and configured in the logger.
2. on gives the number of active channels, which excludes any channels turned off by the user: see the status argument to the channel command.
3. latency is the power-on settling delay in milliseconds; this is the time the logger will wait after waking from its quiescent state, before attempting to take measurements. It allows all sensors and channel electronics to reach a stable condition. This overall latency delay is determined by the longest of all the individual active channel delays; channels which are turned off do not contribute.
4. readtime is the overall reading time in milliseconds; this is the additional time the logger needs to acquire data from all active channels once the latency delay has expired. This overall readtime is determined by the longest value of all the individual active channels; any which are turned off do not contribute.
5. Most channels have a fixed, pre-determined readtime, but for some it may be variable. An example would be a channel which supports, and is configured to use, the auto-ranging feature: the readtime is longer when the channel is in auto-ranging mode than when operated in a fixed-gain mode. The logger adjusts the reported value of the readtime to reflect the operating mode and status of all active channels.  
6. minperiod is the minimum sampling period in milliseconds with the currently active channels. This takes account of the current overall values for latency and readtime, and adds some overhead and safety margin for both fixed and per-channel activities. The value applies to the "normal" sampling mode supported by all loggers; loggers configured to support fast sampling modes as well may use selected periods less than this value.

Examples

Errors

Error E0108 invalid argument to command: '<invalid-argument>'
An unrecognized argument was given with the command.

Error E0505 no channels configured
Indicates a serious fault with the logger; please contact RBR Ltd for help.