settings

Usage

>> settings [ fetchpoweroffdelay | sensorpoweralwayson | castdetection | inputtimeout | speccondtempco | altitude | temperature | pressure | atmosphere | density | salinity | avgsoundspeed ]

Security

Unsafe.

Description

Reports or sets the values of miscellaneous settings in the logger as described below.

  • fetchpoweroffdelay [= <timeoutinmilliseconds>] is the delay in milliseconds between successful completion of a fetch command, and power to the front end sensors being removed by the logger. Power is left on for a short time to avoid excessive power cycling when sending repeated fetch commands; this parameter allows that delay to be adjusted. The default value is 8000.

  • sensorpoweralwayson [= <state>] is a flag which is either on or off. When on, the logger does not remove power from the front end sensors between samples. This can be useful for sensors with very long power-on stabilization times. The default setting is off.

  • castdetection [= <state>]  is a flag which is either on or off. When on, the logger will detect automatically upcasts and downcasts, and will generate cast detection events in the datastream. It is advisable to ensure this option is off if the logger is not used as a profiler. The default setting is off.

  • inputtimeout [= <timeoutinmilliseconds>] specifies the value of a timeout used by the logger when receiving command input; it is used to temporarily blank other output such as streamed data, and to assist in power saving by turning off the serial communication interface if it is not needed. See the section Timeouts, Output Blanking and Power Saving for more details. The value is specified in milliseconds; the default value for all instruments is 10000 (10 seconds). The value may be set within the range 10000 (10 seconds) to 240000 (4 minutes) inclusive; partial seconds are rounded up to the next whole second value. Instead of a numeric value, the word default may be used to restore the.default value of 10000.

  • speccondtempco [= <value>] is the temperature coefficient used to correct the derived channel for specific conductivity to 25°C. Its value depends on the ionic composition of the water being monitored, and should be set to an appropriate value for best results. A typical range of values is 0.0191 to 0.0214, with the lower end suitable for KCl solutions and the upper end for NaCl solutions. When specifying a value, any simple numeric format compatible with floating point representation may be used; for example 0.02, 0.0200, or 2e-2 would all be accepted.  If the parameter is never explicitly set, the default value is 0.0191, suitable for standard KCl solution.

  • altitude [= <value>] is the height above the seabed in metres at which the logger is deployed. This is a user-entered parameter which is required by host software to calculate statistics and parameters for wave analysis: it is not used internally by the logger, and if wave analysis is not required the parameter can be ignored.

  • temperaturepressure, atmospheredensity, salinity, avgsoundspeed [= <value>]: these are default parameter values, to be used when the logger does not have a channel which measures the named parameter, but one or more cross-channel calibration equations requires it as an input.
    When specifying a value, any simple numeric format compatible with floating point representation may be used; for example 11, 11.000 or 1.10e+1 would all be accepted. 
    The units of these parameter values are implicit, and must be as shown below. If these parameter values are never explicitly set, they will have default values based on standard sea water (salinity = 35PSU, temperature = 15°C, hydrostatic pressure = 0 dbar), and one standard atmosphere for atmospheric pressure. 
    1. temperature in °C, default value 15.0
    2. absolute pressure in dbar, default value 10.132501 (1 standard atmosphere)
    3. atmospheric pressure in dbar, default value 10.132501
    4. water density in g/cm3, default value 1.026021
    5. salinity in PSU, default value 35
    6. avgsoundspeed in m/s, default value 1506.8

Examples

>> settings atmosphere
<< settings atmosphere = 10.132501
>> settings density = 1.0295
<< settings density = 1.0295
>> settings sensorpoweralwayson
<< settings sensorpoweralwayson = off
>> settings castdetection
<< settings castdetection = off

Errors

Error E0105 command prohibited while logging 
Parameters may not be modified while logging is in progress.

Error E0108 invalid argument to command: '<invalid-argument>' 
The supplied argument was not valid; examples include: invalid parameter name and improperly specified value.