参数 & 配置

官网英文原文地址：http://dev.px4.io/advanced-configurations.html

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
  8.  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);