Networking Messages

Heartbeat

The Heartbeat message is used to inform other modules that the sending entity’s system is running normally and communications are alive.

  • Abbreviation: Heartbeat
  • Identification Number: 150
  • Fixed Payload Size: 0

This message has no fields.

Announce

A system description that is to be broadcasted to other systems.

  • Abbreviation: Announce
  • Identification Number: 151
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
System Name sys_name - plaintext System name. Same as field type
System Type sys_type Enumerated uint8_t System type. Same as field type
Control Owner owner - uint16_t The owner IMC system ID. Same as field type
Latitude WGS-84 lat rad fp64_t WGS-84 Latitude. If lat=0 and lon=0 means location value is unknown. Same as field type
Longitude WGS-84 lon rad fp64_t WGS-84 Longitude. If lat=0 and lon=0 means location value is unknown. Same as field type
Height WGS-84 height m fp32_t Height above WGS-84 ellipsoid. Same as field type
Services services - plaintext Semicolon separated list of URLs. Examples of such URLs are - imc+udp://192.168.106.34:6002/ - dune://0.0.0.0/uid/1294925553839635/ - http://192.168.106.34/dune/. Same as field type

Announce Service

Announcement about the existence of a service.

  • Abbreviation: AnnounceService
  • Identification Number: 152
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Service service - plaintext Semicolon separated list of URLs (see Announce). Same as field type
ServiceType service_type Bitfield uint8_t Informs about the availability of the service on internal and external networks. Same as field type

Receive Signal Strength Information

Measure of the RSSI by a networking device. Indicates the gain or loss in the signal strength due to the transmission and reception equipment and the transmission medium and distance.

  • Abbreviation: RSSI
  • Identification Number: 153
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Value value % fp32_t RSSI measurement. Same as field type

Voltage Standing Wave Ratio

Measure of the VSWR by a networking device.

  • Abbreviation: VSWR
  • Identification Number: 154
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Value value - fp32_t VSWR measurement. Same as field type

SMS

Send a SMS message.

  • Abbreviation: Sms
  • Identification Number: 156
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Number number - plaintext Target mobile device number. Same as field type
Timeout timeout - uint16_t Timeout for sending message. Same as field type
Contents contents - plaintext Message contents. Same as field type

SMS Transmit

Request to send SMS.

  • Abbreviation: SmsTx
  • Identification Number: 157
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Sequence Number seq - uint32_t Sequence number. Same as field type
Destination destination - plaintext Number or name of the recipient. Same as field type
Timeout timeout s uint16_t Timeout for sending message. Same as field type
Data data - rawdata Message data. Same as field type

SMS Receive

Received SMS data.

  • Abbreviation: SmsRx
  • Identification Number: 158
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Source source - plaintext Number of name of the sender. Same as field type
Data data - rawdata Message data. Same as field type

SMS State

No description

  • Abbreviation: SmsState
  • Identification Number: 159
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Sequence Number seq - uint32_t Sequence number. Same as field type
State state Enumerated uint8_t Current state of an SMS transaction. Same as field type
Error Message error - plaintext   Same as field type

Text Message

A text message has been received.

  • Abbreviation: TextMessage
  • Identification Number: 160
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Origin origin - plaintext Message origin (if known). Same as field type
Text text - plaintext Message contents. Same as field type

Received Iridium Message

No description

  • Abbreviation: IridiumMsgRx
  • Identification Number: 170
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Origin Identifier origin - plaintext The unique identifier of this message’s origin device (e.g. lauv-xtreme-2, manta-0). Same as field type
Timestamp htime s fp64_t Timestamp (Epoch time). Same as field type
Latitude Reference lat rad fp64_t   Same as field type
Longitude Reference lon rad fp64_t   Same as field type
Data data - rawdata Message data. Same as field type

Transmit Iridium Message

No description

  • Abbreviation: IridiumMsgTx
  • Identification Number: 171
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Request Identifier req_id - uint16_t The request identifier used to receive transmission updates. Same as field type
Time to live ttl s uint16_t Time, in seconds, after which there will be no more atempts to transmit the message. Same as field type
Destination Identifier destination - plaintext The unique identifier of this message’s destination (e.g. lauv-xtreme-2, manta-0). Same as field type
Data data - rawdata Message data. Same as field type

Iridium Transmission Status

No description

  • Abbreviation: IridiumTxStatus
  • Identification Number: 172
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Request Identifier req_id - uint16_t The request identifier used to receive transmission updates Same as field type
Status Code status Enumerated uint8_t   Same as field type
Status Text text - plaintext   Same as field type

Group Membership State

Group communication link assertion.

  • Abbreviation: GroupMembershipState
  • Identification Number: 180
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Group Name group_name - plaintext Name of the group of systems. Same as field type
Communication Links Assertion links - uint32_t Communication link assertion for each group member. One bit to assert each system communication link state. Same as field type

System Group

Group of systems configuration.

  • Abbreviation: SystemGroup
  • Identification Number: 181
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Group Name GroupName - plaintext Name of the group of systems. Same as field type
Group List Action Action Enumerated uint8_t Actions on the group list. Same as field type
Systems Name List GroupList - plaintext List of names of system in the group, separated by commas. Same as field type

Extended Receive Signal Strength Information

Measure of the RSSI by a networking device. Indicates the gain or loss in the signal strenght due to the transmission and reception equipment and the transmission medium and distance.

  • Abbreviation: ExtendedRSSI
  • Identification Number: 183
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Value value - fp32_t RSSI measurement. Same as field type
RSSI Units units Enumerated uint8_t Indicates the units used for the RSSI value. Same as field type

Historic Data Series

This message holds a list of inline data samples produced by one or more vehicles in the past. It is used to transfer data over disruption tolerant networks.

  • Abbreviation: HistoricData
  • Identification Number: 184
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Base Latitude base_lat ° fp32_t All data sent inside this message will have offsets relative to this latitude. Same as field type
Base Longitude base_lon ° fp32_t All data sent inside this message will have offsets relative to this longitude. Same as field type
Base Timestamp base_time s fp32_t All data sent inside this message will use this time as the origin (0). Same as field type
Data data - message-list   Same as field type

Compressed Historic Data Series

This message holds a list of inline data samples produced by one or more vehicles in the past. It is used to transfer data over disruption tolerant networks.

  • Abbreviation: CompressedHistory
  • Identification Number: 185
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Base Latitude base_lat ° fp32_t All data sent inside this message will have offsets relative to this latitude. Same as field type
Base Longitude base_lon ° fp32_t All data sent inside this message will have offsets relative to this longitude. Same as field type
Base Timestamp base_time s fp32_t All data sent inside this message will use this time as the origin (0). Same as field type
Data data - rawdata A message-list of HistoricSample messages compressed with GZip algorithm. Same as field type

Historic Data Sample

No description

  • Abbreviation: HistoricSample
  • Identification Number: 186
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Original System Id sys_id - uint16_t The IMC identifier of the system that produced this sample. Same as field type
Priority priority - int8_t The priority for this data sample. Default priority is 0. Samples with higher priorities will always be transmitted before samples with lower priorities. Samples with -127 priority will not be transmitted but just logged to disk locally. Same as field type
X offset x m int16_t Northing offsets relative to base latitude / longitude expressed in the enclosing HistoricData message. Same as field type
Y offset y m int16_t Easting offsets relative to base latitude / longitude expressed in the enclosing HistoricData message. Same as field type
Z offset z dm int16_t Altitude / depth offsets relative to sea level expressed in decimeters. Negative values mean depth and positive values mean altitude. Same as field type
Time offset t s int16_t Time offset in seconds relative to the base time expressed in the enclosing HistoricData message. Same as field type
Data Sample sample - message   Same as field type

Historic Data Query

No description

  • Abbreviation: HistoricDataQuery
  • Identification Number: 187
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Request Id req_id - uint16_t   Same as field type
Request Type type Enumerated uint8_t   Same as field type
Maximum Size max_size - uint16_t   Same as field type
Data data - message   Same as field type

Remote Command

Command to remote system. If a system receives a RemoteCommand and it isn’t the intended recipient, then it should resend it.

  • Abbreviation: RemoteCommand
  • Identification Number: 188
  • Fixed Payload Size: 0
Name Abbreviation Unit Type Description Range
Original Source original_source - uint16_t IMC id of the original sender. Same as field type
Destination destination - uint16_t IMC id of the recipient. Same as field type
Timeout timeout s fp64_t Expiration time of the message (Epoch Time), in seconds. If the message doesn’t reach the destination within timeout, the validity of the message expires and there will be no more attempts to transmit the message. Same as field type
Command cmd - message Command to be unpacked by the recipient. Same as field type