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
<< enable status = pending, warning = none

The programmed schedule is valid and the logger will begin collecting data at the start time. 

>> enable
<< enable status = logging, warning = none

The programmed schedule is valid and the logger will begin collecting data at the next scheduled sample time.

>> enable
<< 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.