libRBR  v1.2.3
RBR instrument communication API
RBRInstrumentSchedule.h
Go to the documentation of this file.
1 
13 #ifndef LIBRBR_RBRINSTRUMENTSCHEDULE_H
14 #define LIBRBR_RBRINSTRUMENTSCHEDULE_H
15 
16 #ifdef __cplusplus
17 extern "C" {
18 #endif
19 
26 #define RBRINSTRUMENT_AVAILABLE_FAST_PERIODS_MAX 32
27 
29 #define RBRINSTRUMENT_SAMPLING_PERIOD_MAX 86400000
30 
38 typedef struct RBRInstrumentClock
39 {
61 
80  RBRInstrumentClock *clock);
81 
108  const RBRInstrumentClock *clock);
109 
117 {
142 
151 
160 typedef enum RBRInstrumentGate
161 {
183 
191 const char *RBRInstrumentGate_name(RBRInstrumentGate gate);
192 
202 typedef struct RBRInstrumentSampling
203 {
231  const RBRInstrumentPeriod
248  int32_t burstLength;
263 
275  RBRInstrument *instrument,
276  RBRInstrumentSampling *sampling);
277 
321  RBRInstrument *instrument,
322  const RBRInstrumentSampling *sampling);
323 
355  RBRInstrument *instrument,
356  const RBRInstrumentSampling *sampling);
357 
368 {
400 
410 
419 {
439 
451  RBRInstrument *instrument,
452  RBRInstrumentDeployment *deployment);
453 
476  RBRInstrument *instrument,
477  const RBRInstrumentDeployment *deployment);
478 
479 #ifdef __cplusplus
480 }
481 #endif
482 
483 #endif /* LIBRBR_RBRINSTRUMENTSCHEDULE_H */
RBRINSTRUMENT_GATE_COUNT
@ RBRINSTRUMENT_GATE_COUNT
Definition: RBRInstrumentSchedule.h:179
RBRINSTRUMENT_STATUS_PENDING
@ RBRINSTRUMENT_STATUS_PENDING
Definition: RBRInstrumentSchedule.h:372
RBRInstrument_getDeployment
RBRInstrumentError RBRInstrument_getDeployment(RBRInstrument *instrument, RBRInstrumentDeployment *deployment)
Get the instrument deployment parameters.
RBRInstrumentDeployment
struct RBRInstrumentDeployment RBRInstrumentDeployment
Instrument deployment command parameters.
RBRInstrument_getSampling
RBRInstrumentError RBRInstrument_getSampling(RBRInstrument *instrument, RBRInstrumentSampling *sampling)
Get the instrument sampling parameters.
RBRINSTRUMENT_UNKNOWN_GATE
@ RBRINSTRUMENT_UNKNOWN_GATE
Definition: RBRInstrumentSchedule.h:181
RBRINSTRUMENT_GATE_INVALID
@ RBRINSTRUMENT_GATE_INVALID
Definition: RBRInstrumentSchedule.h:177
RBRInstrument_setDeployment
RBRInstrumentError RBRInstrument_setDeployment(RBRInstrument *instrument, const RBRInstrumentDeployment *deployment)
Set the instrument deployment parameters.
RBRInstrumentSampling::gate
RBRInstrumentGate gate
The sampling gating condition.
Definition: RBRInstrumentSchedule.h:261
RBRInstrumentClock::dateTime
RBRInstrumentDateTime dateTime
The instrument's date and time.
Definition: RBRInstrumentSchedule.h:43
RBRINSTRUMENT_STATUS_DISABLED
@ RBRINSTRUMENT_STATUS_DISABLED
Definition: RBRInstrumentSchedule.h:370
RBRInstrumentGate_name
const char * RBRInstrumentGate_name(RBRInstrumentGate gate)
Get a human-readable string name for a gating condition.
RBRInstrumentDeploymentStatus
RBRInstrumentDeploymentStatus
Possible instrument logging statuses.
Definition: RBRInstrumentSchedule.h:367
RBRInstrumentClock
Instrument clock command parameters.
Definition: RBRInstrumentSchedule.h:38
RBRINSTRUMENT_STATUS_FAILED
@ RBRINSTRUMENT_STATUS_FAILED
Definition: RBRInstrumentSchedule.h:390
RBRInstrumentSampling::period
RBRInstrumentPeriod period
Time between measurements.
Definition: RBRInstrumentSchedule.h:215
RBRInstrument_setClock
RBRInstrumentError RBRInstrument_setClock(RBRInstrument *instrument, const RBRInstrumentClock *clock)
Set the instrument clock.
RBRInstrumentDateTime
int64_t RBRInstrumentDateTime
Definition: RBRInstrument.h:181
RBRInstrumentDeployment::startTime
RBRInstrumentDateTime startTime
The deployment start date and time.
Definition: RBRInstrumentSchedule.h:425
RBRINSTRUMENT_SAMPLING_COUNT
@ RBRINSTRUMENT_SAMPLING_COUNT
Definition: RBRInstrumentSchedule.h:138
RBRInstrumentSampling::availableFastPeriods
const RBRInstrumentPeriod availableFastPeriods[RBRINSTRUMENT_AVAILABLE_FAST_PERIODS_MAX]
Fast measurement periods available for the logger for sampling rates faster than 1Hz.
Definition: RBRInstrumentSchedule.h:232
RBRINSTRUMENT_UNKNOWN_STATUS
@ RBRINSTRUMENT_UNKNOWN_STATUS
Definition: RBRInstrumentSchedule.h:398
RBRInstrumentSamplingMode_name
const char * RBRInstrumentSamplingMode_name(RBRInstrumentSamplingMode mode)
Get a human-readable string name for a sampling mode.
RBRINSTRUMENT_STATUS_FULLANDSTOPPED
@ RBRINSTRUMENT_STATUS_FULLANDSTOPPED
Definition: RBRInstrumentSchedule.h:386
RBRInstrumentPeriod
int32_t RBRInstrumentPeriod
A periodic parameter.
Definition: RBRInstrument.h:191
RBRINSTRUMENT_GATE_THRESHOLDING
@ RBRINSTRUMENT_GATE_THRESHOLDING
Definition: RBRInstrumentSchedule.h:169
RBRInstrumentDeployment::endTime
RBRInstrumentDateTime endTime
The deployment end date and time.
Definition: RBRInstrumentSchedule.h:431
RBRInstrument_setBurstSampling
RBRInstrumentError RBRInstrument_setBurstSampling(RBRInstrument *instrument, const RBRInstrumentSampling *sampling)
Set the instrument burst sampling length and interval.
RBRINSTRUMENT_STATUS_UNKNOWN
@ RBRINSTRUMENT_STATUS_UNKNOWN
Definition: RBRInstrumentSchedule.h:394
RBRInstrumentSamplingMode
RBRInstrumentSamplingMode
Possible instrument sampling modes.
Definition: RBRInstrumentSchedule.h:116
RBRInstrumentClock
struct RBRInstrumentClock RBRInstrumentClock
Instrument clock command parameters.
RBRINSTRUMENT_STATUS_NOTBLANK
@ RBRINSTRUMENT_STATUS_NOTBLANK
Definition: RBRInstrumentSchedule.h:392
RBRINSTRUMENT_SAMPLING_REGIMES
@ RBRINSTRUMENT_SAMPLING_REGIMES
Definition: RBRInstrumentSchedule.h:129
RBRINSTRUMENT_SAMPLING_AVERAGE
@ RBRINSTRUMENT_SAMPLING_AVERAGE
Definition: RBRInstrumentSchedule.h:125
RBRInstrumentError
RBRInstrumentError
Errors which can be returned from library functions.
Definition: RBRInstrument.h:200
RBRInstrumentClock::offsetFromUtc
float offsetFromUtc
The offset of the instrument's date and time from UTC.
Definition: RBRInstrumentSchedule.h:59
RBRInstrumentSampling
Instrument sampling command parameters.
Definition: RBRInstrumentSchedule.h:202
RBRInstrumentDeployment
Instrument deployment command parameters.
Definition: RBRInstrumentSchedule.h:418
RBRInstrumentSampling::mode
RBRInstrumentSamplingMode mode
The instrument sampling mode.
Definition: RBRInstrumentSchedule.h:205
RBRInstrument_getClock
RBRInstrumentError RBRInstrument_getClock(RBRInstrument *instrument, RBRInstrumentClock *clock)
Get the instrument clock.
RBRINSTRUMENT_SAMPLING_WAVE
@ RBRINSTRUMENT_SAMPLING_WAVE
Definition: RBRInstrumentSchedule.h:123
RBRInstrumentSampling::burstLength
int32_t burstLength
The number of measurements taken in each burst.
Definition: RBRInstrumentSchedule.h:248
RBRINSTRUMENT_SAMPLING_TIDE
@ RBRINSTRUMENT_SAMPLING_TIDE
Definition: RBRInstrumentSchedule.h:127
RBRInstrumentSampling
struct RBRInstrumentSampling RBRInstrumentSampling
Instrument sampling command parameters.
RBRINSTRUMENT_UNKNOWN_SAMPLING
@ RBRINSTRUMENT_UNKNOWN_SAMPLING
Definition: RBRInstrumentSchedule.h:140
RBRINSTRUMENT_STATUS_LOGGING
@ RBRINSTRUMENT_STATUS_LOGGING
Definition: RBRInstrumentSchedule.h:374
RBRINSTRUMENT_AVAILABLE_FAST_PERIODS_MAX
#define RBRINSTRUMENT_AVAILABLE_FAST_PERIODS_MAX
The maximum number of available fast sampling periods to parse from the instrument.
Definition: RBRInstrumentSchedule.h:26
RBRINSTRUMENT_STATUS_COUNT
@ RBRINSTRUMENT_STATUS_COUNT
Definition: RBRInstrumentSchedule.h:396
RBRINSTRUMENT_SAMPLING_DDSAMPLING
@ RBRINSTRUMENT_SAMPLING_DDSAMPLING
Definition: RBRInstrumentSchedule.h:136
RBRInstrumentSampling::userPeriodLimit
const RBRInstrumentPeriod userPeriodLimit
The minimum period which can be used in fast sampling modes.
Definition: RBRInstrumentSchedule.h:242
RBRINSTRUMENT_STATUS_FULL
@ RBRINSTRUMENT_STATUS_FULL
Definition: RBRInstrumentSchedule.h:388
RBRInstrumentDeployment::status
const RBRInstrumentDeploymentStatus status
The deployment status.
Definition: RBRInstrumentSchedule.h:437
RBRInstrument
Core library context object.
Definition: RBRInstrument.h:591
RBRINSTRUMENT_STATUS_FINISHED
@ RBRINSTRUMENT_STATUS_FINISHED
Definition: RBRInstrumentSchedule.h:378
RBRINSTRUMENT_SAMPLING_BURST
@ RBRINSTRUMENT_SAMPLING_BURST
Definition: RBRInstrumentSchedule.h:121
RBRINSTRUMENT_GATE_TWISTACTIVATION
@ RBRINSTRUMENT_GATE_TWISTACTIVATION
Definition: RBRInstrumentSchedule.h:175
RBRInstrumentGate
RBRInstrumentGate
Possible instrument gating conditions.
Definition: RBRInstrumentSchedule.h:160
RBRINSTRUMENT_STATUS_STOPPED
@ RBRINSTRUMENT_STATUS_STOPPED
Definition: RBRInstrumentSchedule.h:384
RBRINSTRUMENT_GATE_NONE
@ RBRINSTRUMENT_GATE_NONE
Definition: RBRInstrumentSchedule.h:163
RBRInstrumentSampling::burstInterval
RBRInstrumentPeriod burstInterval
The time between the first measurement of two consecutive bursts.
Definition: RBRInstrumentSchedule.h:259
RBRINSTRUMENT_SAMPLING_CONTINUOUS
@ RBRINSTRUMENT_SAMPLING_CONTINUOUS
Definition: RBRInstrumentSchedule.h:119
RBRINSTRUMENT_STATUS_GATED
@ RBRINSTRUMENT_STATUS_GATED
Definition: RBRInstrumentSchedule.h:376
RBRInstrumentDeploymentStatus_name
const char * RBRInstrumentDeploymentStatus_name(RBRInstrumentDeploymentStatus status)
Get a human-readable string name for a deployment status.
RBRInstrument_setSampling
RBRInstrumentError RBRInstrument_setSampling(RBRInstrument *instrument, const RBRInstrumentSampling *sampling)
Set the instrument sampling mode and period.