参数 & 配置

PX4使用参数子系统(实际就是浮点和整型数据的列表)和文本文件(用来配置Mixer混合器和启动脚本)来储存相关配置。

关于系统启动机体参数配置的实现在其他章节有详细讲述。这部分主要是详细讨论参数子系统。

命令行的使用

PX4系统控制台 提供了 param 命令,可以对参数进行设置、访问、保存,以及从文件中导入和保存到文件。

访问和设置参数

命令行param show 可以列出所有系统参数:

  1. param show

参数名+字符可以选择对应的参数进行操作:

  1. nsh> param show RC_MAP_A*
  2. Symbols: x = used, + = saved, * = unsaved
  3. x RC_MAP_AUX1 [359,498] : 0
  4. x RC_MAP_AUX2 [360,499] : 0
  5. x RC_MAP_AUX3 [361,500] : 0
  6. x RC_MAP_ACRO_SW [375,514] : 0
  7. 723 parameters total, 532 used.

导出和加载参数

一般的保存命令可以保存参数到默认的文件中:

  1. param save

如果保存后面加上路径,将会保存参数到新的位置

  1. param save /fs/microsd/vtol_param_backup

加载参数有两种方法:
param load
加载文件并用文件中的数据代替现有参数设置,最终把以前某个状态储存的数据一一复制过来
param import
这个命令更为精妙,它只改变与默认设置不同的参数。这个命令有重要的作用,比如在进行最初校准但不进行其他配置时,导入之前校准的参数就可以只改变校准数据而不对其他配置操作。

覆盖现有参数:

  1. param load /fs/microsd/vtol_param_backup

合并现有参数和储存的参数 (储存文件中与默认参数不同的参数覆盖默认参数):

  1. param import /fs/microsd/vtol_param_backup

C / C++ API

PX4还有独立的C和C++接口访问配置数据。

  1. int32_t param = 0;
  2. param_get(param_find("PARAM_NAME"), &param);

参数数据元

PX4使用一个参数数据元系统把参数展示给用户。正确的合适的数据元对地面站的用户体验有重要意义。

一段传统的数据元如下所示:

  1. /**
  2. * Pitch P gain
  3. *
  4. * Pitch proportional gain, i.e. desired angular speed in rad/s for error 1 rad.
  5. *
  6. * @unit 1/s
  7. * @min 0.0
  8. * @max 10
  9. * @decimal 2
  10. * @increment 0.0005
  11. * @reboot_required true
  12. * @group Multicopter Attitude Control
  13. */
  14. PARAM_DEFINE_FLOAT(MC_PITCH_P, 6.5f);

各行的作用:

  1. /**
  2. * <title>
  3. *
  4. * <longer description, can be multi-line>
  5. *
  6. * @unit <the unit, e.g. m for meters>
  7. * @min <the minimum sane value. Can be overriden by the user>
  8. * @max <the maximum sane value. Can be overriden by the user>
  9. * @decimal <the minimum sane value. Can be overriden by the user>
  10. * @increment <the "ticks" in which this value will increment in the UI>
  11. * @group <a title for parameters which form a group>
  12. */
  13. PARAM_DEFINE_FLOAT(MC_PITCH_P, 6.5f);