Engee documentation

Ardupilot Support Package

The Ardupilot support package provides cosimulation Engee with Ardupilot autopilot in SITLfootnote mode:[Ardupilot SITL (Software In The Loop) — a simulator that allows you to run the Ardupilot autopilot firmware directly on a personal computer without using any hardware flight control board.]: model Engee calculates the physics of the device, and Ardupilot calculates the control logic, and both sides synchronously exchange data over UDP.

The Ardupilot support package includes a library of blocks Ardupilot and program control functions. The package uses a client program Engee.Integrations. Autopilot telemetry (MAVLink messages) can be received in parallel using the support package MAVLink.

Requirements

  • Ardupilot SITL, launched in a mode where the physical parameters of the simulation are calculated by an external source. In this mode, SITL does not calculate the physics of the device itself: it exchanges with Engee frames over the UDP protocol on the port 9002 — sends PWM frames of motor control and receives a JSON frame in response. [1] with virtual sensor data. For more information about the protocol, see the Ardupilot documentation: Simulation JSON interface, implementation examples are available in the Ardupilot repository (JSON backend examples).

  • A ready-made infrastructure for running a simulation (Docker container) is included in the examples of the support package — see the article ArduPilot SITL: infrastructure for running cosimulation.

  • The calculation step of the model corresponding to the frequency of the autopilot cycle.

Quick start

  1. Install or update the Engee subsystem.Integration as shown in article.

  2. Start Ardupilot SITL in the mode of calculating the physical parameters of the simulation from Engee (for example, the container from the support package examples, see ArduPilot SITL: infrastructure for running cosimulation).

  3. Now you can use block library and software control functions Ardupilot.


1. JSON frame - virtual sensor data (position, orientation, speeds) serialized in JSON.