Engee.Интеграции
Интеграция Engee с оборудованием обеспечивается подсистемой Engee.Интеграции, которая подключает Engee к внешним устройствам, интерфейсам, протоколам и программным средам. Реализация опирается на пакеты поддержки конкретного оборудования (например, VISA, Arduino, РИТМ и т.д.); они охватывают как модули ввода-вывода, подключенные к компьютеру, так и встраиваемые системы. Внешнее оборудование и протоколы физически работают на компьютере пользователя, но становятся доступны напрямую в Engee именно через подсистему Engee.Интеграции.
Engee работает в браузере и, как следствие, не имеет прямого доступа к физическим портам компьютера. Ограничение доступа браузера к низкоуровневым интерфейсам операционной системы не позволяет просто подключить оборудование и сразу начать работу. Для решения этой задачи используется следующая архитектура взаимодействия:
На схеме показано, что Engee обменивается данными с клиентской программой Engee.Интеграции, установленной на компьютере пользователя; эта программа работает с физическими интерфейсами системы (COM-портами, USB и т.д.) и передает команды/данные подключенному оборудованию. При этом для организации сетевого взаимодействия между Engee и клиентской программой используется сервер на стороне Engee.
| Перед началом работы на компьютере с подключенным оборудованием нужно установить клиентскую программу Engee.Интеграции и подключить ее к Engee. Браузер с Engee можно открыть как на этом же компьютере, так и на любом другом устройстве в сети. Это позволяет создавать «виртуальные лаборатории» и дает возможность нескольким пользователям подключаться к одному и тому же компьютеру, работая с оборудованием напрямую через Engee. |
Установка Engee.Интеграции
Скачайте и распакуйте архив для своей ОС, затем запустите Engee.Интеграции:
-
Host-Device-Manager-Windows.zip — для Windows;
-
Host-Device-Manager-Linux.zip — для Linux.
|
Антивирус может заблокировать установку или запуск клиентской программы Engee.Интеграции. Если при установке или запуске появляются предупреждения системы безопасности, то временно отключите защиту в реальном времени и добавьте исполняемый файл клиента в исключения. Например, для отключения антивируса «Безопасность Windows» и добавления исключений следуйте инструкции: Пошаговая инструкция
|
| В корпоративных средах политика безопасности может запрещать добавление исключений пользователем. В этом случае обратитесь к администратору ИБ. |
После запуска клиентской программы Engee.Интеграции откроется окно:
Для подключения клиентской программы Engee.Интеграции к Engee необходимо создать токен личного доступа (Personal Access Token, PAT) в личном кабинете Engee. Подключение по адресу сервера (например, engee.com) не работает без токена. Токен хранится только на персональном компьютере и передается на выбранный сервер. Его статус виден в шапке приложения справа, рядом с кнопкой «i» 
: «Не задан» / «Активен».
Подключение по токену личного доступа
Создание токена личного доступа в Engee
-
Откройте личный кабинет Engee и перейдите в раздел Связь и безопасность.
-
Выберите Токены личного доступа.
-
Разверните блок Токены личного доступа и нажмите Добавить новый токен.
-
Заполните форму: имя токена, срок действия, разрешение «Доступ к API Engee», затем нажмите Добавить токен личного доступа.
-
Скопируйте созданный токен — он показывается один раз и понадобится для подключения в клиентской программе.
Для копирования используйте кнопку
, для просмотра — 
.Сохраните токен сразу после создания. Повторно просмотреть его в интерфейсе невозможно.
Выбор сервера в Engee.Интеграции
В клиентской программе выберите сервер из списка (по умолчанию engee.com) или добавьте свой сервер. Для этого нажмите Добавить новый… в конце списка адресов.
Добавление токена
Нажмите на кнопку с карандашом 
, вставьте токен личного доступа и сохраните, после чего статус токена изменится на «Активен».
Подключение
Запустите сессию Engee — активная лицензия появится в адресе сервера автоматически. Когда она появится, нажмите Подключиться. Клиентская программа сама дождется готовности, установит или обновит серверную программу и подключится; прогресс отображается в окне диагностики.
|
Обновление Engee.Интеграции
При каждом открытии клиентской программы Engee.Интеграции выполняется проверка наличия новой версии. Если обновление доступно, достаточно подтвердить его установку.
Серверная часть обновляется автоматически. Сообщения об этом выводятся в окно диагностики.
Интерфейс клиентской программы
Интерфейс клиентской программы Engee.Интеграции имеет следующий вид:
-
Название и версия клиентской программы.
-
Кнопка окна статусов оборудования.
При нажатии на нее открывается окно, которое содержит вкладки со статусами оборудования:
В этом окне представлена вся информация о подключенном оборудовании и интеграциях.
На вкладке «Расширения» можно загрузить (или удалить) пользовательский пакет поддержки в клиентскую программу.
-
Кнопка окна настроек.
-
Кнопка сворачивания в трей (только в версии для Windows).
При нажатии на нее приложение помещается в системный трей, а статус подключения подсвечивается в иконке:
-
Если клиентская программа подключена:
-
Если клиентская программа отключена:
-
-
Поле для выбора сервера, кнопки добавления
и удаления токена 
, статус токена и кнопка подключения. -
Статус подключения к Engee.
-
Кнопка очистки логов.
-
Окно диагностики.
Сообщения об ошибках
В разделе приведены сообщения об ошибках, которые выводятся в окне диагностики клиентской программы или в командной строке Engee.
-
Текст сообщения:
ERROR: An existing client program is already running. Please close it manually or call function Main.EngeeDeviceManager.UTILS_API.stopClientProgram() in Engee to terminate the previous program instance.Описание: существует запущенный экземпляр клиентской программы, использование второго экземпляра клиентской программы невозможно.
Причина: один экземпляр клиентской программы уже запущен, и пользователь запустил второй.
Решение: закройте первый экземпляр вручную или выполните в командной строке
Main.EngeeDeviceManager.UTILS_API.stopClientProgram(). -
Текст сообщения:
ERROR: Request failed: there is no such host client object for corresponding object Socket! Please, verify the host client is connected and recreate object by calling: socket = SOCKET.Socket()Текст сообщения приведен для объекта Socket. Для других объектов наименование в сообщении будет соответствующим.Описание: обращение к ранее созданному объекту после перезапуска клиентской программы вызывает ошибку.
Причина: перезапуск клиентской программы во время работы с ранее созданным объектом в командной строке или в редакторе скриптов Engee.
Решение: после перезапуска клиентской программы создайте объект заново (например, через
socket = SOCKET.Socket()) и используйте только его — ранее созданный объект восстановлению не подлежит. -
Текст сообщения:
ERROR: Operation cannot be completed: there is no available route to host client program. Please verify that the host client is connected.Описание: создание объекта без активного подключения к клиентской программе вызывает ошибку.
Причина: попытка создать объект в командной строке или в редакторе скриптов Engee, когда клиентская программа не подключена.
Решение: предварительно подключите клиентскую программу, убедитесь в наличии соединения и только после этого создавайте объекты и работайте с ними.
Программное управление
| Функции программного управления пакетами поддержки доступны только при установленной и запущенной подсистеме Engee.Интеграции. |
Помимо программного управления моделированием в Engee доступно программное управление пакетами поддержки:
-
Программное управление VISA — работа с приборами по спецификации VISA.
-
Программное управление HTTP — работа с HTTP-соединениями.
-
Программное управление MAVLink — работа с устройствами MAVLink.
-
Программное управление Ardupilot — работа с автопилотом ArduPilot.
-
Программное управление EULER — работа с решателем EULER.
-
Программное управление T-FLEX DOCs — работа с объектами расчетов в T-FLEX DOCs.
-
Программное управление CAN — работа с CAN-интерфейсами.
-
Программное управление COM — работа с COM-интерфейсами.
-
Программное управление Analog Discovery — работа с лабораторными устройствами Digilent серии Analog Discovery.
-
Программное управление таргетами — работа со встраиваемыми системами.
-
Программное управление РИТМ — загрузка/запуск моделей, работа с файлами, логами и статусами на целевой платформе РИТМ.
-
Программное управление SDR-платами РИТМ — работа с SDR-платами РИТМ.