IMCInter Module Communication
v5.5.11

Station Keeping Extended

StationKeepingExtended ID 720
Payload
≥ 39 bytes, variable
Packet
≥ 61 bytes
Source
ccu
Category
Maneuvering

The Station Keeping Extended maneuver makes the vehicle come to the surface and then enter a given circular perimeter around a waypoint coordinate for a certain amount of time. It extends the Station Keeping maneuver with the feature 'Keep Safe', which allows for the vehicle to hold position underwater and popup periodically to communicate.

#Fields

Offset FieldTypeUnitRangeDescription
0 #latLatitude WGS-84 fp64_t rad −π/2 … π/2

WGS-84 Latitude.

8 #lonLongitude WGS-84 fp64_t rad −π … π

WGS-84 Longitude.

16 #zZ Reference fp32_t m –

Maneuver reference in the z axis. Use z_units to specify whether z represents depth, altitude or other.

20 #z_unitsZ Units uint8_t Enumerated
default 0

Units of the z reference.

4 values from ZUnits
0Z_NONENone
1Z_DEPTHDepth
2Z_ALTITUDEAltitude
3Z_HEIGHTHeight
21 #radiusRadius fp32_t m –

Radius.

25 #durationDuration uint16_t s –

Duration (0 for unlimited).

27 #speedSpeed fp32_t – –

The value of the desired speed, in the scale specified by the "Speed Units" field.

31 #speed_unitsSpeed Units uint8_t Enumerated –

Indicates the units used for the speed value.

3 values from SpeedUnits
0SUNITS_METERS_PSMeters per second
1SUNITS_RPMRPM
2SUNITS_PERCENTAGEPercentage
32 #popup_periodPopUp Period uint16_t s –

The period at which the vehicle will popup to report its position. Only used if flag KEEP_SAFE is on.

34 #popup_durationPopUp Duration uint16_t s –

The duration of the station keeping at surface level when it pops up. Only used if flag KEEP_SAFE is on.

36 #flagsFlags uint8_t Bitfield –

Flags of the maneuver.

0x01FLG_KEEP_SAFEKeep safe behaviour

If this flag is set, the vehicle will hold position underwater, loitering at z reference. It will popup periodically to report position. When it pops up, it will stay at surface in "normal" station keeping behaviour for a certain time (popup_duration).

37 #customCustom settings for maneuver plaintext TupleList –

Custom settings for maneuver.

#References

Member of Maneuver: it can be sent where that group is expected.

Carried inline by: