Alpha.Community

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

Решения и проекты

Проект автоматизации в Alpha.DevStudio описывается в виде проектов и модулей. Проект – это то, с чем вы работаете в Alpha.DevStudio, он содержит элементы и файлы, которые вы добавляете. Модуль – это готовый проект, представляющий собой неизменяемую сущность, которую можно использовать в других проектах.

Решение – это контейнер для одного или нескольких связанных между собой проектов и модулей. Проект всегда открывается внутри решения, в которое он входит. Само по себе решение не содержит данных; работа с решением – это работа с входящими в него проектами. Исходный файл решения содержит информацию о входящих в него проектах.

Вместе с дистрибутивом Alpha.DevStudio поставляются проекты-примеры. Чтобы с ними ознакомиться, откройте меню Пуск → Automiq → Примеры решений. Эти решения поставляются для ознакомления с примерами использования Alpha.DevStudio для решения различных задач.

Создание проекта и решения

При запуске Alpha.DevStudio открывается среда разработки, в которой не открыто ни одного решения. Чтобы начать работу, необходимо создать проект и содержащее его решение.

Чтобы создать проект и решение:

  1. Выберите в меню Файл → Создать проект.... Откроется мастер создания проекта.
  2. На вкладке Шаблон выберите один из шаблонов. В мастере создания проекта реализованы шаблоны:
    • Резервируемые сервера. Этот шаблон можно использовать для описания резервируемого сервера, резервного сервера и АРМ оператора, объединенных в единую сеть. Он содержит домен, в котором к сети подключен резервируемый сервер, резервный сервер и АРМ оператора. На каждом сервере ведется запись истории. На АРМ оператора есть доступ к объектам резервируемого сервера.
    • Проект приложения. Этот шаблон можно использовать для создания своего приложения. Он содержит контейнер, в котором будет создано приложение.
    • Проект развертывания. Этот шаблон можно использовать для описания устройств, объединенных в единую сеть. Он содержит домен, в котором к сети подключен один узел.
    • Пустой проект. Этот шаблон содержит только ссылки на системные модули Om.System и Om.Server.
    • Библиотека элементов. Этот шаблон можно использовать для создания своей библиотеки типов. Он содержит пространства имен для описания типов ПЛК и серверов ввода-вывода.
    Все шаблоны содержат ссылки на системные модули Om.System и Om.Server. Подробнее о них написано в подразделе Ссылка на модуль или проект модуля.
  3. На вкладке Проект:
    1. Укажите Размещение – папку для сохранения проекта и решения.
    2. Введите Имя проекта.
    3. Установите флаг Разместить проект в папке с решением, если в этом есть необходимость. По умолчанию этот флаг снят – проект сохраняется в отдельной папке решения.
    4. Укажите Имя решения. По умолчанию имя решения совпадает с именем проекта. Имя решения можно изменить.
    5. Установите флаг Создать папку для решения, если в этом есть необходимость. По умолчанию флаг снят – решение сохраняется в папке, указанной на шаге 1.
    6. Нажмите Готово.

Если все прошло успешно, то будут созданы:

  • исходный файл с расширением *.omx, содержащий описания элементов;
  • файл проекта модуля с расширением *.omx-project, содержащий список исходных файлов и ресурсных файлов;
  • файл решения с расширением *.solution, содержащий список проектов и подключенных модулей.

Содержимое проекта модуля откроется в рабочей области Alpha.DevStudio, структура решения отобразится в Обозревателе решений.

В папке проекта также создается файл с расширением *.dgm, описывающий расположение символов на Диаграмме. Он появится в этой папке после того, как будет закрыта Диаграмма рабочей области. Отсутствие этого файла не влияет на компиляцию проекта. При совместной разработке проектов Alpha.DevStudio с использованием системы контроля версий SVN этот файл можно не сохранять в SVN. Подробнее о разработке проекта Alpha.DevStudio несколькими пользователями написано в разделе Совместная разработка проекта несколькими пользователями.

Создание, добавление и исключение проектов в открытом решении

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

Добавление нового проекта в открытом решении

Чтобы добавить новый проект в папке с открытым решением:

  1. Выберите в меню Файл → Добавить → Новый проект модуля... или в Обозревателе решений в контекстном меню решения выберите Добавить → Новый проект модуля.... Откроется мастер создания проекта.
  2. На вкладке Шаблон выберите один из шаблонов. Шаблоны описаны в разделе Создание проекта и решения.
  3. На вкладке Проект укажите Имя проекта и установите флаг Разместить проект в папке с решением, если в этом есть необходимость. По умолчанию этот флаг снят – проект сохраняется в отдельной папке решения.
  4. Нажмите Готово.

Если все прошло успешно, то проект будет добавлен в решение. В папке решения будут созданы исходный файл проекта Alpha.DevStudio с расширением *.omx и проект модуля с расширением *.omx-project. Содержимое проекта модуля откроется в рабочей области Alpha.DevStudio, структура решения обновится в Обозревателе решений.

Добавление существующего проекта в открытом решении

В открытое решение можно добавить проект модуля, сохраненный локально. Проект модуля можно редактировать, а также использовать в вашем проекте Alpha.DevStudio элементы, описанные в проекте модуля. Чтобы использовать эти элементы, следует сослаться на добавленный проект модуля, подробнее об этом написано в подразделе Ссылка на модуль или проект модуля.

Чтобы добавить проект модуля, выберите в меню Файл → Добавить→ Существующий проект модуля... или в Обозревателе решений в контекстном меню решения выберите Добавить→ Существующий проект модуля.... Откроется диалоговое окно, в котором можно выбрать проект модуля.

Если добавление проекта модуля прошло успешно, то он будет добавлен в решение и отобразится в Обозревателе решений.

Исключение проекта

Чтобы исключить проект из открытого решения, в Обозревателе решений выберите в контекстом меню проекта Исключить из решения. Такой проект не будет использоваться при построении решения. Он не удаляется с жесткого диска, а только исключается из решения.

Модули

Модуль создается на основе проекта модуля. Модуль можно опубликовать, то есть сохранить в виде отдельного файла. Этот файл удобно пересылать или хранить локально. Такой файл, в отличие от проекта, нельзя редактировать. Это позволяет защитить содержимое модуля от случайных изменений. Опубликованный модуль можно подключить в другой проект или решение с помощью мастера импорта или добавить вручную. Если от модуля зависит экземпляр Alpha.Server, то вы можете посмотреть информацию об этом модуле в сигнале сервера.

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

Публикация модуля

Чтобы опубликовать модуль:

  1. В Обозревателе решений в контекстном меню решения выберите Опубликовать модули.... Откроется мастер публикации.
  2. На вкладке Выбор проектов выберите проекты модулей, которые необходимо опубликовать.
  3. На вкладке Параметры публикации укажите место для публикации.
  4. Нажмите Готово.

Если публикация выполнена успешно, то в Журнале появится сообщение об этом, а в папке, указанной в параметрах публикации, будут созданы файл модуля (*.binom) и файл с информацией о модуле (*.index).

В файле модуля (*.binom) доступны для использования и отображаются в Обозревателе решений такие элементы проекта модуля, у которых свойство Уровень доступа принимает значение публичный или защищённый. Подробнее об уровнях доступа можно прочитать в разделе Изменение доступности элементов проекта.

Модуль с расширением *.binom не является тождественным файлу проекта, скомпилированного в Alpha.HMI, с расширением *.binom.

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

  1. Выберите в меню Файл → Параметры. Откроется окно параметров.
  2. Перейдите в раздел Публикация модулей и укажите Папку для публикации.
  3. Нажмите Применить или Закрыть.

Теперь выбранная папка будет указана в мастере публикации по умолчанию.

Импорт модуля

Если модуль опубликован, то его можно импортировать в решение. Чтобы импортировать сразу несколько модулей, воспользуйтесь мастером импорта. Перед этим нужно настроить хранилище, в котором располагаются модули.

Чтобы настроить хранилище:

  1. Выберите в меню Файл → Параметры. Откроется окно параметров.
  2. Перейдите в раздел Импорт модулей.
  3. Нажмите и укажите Параметры хранилища. Можно создать несколько хранилищ.
  4. Нажмите Применить или Закрыть.

Чтобы импортировать модули:

  1. В меню Файл → Добавить выберите Импортировать модули... или в Обозревателе решений в контекстном меню решения выберите Импортировать модули.... Откроется мастер импорта.
  2. На вкладке Модули выберите модули для импорта. По умолчанию на этой вкладке отображаются модули из всех хранилищ. Если нужно выбрать модули какого-то одного хранилища, то выберите его в выпадающем списке Хранилище.
  3. На вкладке Версии выберите версию модуля. По умолчанию указывается последняя версия модуля.
  4. На вкладке Зависимости убедитесь, что требуемая и подключенная версии модулей, от которых зависят подключаемые модули, совпадают.
  5. Нажмите Готово.

Если импорт прошел успешно, то в Журнале появится сообщение об этом. Модули будут добавлены в решение и отобразятся в Обозревателе решений. На Панели элементов появятся ссылки на эти модули. В папке с решением будет создана папка packages. Эта папка содержит папки с копиями модулей *.binom, размещенными в Хранилище.

Добавление модуля

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

Чтобы добавить модуль:

  1. Скопируйте его в папку с решением.
  2. В меню Файл → Добавить выберите Модуль... или в Обозревателе решений в контекстном меню решения выберите Модуль.... Откроется диалоговое окно выбора файла.
  3. В открывшемся окне выберите файл и нажмите Открыть.

Модуль будет добавлен в решение и отобразится в Обозревателе решений. На Панели элементов появится ссылка на этот модуль.

Конвертация подключенных модулей

В более ранних версиях Alpha.DevStudio конвертация подключенных бинарных модулей *.binom выполнялась автоматически при каждой загрузке проекта. Теперь при загрузке проекта появляется диалоговое окно, в котором можно подтвердить преобразование к новому формату или отказаться от этого.

Если вы подтвердите преобразование, то в Alpha.DevStudio будет открыто ваше решение, станет активной кнопка Сохранить все. Если вы сохраните изменения в проекте, то сконвертированный модуль *.binom будет обновлен, а в его родительской папке появится файл с расширением *.bak, в котором хранится модуль до конвертации. Чтобы использовать прежнюю версию модуля (до конвертации) в проекте или решении, измените расширение файла с *.bak на *.binom, а затем подключите этот модуль.

Если вы откажетесь от преобразования, то ваше решение не будет открыто в Alpha.DevStudio.

Получение информации о модулях в сигнале сервера

Сигнал Service.Config.BuildInfo.Dependencies Alpha.Server содержит информацию о проектах и модулях, от которых зависит конфигурация сервера. Вы можете посмотреть в этом сигнале идентификатор, имя и версию модулей *.binom, от которых зависит экземпляр Alpha.Server вашего проекта. Информация о модуле может быть необходима в случае, если в ходе эксплуатации проекта возникают проблемы, и для их диагностики необходимо определить, на каких модулях в Alpha.DevStudio была построена эта конфигурация сервера. Список модулей, использованных при построении конфигурации сервера, можно посмотреть в Alpha.HMI.Explorer или вывести на мнемосхему вашего проекта в Alpha.HMI в качестве диагностической информации.

Информация о модуле записывается в формате JSON-массива, где каждый элемент массива содержит информацию об одном модуле:

[{
 "Id": "<идентификатор модуля>",
 "Name": "Om.System",
 "Version": "1.0.0.0"
}]

Здесь:

  • Id – идентификатор модуля;
  • Name – имя модуля;
  • Version – версия модуля.

Ссылка на модуль или проект модуля

В проект можно добавить ссылку на модуль или проект модуля. Ссылка на модуль или проект модуля позволяет создавать в проекте объекты его типов, а также использовать его типы атрибутов. В набор инструментов Alpha.DevStudio входят готовые модули, они доступны на Панели элементов:

  • System – ссылка на модуль Om.System. Модуль предоставляет типы атрибутов для различных элементов.
  • Automation – ссылка на модуль Automation. Модуль предоставляет тип логического сетевого адаптера.
  • OPC – ссылка на модуль Om.OPC. Модуль предоставляет типы атрибутов, которые можно использовать для описания обмена данными по протоколам OPC.
  • PLC – ссылка на модуль Om.PLC. Модуль предоставляет типы атрибутов и элементы, описывающие сущности программы в ПЛК.
  • IEC60870 – ссылка на модуль Om.IEC60870. Модуль предоставляет типы атрибутов и элементы, которые можно использовать для описания обмена данными между Alpha.Server и устройствами, поддерживающими протокол МЭК 60870-5.
  • Server – ссылка на модуль Om.Server. Модуль предоставляет типы атрибутов и элементы, которые можно использовать для конфигурирования сервера. Об использовании элементов, предоставляемых модулем Om.Server, можно почитать в разделе Добавление служебных сигналов в Alpha.Server.
  • BACnet – ссылка на модуль Om.BACnet. Модуль предоставляет типы атрибутов и элементы, которые можно использовать для описания обмена данными между Alpha.Server и устройствами, поддерживающими протокол BACnet.
  • CANopen – ссылка на модуль CANopen. Модуль предоставляет типы атрибутов и элементы, которые можно использовать для описания обмена данными между Alpha.Server и устройствами, поддерживающими протокол CANopen.
  • EtherNetIP – ссылка на модуль Om.EtherNetIP. Модуль предоставляет типы атрибутов, которые можно использовать для описания обмена данными между Alpha.Server и ПЛК по протоколу EtherNet/IP.
  • GenericDevices – ссылка на модуль GenericDevices. Модуль предоставляет типы атрибутов и элементы, которые можно использовать для описания обмена данными между Alpha.Server и устройствами, поддерживающими протоколы DCON или Меркурий.
  • History – ссылка на модуль History. Модуль предоставляет типы и элементы, которые можно использовать для описания обмена данными между Alpha.Server и модулем истории.
  • HMI – ссылка на модуль Om.HMI. Модуль предоставляет типы атрибутов для интеграции с Alpha.HMI. Они используются при открытии проекта Alpha.DevStudio в Alpha.HMI.
  • KNX – ссылка на модуль KNX. Модуль предоставляет типы атрибутов и элементы, которые можно использовать для описания обмена данными между Alpha.Server и устройствами, поддерживающими протокол KNX.
  • MDLC – ссылка на модуль MDLC. Модуль предоставляет типы атрибутов и элементы, которые можно использовать для описания обмена данными между Alpha.Server и устройствами, поддерживающими протокол MDLC.
  • MQTT – ссылка на модуль MQTT. Модуль предоставляет типы атрибутов и элементы, которые можно использовать для описания обмена данными между Alpha.Server и брокером по протоколу MQTT.

Добавить ссылку на модуль или проект модуля в проект можно двумя способами:

  • Раскройте элемент Ссылка на модуль из Панели элементов и перенесите необходимую ссылку в проект.
  • Перенесите элемент Ссылка на модуль из Панели элементов в проект. В свойстве Модуль этого элемента выберите необходимый модуль или проект модуля.

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