Engee documentation

Getting started

Preparation

To fully start working with the KPM "RHYTHM" blocks and with the software control for KPM "RHYTHM" in Engee, install RITM KPM Support Package by doing the following command in script editor interactive script icon or command line img 41 1 2:

engee.package.install("RITM-Engee-Blocks")

After installing the support package for the blocks RITM, you can use other commands as well engee.package, namely:

  • engee.packages.checkupdates() — checks the available updates of the installed support package;

  • engee.packages.update("RITM-Engee-Blocks") — updates the specified support package to the latest version;

  • engee.packages.uninstall("RITM-Engee-Blocks) — deletes the specified support package.

For a detailed description of the functions, see feature/engee-package-functions.adoc#engee.package.install.

To start working with KPM RITM, go to the Engee applications engee apps in the workspace and select RITM.Manager:

  • Add the machine to Engee using Main MenuChoose machineAdd the machine. In the menu that opens, enter the name and IP address of the machine:

    ritm add machine 2 enritm add machine en

  • Update the firmware by clicking ritm updater and using Firmware updateLocal update or Online Update:

    ritm package update en

  • After updating the firmware, install the Engee support package on RHYTHM by clicking again ritm updater and using Support package updateSupport package updateLocal update or Online Update:

    ritm updater 1 en

  • After successfully updating the firmware and support package to the latest version, the icon Update firmware will change the view from ritm updater on ritm updater x.

After each firmware update ritm updater it is necessary to reinstall the support package on the RHYTHM.

The general architecture of the interaction between the firmware, the RHYTHM support package and Engee looks like this:

ritm packages main en

On the diagram:

  • The RHYTHM Support Package is an extension for the subsystem Engee.Integrations, adding library blocks Engee for working with I/O modules on the KPM "RHYTHM", as well as the following features software rhythm control from Engee.

  • Firmware is the software framework of KPM "RHYTHM", which includes the RHYTHM operating system.RV, as well as drivers and libraries for working with I/O modules.

  • The Engee Support Package is an extension of the RHYTHM firmware that adds features launching Engee models on KPM "RHYTHM".

An example of a simple model

This example shows how to create an Engee model from scratch and run it on KPM RITM.

  • Create a new model and add standard blocks to the model Sine Wave, Integrator and Out1 and connect them. Turn it on signal recording signal logging 1 to exit the block Integrator:

    ritm getstarted model en

  • Select "RHYTHM" as the target platform from the drop-down menu in the Main Menu of the model:

    ritm manager choosing

  • Set an infinite simulation time (inf) and press the button Run the model on hardware:

    ritm getstarted run

  • A real-time application is created from the model, which is downloaded and launched on the selected machine.:

    ritm getstarted running en

  • You can stop the execution of the RHYTHM model by pressing Stop the model stop button in the simulation control menu. The simulation time and status are displayed in the Status bar of the model (lower right corner of the workspace):

    ritm getstarted status en

  • During execution, you can monitor the recorded signals using visualization windows graphs icon 1. Also, during execution, you can change the configurable parameters of the model on the fly and see the changes. For example, you can change the amplitude of the sine wave (block Sine Wave) with 1 on 2 and observe the changes on the charts:

    ritm getstarted sine en

    ritm getstarted plots en