Browse Source

增加编队飞行相关指令说明

Liu Yang 6 months ago
parent
commit
e139e90674
2 changed files with 33 additions and 4 deletions
  1. 2 2
      msg_definitions/VKFly.xml
  2. 31 2
      readme.md

+ 2 - 2
msg_definitions/VKFly.xml

@@ -780,9 +780,9 @@
     </message>
 
     <message id="53005" name="VK_ENGINE_ECU_STAUS">
-      <description> formation fly leader status message </description>
+      <description> engine ecu status message </description>
       <field type="uint32_t" name="timestamp" units="ms">Timestamp in ms from system boot.</field>
-      <field type="uint16_t" name="spd_rpm">formation leader drone state bitmap</field>
+      <field type="uint16_t" name="spd_rpm">rotational speed in rpm</field>
       <field type="uint8_t" name="thr_pos" units="%" minValue="0" maxValue="100" increment="1">throttle
         position </field>
       <field type="uint8_t" name="fuel_pos" units="%" minValue="0" maxValue="100" increment="1">fuel

+ 31 - 2
readme.md

@@ -201,7 +201,8 @@ typedef enum VKFLY_CUSTOM_MODE
     VKFLY_CUSTOM_MODE_DYN_LAND=25, /* Dyn_Land 动平台降落| */
     VKFLY_CUSTOM_MODE_OBAVOID=26, /* Obavoid  自主避障| */
     VKFLY_CUSTOM_MODE_OFFBOARD=27, /* Offboard command control. OFFBORAD 控制| */
-    VKFLY_CUSTOM_MODE_ENUM_END=28, /*  | */
+    VKFLY_CUSTOM_MODE_FORMATION=28, /* Formation 队形编队 */
+    VKFLY_CUSTOM_MODE_ENUM_END=29 /*  | */
 } VKFLY_CUSTOM_MODE;
 ```
 
@@ -252,6 +253,7 @@ typedef enum VKFLY_LOITER_REASON
     VLFLY_LOITER_REASON_RC_BAD=13, /* 遥控器数据异常悬停 | */
     VLFLY_LOITER_REASON_BAT_CAP_LOW=14, /* 电池电量低悬停 | */
     VLFLY_LOITER_REASON_OFFBOARD=15, /* OFFBORAD控制悬停 | */
+    VLFLY_LOITER_REASON_QUIT_FORMATION=16, /* 退队编队悬停 | */
     VLFLY_LOITER_REASON_H2P_LOW=17, /* 氢能气压低悬停 | */
     VLFLY_LOITER_REASON_ECU_FUEL_LOW=18, /* 发动机油量低悬停 | */
     VLFLY_LOITER_REASON_WPDATA_ERR=21, /* 航点数据异常悬停  | */
@@ -413,6 +415,18 @@ typedef enum VKFLY_RTL_EXEC_MODE
     VKFLY_RTL_EXEC_MODE_ENUM_END=3, /*  | */
 } VKFLY_RTL_EXEC_MODE;
 ```
+### 1.21 编队队形 VKFLY_FORMATION_TYPE
+```c
+typedef enum VKFLY_FORMATION_TYPE
+{
+   VKFLY_FORMATION_ROW=0, /*  横一字队形 | */
+   VKFLY_FORMATION_COLUM=1, /* 纵一字队形 | */
+   VKFLY_FORMATION_TRIANGLE=2, /* 三角队形 | */
+   VKFLY_FORMATION_RECTANGLE=3, /* 矩形队形 | */
+   VKFLY_FORMATION_CUSTOM=4, /* 自定义队形 | */
+   VKFLY_FORMATION_TYPE_ENUM_END=5, /*  | */
+} VKFLY_FORMATION_TYPE;
+```
 
 ## 2 飞控遥测数据消息
 
@@ -716,7 +730,7 @@ LOCAL 定位信息
 | x_dist         | 机间左右间距 m                     |
 | y_dist         | 机间前后间距 m                     |
 | z_dist         | 机间高度间距 m                     |
-| rect_col_num   | 机间高度间距 m                     |
+| rect_col_num   | 矩形队形列数 m                     |
 | formation_type | 队形类型 参考 VKFLY_FORMATION_TYPE |
 
 ### 2.22 组件设备版本信息 VK_COMP_VERSION
@@ -1276,6 +1290,21 @@ param1~param5中,
 | param1 | 重量校准, 填写实际载重单位克. NAN表示忽略 |
 | param2 | 1-恢复出厂配置.  NAN表示忽略              |
 
+### 5.37 队形飞行 VKFLY_CMD_FORMATION_FLY
+
+编队指令. 编队集结或解散指令发送给队形从机, 设置队形指令发送给队形主机.
+队形主机将队形参数通过 VK_FORMATION_LEADER 持续广播给编队从机.
+
+| 参数   | 说明                           |
+| ------ | ------------------------------ |
+| param1 | 1编队集结 2编队解散 3设置队形  |
+| param2 | 编队队形, VKFLY_FORMATION_TYPE |
+| param3 | 举行队形列数                   |
+| param4 | 预留                           |
+| param5 | 左右间距 单位m                 |
+| param6 | 前后间距 单位m                 |
+| param7 | 上下间距 单位m                 |
+
 ## 6 飞控 LOG 读取
 
 - LOG_REQUEST_LIST