Engee documentation

Arduino Support Package

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

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

  • Port is the COM port of the target device.

    Can take the value <auto> — in this mode, the port is automatically searched among the available COM ports. If a single port is found, it will be used, otherwise you must specify it explicitly.

  • Full name of the board is the name of the board, which serves as a unique identifier in the format VENDOR:ARCHITECTURE:BOARD_ID (for example, arduino:avr:mega).

    Can take the value <auto> — in this mode, the name of the card is determined automatically from the information about the COM ports. If a single port is found that is identified as an Arduino device, its full name will be used, otherwise it must be specified explicitly.

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

    Can take the value <auto> — the tulchain will be searched automatically among:

    • Paths added to the environment variable PATH;

    • The current directory of the client program;

    • In C:\Program Files\;

    • In C:\Program Files (x86)\.

      The listed paths are checked in descending order of search priority.

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

Before starting work, you must install arduino-cli is a toolchain for compiling and firmware of Arduino hardware. 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.

To work with Arduino-compatible clones, you may need to install an additional driver. For example, the Arduino Mega 2560 clone board for Windows requires a CH340 driver.

Preparation

Make sure that the hardware support package is installed and configured. Its installation is described in detail in the section Hardware connection.

If the support package is already installed, then you can proceed to launch the client program and connect using the provided URL.

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 the Engee canvas. If the block is missing from the library, update the basic *Engee support package.Integration by the * 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 management 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

For more information about the operating modes of Target Hardware, see the article Running models on target hardware.

  1. Model execution modes

  2. Model Settings

  3. Engee.Integrations

  4. EDM-Target-Arduino