Engee documentation

Arduino Support Package

Page in progress.

Target Hardware is a mode in which the Engee model is executed on the connected (target) hardware instead of the Engee mathematical core.

To work with Arduino-compatible boards in this mode, the EDM-Target-Arduino block is used, which adjusts the interaction with the equipment through three main parameters:

  • Port — COM port of the target device;

  • Path to ArduinoCLI — full path to the toolchain executable file arduino-cli[.exe];

  • Model Directory — a directory for storing the source code of models relative to the client program Engee.Integration.

Before starting work, you must install arduino-cli is a toolchain for compiling and firmware of Arduino equipment. After installation, copy the full path to the executable file arduino-cli[.exe] and specify it in the corresponding parameter of the EDM-Target-Arduino block.

Preparation

  1. Install the subsystem Engee.Integrations:

    engee.package.install("Engee-Device-Manager")

    If the subsystem is Engee.Integration has already been installed, then just run it with the command:

    engee.package.start("Engee-Device-Manager")
  2. Launch the Engee client program.Integration on your computer to which Arduino equipment is connected, and connect using the URL provided (for more information, see Hardware connection).

Setting up and launching the model

  1. Open the Engee model.

  2. Click on the target platform selection button and select Target Hardware:

    target hardware 1

  3. Add the EDM-Target-Arduino block from block libraries on canvas Engee. If the block is missing from the library, update the main support package Engee.Integration by team engee.package.start:

    arduino model engee hardware

  4. Select the model execution mode:

    • Run the model on hardware target hardware 4 — Interactive execution on the target platform with control and supervision from Engee.

    • Run in independent mode target hardware 3 — offline execution on the target platform without control from Engee.

  5. Click Run the model on hardware or Run in independent mode (for offline launch).

If the EDM-Target-Arduino block is not placed in the model, an error will be displayed at startup:

ErrorException("EDM-Target-Arduino block not found. To start model in Target Hardware mode, the model must include an EDM-Target-Arduino block.")

Execution modes

The behavior of Target Hardware modes is similar to the model execution modes on the RITM CPM (for more information, see the article Model execution modes).

Mode "Run the model on hardware»

How to launch

click "Run the model on hardware target hardware 4»:

ritm interactive

How to manage the model

You can start/stop/set the simulation time and compile the model.

What happens

An interactive real-time application is generated and launched on the target hardware. You can track the execution of the model in Engee, in the window signal visualizations graphs icon 1 and in data inspector data inspector icon.

What you can do in the mode

manage the model, change parameters on the fly, record signals and view them.

Mode "Run in independent mode»

How to launch

click "Run in independent mode» target hardware 3:

target hardware 5

How to manage the model

by means of a specific platform (web panel, utilities, etc.).

What happens

an offline real-time application is generated and launched on the target platform regardless of Engee. The execution of the model is visible on the display/web panel/logs of the target platform.

What you can do in the mode

the model functions on the target platform outside of Engee.