添加一个新的机型

官网英文原文地址：http://dev.px4.io/airframes-adding-a-new-frame.html

PX4使用存储的配置作为机型的起始点。添加配置是非常简单的：在init.d文件夹创建一个新的文件，这个文件需要以一个没有使用的自动启动ID作为文件名的前缀，然后构建并上传固件即可。

如果不想创建自己的配置文件，也可以用SD卡上的文本文件替换掉已有的自定义配置文件，具体细节请查看自定义系统启动页。

机型配置

一个机型配置包括3项基本内容：

  • 应该启动的应用，例如多旋翼或者固定翼的控制器
  • 系统（固定翼，飞翼或者多旋翼）的物理配置，这叫做混控器
  • 参数整定

这三方面大多数时候是独立的，也就是说，许多配置会共享相同的机型物理布局以及启动相同的应用，它们之间最大的不同在参数整定部分。

所有的配置存储在ROMFS/px4fmu_common/init.d文件夹。所有的混控器存储在ROMFS/px4fmu_common/mixers文件夹。

配置文件

如下所示，是一个典型的配置文件：

  1. #!nsh
  2. #
  3. # @name Wing Wing (aka Z-84) Flying Wing
  4. #
  5. # @url https://pixhawk.org/platforms/planes/z-84_wing_wing
  6. #
  7. # @type Flying Wing
  8. #
  9. # @output MAIN1 left aileron
  10. # @output MAIN2 right aileron
  11. # @output MAIN4 throttle
  12. #
  13. # @output AUX1 feed-through of RC AUX1 channel
  14. # @output AUX2 feed-through of RC AUX2 channel
  15. # @output AUX3 feed-through of RC AUX3 channel
  16. #
  17. # @maintainer Lorenz Meier <lorenz@px4.io>
  18. #
  20. sh /etc/init.d/rc.fw_defaults
  22. if [ $AUTOCNF == yes ]
  23. then
  24.     param set BAT_N_CELLS 2
  25.     param set FW_AIRSPD_MAX 15
  26.     param set FW_AIRSPD_MIN 10
  27.     param set FW_AIRSPD_TRIM 13
  28.     param set FW_ATT_TC 0.3
  29.     param set FW_L1_DAMPING 0.74
  30.     param set FW_L1_PERIOD 16
  31.     param set FW_LND_ANG 15
  32.     param set FW_LND_FLALT 5
  33.     param set FW_LND_HHDIST 15
  34.     param set FW_LND_HVIRT 13
  35.     param set FW_LND_TLALT 5
  36.     param set FW_THR_LND_MAX 0
  37.     param set FW_PR_FF 0.35
  38.     param set FW_RR_FF 0.6
  39.     param set FW_RR_P 0.04
  40. fi
  42. # Configure this as plane
  43. set MAV_TYPE 1
  44. # Set mixer
  45. set MIXER wingwing
  46. # Provide ESC a constant 1000 us pulse
  47. set PWM_OUT 4
  48. set PWM_DISARMED 1000

注意事项: IMPORTANT REMARK: If you want to reverse a channel, never do this neither on your RC transmitter nor with e.g RC1_REV. The channels are only reversed when flying in manual mode, when you switch in an autopilot flight mode, the channels output will still be wrong (it only inverts your RC signal). Thus for a correct channal assignment change either your PWM signals with PWM_MAIN_REV1 (e.g. for channel one) or change the signs for both output scaling and output range in the corresponding mixer (see below).

混控器文件

一个典型的混控器文件会像下面这样：

所以MAIN1对应左副翼，MAIN2对应右副翼，MAIN3置空（注意：Z即为空混控器），MAIN4则对应油门（对于一般固定翼配置，保持油门和输出4对应）。

混控器被编码为从-10000到10000的标准单位，对应-1到+1。

  1. M: 2
  2. O:      10000  10000      0 -10000  10000
  3. S: 0 0  -6000  -6000      0 -10000  10000
  4. S: 0 1   6500   6500      0 -10000  10000

从左到右每个数字代表的意思如下：

  • M：代表有2个缩放系数（对应着两个输入）
  • O：代表输出缩放系数（负输入量缩放系数为1，正输入量缩放系数为1），偏移量（这里是0），输出范围（这里-1到+1）
  • S：代表第一个输入量的缩放系数：输入量来自控制组#0（姿态控制）的第一个输入（滚转），缩放系数为0.6，并且符号取反（-0.6换算到标准单位是-6000），没有偏移量（0），输出为全范围（-1到+1）
  • S：代表第二个输入量的缩放系数：输入量来自控制组#0（姿态控制）的第二个输入（俯仰），缩放系数为0.65（0.65换算到标准单位是6500），没有偏移量（0），输出为全范围（-1到+1）

所有的缩放器结果累加，对飞翼而言，控制面偏移量取滚转信号的60%和俯仰信号的65%。如果俯仰信号和滚转信号都取最大值，那么偏移量将达到125%，超出了输出范围，这就意味着第一个通道（滚转）比第二个通道（俯仰）优先级高。

完整的混控器定义如下：

  1. Delta-wing mixer for PX4FMU
  2. ===========================
  4. Designed for Wing Wing Z-84
  6. This file defines mixers suitable for controlling a delta wing aircraft using
  7. PX4FMU. The configuration assumes the elevon servos are connected to PX4FMU
  8. servo outputs 0 and 1 and the motor speed control to output 3. Output 2 is
  9. assumed to be unused.
  11. Inputs to the mixer come from channel group 0 (vehicle attitude), channels 0
  12. (roll), 1 (pitch) and 3 (thrust).
  14. See the README for more information on the scaler format.
  16. Elevon mixers
  17. -------------
  18. Three scalers total (output, roll, pitch).
  20. On the assumption that the two elevon servos are physically reversed, the pitch
  21. input is inverted between the two servos.
  23. The scaling factor for roll inputs is adjusted to implement differential travel
  24. for the elevons.
  26. M: 2
  27. O:      10000  10000      0 -10000  10000
  28. S: 0 0  -6000  -6000      0 -10000  10000
  29. S: 0 1   6500   6500      0 -10000  10000
  31. M: 2
  32. O:      10000  10000      0 -10000  10000
  33. S: 0 0  -6000  -6000      0 -10000  10000
  34. S: 0 1  -6500  -6500      0 -10000  10000
  36. Output 2
  37. --------
  38. This mixer is empty.
  40. Z:
  42. Motor speed mixer
  43. -----------------
  44. Two scalers total (output, thrust).
  46. This mixer generates a full-range output (-1 to 1) from an input in the (0 - 1)
  47. range.  Inputs below zero are treated as zero.
  49. M: 1
  50. O:      10000  10000      0 -10000  10000
  51. S: 0 3      0  20000 -10000 -10000  10000