Документация Engee

Engee.Интеграции

Интеграция Engee с оборудованием обеспечивается подсистемой Engee.Интеграции, которая подключает Engee к внешним устройствам, интерфейсам, протоколам и программным средам. Поддержка реализуется через пакеты поддержки конкретного оборудования (например, VISA, Arduino, РИТМ и т.д.), включая модули ввода-вывода (подключенные к компьютеру) и встраиваемые системы. Внешнее оборудование и протоколы физически работают на компьютере пользователя, но становятся доступны напрямую в Engee именно через подсистему Engee.Интеграции.


Engee работает в браузере и, как следствие, не имеет прямого доступа к физическим портам компьютера. Ограничение доступа браузера к низкоуровневым интерфейсам операционной системы не позволяет просто подключить оборудование и сразу начать работу. Для решения этой задачи используется следующая архитектура взаимодействия:

engee hardware ru

На схеме показано, что Engee обменивается данными с клиентской программой Engee.Интеграции, установленной на компьютере пользователя; эта программа работает с физическими интерфейсами системы (COM-портами, USB и т.д.) и передает команды/данные подключенному оборудованию. При этом для организации сетевого взаимодействия между Engee и клиентской программой используется сервер на стороне Engee.

Перед началом работы необходимо запустить клиентскую программу Engee.Интеграции на компьютере, к которому подключено оборудование. Браузер с Engee можно открыть как на этом же компьютере, так и на любом другом устройстве в сети. Это позволяет создавать «виртуальные лаборатории» и дает возможность нескольким пользователям подключаться к одному и тому же компьютеру, работая с оборудованием напрямую через Engee.

Подключение к оборудованию

На базе Engee.Интеграции создаются различные пакеты поддержки оборудования. Сначала установите основной пакет поддержки Engee.Интеграции, универсальный для любого оборудования и подключитесь к клиентской программе.

Чтобы начать работу с подсистемой Engee.Интеграции, установите основной пакет поддержки, выполнив команду engee.package.install в командной строке img 41 1 2:

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

Если основной пакет поддержки распространяется в виде zip-архива, то путь к нему необходимо указывать как именованный аргумент zip_path. Например, если архив называется edmv2.4.zip и находится в папке distr, то используйте команду:

engee.package.install("Engee-Device-Manager", zip_path="/distr/edmv2.4.zip")

После успешной установки, в командной строке отобразится сообщение:

engee working hardware 2

В этом сообщении будет предоставлен URL для подключения через клиентскую программу Engee.Интеграции. Также будут предложены ссылки для загрузки архивов с этими клиентскими программами. Выберите нужный архив в зависимости от вашей операционной системы (Windows/Linux):

engee working hardware 3

Скачайте архив на ваш компьютер, распакуйте его и запустите клиентскую программу Engee.Интеграции.

Антивирус может заблокировать установку или запуск клиентской программы Engee.Интеграции. Если при установке или запуске появляются предупреждения системы безопасности, то временно отключите защиту в реальном времени.

Например, для отключения антивируса «Безопасность Windows» следуйте инструкции:

Пошаговая инструкция
  1. Откройте поиск windows search и введите «Безопасность Windows»:

    disable defender step1

  2. Выберите «Защита от вирусов и угроз»:

    disable defender step2

  3. Нажмите «Управление настройками» в разделе «Параметры защиты от вирусов и других угроз»:

    disable defender step3

  4. Переключите тумблер «Защита в реальном времени» в положение «Выкл.» (при появлении запроса контроля учетных записей нажмите «Да»).

    disable defender step4

  5. После установки и первого запуска клиентской программы переключите тумблер обратно в положение «Вкл.».

После запуска клиентской программы Engee.Интеграции откроется окно с полем для ввода URL из сообщения:

engee host access

Далее скопируйте URL из сообщения в командной строке (текст после Ссылка для подключения:), вставьте его в клиентскую программу Engee.Интеграции и нажмите кнопку «Подключиться». Статус подключения должен смениться на «Подключен»:

engee host access 1

После успешного подключения можно загрузить примеры моделей, которые помогут разобраться в работе с оборудованием. Для этого в командной строке Engee выполните команду:

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

Отлично — подсистема Engee.Интеграции установлена и готова к работе!

После перезапуска клиента Engee не нужно заново устанавливать подсистему Engee.Интеграции — достаточно повторно запустить ее серверную программу с помощью команды:

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

Встраиваемые системы

Работа со спецификацией VISA

После установки пакета поддержки работы с оборудованием, а также подключения через клиентскую программу, в системе становится доступна работа со спецификацией VISA.

VISA (Virtual Instrument Software Architecture) — это спецификация, разработанная для унификации взаимодействия с измерительными приборами. VISA предоставляет абстракцию для общения с различными типами оборудования, такими как USB, Ethernet, GPIB и другими интерфейсами. Благодаря клиентской программе, Engee получает доступ к этим приборам посредством сервера, что позволяет работать с ними из Engee с помощью Julia.

Работа с VISA в Engee позволяет:

  • Получать список доступных приборов;

  • Управлять доступными приборами — открывать сессии, отправлять команды, считывать ответы;

  • Работать с бинарными данными и I/O-буферами.

Подробнее о работе со спецификацией VISA см. в статье Работа с внешним оборудованием через VISA в Engee.

Работа с КПМ «РИТМ»

Пакет поддержки КПМ «РИТМ» устанавливается отдельно поверх подсистемы Engee.Интеграции:

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

КПМ «РИТМ» — это аппаратное решение для работы с моделями в реальном времени, предоставляющее возможность интеграции и управления процессами на реальном оборудовании. С помощью пакета поддержки КПМ «РИТМ», Engee получает доступ к системе РИТМ и может работать с ней напрямую, используя язык программирования Julia.

Работа с КПМ «РИТМ» в Engee позволяет:

  • Загружать и запускать модели на машине РИТМ;

  • Генерировать Си обвязку для моделей;

  • Компилировать и запускать модели в различных режимах (независимый или интерактивный);

  • Проверять доступность устройства и работать с файлами на РИТМ;

  • Получать информацию о потребляемой памяти моделью и выводить логи выполнения.

Подробнее о работе с КПМ «РИТМ» см. в статье Работа с внешним оборудованием через РИТМ в Engee.

Программное управление

Для использования функций программного управления VISA и РИТМ требуется установить пакет для работы с оборудованием:

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

Подробнее о функциях читайте в статьях Программное управление VISA и Программное управление РИТМ.