enable

Usage

>> enable [erasememory = true]

Security

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.

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 checks are passed, the logger's status will be reported as one of:
- pending, if logging is enabled but the start time is still in the future,
- logging, if logging is now in progress, or
- gated, if logging would now be in progress but the selected gating condition is not satisfied.

If the memory would fill before the end time is reached, a warning message is issued but the logger is still enabled to sample.

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.

Examples

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

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

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. 

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 status command.

Error E0408 logging already active
The logger must not already be enabled or active in any sense.

Error E0409 uncleared error, use 'errorlog'
The runtime error log must be clear. 

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.