pause
Usage
>> pause
Security
Open
Description
This command is available in firmware versions 1.116 or later. It pauses an enabled deployment.
If successful, the command reports its status:
- status, will be "paused".
Error conditions that would prevent the successful execution of the command are:
- An older version of firmware that does not support the command is on the instrument.
- The instrument has not be enabled for deployment.
- A gating condition (twist, thresholding) is in effect for the deployment.
- The instrument has been enabled in the 'regimes' sampling mode
When a pause is issued, the following will happen:
- Streaming is immediately suspended if it was enabled for the deployment.
- The current acquisition, if any, is terminated. For averages/tides, this means that the current sample will be thrown away and not recorded in memory or streamed. For bursts/waves the burst will terminate before the expected number of samples.
- An event of type EVENT_PAUSE (0x2B) is stored in the data stream.
- No further acquisitions will be scheduled until a resume command is received.
Examples
>> pause
<< pause status = paused
Deployment is now paused and no more samples will be taken once the current, if any, acquisition finishes.
>> pause
<< E0406 not logging
Cannot pause deployment before deployment is enabled.
<< pause
>> E0415 more than one gating condition is enabled
Assuming that either the wet switch or twist activation has been enabled the pause and resume feature cannot be used.
Errors
E0102 invalid command
The logger does not support the sampling pause and resume feature.
E0109 feature not available
The feature has not been allowed.
E0406 not logging
The logger deployment is not enabled and so cannot be paused/resumed.
E0415 more than one gating condition is enabled
If one gating mechanism has already been enabled (wet switch, twist) the pause and resume feature cannot be used.
E0417 no gating allowed with regimes mode
The logger deployment is enabled with the regimes sampling mode so the pause/resume feature cannot be used.