Пакет поддержки Arduino

Target Hardware — это режим, в котором модель Engee выполняется на подключенном (целевом) оборудовании вместо математического ядра Engee.

Для работы с Arduino-совместимыми платами в данном режиме используется блок EDM-Target-Arduino, настраивающий взаимодействие с оборудованием через четыре основных параметра:

Порт — COM-порт целевого устройства.

Может принимать значение <auto> — при таком режиме порт ищется автоматически среди доступных COM-портов. Если найден единственный порт — он и будет использоваться, иначе необходимо указать явно.
Полное имя платы — имя платы, служащее уникальным идентификатором в формате VENDOR:ARCHITECTURE:BOARD_ID (например, arduino:avr:mega).

Может принимать значение <auto> — при таком режиме имя платы определяется автоматически из информации о COM-портах. Если найден единственный порт, опознанный как устройство Arduino, то будет использовано его полное имя, иначе необходимо указать явно.
Путь к ArduinoCLI — полный путь до исполняемого файла тулчейна arduino-cli[.exe].

Может принимать значение <auto> — тулчейн будет искаться автоматически среди:
- Путей, добавленных в переменную окружения PATH;
- Текущей директории клиентской программы;
- В C:\Program Files\;
- В C:\Program Files (x86)\.
  
  Перечисленные пути проверяются в порядке убывания приоритета поиска.
Директория моделей — директория хранения исходного кода моделей относительно клиентской программы Engee.Интеграции.

Перед началом работы необходимо установить arduino-cli — тулчейн для компиляции и прошивки Arduino-оборудования. После установки скопируйте полный путь до исполняемого файла arduino-cli[.exe] и укажите его в соответствующем параметре блока EDM-Target-Arduino.

Для работы с Arduino-совместимыми клонами может понадобиться установка дополнительного драйвера. Например, для платы-клона Arduino Mega 2560 под Windows требуется драйвер CH340.

Подготовка

Установите подсистему Engee.Интеграции:
```
engee.package.install("Engee-Device-Manager")
```
Если подсистема Engee.Интеграции уже была установлена, то просто запустите ее командой:
```
engee.package.start("Engee-Device-Manager")
```
Запустите клиентскую программу Engee.Интеграции на своем компьютере, к которому подключено оборудование Arduino, и подключитесь по выданному URL (подробнее см. Подключение к оборудованию).

Настройка и запуск модели

Откройте модель Engee.
Нажмите по кнопке выбора целевой платформы и выберите Target Hardware:
Добавьте блок EDM-Target-Arduino из библиотеки блоков на холст Engee. Если блок отсутствует в библиотеке — обновите основной пакет поддержки Engee.Интеграции командой engee.package.start:
Выберите режим выполнения модели:
- Запустить модель на железе — интерактивное выполнение на целевой платформе с управлением и наблюдением из Engee.
- Запуск в независимом режиме — автономное выполнение на целевой платформе без управления из Engee.
Нажмите Запустить модель на железе или Запуск в независимом режиме (для автономного запуска).

Если блок EDM-Target-Arduino не помещен в модель, то при запуске выведется ошибка:

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

Режимы выполнения

Поведение режимов Target Hardware аналогично режимам выполнения моделей на КПМ «РИТМ» (подробнее см. в статье Режимы выполнения модели).

Режим «Запустить модель на железе»

Как запустить	нажмите «Запустить модель на железе »:
Как управлять моделью	можно запускать/останавливать/задавать время симуляции и компилировать модель.
Что происходит	генерируется интерактивное приложение реального времени и запускается на целевом оборудовании. Отслеживать выполнение модели можно в Engee, в окне визуализации сигналов и в инспекторе данных .
Что можно делать в режиме	управлять моделью, менять параметры «на лету», записывать сигналы и просматривать их.

Режим «Запуск в независимом режиме»

Как запустить	нажмите «Запуск в независимом режиме» :
Как управлять моделью	средствами конкретной платформы (веб-панель, утилиты и т.п.).
Что происходит	генерируется автономное приложение реального времени и запускается на целевой платформе независимо от Engee. Информация о сборке и загрузке модели видна в окне диагностики .
Что можно делать в режиме	модель функционирует на целевой платформе вне Engee.