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 | Field | Type | Unit | Range | Description | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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
|
0 | Z_NONE | None |
1 | Z_DEPTH | Depth |
2 | Z_ALTITUDE | Altitude |
3 | Z_HEIGHT | Height |
radiusRadiusfp32_tRadius.
durationDurationuint16_tDuration (0 for unlimited).
speedSpeedfp32_tThe value of the desired speed, in the scale specified by the "Speed Units" field.
speed_unitsSpeed Unitsuint8_tIndicates the units used for the speed value.
3 values from SpeedUnits
0 | SUNITS_METERS_PS | Meters per second |
1 | SUNITS_RPM | RPM |
2 | SUNITS_PERCENTAGE | Percentage |
popup_periodPopUp Perioduint16_tThe period at which the vehicle will popup to report its position. Only used if flag KEEP_SAFE is on.
popup_durationPopUp Durationuint16_tThe duration of the station keeping at surface level when it pops up. Only used if flag KEEP_SAFE is on.
flagsFlagsuint8_tFlags of the maneuver.
0x01 | FLG_KEEP_SAFE | Keep 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). |
customCustom settings for maneuverplaintextCustom settings for maneuver.
#References
Member of Maneuver: it can be sent where that group is expected.
Carried inline by:
VehicleCommand.maneuvermessage · via ManeuverPlanManeuver.datamessage · via ManeuverManeuverResumed.man_listmessage-list · via Maneuver