sensor

Usage

>> sensor <indexorlabel> [ param1 | ... | paramn]

Security

Unsafe.

Description

Returns information about the sensor attached to the channel at the specified <indexorlabel> (see channel)

A special value of allindices or alllabels may be given for <indexorlabel> causing the requested parameters to be reported for all channels. The output for each channel is terminated by ||, except for the last channel which is terminated by a <cr><lf> pair as normal.
All parameters might be obtained using the all keyword in lieu of parameter names but this one is optional.

The purpose of this command is to manage miscellaneous information relating to the sensor associated with a given logger channel, as opposed to any property of the channel itself; the distinction is rather fine. In general the sensor command is used for information which belongs with a particular sensor, but which the logger does not need to know; a good example would be the sensor's serial number. For information common to all sensors of this type which the logger does need to know, the channel command is used; a good example would be the settlingtime, or power-on settling delay.

In principle any channel type could make use of the sensor command; in practice the channels which use it and the parameters which are supported are defined by the instrument's Factory configuration. End users may change the values of existing parameters, but they can not add new parameters or add the capability to channels which do not already have it. Attempting to use the sensor command with a channel not configured to support it will provoke an error message, as detailed below.

Examples

CODE

>> sensor 3
<< sensor 3 serial = 129837

Retrieve all information pertaining to channel 3. In this example, only the "serial" parameter is available.

CODE

>> sensor 3 serial
<< sensor 3 serial = 129837

Request a specific parameter.

CODE

>> sensor 3 serial = 119945
<< sensor 3 serial = 119945

Change the value of a parameter.

CODE

>> sensor 4
<< sensor 4

No sensor information is available for channel 4.

CODE

>> sensor 4 serial
<< sensor 4 serial = n/a

The "serial" parameter is unavailable for channel 4.

CODE

>> sensor allindices serial
<< sensor 1 serial = n/a || sensor 2 serial = n/a || sensor 3 serial = 129837 || sensor 4 serial = n/a

Errors

Error E0105 command prohibited while logging
Parameters may not be modified while logging is in progress; reading them is permitted.

Error E0107 expected argument missing
An argument expected by the logger was not given with the command; for example, there must always be an <index> argument.

Error E0108 invalid argument to command: '<invalid-argument>'
This error will occur if the <index> is out of range, or if an unknown parameter is requested. Logger channels are numbered from 1 to N; zero is not valid.

Error E0111 command failed
There was a problem reading or modifying some data for the specified parameter and/or channel. Please contact RBR Ltd for help.

Error E0505 no channels configured
There is a serious problem with the logger's configuration. Please contact RBR Ltd for help.

Error E0501 item is not configured
There is a problem with the configuration of the specified channel; please contact RBR Ltd for help.