IMCInter Module Communication
v5.5.11

Leader State

LeaderState ID 563Periodic
Payload
≥ 83 bytes, variable
Packet
≥ 105 bytes
Source
vehicle
Category
Plan Supervision

This message defines the formation leader state.

LeaderState is a complete description of the leader state in terms of parameters such as position, orientation and velocities at a particular moment in time.

The system position is given by a North-East-Down (NED) local tangent plane displacement (x, y, z) relative to an absolute WGS-84 coordinate (latitude, longitude, height above ellipsoid).

The symbols for position and attitude as well as linear and angular velocities were chosen according to SNAME's notation (1950). The body-fixed reference frame and Euler angles are depicted next:

euler-lauv.png

:align: center

Euler angles

#Fields

Offset FieldTypeUnitRangeDescription
0 #group_nameGroup Name plaintext – –

Name for the formation group.

var #opAction on the leader state uint8_t Enumerated –

Action on the formation leader state variables

0OP_REQUESTRequest
1OP_SETSet
2OP_REPORTReport
var #latLatitude (WGS-84) fp64_t rad −π/2 … π/2

WGS-84 Latitude.

var #lonLongitude (WGS-84) fp64_t rad −π … π

WGS-84 Longitude.

var #heightHeight (WGS-84) fp32_t m –

Height above the WGS-84 ellipsoid.

var #xOffset north fp32_t m –

The North offset of the North/East/Down field with respect to LLH.

var #yOffset east fp32_t m –

The East offset of the North/East/Down field with respect to LLH.

var #zOffset down fp32_t m –

The Down offset of the North/East/Down field with respect to LLH.

var #phiRotation over x axis fp32_t rad −π … π

The phi Euler angle from the vehicle's attitude.

var #thetaRotation over y axis fp32_t rad −π/2 … π/2

The theta Euler angle from the vehicle's attitude.

var #psiRotation over z axis fp32_t rad −π … π

The psi Euler angle from the vehicle's attitude.

var #vxGround Velocity X (North) fp32_t m/s –

Ground Velocity xx axis velocity component.

var #vyGround Velocity Y (East) fp32_t m/s –

Ground Velocity yy axis velocity component.

var #vzGround Velocity Z (Down) fp32_t m/s –

Ground Velocity zz axis velocity component.

var #pAngular Velocity in x fp32_t rad/s −π … π

The angular velocity over body-fixed xx axis (roll).

var #qAngular Velocity in y fp32_t rad/s −π … π

The angular velocity over body-fixed yy axis (pitch).

var #rAngular Velocity in z fp32_t rad/s −π … π

The angular velocity over body-fixed zz axis (yaw).

var #svxStream Velocity X (North) fp32_t m/s –

Stream Velocity xx axis velocity component.

var #svyStream Velocity Y (East) fp32_t m/s –

Stream Velocity yy axis velocity component.

var #svzStream Velocity Z (Down) fp32_t m/s –

Stream Velocity zz axis velocity component.