|
10 | 10 | xsi:noNamespaceSchemaLocation="IMC.xsd" |
11 | 11 | name="IMC" |
12 | 12 | long-name="Inter Module Communication" |
13 | | - version="5.4.7"> |
| 13 | + version="5.4.8"> |
14 | 14 |
|
15 | 15 | <description> |
16 | 16 | This document describes the communications protocol associated |
|
326 | 326 | <message-type abbrev="FormationPlanExecution"/> |
327 | 327 | <message-type abbrev="Dislodge"/> |
328 | 328 | <message-type abbrev="Drop"/> |
| 329 | + <message-type abbrev="ScheduledGoto"/> |
329 | 330 | </message-group> |
330 | 331 |
|
331 | 332 | <message-group name="Control Command" abbrev="ControlCommand"> |
|
2033 | 2034 | </field> |
2034 | 2035 | </message> |
2035 | 2036 |
|
| 2037 | + <message id="214" name="Acoustic Link Quality" abbrev="AcousticLink"> |
| 2038 | + <description> |
| 2039 | + This message is used to report the perceived link quality to other |
| 2040 | + acoustic peers. |
| 2041 | + </description> |
| 2042 | + <field name="Peer Name" abbrev="peer" type="plaintext"> |
| 2043 | + <description> |
| 2044 | + The name of the peer on the other side of this link. |
| 2045 | + </description> |
| 2046 | + </field> |
| 2047 | + <field name="Received Signal Strength Indicator" abbrev="rssi" type="fp32_t" unit="dB"> |
| 2048 | + <description> |
| 2049 | + RSSI is a signed floating point number. Higher RSSI values correspond to |
| 2050 | + stronger signals. |
| 2051 | + The signal strength is acceptable when measured RSSI values lie between |
| 2052 | + -20 dB and -85 dB. |
| 2053 | + </description> |
| 2054 | + </field> |
| 2055 | + <field name="Signal Integrity Level" abbrev="integrity" type="uint16_t"> |
| 2056 | + <description> |
| 2057 | + Signal Integrity value illustrates distortion of the last received |
| 2058 | + acoustic signal. It is calculated based on cross-correlation |
| 2059 | + measurements. |
| 2060 | + Higher *Signal Integrity Level* values correspond to less distorted |
| 2061 | + signals. An acoustic link is considered weak if the *Signal Integrity |
| 2062 | + Level* value is less than 100. |
| 2063 | + </description> |
| 2064 | + </field> |
| 2065 | + </message> |
| 2066 | + |
2036 | 2067 | <!-- Sensors --> |
2037 | 2068 | <message id="250" name="Revolutions Per Minute" abbrev="Rpm" source="vehicle"> |
2038 | 2069 | <description> |
|
6677 | 6708 | </description> |
6678 | 6709 | </field> |
6679 | 6710 | </message> |
| 6711 | + |
| 6712 | + <message id="487" name="Scheduled Goto" abbrev="ScheduledGoto" source="ccu"> |
| 6713 | + <description> |
| 6714 | + This maneuver is used to command the vehicle to arrive at some destination at |
| 6715 | + a specified absolute time. |
| 6716 | + |
| 6717 | + The vehicle's speed will vary according to environment conditions and/or maneuver start time. |
| 6718 | + </description> |
| 6719 | + <field name="Time of arrival" abbrev="arrival_time" type="fp64_t" unit="s"> |
| 6720 | + <description> |
| 6721 | + Unix timestamp, in seconds, for the arrival at the destination. |
| 6722 | + </description> |
| 6723 | + </field> |
| 6724 | + <field name="Destination Latitude WGS-84" abbrev="lat" type="fp64_t" unit="rad" min="-1.5707963267948966" max="1.5707963267948966"> |
| 6725 | + <description> |
| 6726 | + WGS-84 Latitude of target waypoint. |
| 6727 | + </description> |
| 6728 | + </field> |
| 6729 | + <field name="Destination Longitude WGS-84" abbrev="lon" type="fp64_t" unit="rad" min="-3.141592653589793" max="3.141592653589793"> |
| 6730 | + <description> |
| 6731 | + WGS-84 Longitude of target waypoint. |
| 6732 | + </description> |
| 6733 | + </field> |
| 6734 | + <field name="Destination Z Reference" abbrev="z" type="fp32_t" unit="m"> |
| 6735 | + <description> |
| 6736 | + Target reference in the z axis. Use z_units to specify |
| 6737 | + whether z represents depth, altitude or other. |
| 6738 | + </description> |
| 6739 | + </field> |
| 6740 | + <field name="Z Units" abbrev="z_units" type="uint8_t" value="0" unit="Enumerated" enum-def="ZUnits"> |
| 6741 | + <description> |
| 6742 | + Units of the destination z reference. |
| 6743 | + </description> |
| 6744 | + </field> |
| 6745 | + <field name="Travel Z Reference" abbrev="travel_z" type="fp32_t" unit="m"> |
| 6746 | + <description> |
| 6747 | + Z reference to use while travelling to the destination. |
| 6748 | + </description> |
| 6749 | + </field> |
| 6750 | + <field name="Travel Z Units" abbrev="travel_z_units" type="uint8_t" value="0" unit="Enumerated" enum-def="ZUnits"> |
| 6751 | + <description> |
| 6752 | + Z reference units to use while travelling to the destination. |
| 6753 | + </description> |
| 6754 | + </field> |
| 6755 | + <field name="Delayed Behavior" abbrev="delayed" type="uint8_t" value="0" unit="Enumerated" prefix="DBEH"> |
| 6756 | + <description> |
| 6757 | + What to do if the vehicle fails to arrive before or at the requested time. |
| 6758 | + </description> |
| 6759 | + <value abbrev="RESUME" name="Resume" id="0"> |
| 6760 | + <description> |
| 6761 | + If the vehicle fails to arrive at the specified time, it will keep going to the destination |
| 6762 | + at top speed and only then consider this maneuver completed. |
| 6763 | + </description> |
| 6764 | + </value> |
| 6765 | + <value abbrev="SKIP" name="Skip" id="1"> |
| 6766 | + <description> |
| 6767 | + If the vehicle fails to arrive at the specified time, it will stop the current maneuver and |
| 6768 | + advance to the next one (independently of how far it is from destination). |
| 6769 | + </description> |
| 6770 | + </value> |
| 6771 | + <value abbrev="FAIL" name="Fail" id="2"> |
| 6772 | + <description> |
| 6773 | + If the vehicle fails to arrive at the specified time, it will stop the execution of this |
| 6774 | + maneuver with a FAILED result (the entire plan will be stopped). |
| 6775 | + </description> |
| 6776 | + </value> |
| 6777 | + </field> |
| 6778 | + </message> |
6680 | 6779 |
|
6681 | 6780 | <!-- Vehicle Supervision --> |
6682 | 6781 | <message id="500" name="Vehicle State" abbrev="VehicleState" source="vehicle"> |
|
0 commit comments