mirror of
https://github.com/PX4/PX4-Autopilot.git
synced 2026-11-22 14:19:57 +08:00
69 lines
2.1 KiB
Markdown
69 lines
2.1 KiB
Markdown
# Modules Reference: Simulation
|
|
|
|
::: info
|
|
**This page is [auto-generated](https://github.com/PX4/PX4-Autopilot/blob/main/Tools/px4moduledoc/markdownout.py) from the source code** using the build command: `make module_documentation`.
|
|
Do not edit it directly; fix the module documentation in the [PX4-Autopilot](https://github.com/PX4/PX4-Autopilot) source instead.
|
|
:::
|
|
|
|
## simulator_sih
|
|
|
|
Source: [modules/simulation/simulator_sih](https://github.com/PX4/PX4-Autopilot/tree/main/src/modules/simulation/simulator_sih)
|
|
|
|
### Description
|
|
|
|
This module provides a simulator for quadrotors and fixed-wings running fully
|
|
inside the hardware autopilot.
|
|
|
|
This simulator subscribes to "actuator_outputs" which are the actuator pwm
|
|
signals given by the control allocation module.
|
|
|
|
This simulator publishes the sensors signals corrupted with realistic noise
|
|
in order to incorporate the state estimator in the loop.
|
|
|
|
### Implementation
|
|
|
|
The simulator implements the equations of motion using matrix algebra.
|
|
Quaternion representation is used for the attitude.
|
|
Forward Euler is used for integration.
|
|
Most of the variables are declared global in the .hpp file to avoid stack overflow.
|
|
|
|
### Examples
|
|
|
|
Pose the vehicle on the ground for accel and mag calibration (SITL only), sides named as the calibration names them.
|
|
With `rotate` it turns about the vertical with a tilt swing, as the mag calibration asks for:
|
|
|
|
```
|
|
simulator_sih orient left rotate
|
|
```
|
|
|
|
Each side in turn: 10 s still, then 10 s rotating, then level. This completes either calibration.
|
|
|
|
```
|
|
simulator_sih orient all
|
|
```
|
|
|
|
Level the vehicle and resume the flight dynamics:
|
|
|
|
```
|
|
simulator_sih orient off
|
|
```
|
|
|
|
### Usage {#simulator_sih_usage}
|
|
|
|
```
|
|
simulator_sih <command> [arguments...]
|
|
Commands:
|
|
start
|
|
[-t <val>] Terrain elevation GeoTIFF (DEM), SITL only
|
|
values: <file>
|
|
|
|
orient Pose the vehicle on the ground for calibration
|
|
down|up|front|back|left|right|all|off Side facing down, every side in turn,
|
|
or level
|
|
[rotate] Rotate about the vertical
|
|
|
|
stop
|
|
|
|
status print status info
|
|
```
|