channels

Usage

>> channels [ count | on | settlingtime | readtime | minperiod ] 

Security

Open.

Description

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

  • count is simply the number of channels installed and configured in the logger.

  • on gives the number of active channels, which excludes any channels turned off by the user: see the status argument to the channel command.

  • settlingtime 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 settling time is determined by the longest of all the individual active channel delays; channels which are turned off do not contribute.

  • 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 settling time has passed. This overall readtime is determined by the longest value of all the individual active channels; any which are turned off do not contribute.

    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.  

  • minperiod is the minimum sampling period in milliseconds with the currently active channels. This takes account of the current overall values for the settling and read times, 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

>> channels
<< channels count = 2, on = 2, settlingtime = 160, readtime = 150, minperiod = 1000
>> channels settlingtime, readtime
<< channels settlingtime = 160, readtime = 150

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.