# 模块参考:命令

# 致动器测试

资料来源 systemcmds/actuator_test (打开新窗口)

测试执行器的实用程序。

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

# 使用方法

actuator_test <command>(执行器测试) [arguments...] (参数...) 命令: set 将执行器设置为特定的输出值 执行器可以通过电机、伺服或功能直接指定:[-m <val>] 要测试的电机(1...8) [-s <val>] 要测试的伺服(1...8) [-f <val>] 直接指定函数 -v <val> 值(-1...1) [-t <val>] 以秒为单位的超时(如果未设置,则交互运行) 默认值:0 iterate-motors Iterate all motorors starting and stopping one after another iterate-servos Iterate all servos deflecting one after another

# 更新

资料来源 systemcmds/bl_update (打开新窗口)

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

# 使用方法

bl_update [arguments...] setopt 设置选项位以解锁 FLASH(仅在锁定状态下需要) <file> 引导加载程序 bin 文件

# bsondump

资料来源 systemcmds/bsondump (打开新窗口)

从文件中读取 BSON 并以人形打印

# 使用方法

bsondump [arguments...] <file> 文件名

# 转储文件

资料来源 systemcmds/dumpfile (打开新窗口)

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

# 使用方法

dumpfile [arguments...] <file> 要转储的文件

# 动态

资料来源 systemcmds/dyn (打开新窗口)

# 说明

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

# 示例

dyn ./hello.px4mod start

# 使用方法

dyn [arguments...] <file> 包含模块的文件 [arguments...] 模块的参数

# 失败

资料来源 systemcmds/failure (打开新窗口)

# 说明

将故障注入系统。

# 实施情况

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

# 实例

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

故障 GPS 关闭

# 使用方法

失败 [参数...] 帮助 显示此帮助文本 gps|...指定组件 ok|off|...指定故障类型 [-i <val>] 传感器实例(0=全部) 默认值:0

# gpio

资料来源 systemcmds/gpio (打开新窗口)

# 说明

该命令用于读写 GPIO

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

# 实例

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

gpio 读 H4 PULLUP

1 OK

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

gpio write E7 1 --force

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

gpio 写 /dev/gpin1 1

# 使用方法

gpio [arguments...读 <PORT><PIN>/<DEVICE> GPIO 端口和引脚或设备 [PULLDOWN|PULLUP] 下拉/上拉 [--force] 强制(忽略板上的 gpio 列表) 写 <PORT><PIN> GPIO 端口和引脚 <VALUE> 要写入的值 [PUSHPULL|OPENDRAIN] 下拉/上拉 [--force] 强制(忽略板上的 gpio 列表)

# 硬故障日志

资料来源 systemcmds/hardfault_log (打开新窗口)

硬故障实用程序

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

# 使用方法

hardfault_log <command> [arguments...] 命令: check 检查是否有未提交的硬故障 rearm 删除未提交的硬故障 fault 生成硬故障(此命令会导致系统崩溃:) [0|1] 硬故障类型:0= 除以 0,1= 断言(默认值=0) commit 将未提交的硬故障写入 /fs/microsd/fault_%i.txt(并重新上膛,但不重置) count 读取重启计数器,计算未提交的硬故障的重启次数(作为程序的退出代码返回) reset 重置重启计数器

# 历史

资料来源 systemcmds/hist (打开新窗口)

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

# 使用方法

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

# i2cdetect

资料来源 systemcmds/i2cdetect (打开新窗口)

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

# 使用方法

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

# led_control

资料来源 systemcmds/led_control (打开新窗口)

# 说明

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

要使用它,必须确保有一个处理 led_control uorb 主题的驱动程序在运行。

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

# 实例

第一个 LED 蓝色闪烁 5 次:

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

# 使用方法

led_control <command> [arguments...命令: test 运行测试模式 on 打开 LED off 关闭 LED reset 重置 LED 优先级 blink 闪烁 LED N 次 [-n <val>] 闪烁次数默认值:3 [-s <val>] 设置闪烁速度值:快速|正常|慢速,默认值:正常 breathe 持续淡入淡出闪烁两次快速闪烁,然后熄灭,频率为 1Hz 除 "test "外,以下参数适用于上述所有命令:[-c <val>] 颜色值:红色|蓝色|绿色|黄色|紫色|琥珀色|青色|白色,默认值:白色 [-l <val>] 控制哪个 LED:0、1、2......(默认值=全部) [-p <val>] 优先级 默认值:2

# 听众

资料来源 systemcmds/topic_listener (打开新窗口)

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

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

# 使用方法

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

# mfd

资料来源 systemcmds/mft (打开新窗口)

实用程序与清单互动

# 使用方法

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

# mtd

资料来源 systemcmds/mtd (打开新窗口)

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

# 使用方法

mtd <命令> [参数...] 命令: status 打印状态信息 readtest 执行读取测试 rwtest 执行读写测试 erase 擦除分区 命令 "readtest "和 "rwtest "有一个可选的实例索引:-i<val>]存储索引(如果电路板有多个存储空间) 默认值:0 "readtest"、"rwtest "和 "erase "命令有一个可选参数: [<partition_name1> [<partition_name2> ...]] 分区名称(例如//partition_name1> [<partition_name2> ...])。分区名称(如 /fs/mtd_params),如果未提供,则使用系统默认值

# nshterm

资料来源 systemcmds/nshterm (打开新窗口)

在指定端口上启动 NSH shell。

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

# 使用方法

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

# 停止

资料来源 systemcmds/param (打开新窗口)

# 说明

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

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

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

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

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

# 实例

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

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

# 使用方法

param <command> [arguments...] 命令:load 从文件加载参数(覆盖所有参数) [<file>] 文件名(如果未给出,则使用默认值) import 从文件导入参数 [<file>] 文件名(如果未给出,则使用默认值) save 将参数保存到文件 [<file>] 文件名(如果未给出,则使用默认值) select 选择默认文件 [<file>;选择默认文件 [<file>] 文件名 select-backup 选择默认文件 [<file>] 文件名 show 显示参数值 [-a] 显示所有参数(不只是使用过的参数) [-c] 仅显示更改的参数(也包括未使用过的参数) [-q] 静音模式,仅打印参数值(名称必须准确) [<filter>] 通过参数名称进行过滤(允许在末尾使用通配符,例如.sys_*) show-for-airframe 显示已更改的机身参数 config status 打印参数状态 system set 将参数设置为值 <param_name> <value>;要设置的参数名和值 [fail] 如果提供,如果找不到参数,则命令失败 set-default 将参数默认设置为值 [-s] 如果提供,如果参数不存在,则无声错误 <param_name> <value> 要设置的参数名和值 [fail] 如果提供,如果找不到参数,则命令失败 compare 比较参数和值。如果相等,则命令成功 [-s] 如果提供,则在参数不存在时无声出错 <param_name> <value> 要比较的参数名和值 greater 比较参数和值。如果参数大于值,命令将成功执行 [-s] 如果提供,如果参数不存在,将出现无声错误 <param_name> <value> 要比较的参数名和值 <param_name> <value> 要比较的参数名和值 touch 将参数标记为已使用 [<param_name1> [<param_name2>]] 参数名(一个或多个参数名称(一个或多个) reset 仅将指定的参数重置为默认值 [<param1> [<param2>]] 重置的参数名称(一个或多个要重置的参数名(允许在末尾使用通配符) reset_all 将所有参数重置为默认值 [<exclude1> [<exclude2>]] 不重置匹配的参数(允许在末尾使用通配符)。不重置匹配的参数(允许使用末尾的通配符 index 显示给定索引的参数 <index> 索引:整数 >= 0 index_used 显示给定索引的已用参数 <index> 索引:整数 >= 0 find 显示参数的索引 <param> 参数名

# 有效载荷发送器

资料来源 modules/payload_deliverer (打开新窗口)

# 说明

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

# 使用方法

payload_deliverer <命令> [参数...] 命令: start gripper_test 测试抓取器的释放&抓取顺序 gripper_open 打开抓取器 gripper_close 关闭抓取器 stop status 打印状态信息

# 敷衍

资料来源 systemcmds/perf (打开新窗口)

打印性能计数器的工具

# 使用方法

reset 重置所有计数器 latency 打印 HRT 定时器延迟直方图 如果未给出参数,则打印所有性能计数器

# 重新启动

资料来源 systemcmds/reboot (打开新窗口)

重启系统

# 使用方法

重启 [参数...] [-b] 重启到引导加载程序 [lock|unlock] 获取/释放关机锁(用于测试)

# sd_bench

资料来源 systemcmds/sd_bench (打开新窗口)

测试 SD 卡的速度

# 使用方法

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

# sd_stress

资料来源 systemcmds/sd_stress (打开新窗口)

测试在 SD 卡上的操作

# 使用方法

sd_stress [arguments...] [-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 set 1600775044 system_time get

# 使用方法

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

# 顶级

资料来源 systemcmds/top (打开新窗口)

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

# 使用方法

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

# usb_connected

资料来源 systemcmds/usb_connected (打开新窗口)

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

# 使用方法

usb_connected [参数...]

# ......验证

资料来源 systemcmds/ver (打开新窗口)

打印各种版本信息的工具

# 使用方法

ver <command> [arguments...] 命令: hw 硬件架构 mcu MCU 信息 git git 版本信息 bdate 生成日期和时间 gcc 编译器信息 bdate 生成日期和时间 px4guid PX4 GUID uri 生成 URI all 打印所有版本 hwcmp 比较硬件版本(匹配时返回 0) <hw> [<hw2>] 要与之比较的硬件(例如 PX4_FMU_V4)。如果指定多个,则使用 OR 比较 hwtypecmp 比较硬件类型(匹配时返回 0) <hwtype> [<hwtype2>] 要与之比较的硬件类型(例如 V2)。如果指定多个,则使用 OR 比较