sensor

Usage

>> sensor <index> [ <parameter_name> [ = <parameter_value> ], ...]

Security

Open.

Description

Returns information about the sensor attached to the channel at the specified <index>: the first channel has an <index> of 1.

This command is available only with firmware versions 1.220 or later. Its purpose 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 latency, 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. Channel types and parameters which may currently be configured in an instrument include the following; new combinations may be added in future.

Channel typeParameter nameFirmware versionComment
bpr_08serial1.220Sensor serial number
bpr_09serial1.220Sensor serial number


Examples

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

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 E0109 feature not available
The channel selected by <index> is not configured to support auxiliary information via the sensor command.

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.