libRBR  v1.2.3
RBR instrument communication API
RBRInstrumentVehicle.h
Go to the documentation of this file.
1 
13 #ifndef LIBRBR_RBRINSTRUMENTVEHICLE_H
14 #define LIBRBR_RBRINSTRUMENTVEHICLE_H
15 
16 #ifdef __cplusplus
17 extern "C" {
18 #endif
19 
21 #define RBRINSTRUMENT_REGIME_MAX 3
22 
24 #define RBRINSTRUMENT_REGIME_BOUNDARY_MAX 65535
25 
27 #define RBRINSTRUMENT_REGIME_BINSIZE_MAX 6553.5
28 
30 #define RBRINSTRUMENT_REGIME_SAMPLING_PERIOD_MAX 65000
31 
41 {
51 
60 
69 {
79 
89 
97 typedef struct RBRInstrumentRegimes
98 {
106  int32_t count;
110 
123  RBRInstrument *instrument,
124  RBRInstrumentRegimes *regimes);
125 
148  RBRInstrument *instrument,
149  const RBRInstrumentRegimes *regimes);
150 
152 typedef uint8_t RBRInstrumentRegimeIndex;
153 
161 typedef struct RBRInstrumentRegime
162 {
177  float boundary;
183  float binSize;
192 
216  RBRInstrument *instrument,
217  RBRInstrumentRegime *regime);
218 
239  RBRInstrument *instrument,
240  const RBRInstrumentRegime *regime);
241 
250 {
284 
297  RBRInstrument *instrument,
299 
320  RBRInstrument *instrument,
322 
323 #ifdef __cplusplus
324 }
325 #endif
326 
327 #endif /* LIBRBR_RBRINSTRUMENTVEHICLE_H */
RBRINSTRUMENT_REFERENCE_ABSOLUTE
@ RBRINSTRUMENT_REFERENCE_ABSOLUTE
Definition: RBRInstrumentVehicle.h:71
RBRInstrumentDirectionDependentSampling::slowThreshold
float slowThreshold
Sets the boundary, based on the previous profile, where the instrument should switch to the slow peri...
Definition: RBRInstrumentVehicle.h:282
RBRInstrument_getDirectionDependentSampling
RBRInstrumentError RBRInstrument_getDirectionDependentSampling(RBRInstrument *instrument, RBRInstrumentDirectionDependentSampling *ddsampling)
Get the instrument direction-dependent sampling settings.
RBRInstrument_setRegime
RBRInstrumentError RBRInstrument_setRegime(RBRInstrument *instrument, const RBRInstrumentRegime *regime)
Set the instrument regime settings.
RBRInstrument_getRegime
RBRInstrumentError RBRInstrument_getRegime(RBRInstrument *instrument, RBRInstrumentRegime *regime)
Get the instrument regime settings.
RBRINSTRUMENT_REFERENCE_SEAPRESSURE
@ RBRINSTRUMENT_REFERENCE_SEAPRESSURE
Definition: RBRInstrumentVehicle.h:73
RBRInstrumentDirectionDependentSampling::fastThreshold
float fastThreshold
Sets the boundary, based on the previous profile, where the instrument should switch to the fast peri...
Definition: RBRInstrumentVehicle.h:274
RBRInstrumentDirectionDependentSampling::direction
RBRInstrumentDirection direction
In which direction the instrument samples at the fast rate.
Definition: RBRInstrumentVehicle.h:252
RBRINSTRUMENT_DIRECTION_ASCENDING
@ RBRINSTRUMENT_DIRECTION_ASCENDING
Definition: RBRInstrumentVehicle.h:43
RBRINSTRUMENT_DIRECTION_DESCENDING
@ RBRINSTRUMENT_DIRECTION_DESCENDING
Definition: RBRInstrumentVehicle.h:45
RBRInstrumentRegimes::count
int32_t count
The number of regimes that are set.
Definition: RBRInstrumentVehicle.h:106
RBRInstrument_setDirectionDependentSampling
RBRInstrumentError RBRInstrument_setDirectionDependentSampling(RBRInstrument *instrument, RBRInstrumentDirectionDependentSampling *ddsampling)
Set the instrument regime settings.
RBRINSTRUMENT_UNKNOWN_REFERENCE
@ RBRINSTRUMENT_UNKNOWN_REFERENCE
Definition: RBRInstrumentVehicle.h:77
RBRInstrumentDirection
RBRInstrumentDirection
Whether settings apply to ascent or descent.
Definition: RBRInstrumentVehicle.h:40
RBRInstrumentPeriod
int32_t RBRInstrumentPeriod
A periodic parameter.
Definition: RBRInstrument.h:191
RBRInstrumentRegime::samplingPeriod
RBRInstrumentPeriod samplingPeriod
The same meaning as RBRInstrumentSampling.period, but applies only to this particular regime.
Definition: RBRInstrumentVehicle.h:190
RBRINSTRUMENT_UNKNOWN_DIRECTION
@ RBRINSTRUMENT_UNKNOWN_DIRECTION
Definition: RBRInstrumentVehicle.h:49
RBRInstrumentRegimes
struct RBRInstrumentRegimes RBRInstrumentRegimes
Instrument regimes command parameters.
RBRInstrumentError
RBRInstrumentError
Errors which can be returned from library functions.
Definition: RBRInstrument.h:200
RBRINSTRUMENT_DIRECTION_COUNT
@ RBRINSTRUMENT_DIRECTION_COUNT
Definition: RBRInstrumentVehicle.h:47
RBRInstrumentDirectionDependentSampling::fastPeriod
RBRInstrumentPeriod fastPeriod
The same meaning as RBRInstrumentSampling.period, but applies only when the instrument is moving in t...
Definition: RBRInstrumentVehicle.h:259
RBRInstrumentRegime::boundary
float boundary
The first boundary in a region.
Definition: RBRInstrumentVehicle.h:177
RBRInstrument_getRegimes
RBRInstrumentError RBRInstrument_getRegimes(RBRInstrument *instrument, RBRInstrumentRegimes *regimes)
Get the instrument regimes settings.
RBRInstrumentRegimesReference
RBRInstrumentRegimesReference
The types of pressure available for use a reference for the determination of the current regime and b...
Definition: RBRInstrumentVehicle.h:68
RBRINSTRUMENT_REFERENCE_COUNT
@ RBRINSTRUMENT_REFERENCE_COUNT
Definition: RBRInstrumentVehicle.h:75
RBRInstrumentRegime::binSize
float binSize
The size used for each averaged bin.
Definition: RBRInstrumentVehicle.h:183
RBRInstrumentDirectionDependentSampling::slowPeriod
RBRInstrumentPeriod slowPeriod
The same meaning as RBRInstrumentSampling.period, but applies only when the instrument is not moving ...
Definition: RBRInstrumentVehicle.h:266
RBRInstrumentRegimesReference_name
const char * RBRInstrumentRegimesReference_name(RBRInstrumentRegimesReference reference)
Get a human-readable string name for a regime pressure reference.
RBRInstrumentRegimes
Instrument regimes command parameters.
Definition: RBRInstrumentVehicle.h:97
RBRInstrument_setRegimes
RBRInstrumentError RBRInstrument_setRegimes(RBRInstrument *instrument, const RBRInstrumentRegimes *regimes)
Set the instrument regimes settings.
RBRInstrumentRegimeIndex
uint8_t RBRInstrumentRegimeIndex
A regime identifier.
Definition: RBRInstrumentVehicle.h:152
RBRInstrument
Core library context object.
Definition: RBRInstrument.h:591
RBRInstrumentRegime::index
RBRInstrumentRegimeIndex index
The index of the regime in question.
Definition: RBRInstrumentVehicle.h:171
RBRInstrumentRegime
struct RBRInstrumentRegime RBRInstrumentRegime
Instrument regime command parameters.
RBRInstrumentDirectionDependentSampling
Instrument ddsampling command parameters.
Definition: RBRInstrumentVehicle.h:249
RBRInstrumentDirection_name
const char * RBRInstrumentDirection_name(RBRInstrumentDirection direction)
Get a human-readable string name for an instrument direction.
RBRInstrumentRegime
Instrument regime command parameters.
Definition: RBRInstrumentVehicle.h:161
RBRInstrumentRegimes::direction
RBRInstrumentDirection direction
The regimes-relevant direction through the water column.
Definition: RBRInstrumentVehicle.h:100
RBRInstrumentDirectionDependentSampling
struct RBRInstrumentDirectionDependentSampling RBRInstrumentDirectionDependentSampling
Instrument ddsampling command parameters.
RBRInstrumentRegimes::reference
RBRInstrumentRegimesReference reference
The pressure type used for regime and bin determination.
Definition: RBRInstrumentVehicle.h:108