跳至内容

模块参考:命令

致动器测试

资料来源 systemcmds/actuator_test

测试执行器的实用程序。

警告:使用此命令前请移除所有道具。

使用方法

actuator_test <命令> [arguments...] [参数...
 命令
   设置 将执行机构设置为特定输出值

 可直接按电机、伺服或功能指定执行器:
     [-m <val>] 要测试的电机 (1...8)
     [-s <val>] 要测试的伺服(1...8)
     [-f <val>] 直接指定函数
     -v <val> 值(-1...1)
     [-t <val>] 以秒为单位的超时(如果未设置,则交互运行)
                 默认值:0

   iterate-motors 迭代所有电机,逐个启动和停止

   遍历所有伺服器,一个接一个地偏转

更新

资料来源 systemcmds/bl_update

从文件闪存启动加载程序的实用程序

使用方法

bl_update [参数...]
   setopt 设置解锁 FLASH 的选项位(仅在锁定状态下需要)。
                 国家)

   启动程序 bin 文件

bsondump

资料来源 systemcmds/bsondump

从文件中读取 BSON 并打印或输出文档大小的实用程序。

使用方法

bsondump [参数...]
     要解码和打印的 BSON 文件。

转储文件

资料来源 systemcmds/dumpfile

转储文件实用程序。以二进制模式(不要用 CR LF 代替 LF)将文件大小和内容打印到 stdout。

使用方法

dumpfile [参数...]
     要转储的文件

动态

资料来源 systemcmds/dyn

说明

加载并运行未编译到 PX4 二进制文件中的动态 PX4 模块。

示例

dyn ./hello.px4mod start

使用方法

dyn [参数......]
     包含模块的文件
     [模块参数

失败

资料来源 systemcmds/failure

说明

将故障注入系统。

实施情况

该系统指令通过 uORB 发送载具指令以触发故障。

实例

通过停止 GPS 测试 GPS 防故障保护:

故障 GPS 关闭

使用方法

失败 [参数......]
   help 显示此帮助文本

   gps|...指定组件

   ok|off|...指定故障类型
     [-i <val>] 传感器实例(0=全部)
                 默认值:0

gpio

资料来源 systemcmds/gpio

说明

该命令用于读写 GPIO

gpio read <PORT><PIN>/<DEVICE> [PULLDOWN|PULLUP] [--force] [--force
gpio write <PORT><PIN>/<DEVICE> <VALUE> [PUSHPULL|OPENDRAIN] [--force] [--force

实例

读取配置为上拉的端口 H 引脚 4 的值,该值为高电平

gpio 读 H4 PULLUP

1 OK

将端口 E 第 7 针的输出值设置为高电平

gpio write E7 1 --force

将设备 /dev/gpio1 的输出值设置为高电平

gpio 写 /dev/gpio1 1

使用方法

gpio [参数...]
   阅读
     <端口><引脚>/<设备> GPIO 端口和引脚或设备
     [PULLDOWN|PULLUP] 下拉/上拉
     [强制(忽略电路板 gpio 列表)

   写道
     <PORT> <PIN> GPIO 端口和引脚
     <VALUE> 要写入的值
     [PUSHPULL|OPENDRAIN] 推拉/排水系统
     [强制(忽略电路板 gpio 列表)

硬故障日志

资料来源 systemcmds/hardfault_log

硬故障实用程序

在启动脚本中用于处理硬故障

使用方法

hardfault_log <命令> [参数...]
 命令
   check 检查是否存在未提交的硬故障

   重新上膛 丢弃未承诺的硬故障

   fault 生成硬故障(该命令会导致系统崩溃:)。
     [0|1|2|3] 硬故障类型:0=除以 0,1=断言,2=跳转到 0x0、
                 3=写入 0x0(默认值=0)

   提交 将未提交的硬故障写入 /fs/microsd/fault_%i.txt(和
                 重新上膛,但不要重置)

   计数 读取重启计数器,计算重启的次数。
                 未提交的硬故障(作为
                 程序)

   重置 重启计数器

历史

资料来源 systemcmds/hist

命令行工具,用于显示 px4 消息历史记录。没有参数。

使用方法

历史[参数......]

i2cdetect

资料来源 systemcmds/i2cdetect

扫描特定总线上 I2C 设备的实用程序。

使用方法

i2cdetect [参数...]
     [-b <val>] I2C 总线
                 默认:1

led_control

资料来源 systemcmds/led_control

说明

控制和测试(外部)LED 的命令行工具。

要使用它,请确保有驱动程序正在运行,该驱动程序负责处理 led_control uorb 主题。

有不同的优先级,例如,一个模块可以低优先级设置一种颜色,另一个模块可以高优先级闪烁 N 次,闪烁后 LED's 自动返回到低优先级状态。LED 重置 命令也可用于返回较低的优先级。

实例

第一个 LED 蓝色闪烁 5 次:

led_control 闪烁 -c 蓝色 -l 0 -n 5

使用方法

led_control <命令> [参数...]
 命令
   test 运行测试模式

   打开 LED

   关闭 关闭 LED

   重置 LED 优先级

   闪烁 LED 闪烁 N 次
     [-n <val>] 闪烁次数
                 默认:3
     [-s <val>] 设置闪烁速度
                 值:快速|正常|慢速,默认值:正常

   呼吸 持续淡入淡出 LED

   闪烁 两次快速闪烁,然后熄灭,频率为 1 赫兹

 除了 'test',以下参数适用于上述所有命令:
     [-c <val>] 颜色
                 值:red|blue|green|yellow|purple|amber|cyan|white,默认值:
                 白色
     [-l <val>] 控制哪个 LED:0、1、2、...(默认为全部)
     [-p <val>] 优先级
                 默认:2

听众

资料来源 systemcmds/topic_listener

监听 uORB 主题并将数据打印到控制台的实用程序。

可随时按 Ctrl+C、Esc 或 Q 键退出监听器。

使用方法

监听器 <command> [参数...]
 命令
     uORB 主题名称
     [-i <val>] 主题实例
                 默认值:0
     [-n <val>] 信息数量
                 默认:1
     [-r <val>] 订阅率(如果为 0,则无限制)
                 默认值:0

mfd

资料来源 systemcmds/mft

实用程序与清单互动

使用方法

mfd <command> [arguments...] [参数...
 命令
   查询 如果不存在,返回 true

mtd

资料来源 systemcmds/mtd

安装和测试分区的实用程序(基于电路板定义的 FRAM/EEPROM 存储空间)

使用方法

mtd <命令> [参数...]
 命令
   状态 打印状态信息

   readtest 执行读取测试

   rwtest 执行读写测试

   擦除分区

 命令 'readtest' 和 'rwtest' 有一个可选的实例索引:
     [-i <val>]存储索引(如果电路板有多个存储空间)
                 默认值:0

 命令 'readtest'、'rwtest' 和 'erase'有一个可选参数:
     [<partition_name1> [<partition_name2> ...]]。分区名称(例如
                 /fs/mtd_params),如果未提供,则使用系统默认值

nshterm

资料来源 systemcmds/nshterm

在指定端口上启动 NSH shell。

以前,它用于在 USB 串口上启动 shell。现在有了 mavlink,就可以在 mavlink 上使用 shell 了。

使用方法

nshterm [参数...]
     <file:dev> 启动 shell 的设备(例如 /dev/ttyACM0)

停止

资料来源 systemcmds/param

说明

通过 shell 或脚本访问和操作参数的命令。

例如在启动脚本中用于设置机身特定参数。

参数更改后会自动保存,例如使用 参数集.它们通常存储在 FRAM 或 SD 卡中。 参数选择 可用于更改后续保存的存储位置(每次启动时都需要(重新)配置)。

如果启用了基于 FLASH 的后端(在编译时启用,如 Intel Aero 或 Omnibus)、 参数选择 不起作用,默认情况下始终使用 FLASH 后端。但是 参数 save/load <file>; 仍可用于写入/读取文件。

每个参数都有一个"'used'标志,在启动过程中读取时被设置。它只用于向地面控制站显示相关参数。

实例

更改机身并确保加载了机身的默认参数:

参数设置 SYS_AUTOSTART 4001
参数设置 SYS_AUTOCONFIG 1
重新启动

使用方法

param <command> [arguments...] [参数...
 命令
   加载 从文件加载参数(覆盖所有参数)
     [文件名(如果未给出,则使用默认值)

   import 从文件导入参数
     [文件名(如果未给出,则使用默认值)

   保存 将参数保存到文件
     [文件名(如果未给出,则使用默认值)

   选择 选择默认文件
     [文件名

   select-backup 选择默认文件
     [文件名

   show 显示参数值
     [-a] 显示所有参数(不只是已用参数)
     [-c] 仅显示已更改的参数(也未使用)
     [-q] 静音模式,只打印参数值(名称必须准确无误)
     [<filter>] 按参数名称过滤(允许在末尾使用通配符,如 sys_*)

   show-for-airframe 显示已更改的机身配置参数

   状态 打印参数系统的状态

   设置 将参数设置为某一数值
     <param_name> <value> 要设置的参数名称和值
     [fail] 如果提供,则在找不到参数时让命令失败

   set-default 设置参数默认值
     [-s] 如果提供,则在参数不存在时显示无声错误
     <param_name> <value> 要设置的参数名称和值
     [fail] 如果提供,则在找不到参数时让命令失败

   compare 比较参数和值。如果相等,命令将成功执行
     [-s] 如果提供,则在参数不存在时显示无声错误
     <param_name> <value> 要比较的参数名称和值

   更大 将一个参数与一个值进行比较。如果参数
                 大于
     [-s] 如果提供,则在参数不存在时显示无声错误
     <param_name> <value> 要比较的参数名称和值
     <param_name> <value> 要比较的参数名称和值

   触摸 标记已使用的参数
     [<param_name1> [<param_name2>]] 参数名称(一个或多个参数名称(一个或多个)

   重置 仅将指定参数重置为默认值
     [<param1> [<param2>]]要重置的参数名称(允许在末尾使用通配符)

   reset_all 将所有参数重置为默认值
     [<exclude1> [<exclude2>]] 不重置匹配参数(末尾的通配符)。不重置匹配参数(末尾为通配符
                 允许)

   index 显示给定索引的参数
     <index> 索引:整数 >= 0

   index_used 显示指定索引的已用参数
     <index> 索引:整数 >= 0

   查找参数的显示索引
     参数名称

有效载荷发送器

资料来源 modules/payload_deliverer

说明

通过适当的超时/反馈传感器设置,使用机械手或绞盘处理有效载荷的交付,并在内部将交付结果作为确认信息进行反馈

使用方法

payload_deliverer <command> [arguments...] (参数...)
 命令
   启动

   gripper_test 测试抓取器的释放和抓取顺序

   gripper_open 打开机械手

   gripper_close 关闭机械手

   停止

   状态 打印状态信息

敷衍

资料来源 systemcmds/perf

打印性能计数器的工具

使用方法

敷衍 [参数......]
   reset 重置所有计数器

   延迟 打印 HRT 定时器延迟直方图

 如果未给出参数,则打印所有性能计数器

重新启动

资料来源 systemcmds/reboot

重启系统

使用方法

重新启动 [参数...]
     [-b] 重启进入启动加载程序
     [-i] 重启进入 ISP(第一阶段引导加载程序)
     [锁定/解锁] 获取/释放关机锁(用于测试)

sd_bench

资料来源 systemcmds/sd_bench

测试 SD 卡的速度

使用方法

sd_bench [参数...]
     [-b <val>] 每次读/写的块大小
                 默认值:4096
     [-r <val>] 运行次数
                 默认值:5
     [以毫秒为单位的运行持续时间
                 默认值:2000
     [-k] 保留测试文件
     [-s] 在每个区块之后调用 fsync(默认值=每次运行结束时)
     [-u] 测试未对齐数据的性能
     [-U] 测试强制字节不对齐数据的性能
     [-v] 验证数据和区块编号

sd_stress

资料来源 systemcmds/sd_stress

测试在 SD 卡上的操作

使用方法

sd_stress [参数...]
     [-r <val>] 运行次数
                 默认值:5
     [-b <val>] 字节数
                 默认值:100

串行直通

资料来源 systemcmds/serial_passthru

将数据从一个设备传递到另一个设备。

这可用于将连接到 USB 的 u-center 与串行端口上的 GPS 配合使用。

使用方法

serial_passthru [arguments...] [参数...
     -e <val> 外部设备路径
                 值:<file:dev>;
     -d <val> 内部设备路径
                 值:<file:dev>;
     [-b <val>] 波特率
                 默认值:115200
     [-t] 在内部设备上跟踪外部设备波特率

系统时间

资料来源 systemcmds/system_time

说明

命令行工具,用于设置和获取系统时间。

实例

设置系统时间并回读

system_time 设置 1600775044
system_time get

使用方法

system_time <命令> [参数...]
 命令
   set 设置系统时间,以 unix epoch time 格式提供时间

   get 获取系统时间

顶级

资料来源 systemcmds/top

监控运行中的进程及其 CPU、堆栈使用率、优先级和状态

使用方法

置顶 [参数...]
   只打印加载一次

usb_connected

资料来源 systemcmds/usb_connected

用于检查 USB 是否已连接的实用程序。以前用于启动脚本。返回值为 0 表示 USB 已连接,否则为 1。

使用方法

usb_connected [参数...]

......验证

资料来源 systemcmds/ver

打印各种版本信息的工具

使用方法

ver <command> [arguments...] [参数...
 命令
   hw 硬件架构

   mcu MCU 信息

   git 版本信息

   bdate 生成日期和时间

   gcc 编译器信息

   bdate 生成日期和时间

   px4guid PX4 GUID

   uri 构建 URI

   所有 打印所有版本

   hwcmp 比较硬件版本(匹配时返回 0)
     要与之比较的硬件(如 PX4_FMU_V4)。OR 比较
                 如果指定多个

   hwtypecmp 比较硬件类型(匹配时返回 0)
     要与之比较的硬件类型(如 V2)。一个 OR
                 如果指定多个,则使用比较

   hwbasecmp 比较硬件基数(匹配时返回 0)
     要与之比较的硬件类型(如 V2)。一个 OR
                 如果指定多个,则使用比较