enable
Usage
>> enable [ erasememory ]
Security
Open.Description
Enables a logger to sample according to the programmed schedule.
An option is available to erase the memory and enable the logger with a single command, otherwise the memclear command must be used to erase the memory beforehand if necessary.
erasememory = true, erase the memory
Although the enable command is always available, a number of checks are made before logging is actually enabled. If any check fails, the logger is not enabled and an error message is sent as described below. The most severe error found causes immediate failure of the command; a single attempt to enable the logger will not detect multiple errors. If all required conditions are satisfied, an internal error may still prevent sampling from being enabled when the logger attempts it. This also will provoke an error message.
If successful, the command reports two parameters:
status, this is the same status reported by the deployment command.
warning, warning code if any (see description below), none otherwise.
Examples
<< enable status = pending, warning = none
The programmed schedule is valid and the logger will begin collecting data at the start time.
<< enable status = logging, warning = none
The programmed schedule is valid and the logger will begin collecting data at the next scheduled sample time.
<< enable status = pending, warning = W0401
The programmed schedule is valid and the logger will begin collecting data at the start time; however, the memory may fill before the end time.
Warning messages:
W0401 estimated memory usage exceeds capacity
The schedule is valid, but the memory may fill up before the end time is reached.
W0408 logging already active
The logger was already active.
Errors
Error E0107 expected argument missing
For example, the true argument was not given with the erasememory option.
Error E0108 invalid argument to command: '<invalid-argument>'
An unrecognized argument was given with the command.
Error E0301 memory erase not completed
Memory erase failed (requested with erasememory = true option).
Error E0402 memory not empty, erase first
The data memory must be empty
Error E0403 end time must be after start time
The end time must be later than the start time.
Error E0404 end time must be after current time
The end time must be later than the logger's current time.
Error E0405 failed to enable for logging
An internal problem prevented the logger from enabling the sampling schedule. For further details and suggestions for recovery, refer to the deployment command.
Error E0410 no sampling channels active
All the logger's measured channels have been turned off (in instruments which support this feature); there is nothing to sample.
Error E0411 period not valid for selected mode
The measurement period is not consistent with other programmed parameters.
Error E0412 burst parameters inconsistent
The programmed burst parameters are not consistent for the selected sample mode.
Error E0413 period too short for serial streaming
Serial streaming may not be available at high sample rates.
Error E0414 thresholding interval not valid
The requested threshold check interval is not consistent with the logger's capabilities or other programmed parameters.
Error E0415 more than one gating condition is enabled
Gating conditions such as thresholding and twist activation can not be used in combination; choose one.
Error E0416 wrong regimes settings
The programmed settings for 'regimes' sampling are not consistent.
Error E0417 no gating allowed with regimes mode
A gating condition can not be used with the 'regimes' sampling mode.
Error E0418 cast detection needs a pressure/depth channel
The cast detection feature can not be used if the logger has no pressure or depth channel.
Error E0419 calibration coefficients are missing
Valid calibration coefficients for all sampled channels must be present before logging can be enabled.
Error E0420 required channel is turned off; <channel-index>
The indicated channel has been turned off, but it must be sampled for a selected feature (eg. thresholding) to work; turn the channel back on.
Error E0421 raw output format not allowed
Raw streaming output formats are not permitted if the memory storage format is set to EasyParse (calbin00).
Error E0422 AUX1 not available in current serial mode
The AUX1 signal can be used only in RS-232 mode.
Error E0423 wrong ddsampling settings
The programmed settings for 'ddsampling' sampling are not consistent.
Error E0114 feature not supported by hardware
An attempt is being made to enable the logger using a feature it does not support.