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

РИТМ.Управление машинами

Подробнее о РИТМ и полунатурном моделировании читайте в разделе Полунатурное моделирование.

Приложение РИТМ.Управление машинами ritm icon предназначено для решения следующих задач:

  • Подключение и настройка машин реального времени КПМ «РИТМ»;

  • Настройка сетевых интерфейсов машины РИТМ;

  • Настройка интерфейса RITM Monitor на экране РИТМа;

  • Управление приложениями реального времени, сгенерированными из моделей Engee.

РИТМ.Управление машинами можно запустить из меню Приложения engee apps в рабочем пространстве Engee.

Подготовка к работе

Перед началом работы с РИТМ.Управление машинами установите и подключите Engee.Интеграции. Это обязательное первое действие: без него операции с машиной недоступны — можно будет только редактировать список машин (например, сохранить IP-адрес машины). Подробная инструкция по установке и подключению приведена в статье Engee.Интеграции.

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

  • пакет поддержки не установлен — выполните команду engee.package.install("Engee-Device-Manager");

  • пакет установлен, но не запущен — выполните команду engee.package.start("Engee-Device-Manager");

  • нет подключения к Engee — подключитесь по ссылке, которую выдает команда engee.package.start("Engee-Device-Manager").

    ritm manager prepare edm ru

После устранения причины нажмите «Продолжить» и проверьте статус, нажав на кнопку Проверить статус машины ritm manager reload в главном меню.

Описание

Интерфейс РИТМ.Управление машинами содержит несколько областей:

ritm manager app ru

Главное меню состоит из следующих опций:

ritm manager main menu ru

  • Справка ritm reference icon — открывает документацию РИТМ.Управление машинами.

  • Выберите машину — позволяет выбрать машину из списка, добавить новую машину и удалить машину из списка. Также отображает текущий статус соединения с машиной рядом с именем машины (подключен ritm connected; не подключен ritm not connected). Процесс добавления машины описан в статье Начало работы.

    ritm manager machine list ru

    При добавлении машины указываются:

    • «Название» — произвольное имя машины;

    • «IP адрес» — адрес машины в сети;

    • «Машина по умолчанию» — машина будет выбрана автоматически при следующем открытии приложения.

    ritm manager add machine ru

  • Редактировать машину ritm edit 1 — позволяет изменить «Название», «IP адрес» и признак «Машина по умолчанию» для выбранной машины.

    ritm manager edit machine ru

  • Проверить статус машины ritm manager reload — повторно проверяет соединение с машиной, если оно было нарушено. Статус соединения также проверяется автоматически.

  • Управлять питанием машины ritm manager power — позволяет перезагрузить или выключить машину.

    ritm manager power menu ru

  • Обновление машины ritm updater x — позволяет обновить прошивку и пакет поддержки устройства.

    ritm manager update menu ru

    • Обновление прошивки

      Details

      Локальное обновление — выбор файла прошивки и файла контрольной суммы, доступных офлайн (например, полученных через техническую поддержку РИТМ).

      ritm manager firmware local ru

      Онлайн обновление — проверяет наличие новой версии прошивки через Интернет и предлагает ее обновить.

      ritm manager firmware online ru

    • Обновление пакета поддержки

      Details

      Локальное обновление — выбор файла пакета поддержки.

      ritm manager support local ru

      Онлайн обновление — проверяет наличие новой версии пакета поддержки через Интернет и предлагает ее обновить.

      ritm manager support online ru

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

Управление приложениями

В панели Управление приложениями выводится список всех приложений реального времени, загруженных на машину, и отмечается приложение, запущенное в данный момент. Для поиска нужного приложения воспользуйтесь полем Введите название приложения.

ritm manager apps ru

Управление приложениями осуществляется с помощью кнопок в строке приложения:

  • Запустить ritm start app — текущее запущенное приложение останавливается и запускается выбранное приложение.

  • Остановить ritm stop app — текущее запущенное приложение останавливается.

  • Запускать при включении машины ritm auto start — выбранное приложение помещается в автозапуск: оно будет автоматически запускаться при включении машины. Приложение с включенным автозапуском отмечено иконкой молнии в списке.

  • Удалить ritm delete app — если выбранное приложение запущено, оно останавливается, а затем удаляется с машины.

Приложения, собранные в интерактивном режиме выполнения модели, не поддерживают автозапуск — для них кнопка Запускать при включении машины ritm auto start недоступна.

Настройки машины

В заголовке панели Настройки машины отображаются версия прошивки и пакета поддержки, установленных на машине (или сообщение «не установлен»).

ritm manager machine settings ru

  • Настройка сетевого интерфейса хост-таргет — позволяет сменить IPv4 адрес на машине.

    ritm manager network host target ru

    Также автоматически меняется IP адрес в профиле подключения. Если соединение не восстановилось сразу после смены адреса, то используйте кнопку Проверить статус машины ritm manager reload в главном меню для восстановления подключения.

  • Настройка сетевых интерфейсов — позволяет настроить доступные на машине сетевые интерфейсы.

    ritm manager network interfaces ru

    Нажатие кнопки Сбросить настройки сетевых интерфейсов сбрасывает настройки всех сетевых интерфейсов, кроме интерфейса хост-таргет.

  • Настройка RITM Monitor — позволяет настроить отображение RITM Monitor на экране машины.

    ritm manager monitor settings ru

    • Режим отображения:

      • Графический — журнал приложения (Application Log) выводится на экране РИТМа справа в свернутом виде;

      • Текстовый — журнал приложения открывается снизу в развернутом виде: в него помещается больше текста вывода.

    • Тема — темная или светлая.

    • Раскладка графиков — сетка, вертикальная или горизонтальная.

    • Расширенный монитор — включает вывод дополнительных показателей:

      • количество занятой памяти RAM;

      • загрузку процессора (CPU Usage);

      • таблицу Model TET — Detailed Metrics со столбцами:

        Столбец Что показывает

        Task

        Название задачи

        Max TET (us)

        Максимальное время выполнения задачи, мкс

        Average TET (us)

        Среднее время выполнения задачи, мкс

        p95 TET (us)

        95-й перцентиль времени выполнения, мкс

        p99 TET (us)

        99-й перцентиль времени выполнения, мкс

        TET / Sample Time

        Отношение времени выполнения задачи к шагу дискретизации

    Пример настроек RITM Monitor

    Изначально на экране машины включена темная тема, а расширенный монитор выключен:

    ritm manager monitor before settings ru

    После выбора светлой темы и включения расширенного монитора интерфейс RITM Monitor стал светлым, и на экране появились дополнительные показатели, например загрузка процессора (CPU Usage):

    ritm manager monitor after settings ru

Логи машины

В панели Логи машины отображаются последние строки логов вывода RITM Monitor — фактически это вывод, который RITM Monitor показывает на экране машины. Логи полезны для контроля выполнения модели и диагностики неполадок на машине.

ritm manager machine logs ru

Панель обновляется автоматически: показываются последние 15 строк вывода RITM Monitor.

Служебные сообщения

В панели Служебные сообщения отображаются служебные и статусные сообщения для пользователя:

ritm manager service messages ru

Настройка сети

Обратите внимание, что IP адрес хоста (заданный в настройках вашей операционной системы) должен находиться в одной подсети с IP адресом машины РИТМ.

Не рекомендуется одновременно задействовать несколько сетевых интерфейсов с IP адресами, принадлежащими одной сети. Это замечание относится также и к интерфейсу хост-таргет. IP адреса из одной подсети на нескольких сетевых интерфейсах могут приводить к ошибкам маршрутизации и, например, невозможности подключиться к машине по интерфейсу хост-таргет.

В случае возникновения такой ситуации следует отключить сетевые кабели от всех портов, кроме порта, отмеченного как Host на РИТМе, переподключиться к машине и настроить сетевые интерфейсы.

Ошибка подключения к машине

Если машина включена и пингуется, но отображается ошибка подключения:

  1. Убедитесь, что клиентская программа Engee.Интеграции установлена и подключена к Engee (см. раздел Подготовка к работе). Если приложение показывало окно «Предупреждение» — устраните указанную в нем причину.

  2. Убедитесь, что IP адрес хоста находится в одной подсети с IP адресом машины (см. раздел Настройка сети).

  3. Нажмите Проверить статус машины ritm manager reload в главном меню для восстановления соединения.

  4. Если соединение не восстановилось — проверьте сообщения в панелях Служебные сообщения и Логи машины.