settings

Usage

>> settings [ <parameter_name> [ = <value> ] … ] 

Security

Open.

Description

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

  1. fetchpoweroffdelay 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.
  2. sensorpoweralwayson 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.
  3. castdetection 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.
  4. inputtimeout is available only in firmware versions 1.130 or later, and 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.
  5. offsetfromutc is available only in firmware versions 1.210 or later. It is intended to record the local time zone used when the logger was deployed, as an offset from Universal Coordinated Time (UTC). This can facilitate correct interpretation of the time information, even if the downloaded data file is reviewed in a different time zone. The offset is specified in hours; fractional hours are permitted to support time zones which require this, and the offset is always reported to two decimal places. When specifying a value, any simple numeric format compatible with floating point representation may be used; for example 11, +11, or 11.00 would all be accepted.  Setting this parameter does not change the logger's time as reported by the now command; it is intended simply as a record of the local time zone. However, setting the date and time using the now command erases this setting; it must be restored if necessary. By default the parameter is In the erased state, in which case it is reported as unknown.
  6. speccondtempco is available only in firmware versions 1.210 or later. It 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.
  7. temperaturepressureconductivityatmospheredensity, salinity, avgsoundspeed: 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. conductivity in mS/cm, default value 42.914 (not available in firmware 1.310 or later; replaced by salinity)
    5. water density in g/cm3, default value 1.026021
    6. salinity in PSU, default value 35 (only available in firmware 1.310 or later, replaces conductivity)
    7. avgsoundspeed in m/s, default value 1506.8 (only available in firmware 1.330 or later)

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.