Alpha.Community

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

Встраивание ActiveX компонентов, библиотек .NET и Qt плагинов

В проект Alpha.HMI можно встроить:

  • ActiveX компонент Alpha.Alarms;
  • ActiveX компонент Alpha.Trends;
  • Библиотеки на основе .NET Framework и .NET;
  • Плагины Qt.

Встраиваемые компоненты Alpha.Alarms, Alpha.Trends и библиотеки .NET Framework недоступны для использования в ОС Linux.

Компонент Alpha.Alarms

Компонент недоступен при работе в ОС Linux.

Компонент Alpha.Alarms применяется для мониторинга событий, возникающих при изменении состояний технологических объектов. Основными функциями встраиваемого компонента являются:

  • отображение сообщений о событиях в режиме реального времени;
  • отображение истории сообщений о событиях за прошедшие периоды.

Изменение настроек встраиваемого компонента осуществляется с помощью окна Параметры. Чтобы открыть окно Параметры, в контекстном меню выберите Настроить компонент.

На рисунке ниже показан компонент Alpha.Alarms, встроенный в экранную форму.

Встраиваемый компонент Alpha.Alarms, работая в составе проекта автоматизации, предоставляет доступ к своим свойствам, функциям и событиям. Наиболее применяемые свойства, функции и события:

  • режим работы (оперативный или исторический) регулируется свойством ActiveMode;
  • доступность кнопок, отвечающих за квитирование, настраивается свойством AcknowledgmentAvailable;
  • функция AckAll() квитирует все события;
  • функция SetHistoricalInterval(DateFrom, DateTo) устанавливает временной интервал для запроса исторических событий и выполняет этот запрос;
  • действия, происходящие при завершении проигрывания очереди звуков определяются в обработчике события FinishedPlayingSounds.

Описание всех доступных свойств, функций и событий встраиваемого компонента Alpha.Alarms смотрите в документе Alpha.HMI.Справочное руководство или в заключительной главе документа Alpha.Alarms.

Компонент Alpha.Trends

Компонент недоступен при работе в ОС Linux.

Компонент Alpha.Trends применяется для графического отображения изменений значений сигналов. Основными функциями встраиваемого компонента являются:

  • отображение графиков в режиме реального времени (оперативный режим);
  • отображение графиков за прошедший период времени (исторический режим).

Изменение настроек встраиваемого компонента осуществляется с помощью окна Параметры. Чтобы открыть окно Параметры, в контекстном меню выберите Настроить компонент.

На рисунке ниже показан компонент Alpha.Trends, встроенный в экранную форму.

Встраиваемый компонент Alpha.Trends, работая в составе проекта автоматизации, предоставляет доступ к своим свойствам, функциям и событиям. Наиболее применяемые свойства, функции и события:

  • режим работы (оперативный или исторический) регулируется свойством ActiveMode;
  • функция AddItem() добавляет новый сигнал;
  • функция ReloadHistoricalData() запрашивает исторические данные;
  • функция SetHistoricalInterval() устанавливает интервал запроса истории.

Описание всех доступных свойств, функций и событий встраиваемого компонента Alpha.Trends смотрите в документе Alpha.HMI.Справочное руководство или в заключительной главе документа Alpha.Trends.

Библиотеки .NET и Qt плагины

При запуске проекта через Alpha.HMI.WebViewer внешние библиотеки .NET не поддерживаются. Проекты, содержащие ссылки на такие библиотеки, не смогут быть скомпилированы в веб-среде.

Библиотеки .NET и плагины Qt расширяют возможности Alpha.HMI внутри отдельного проекта, добавляя кастомные компоненты и обработчики данных, которые сложно или невозможно реализовать стандартными средствами Alpha.HMI. Основное отличие между ними заключается в используемой технологии: библиотеки .NET написаны на языках платформы .NET, а плагины Qt создаются с использованием фреймворка Qt.

  • Для создания библиотеки на основе .NET, напишите код на языке C# или другом языке платформы .NET. Затем скомпилируйте библиотеку в файл с расширением .dll

    Для корректной работы библиотек .NET в ОС Linux установите пакеты среды выполнения .NET (см. ниже).

  • Для создания плагина на основе Qt напишите код на любом поддерживаемом языке программирования, например, на C++, Python или JavaScript, с использованием фреймворка Qt. Пример кода для создания плагина на C++ можно скачать здесь. После написания кода, скомпилируйте плагин в виде динамической библиотеки: .dll для Windows или .so для Linux (см.ниже).

Сборка плагинов Qt

Убедитесь, что вы используете динамически подключаемые модули Qt версии не ниже 5.x.x, предпочтительно 5.15.2, которая совместима с Alpha.HMI.

Версии Qt 6.x.x не совместимы с Alpha.HMI, поэтому для проектов следует избегать их использования.

ОС Windows

  1. Установите Qt SDK версии 5.15.2.

  2. Установите CMake (рекомендуется версия от 3.15 до 3.22) и добавьте путь к его исполняемому файлу в переменную среды PATH. Это позволит запускать команду cmake из любой папки через командную строку.

  3. Установите Visual Studio 2019 с рабочей нагрузкой Разработка классических приложений на C++. В дополнительных компонентах выберите MSVC v142 - VS 2019 C++ x64/x86 build tools. Рекомендуется использовать версию MSVC 14.28.29910 или близкую к ней.

    1. Проверьте, что в настройках проекта используется динамическая линковка с CRT (Microsoft C Runtime). Для этого:

      • Откройте параметры проекта в Visual Studio.
      • Перейдите в раздел Свойства конфигурации → С/С++ → Создание кода.
      • Убедитесь, что для поля Библиотека времени выполнения выбрано значение Многопоточный DLL (/MD).
  4. Создайте новую папку для вашего плагина. Это место, где будут храниться все файлы. Например:

    C:\Users\YourName\QtPlugins\GenericPlugin
  5. В этой папке создайте файл с именем CMakeLists.txt. Это файл, который CMake использует для настройки сборки. Вот его содержимое:

    cmake_minimum_required(VERSION 3.3)
    project(qtplugins)
    set(CMAKE_AUTOMOC ON)
    set(CMAKE_AUTOUIC ON)
    set(CMAKE_AUTORCC ON)
    set(CMAKE_INCLUDE_CURRENT_DIR ON)
    if(WIN32)
    # Укажите путь до Qt SDK 5.15.2
    set(QT_SDK_PATH_WINDOWS "D:\\Qt\\5.15.2")
    set(CMAKE_PREFIX_PATH "${QT_SDK_PATH_WINDOWS}\\msvc2019_64")
    else()
    # Укажите путь до Qt SDK 5.15.2
    set(QT_SDK_PATH_LINUX "/opt/Qt/5.15.2")
    set(CMAKE_PREFIX_PATH "${QT_SDK_PATH_LINUX}/gcc_64")
    endif()
    find_package(Qt5 REQUIRED COMPONENTS Core Gui Widgets)
    find_package(Threads REQUIRED)
    # README: Указываем имя плагина, может быть любым
    set(pluginName "GenericPlugin")
    # README: Указываем cpp файл плагина
    set(pluginSources "genericplugin.cpp")
    add_library(${pluginName} SHARED ${pluginSources})
    target_link_libraries(${pluginName} Qt5::Core Qt5::Gui Qt5::Widgets Threads::Threads)
  6. Создайте файл genericplugin.cpp в той же папке с проектом. Пример плагина можно скачать здесь.

  7. Перейдите в папку с проектом через терминал Visual Studio, используя команду:

    cd C:\Users\YourName\QtPlugins\GenericPlugin
  8. Создайте папку для сборки и перейдите в неё:

    mkdir build_release
    cd build_release
  9. Выполните команду для настройки сборки через CMake:

    cmake -G "Visual Studio 16 2019" -A x64 ..
  10. После успешной настройки выполните сборку:

    cmake --build . --config Release

После успешной сборки в папке build_release появится файл .dll (Windows библиотека). Этот файл можно импортировать в Alpha.HMI.

ОС Linux

Эта инструкция применима для AstraLinux 1.7.6 и других систем на основе Debian.

Чтобы собрать Qt плагин, выполните следующие шаги:

  1. Откройте файл с репозиториями для редактирования

    sudo nano /etc/apt/sources.list
  2. Удалите символы # в начале строк, если они закомментированы, чтобы активировать стандартные репозитории.

  3. Добавьте следующие строчки в конец файла /etc/apt/sources.list:

    deb http://us.archive.ubuntu.com/ubuntu/ xenial main
    deb http://us.archive.ubuntu.com/ubuntu/ xenial universe

    Сохраните файл и закройте редактор (Ctrl+O, затем Ctrl+X).

  4. Установите компилятор GCC версии 5. Это можно сделать с помощью следующих команд:

    apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 40976EAF437D05B5 3B4FE6ACC0B21F32
    apt-get update
    apt-get install gcc-5 g++-5
    ln -s /usr/bin/gcc-5 /usr/bin/gcc
    ln -s /usr/bin/g++-5 /usr/bin/g++
  5. Установите необходимые пакеты для сборки:

    sudo apt install mesa-common-dev libglu1-mesa-dev cmake
  6. Установите Qt SDK версии 5.15.2.

  7. Создайте папку для плагина (например, ~/Desktop/QtPlugin) и перейдите в неё через терминал:

    cd ~/Desktop/QtPlugin
  8. Создайте файл genericplugin.cpp, который будет содержать код вашего плагина, и поместите его в папку ~/Desktop/QtPlugin. Пример плагина можно скачать здесь.

  9. В папке с плагином создайте файл CMakeLists.txt со следующим содержимым:

    cmake_minimum_required(VERSION 3.3)
    project(qtplugins)
    set(CMAKE_AUTOMOC ON)
    set(CMAKE_AUTOUIC ON)
    set(CMAKE_AUTORCC ON)
    set(CMAKE_INCLUDE_CURRENT_DIR ON)
    if(WIN32)
    # Укажите путь до Qt SDK 5.15.2
    set(QT_SDK_PATH_WINDOWS "D:\\Qt\\5.15.2")
    set(CMAKE_PREFIX_PATH "${QT_SDK_PATH_WINDOWS}\\msvc2019_64")
    else()
    # Укажите путь до Qt SDK 5.15.2
    set(QT_SDK_PATH_LINUX "/opt/Qt/5.15.2")
    set(CMAKE_PREFIX_PATH "${QT_SDK_PATH_LINUX}/gcc_64")
    endif()
    find_package(Qt5 REQUIRED COMPONENTS Core Gui Widgets)
    find_package(Threads REQUIRED)
    # README: Указываем имя плагина, может быть любым
    set(pluginName "GenericPlugin")
    # README: Указываем cpp файл плагина
    set(pluginSources "genericplugin.cpp")
    add_library(${pluginName} SHARED ${pluginSources})
    target_link_libraries(${pluginName} Qt5::Core Qt5::Gui Qt5::Widgets Threads::Threads)
  10. Выполните следующие команды для сборки плагина:

    set -x
    rm -rf build_release
    mkdir build_release
    pushd build_release
    cmake ..
    cmake --build .
    popd

После успешной сборки в папке build_release будет создана библиотека плагина .so, которую можно импортировать в Alpha.HMI.

Автоматическое обнаружение системного .NET Runtime

Alpha.HMI автоматически определяет установленную среду выполнения .NET Runtime в ОС Windows и ОС Linux для работы с библиотеками .NET Framework и .NET.

При запуске Alpha.HMI в журнале отображается сообщение, указывающее, удалось ли найти .NET Runtime.

Как Alpha.HMI находит .NET Runtime

Alpha.HMI ищет .NET Runtime в указанных ниже местах в следующем порядке:

  1. Проверка переменной среды DOTNET_ROOT.

    Если задана переменная среды DOTNET_ROOT, Alpha.HMI использует путь, указанный в этой переменной, как основной источник .NET.

    Примеры значений:

    • В ОС Linux: /home/admin/dotnet.
    • В ОС Windows: C:\Program Files\dotnet.

    В этом каталоге автоматически выбирается последняя стабильная версия .NET (например, .NET 8.0, если доступны версии 6.0 и 8.0). Чтобы изменить это поведение, можно задать дополнительные переменные среды:

    • DOTNET_ROLL_FORWARD определяет, какую версию .NET Runtime будет использовать Alpha.HMI, если запрошенная версия (например, 6.0) не найдена.
      Например:

      • LatestMajor: используется самая новая основная версия (например, 8.0 вместо 6.0).
      • LatestMinor: используется самая новая версия в рамках той же основной версии (например, 6.0.15 вместо 6.0.10).
    • DOTNET_ROLL_FORWARD_TO_PRERELEASE разрешает использование предварительных (пререлизных) версий .NET.
    • DOTNET_MULTILEVEL_LOOKUP позволяет искать .NET в дополнительных каталогах (например, в пользовательских и системных путях установки).

    Подробности о переменных среды см. в документации Microsoft по .NET Runtime.

  2. Проверка переменной среды PATH.

    Если переменная среды DOTNET_ROOT не задана, Alpha.HMI ищет .NET в папках из переменной среды PATH.

    Примеры значений:

    • В ОС Linux: /home/admin/tmp/dotnet.
    • В ОС Windows: C:\Program Files\dotnet.

    Чтобы .NET была найдена, добавьте её папку в начало переменной PATH. Примеры настройки:

    • В ОС Linux:

      export PATH=/home/admin/tmp/dotnet:$PATH
      source ~/.bashrc
    • В ОС Windows:
      setx Path "%Path%;C:\Program Files\dotnet"
  3. Проверка стандартных папок.

    Если ни DOTNET_ROOT, ни PATH не указывают на .NET, Alpha.HMI проверяет стандартные места установки:

    • В ОС Linux: /usr/share/dotnet.
    • В ОС Windows: C:\Program Files\dotnet.

Добавление библиотек .NET или плагина Qt в проект

Чтобы подключить библиотеки .NET или плагины Qt к проекту Alpha.HMI, используйте один из двух способов:

  • Через диалоговое окно — путь к файлу указывается автоматически при выборе.
  • Вручную — путь к файлу вводится самостоятельно (например, с использованием переменных среды или относительных путей).

Добавление через диалоговое окно

  1. В верхнем меню выберите Проект → Ссылки на юниты.
  2. В открывшемся окне щелкните правой кнопкой мыши и выберите Добавить из файлов.

  3. В диалоговом окне выбора файлов найдите и выберите ваш файл (.dll для .NET или Qt-плагина, .so для Qt-плагина на Linux).

    1. Дважды щёлкните по ячейке в столбце Тип, чтобы выбрать нужный тип модуля из выпадающего списка.

  4. Нажмите кнопку Применить — модуль будет сразу загружен, а в колонке Состояние отобразится результат загрузки. Убедитесь, что появилось сообщение Успешно загружено, и нажмите ОК.

Теперь новые библиотеки .NET и плагин Qt успешно добавлены в проект и готовы к использованию. Используйте эти новые компоненты так же, как и встроенные компоненты Alpha.HMI.

Добавление с ручным вводом пути

  1. В верхнем меню выберите Проект → Ссылки на юниты.

  2. В открывшемся окне щелкните правой кнопкой мыши и выберите Добавить.

  3. В поле Путь до модуля введите путь к файлу одним из способов:

    • Абсолютный путь.

      Введите полный путь к файлу на компьютере. Например:

      C:\Users\YourName\Plugins\secondplugin.dll
    • Переменные среды.

      Введите путь с использованием переменной среды, которая автоматически заменяется на системный путь, например, папку текущего пользователя:

      $env:USERPROFILE\Plugins\dotnetfwlib.dll

      Здесь $env:USERPROFILE будет автоматически заменено на путь к папке текущего пользователя (например, C:\Users\YourName).

    • Переменные Alpha.HMI.

      Введите путь относительно расположения проекта. Переменные автоматически заменяются на пути, связанные с проектом.

      $hmi:proj:Folder\Plugins\dotnetcorelib.dll          — путь к папке, в которой находится файл проекта (.hmi)
      $hmi:proj:ResourceFolder\Plugins\dotnetcorelib.dll — путь к папке ресурсов проекта
      $hmi:proj:File — путь к самому файлу проекта (.hmi)
  4. Дважды щёлкните по ячейке в столбце Тип, чтобы выбрать нужный тип модуля из выпадающего списка.

  5. Нажмите кнопку Применить — модуль будет сразу загружен, а в колонке Состояние отобразится результат загрузки. Убедитесь, что появилось сообщение Успешно загружено, и нажмите ОК.

Теперь новые библиотеки .NET и плагин Qt успешно добавлены в проект и готовы к использованию. Используйте эти новые компоненты так же, как и встроенные компоненты Alpha.HMI.

Выгрузка метаинформации модулей

Функция выгрузки метаинформации позволяет экспортировать текстовые описания встроенных и нативных юнитов проекта в формате JSON.

Выгрузка метаинформации может использоваться для:

  • Подготовки технической документации на основе структуры проекта и его компонентов.
  • Извлечения уникальных идентификаторов (UUID) пользовательских форм и модулей для использования при разработке проекта (например, для запуска форм в Alpha.HMI через UUID).

Чтобы выгрузить метаинформацию модулей через графический интерфейс Alpha.HMI:

  1. В верхнем меню выберите Файл → Экспорт метаописаний модулей.

  2. В открывшемся диалоговом окне выберите экспортируемые модули, укажите путь и имя файла для сохранения метаинформации.

  3. Нажмите Экспорт.

После выполнения этих шагов будет создан JSON-файл, содержащий метаописания выбранных модулей.

Пример структуры выгруженного файла:

[
    {
        "elementKind": "UNIT",
        "elementFlags": [],
        "name": "built-in",
        "displayName": "<built-in>",
        "description": "<built-in>",
        "unitKind": "BUILT_IN",
        "uuid": "built-in",
        "version": "2.0.30+b30.r131479",
        "members": [
            {
                "elementKind": "OBJECT",
                "elementFlags": [],
                "accessModifier": "PUBLIC",
                "name": "bool",
                "displayName": "bool",
                "description": "",
                "uuid": "bool",
                "baseTypeUuid": null,
                "baseTypeQualifier": [],
                "declarationType": "TYPE"
            },
            {
                "elementKind": "OBJECT",
                "elementFlags": [],
                "accessModifier": "PUBLIC",
                "name": "int4",
                "displayName": "int4",
                "description": "",
                "uuid": "int4",
                "baseTypeUuid": null,
                "baseTypeQualifier": [],
                "declarationType": "TYPE"
            }
        ]
    }
]

Выгрузку метаинформации также можно выполнить с помощью CLI-утилиты (см. раздел Выгрузка метаинформации).

Установка пакетов среды выполнения .NET

Пакеты установки .NET не поставляются вместе с комплектом установочных пакетов Альфа платформы.

Подробнее установка с использованием Internet описана здесь: https://wiki.astralinux.ru/pages/viewpage.action?pageId=41192241.

Чтобы установить .NET без использования Internet, выполните:

  1. Скачайте установочные пакеты на другом компьютере с доступом в Интернет:

    wget -O dotnet-runtime-3.1.16-x64.deb https://download.visualstudio.microsoft.com/download/pr/63d3b19a-e1e0-4da0-bb3d-e5c0a5f55877/154e474b4ac05495acb058de6f98dd21/dotnet-runtime-3.1.16-x64.deb
    wget -O aspnetcore-runtime-3.1.16-x64.deb https://download.visualstudio.microsoft.com/download/pr/f77ae16c-12e4-4981-8de3-b7a1d9d2baf6/4c07395d15cb215e5b4f11c58005d7b2/aspnetcore-runtime-3.1.16-x64.deb
  2. Перенесите скачанные файлы на целевую машину с помощью USB-накопителя или другого способа передачи данных.
  3. Установите скачанные пакеты на целевой машине:

    sudo dpkg -i dotnet-runtime-3.1.16-x64.deb
    sudo dpkg -i aspnetcore-runtime-3.1.16-x64.deb
  4. Если вы хотите настроить локальный репозиторий для последующих установок, выполните следующие шаги:

    1. Создайте директорию для хранения пакетов:

      sudo mkdir -p /usr/local/packages/dotnet
    2. Скопируйте туда скачанные пакеты:

      sudo cp dotnet-runtime-3.1.16-x64.deb /usr/local/packages/dotnet/
      sudo cp aspnetcore-runtime-3.1.16-x64.deb /usr/local/packages/dotnet/
    3. Добавьте локальный репозиторий в список источников:

      echo "deb [trusted=yes] file:/usr/local/packages/dotnet ./" | sudo tee /etc/apt/sources.list.d/dotnet-local.list
  5. Обновите список пакетов и установите .NET:

    sudo apt-get update
    sudo apt-get install dotnet-runtime-3.1

В документе описана установка .NET 3.1. Уточнить актуальную версию можно по ссылке: https://learn.microsoft.com/en-us/dotnet/core/install/linux-debian.