Files
2026-11-12 13:02:03 +00:00

2.1 KiB

Modules Reference: Simulation

::: info This page is auto-generated from the source code using the build command: make module_documentation. Do not edit it directly; fix the module documentation in the PX4-Autopilot source instead. :::

simulator_sih

Source: 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 <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