mirror of
https://gitee.com/mirrors_PX4/PX4-Autopilot.git
synced 2026-04-14 10:07:39 +08:00
1124 lines
29 KiB
Markdown
1124 lines
29 KiB
Markdown
# 모듈 참조: 시스템
|
|
|
|
## battery_simulator
|
|
|
|
Source: [modules/simulation/battery_simulator](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/simulation/battery_simulator)
|
|
|
|
### 설명
|
|
|
|
### Usage {#battery_simulator_usage}
|
|
|
|
```
|
|
battery_simulator <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## battery_status
|
|
|
|
Source: [modules/battery_status](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/battery_status)
|
|
|
|
### 설명
|
|
|
|
The provided functionality includes:
|
|
|
|
- Read the output from the ADC driver (via ioctl interface) and publish `battery_status`.
|
|
|
|
### 구현
|
|
|
|
It runs in its own thread and polls on the currently selected gyro topic.
|
|
|
|
### Usage {#battery_status_usage}
|
|
|
|
```
|
|
battery_status <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## camera_feedback
|
|
|
|
Source: [modules/camera_feedback](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/camera_feedback)
|
|
|
|
### 설명
|
|
|
|
The camera_feedback module publishes `CameraCapture` UORB topics when image capture has been triggered.
|
|
|
|
If camera capture is enabled, then trigger information from the camera capture pin is published;
|
|
otherwise trigger information at the point the camera was commanded to trigger is published
|
|
(from the `camera_trigger` module).
|
|
|
|
The `CAMERA_IMAGE_CAPTURED` message is then emitted (by streaming code) following `CameraCapture` updates.
|
|
`CameraCapture` topics are also logged and can be used for geotagging.
|
|
|
|
### 구현
|
|
|
|
`CameraTrigger` topics are published by the `camera_trigger` module (`feedback` field set `false`)
|
|
when image capture is triggered, and may also be published by the `camera_capture` driver
|
|
(with `feedback` field set `true`) if the camera capture pin is activated.
|
|
|
|
The `camera_feedback` module subscribes to `CameraTrigger`.
|
|
It discards topics from the `camera_trigger` module if camera capture is enabled.
|
|
For the topics that are not discarded it creates a `CameraCapture` topic with the timestamp information
|
|
from the `CameraTrigger` and position information from the vehicle.
|
|
|
|
### Usage {#camera_feedback_usage}
|
|
|
|
```
|
|
camera_feedback <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## cdcacm_autostart
|
|
|
|
Source: [drivers/cdcacm_autostart](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/cdcacm_autostart)
|
|
|
|
### 설명
|
|
|
|
This module listens on USB and auto-configures the protocol depending on the bytes received.
|
|
The supported protocols are: MAVLink, nsh, and ublox serial passthrough. If the parameter SYS_USB_AUTO=2
|
|
the module will only try to start mavlink as long as the USB VBUS is detected. Otherwise it will spin
|
|
and continue to check for VBUS and start mavlink once it is detected.
|
|
|
|
### Usage {#cdcacm_autostart_usage}
|
|
|
|
```
|
|
cdcacm_autostart <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## commander
|
|
|
|
Source: [modules/commander](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/commander)
|
|
|
|
### 설명
|
|
|
|
The commander module contains the state machine for mode switching and failsafe behavior.
|
|
|
|
### Usage {#commander_usage}
|
|
|
|
```
|
|
commander <command> [arguments...]
|
|
Commands:
|
|
start
|
|
[-h] Enable HIL mode
|
|
|
|
calibrate Run sensor calibration
|
|
mag|baro|accel|gyro|level|esc|airspeed Calibration type
|
|
quick Quick calibration [mag, accel (not recommended)]
|
|
|
|
check Run preflight checks
|
|
|
|
safety Change prearm safety state
|
|
on|off [on] to activate safety, [off] to deactivate safety and allow
|
|
control surface movements
|
|
|
|
arm
|
|
[-f] Force arming (do not run preflight checks)
|
|
|
|
disarm
|
|
[-f] Force disarming (disarm in air)
|
|
|
|
takeoff
|
|
|
|
land
|
|
|
|
transition VTOL transition
|
|
|
|
mode Change flight mode
|
|
manual|acro|offboard|stabilized|altctl|posctl|altitude_cruise|position:slow
|
|
|auto:mission|auto:loiter|auto:rtl|auto:takeoff|auto:land|auto:
|
|
precland|ext1 Flight mode
|
|
|
|
pair
|
|
|
|
termination
|
|
on|off Turn lockdown on or off
|
|
|
|
set_ekf_origin
|
|
lat, lon, alt Origin Latitude, Longitude, Altitude
|
|
|
|
lat|lon|alt Origin latitude longitude altitude
|
|
|
|
set_heading Set current heading
|
|
heading degrees from True North [0 360]
|
|
|
|
poweroff Power off board (if supported)
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## dataman
|
|
|
|
Source: [modules/dataman](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/dataman)
|
|
|
|
### 설명
|
|
|
|
Module to provide persistent storage for the rest of the system in form of a simple database through a C API.
|
|
Multiple backends are supported depending on the board:
|
|
|
|
- a file (eg. on the SD card)
|
|
- RAM (this is obviously not persistent)
|
|
|
|
It is used to store structured data of different types: mission waypoints, mission state and geofence polygons.
|
|
Each type has a specific type and a fixed maximum amount of storage items, so that fast random access is possible.
|
|
|
|
### 구현
|
|
|
|
Reading and writing a single item is always atomic.
|
|
|
|
### Usage {#dataman_usage}
|
|
|
|
```
|
|
dataman <command> [arguments...]
|
|
Commands:
|
|
start
|
|
[-f <val>] Storage file
|
|
values: <file>
|
|
[-r] Use RAM backend (NOT persistent)
|
|
|
|
The options -f and -r are mutually exclusive. If nothing is specified, a file
|
|
'dataman' is used
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## dmesg
|
|
|
|
Source: [systemcmds/dmesg](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/dmesg)
|
|
|
|
### 설명
|
|
|
|
Command-line tool to show bootup console messages.
|
|
Note that output from NuttX's work queues and syslog are not captured.
|
|
|
|
### 예
|
|
|
|
Keep printing all messages in the background:
|
|
|
|
```
|
|
dmesg -f &
|
|
```
|
|
|
|
### Usage {#dmesg_usage}
|
|
|
|
```
|
|
dmesg <command> [arguments...]
|
|
Commands:
|
|
[-f] Follow: wait for new messages
|
|
```
|
|
|
|
## esc_battery
|
|
|
|
Source: [modules/esc_battery](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/esc_battery)
|
|
|
|
### 설명
|
|
|
|
This implements using information from the ESC status and publish it as battery status.
|
|
|
|
### Usage {#esc_battery_usage}
|
|
|
|
```
|
|
esc_battery <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## gyro_calibration
|
|
|
|
Source: [modules/gyro_calibration](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/gyro_calibration)
|
|
|
|
### 설명
|
|
|
|
Simple online gyroscope calibration.
|
|
|
|
### Usage {#gyro_calibration_usage}
|
|
|
|
```
|
|
gyro_calibration <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## gyro_fft
|
|
|
|
Source: [modules/gyro_fft](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/gyro_fft)
|
|
|
|
### 설명
|
|
|
|
### Usage {#gyro_fft_usage}
|
|
|
|
```
|
|
gyro_fft <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## hardfault_stream
|
|
|
|
Source: [modules/hardfault_stream](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/hardfault_stream)
|
|
|
|
### 설명
|
|
|
|
Background process that streams the latest hardfault via MAVLink.
|
|
|
|
The module is especially useful when it is necessary to quickly push a hard fault to the ground station.
|
|
This is useful in cases where the drone experiences a hard fault during flight.
|
|
It ensures that some data is retained in case the permanent storage is destroyed during a crash.
|
|
|
|
To reliably stream, it is necessary to send the STATUSTEXT message via MAVLink at a
|
|
high enough frequency. The recommended frequency is 10 Hz or higher.
|
|
|
|
### Usage {#hardfault_stream_usage}
|
|
|
|
```
|
|
hardfault_stream <command> [arguments...]
|
|
Commands:
|
|
start Start the background task
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## heater
|
|
|
|
Source: [drivers/heater](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/heater)
|
|
|
|
### 설명
|
|
|
|
Background process running periodically on the INS{i} queue to regulate IMU temperature at a setpoint.
|
|
|
|
This task can be started at boot from the startup scripts by setting SENS_EN_THERMAL or via CLI.
|
|
|
|
### Usage {#heater_usage}
|
|
|
|
```
|
|
heater <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## i2c_launcher
|
|
|
|
Source: [systemcmds/i2c_launcher](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/i2c_launcher)
|
|
|
|
### 설명
|
|
|
|
Daemon that starts drivers based on found I2C devices.
|
|
|
|
### Usage {#i2c_launcher_usage}
|
|
|
|
```
|
|
i2c_launcher <command> [arguments...]
|
|
Commands:
|
|
start
|
|
-b <val> Bus number
|
|
-t <val> battery index for calibration values (1 or 3)
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## internal_combustion_engine_control
|
|
|
|
Source: [modules/internal_combustion_engine_control](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/internal_combustion_engine_control)
|
|
|
|
### 설명
|
|
|
|
The module controls internal combustion engine (ICE) features including:
|
|
ignition (on/off), throttle and choke level, starter engine delay, and user request.
|
|
|
|
### Enabling
|
|
|
|
This feature is not enabled by default needs to be configured in the
|
|
build target for your board together with the rpm capture driver:
|
|
|
|
```
|
|
CONFIG_MODULES_INTERNAL_COMBUSTION_ENGINE_CONTROL=y
|
|
CONFIG_DRIVERS_RPM_CAPTURE=y
|
|
```
|
|
|
|
Additionally, to enable the module:
|
|
|
|
- Set [ICE_EN](../advanced_config/parameter_reference.md#ICE_EN)
|
|
to true and adjust the other `ICE_` module parameters according to your needs.
|
|
- Set [RPM_CAP_ENABLE](../advanced_config/parameter_reference.md#RPM_CAP_ENABLE) to true.
|
|
|
|
The module outputs control signals for ignition, throttle, and choke,
|
|
and takes inputs from an RPM sensor.
|
|
These must be mapped to AUX outputs/inputs in the [Actuator configuration](../config/actuators.md),
|
|
similar to the setup shown below.
|
|
|
|

|
|
|
|
### 구현
|
|
|
|
The ICE is implemented with a (4) state machine:
|
|
|
|

|
|
|
|
The state machine:
|
|
|
|
- Checks if [Rpm.msg](../msg_docs/Rpm.md) is updated to know if the engine is running
|
|
- Allows for user inputs from:
|
|
- Manual control AUX
|
|
- Arming state in [VehicleStatus.msg](../msg_docs/VehicleStatus.md)
|
|
- In the state "Stopped" the throttle is set to NAN, which by definition will set the
|
|
throttle output to the disarmed value configured for the specific output.
|
|
|
|
The module publishes [InternalCombustionEngineControl.msg](../msg_docs/InternalCombustionEngineControl.md).
|
|
|
|
The architecture is as shown below:
|
|
|
|

|
|
|
|
<a id="internal_combustion_engine_control_usage"></a>
|
|
|
|
### Usage {#internal_combustion_engine_control_usage}
|
|
|
|
```
|
|
internal_combustion_engine_control <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## land_detector
|
|
|
|
Source: [modules/land_detector](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/land_detector)
|
|
|
|
### 설명
|
|
|
|
Module to detect the freefall and landed state of the vehicle, and publishing the `vehicle_land_detected` topic.
|
|
Each vehicle type (multirotor, fixedwing, vtol, ...) provides its own algorithm, taking into account various
|
|
states, such as commanded thrust, arming state and vehicle motion.
|
|
|
|
### 구현
|
|
|
|
Every type is implemented in its own class with a common base class. The base class maintains a state (landed,
|
|
maybe_landed, ground_contact). Each possible state is implemented in the derived classes. A hysteresis and a fixed
|
|
priority of each internal state determines the actual land_detector state.
|
|
|
|
#### Multicopter Land Detector
|
|
|
|
**ground_contact**: thrust setpoint and velocity in z-direction must be below a defined threshold for time
|
|
GROUND_CONTACT_TRIGGER_TIME_US. When ground_contact is detected, the position controller turns off the thrust setpoint
|
|
in body x and y.
|
|
|
|
**maybe_landed**: it requires ground_contact together with a tighter thrust setpoint threshold and no velocity in the
|
|
horizontal direction. The trigger time is defined by MAYBE_LAND_TRIGGER_TIME. When maybe_landed is detected, the
|
|
position controller sets the thrust setpoint to zero.
|
|
|
|
**landed**: it requires maybe_landed to be true for time LAND_DETECTOR_TRIGGER_TIME_US.
|
|
|
|
The module runs periodically on the HP work queue.
|
|
|
|
### Usage {#land_detector_usage}
|
|
|
|
```
|
|
land_detector <command> [arguments...]
|
|
Commands:
|
|
start Start the background task
|
|
fixedwing|multicopter|vtol|rover|airship Select vehicle type
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## load_mon
|
|
|
|
Source: [modules/load_mon](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/load_mon)
|
|
|
|
### 설명
|
|
|
|
Background process running periodically on the low priority work queue to calculate the CPU load and RAM
|
|
usage and publish the `cpuload` topic.
|
|
|
|
On NuttX it also checks the stack usage of each process and if it falls below 300 bytes, a warning is output,
|
|
which will also appear in the log file.
|
|
|
|
### Usage {#load_mon_usage}
|
|
|
|
```
|
|
load_mon <command> [arguments...]
|
|
Commands:
|
|
start Start the background task
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## logger
|
|
|
|
Source: [modules/logger](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/logger)
|
|
|
|
### 설명
|
|
|
|
System logger which logs a configurable set of uORB topics and system printf messages
|
|
(`PX4_WARN` and `PX4_ERR`) to ULog files. These can be used for system and flight performance evaluation,
|
|
tuning, replay and crash analysis.
|
|
|
|
It supports 2 backends:
|
|
|
|
- Files: write ULog files to the file system (SD card)
|
|
- MAVLink: stream ULog data via MAVLink to a client (the client must support this)
|
|
|
|
Both backends can be enabled and used at the same time.
|
|
|
|
The file backend supports 2 types of log files: full (the normal log) and a mission
|
|
log. The mission log is a reduced ulog file and can be used for example for geotagging or
|
|
vehicle management. It can be enabled and configured via SDLOG_MISSION parameter.
|
|
The normal log is always a superset of the mission log.
|
|
|
|
### 구현
|
|
|
|
The implementation uses two threads:
|
|
|
|
- The main thread, running at a fixed rate (or polling on a topic if started with -p) and checking for
|
|
data updates
|
|
- The writer thread, writing data to the file
|
|
|
|
In between there is a write buffer with configurable size (and another fixed-size buffer for
|
|
the mission log). It should be large to avoid dropouts.
|
|
|
|
### 예
|
|
|
|
Typical usage to start logging immediately:
|
|
|
|
```
|
|
logger start -e -t
|
|
```
|
|
|
|
Or if already running:
|
|
|
|
```
|
|
logger on
|
|
```
|
|
|
|
### Usage {#logger_usage}
|
|
|
|
```
|
|
logger <command> [arguments...]
|
|
Commands:
|
|
start
|
|
[-m <val>] Backend mode
|
|
values: file|mavlink|all, default: all
|
|
[-x] Enable/disable logging via Aux1 RC channel
|
|
[-a] Log 1st armed until shutdown
|
|
[-e] Enable logging right after start until disarm (otherwise only
|
|
when armed)
|
|
[-f] Log until shutdown (implies -e)
|
|
[-t] Use date/time for naming log directories and files
|
|
[-r <val>] Log rate in Hz, 0 means unlimited rate
|
|
default: 280
|
|
[-b <val>] Log buffer size in KiB
|
|
default: 12
|
|
[-p <val>] Poll on a topic instead of running with fixed rate (Log rate
|
|
and topic intervals are ignored if this is set)
|
|
values: <topic_name>
|
|
[-c <val>] Log rate factor (higher is faster)
|
|
default: 1.0
|
|
|
|
on start logging now, override arming (logger must be running)
|
|
|
|
off stop logging now, override arming (logger must be running)
|
|
|
|
trigger_watchdog manually trigger the watchdog now
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## mag_bias_estimator
|
|
|
|
Source: [modules/mag_bias_estimator](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/mag_bias_estimator)
|
|
|
|
### 설명
|
|
|
|
Online magnetometer bias estimator.
|
|
|
|
### Usage {#mag_bias_estimator_usage}
|
|
|
|
```
|
|
mag_bias_estimator <command> [arguments...]
|
|
Commands:
|
|
start Start the background task
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## manual_control
|
|
|
|
Source: [modules/manual_control](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/manual_control)
|
|
|
|
### 설명
|
|
|
|
Module consuming manual_control_inputs publishing one manual_control_setpoint.
|
|
|
|
### Usage {#manual_control_usage}
|
|
|
|
```
|
|
manual_control <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## netman
|
|
|
|
Source: [systemcmds/netman](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/netman)
|
|
|
|
### 설명
|
|
|
|
Network configuration manager saves the network settings in non-volatile
|
|
memory. On boot the `update` option will be run. If a network configuration
|
|
does not exist. The default setting will be saved in non-volatile and the
|
|
system rebooted.
|
|
|
|
#### update
|
|
|
|
`netman update` is run automatically by [a startup script](../concept/system_startup.md#system-startup).
|
|
When run, the `update` option will check for the existence of `net.cfg` in the root of the SD Card.
|
|
It then saves the network settings from `net.cfg` in non-volatile memory,
|
|
deletes the file and reboots the system.
|
|
|
|
#### save
|
|
|
|
The `save` option will save settings from non-volatile memory to a file named
|
|
`net.cfg` on the SD Card filesystem for editing. Use this to edit the settings.
|
|
Save does not immediately apply the network settings; the user must reboot the flight stack.
|
|
By contrast, the `update` command is run by the start-up script, commits the settings to non-volatile memory,
|
|
and reboots the flight controller (which will then use the new settings).
|
|
|
|
#### show
|
|
|
|
The `show` option will display the network settings in `net.cfg` to the console.
|
|
|
|
### 예
|
|
|
|
$ netman save # Save the parameters to the SD card.
|
|
$ netman show # display current settings.
|
|
$ netman update -i eth0 # do an update
|
|
|
|
### Usage {#netman_usage}
|
|
|
|
```
|
|
netman <command> [arguments...]
|
|
Commands:
|
|
show Display the current persistent network settings to the console.
|
|
|
|
update Check SD card for net.cfg and update network persistent network
|
|
settings.
|
|
|
|
save Save the current network parameters to the SD card.
|
|
[-i <val>] Set the interface name
|
|
default: eth0
|
|
```
|
|
|
|
## pwm_input
|
|
|
|
Source: [drivers/pwm_input](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/pwm_input)
|
|
|
|
### 설명
|
|
|
|
Measures the PWM input on AUX5 (or MAIN5) via a timer capture ISR and publishes via the uORB 'pwm_input\` message.
|
|
|
|
### Usage {#pwm_input_usage}
|
|
|
|
```
|
|
pwm_input <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## rc_update
|
|
|
|
Source: [modules/rc_update](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/rc_update)
|
|
|
|
### 설명
|
|
|
|
The rc_update module handles RC channel mapping: read the raw input channels (`input_rc`),
|
|
then apply the calibration, map the RC channels to the configured channels & mode switches
|
|
and then publish as `rc_channels` and `manual_control_input`.
|
|
|
|
### 구현
|
|
|
|
To reduce control latency, the module is scheduled on input_rc publications.
|
|
|
|
### Usage {#rc_update_usage}
|
|
|
|
```
|
|
rc_update <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## replay
|
|
|
|
Source: [modules/replay](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/replay)
|
|
|
|
### 설명
|
|
|
|
This module is used to replay ULog files.
|
|
|
|
There are 2 environment variables used for configuration: `replay`, which must be set to an ULog file name - it's
|
|
the log file to be replayed. The second is the mode, specified via `replay_mode`:
|
|
|
|
- `replay_mode=ekf2`: specific EKF2 replay mode. It can only be used with the ekf2 module, but allows the replay
|
|
to run as fast as possible.
|
|
- Generic otherwise: this can be used to replay any module(s), but the replay will be done with the same speed as the
|
|
log was recorded.
|
|
|
|
The module is typically used together with uORB publisher rules, to specify which messages should be replayed.
|
|
The replay module will just publish all messages that are found in the log. It also applies the parameters from
|
|
the log.
|
|
|
|
The replay procedure is documented on the [System-wide Replay](../debug/system_wide_replay.md)
|
|
page.
|
|
|
|
### Usage {#replay_usage}
|
|
|
|
```
|
|
replay <command> [arguments...]
|
|
Commands:
|
|
start Start replay, using log file from ENV variable 'replay'
|
|
|
|
trystart Same as 'start', but silently exit if no log file given
|
|
|
|
tryapplyparams Try to apply the parameters from the log file
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## send_event
|
|
|
|
Source: [modules/events](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/events)
|
|
|
|
### 설명
|
|
|
|
Background process running periodically on the LP work queue to perform housekeeping tasks.
|
|
It is currently only responsible for tone alarm on RC Loss.
|
|
|
|
The tasks can be started via CLI or uORB topics (vehicle_command from MAVLink, etc.).
|
|
|
|
### Usage {#send_event_usage}
|
|
|
|
```
|
|
send_event <command> [arguments...]
|
|
Commands:
|
|
start Start the background task
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## sensor_agp_sim
|
|
|
|
Source: [modules/simulation/sensor_agp_sim](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/simulation/sensor_agp_sim)
|
|
|
|
### 설명
|
|
|
|
Module to simulate auxiliary global position measurements with optional failure modes for SIH simulation.
|
|
|
|
### Usage {#sensor_agp_sim_usage}
|
|
|
|
```
|
|
sensor_agp_sim <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## sensor_arispeed_sim
|
|
|
|
Source: [modules/simulation/sensor_airspeed_sim](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/simulation/sensor_airspeed_sim)
|
|
|
|
### 설명
|
|
|
|
### Usage {#sensor_arispeed_sim_usage}
|
|
|
|
```
|
|
sensor_arispeed_sim <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## sensor_baro_sim
|
|
|
|
Source: [modules/simulation/sensor_baro_sim](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/simulation/sensor_baro_sim)
|
|
|
|
### 설명
|
|
|
|
### Usage {#sensor_baro_sim_usage}
|
|
|
|
```
|
|
sensor_baro_sim <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## sensor_gps_sim
|
|
|
|
Source: [modules/simulation/sensor_gps_sim](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/simulation/sensor_gps_sim)
|
|
|
|
### 설명
|
|
|
|
### Usage {#sensor_gps_sim_usage}
|
|
|
|
```
|
|
sensor_gps_sim <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## sensor_mag_sim
|
|
|
|
Source: [modules/simulation/sensor_mag_sim](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/simulation/sensor_mag_sim)
|
|
|
|
### 설명
|
|
|
|
### Usage {#sensor_mag_sim_usage}
|
|
|
|
```
|
|
sensor_mag_sim <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## sensors
|
|
|
|
Source: [modules/sensors](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/sensors)
|
|
|
|
### 설명
|
|
|
|
The sensors module is central to the whole system. It takes low-level output from drivers, turns
|
|
it into a more usable form, and publishes it for the rest of the system.
|
|
|
|
The provided functionality includes:
|
|
|
|
- Read the output from the sensor drivers (`SensorGyro`, etc.).
|
|
If there are multiple of the same type, do voting and failover handling.
|
|
Then apply the board rotation and temperature calibration (if enabled). And finally publish the data; one of the
|
|
topics is `SensorCombined`, used by many parts of the system.
|
|
- Make sure the sensor drivers get the updated calibration parameters (scale & offset) when the parameters change or
|
|
on startup. The sensor drivers use the ioctl interface for parameter updates. For this to work properly, the
|
|
sensor drivers must already be running when `sensors` is started.
|
|
- Do sensor consistency checks and publish the `SensorsStatusImu` topic.
|
|
|
|
### 구현
|
|
|
|
It runs in its own thread and polls on the currently selected gyro topic.
|
|
|
|
### Usage {#sensors_usage}
|
|
|
|
```
|
|
sensors <command> [arguments...]
|
|
Commands:
|
|
start
|
|
[-h] Start in HIL mode
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## system_power_simulation
|
|
|
|
Source: [modules/simulation/system_power_simulator](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/simulation/system_power_simulator)
|
|
|
|
### 설명
|
|
|
|
### Usage {#system_power_simulation_usage}
|
|
|
|
```
|
|
system_power_simulation <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## task_watchdog
|
|
|
|
Source: [modules/task_watchdog](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/task_watchdog)
|
|
|
|
### 설명
|
|
|
|
Detects when a higher-priority task starves the system by running too long.
|
|
When starvation is detected, dumps the offending task's registers and stack,
|
|
and saves a cpuload snapshot.
|
|
|
|
### Usage {#task_watchdog_usage}
|
|
|
|
```
|
|
task_watchdog <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
trigger Manually trigger the watchdog
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## tattu_can
|
|
|
|
Source: [drivers/tattu_can](https://github.com/PX4/PX4-Autopilot/tree/main/src/drivers/tattu_can)
|
|
|
|
### 설명
|
|
|
|
Driver for reading data from the Tattu 12S 16000mAh smart battery.
|
|
|
|
### Usage {#tattu_can_usage}
|
|
|
|
```
|
|
tattu_can <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## temperature_compensation
|
|
|
|
Source: [modules/temperature_compensation](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/temperature_compensation)
|
|
|
|
### 설명
|
|
|
|
The temperature compensation module allows all of the gyro(s), accel(s), and baro(s) in the system to be temperature
|
|
compensated. The module monitors the data coming from the sensors and updates the associated sensor_correction topic
|
|
whenever a change in temperature is detected. The module can also be configured to perform the coeffecient calculation
|
|
routine at next boot, which allows the thermal calibration coeffecients to be calculated while the vehicle undergoes
|
|
a temperature cycle.
|
|
|
|
### Usage {#temperature_compensation_usage}
|
|
|
|
```
|
|
temperature_compensation <command> [arguments...]
|
|
Commands:
|
|
start Start the module, which monitors the sensors and updates the
|
|
sensor_correction topic
|
|
|
|
calibrate Run temperature calibration process
|
|
[-a] calibrate the accel
|
|
[-g] calibrate the gyro
|
|
[-m] calibrate the mag
|
|
[-b] calibrate the baro (if none of these is given, all will be
|
|
calibrated)
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## time_persistor
|
|
|
|
Source: [modules/time_persistor](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/time_persistor)
|
|
|
|
### 설명
|
|
|
|
Writes the RTC time cyclically to a file and reloads this value on startup.
|
|
This allows monotonic time on systems that only have a software RTC (that is not battery powered).
|
|
Explicitly setting the time backwards (e.g. via system_time) is still possible.
|
|
|
|
### Usage {#time_persistor_usage}
|
|
|
|
```
|
|
time_persistor <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## tune_control
|
|
|
|
Source: [systemcmds/tune_control](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/tune_control)
|
|
|
|
### 설명
|
|
|
|
Command-line tool to control & test the (external) tunes.
|
|
|
|
Tunes are used to provide audible notification and warnings (e.g. when the system arms, gets position lock, etc.).
|
|
The tool requires that a driver is running that can handle the tune_control uorb topic.
|
|
|
|
Information about the tune format and predefined system tunes can be found here:
|
|
https://github.com/PX4/PX4-Autopilot/blob/main/src/lib/tunes/tune_definition.desc
|
|
|
|
### 예
|
|
|
|
Play system tune #2:
|
|
|
|
```
|
|
tune_control play -t 2
|
|
```
|
|
|
|
### Usage {#tune_control_usage}
|
|
|
|
```
|
|
tune_control <command> [arguments...]
|
|
Commands:
|
|
play Play system tune or single note.
|
|
error Play error tune
|
|
[-t <val>] Play predefined system tune
|
|
default: 1
|
|
[-f <val>] Frequency of note in Hz (0-22kHz)
|
|
[-d <val>] Duration of note in us
|
|
[-s <val>] Volume level (loudness) of the note (0-100)
|
|
default: 40
|
|
[-m <val>] Melody in string form
|
|
values: <string> - e.g. "MFT200e8a8a"
|
|
|
|
libtest Test library
|
|
|
|
stop Stop playback (use for repeated tunes)
|
|
```
|
|
|
|
## uxrce_dds_client
|
|
|
|
Source: [modules/uxrce_dds_client](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/uxrce_dds_client)
|
|
|
|
### 설명
|
|
|
|
UXRCE-DDS Client used to communicate uORB topics with an Agent over serial or UDP.
|
|
|
|
### 예
|
|
|
|
```
|
|
uxrce_dds_client start -t serial -d /dev/ttyS3 -b 921600
|
|
uxrce_dds_client start -t udp -h 127.0.0.1 -p 15555
|
|
```
|
|
|
|
### Usage {#uxrce_dds_client_usage}
|
|
|
|
```
|
|
uxrce_dds_client <command> [arguments...]
|
|
Commands:
|
|
start
|
|
[-t <val>] Transport protocol
|
|
values: serial|udp, default: udp
|
|
[-d <val>] serial device
|
|
values: <file:dev>
|
|
[-b <val>] Baudrate (can also be p:<param_name>)
|
|
default: 0
|
|
[-h <val>] Agent IP. If not provided, defaults to UXRCE_DDS_AG_IP
|
|
values: <IP>
|
|
[-p <val>] Agent listening port. If not provided, defaults to
|
|
UXRCE_DDS_PRT
|
|
[-n <val>] Client DDS namespace. If not provided but UXRCE_DDS_NS_IDX is
|
|
between 0 and 9999 inclusive, then uav_ + UXRCE_DDS_NS_IDX will
|
|
be used
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|
|
|
|
## work_queue
|
|
|
|
Source: [systemcmds/work_queue](https://github.com/PX4/PX4-Autopilot/tree/main/src/systemcmds/work_queue)
|
|
|
|
### 설명
|
|
|
|
Command-line tool to show work queue status.
|
|
|
|
### Usage {#work_queue_usage}
|
|
|
|
```
|
|
work_queue <command> [arguments...]
|
|
Commands:
|
|
start
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|