Alpha.Community

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

SetPoints

SetPoints – тип, предназначенный для размещения на форме Alpha.HMI.

Тип SetPoints не является полноценной заменой приложения Alpha.HMI.SetPoints: экземпляр типа отличается тем, что в нем нет верхней панели инструментов и строки статуса.

Тип можно использовать для создания собственного приложения для просмотра и редактирования уставок.

Тип, используемый в проекте Alpha.HMI, в режиме рантайма создает файлы, описанные в таблице ниже.

Файл Расположение Назначение
settings.json
  • C:\ProgramData\Automiq\HMI.SetPoints для ОС Windows;
  • /home/<user>/Automiq/HMI.SetPoints для ОС Linux.

Хранит информацию о папке, хранящей конфигурационный файл, папке экспорта и настройках печати.

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

session.json
  • C:\Users\<user>\Automiq\HMI.SetPoints для ОС Windows;
  • /home/<user>/Automiq/HMI.SetPoints для ОС Linux.

Хранит информацию об окне просмотра уставок: последней открытой карте уставок, размере колонок таблицы, использовании журнала и т.п..

Файл используется для работы типа, менять его содержимое не рекомендуется.

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

Пример создания собственного приложения

В примере показано, как:

  • загрузить в текущий экземпляр типа конфигурационный файл с картами уставок;
  • прочитать данные из ПЛК и записать данные в ПЛК;
  • загрузить данные из архива уставок и сохранить данные в архив;
  • блокировать кнопки, функциональность которых не используется для текущего источника данных.

Для начала работы разместите на форме экземпляр типа SetPoints и необходимые кнопки. Пусть собственное приложение выглядит следующим образом:

Загрузить конфигурационный файл

Карты уставок хранятся в конфигурационном файле. Подробнее об этом – в разделе Создание конфигурационного файла.

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

  1. В свойстве Путь к файлу конфигурации (ConfigFilePath) экземпляра типа SetPoints укажите путь к нужному файлу.
  2. Вызовите функцию Open() экземпляра типа SetPoints – например, в обработчике события Opened открываемой формы. В качестве входного параметра укажите значение свойства Путь к файлу конфигурации (ConfigFilePath) этого экземпляра:

    SetPoints.Open(SetPoints.ConfigFilePath);

Подключиться к источнику (ПЛК)

Если в качестве источника данных будет использоваться ПЛК, то необходимо в свойстве Режим работы экземпляра типа SetPoints указать значение 0 (ПЛК) или оставить это поле пустым. Также необходимо указать источник подключения. Для этого можно:

  1. Добавить на форму экземпляр типа Источник AP.
  2. В добавленном экземпляре указать значение свойств Хост и Порт, а у свойства Активность установить значение true.
  3. В свойстве init_ApSource экземпляра типа SetPoints сослаться на созданный экземпляр типа Источник AP.

В результате при запуске проекта в рантайм произойдет подключение к источнику, указанному в свойстве init_ApSource экземпляра типа SetPoints.

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

  1. Добавить на форму экземпляр типа Учётныe данные AP.
  2. Вызвать функцию SetPassword() экземпляра типа Учётныe данные AP, в качестве входного параметра указать пароль.

    ApCredentials_1.SetPassword("MyPassword123!");
  3. В свойстве Источник учетных данных экземпляра типа Источник AP сослаться на созданный экземпляр типа Учётныe данные AP.

В результате при запуске проекта в режиме рантайма в экземпляр типа Учётныe данные AP будет передано значение пароля.

Прочитать данные из ПЛК

Чтобы читать данные из ПЛК по нажатию кнопки, разместите на форме экземпляр типа Кнопка. В обработчике события ButtonPressed этого экземпляра используйте команду ReadFromPlc экземпляра типа SetPoints:

SetPoints.ReadFromPlc.Invoke();

Теперь по нажатию этой кнопки в экземпляр типа SetPoints будут загружены значения уставок из ПЛК.

Записать данные в ПЛК

Чтобы записать данные в ПЛК по нажатию кнопки, разместите на форме экземпляр типа Кнопка. В обработчике события ButtonPressed этого экземпляра используйте команду WriteToPlc экземпляра типа SetPoints:

SetPoints.WriteToPlc.Invoke();

Теперь по нажатию этой кнопки значения уставок из экземпляра типа SetPoints будут записаны в ПЛК.

Загрузить данные из архива уставок

Чтобы загрузить данные из архива уставок по нажатию кнопки, разместите на форме экземпляр типа Кнопка. В обработчике события ButtonPressed этого экземпляра используйте команду LoadFromArchive экземпляра типа SetPoints:

SetPoints.LoadFromArchive.Invoke();

Теперь по нажатию этой кнопки будет открываться диалоговое окно загрузки уставок в экземпляр типа SetPoints из архива уставок.

Архив уставок имеет расширение *.spdb.

Сохранить данные в архив

Чтобы сохранить данные в архив по нажатию кнопки, разместите на форме экземпляр типа Кнопка. В обработчике события ButtonPressed этого экземпляра используйте команду SaveToArchive экземпляра типа SetPoints:

SetPoints.SaveToArchive.Invoke();

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

Если в качестве источника данных используются архивные файлы, то по нажатию этой кнопки:

  1. Открывается диалоговое окно сохранения уставок в файл архива уставок с расширением *.spdb.
  2. Уставки сохраняются в оперативный архив. Каждая карта уставок сохраняется в отдельном файле.

Оперативный архив располагается в папке C:\ProgramData\Automiq\HMI.SetPoints\Archive. Файлы оперативного архива не имеют расширения.

Вывести информацию о типе источника данных и заблокировать кнопки

Экземпляр типа SetPoints может быть подключен к одному из двух типов источников данных: ПЛК или архивные файлы. Чтобы узнать, к какому типу источника экземпляр типа подключен в данный момент, получите значение свойства Режим работы (0 - ПЛК, 1 - Архив) (Mode) текущего экземпляра типа. Информацию о типе текущего источника данных можно вывести в текстовое поле, размещенное на форме. Подробнее о текстовом поле можно почитать в документации на Alpha.HMI (Справочное руководство → Компоненты для построения пользовательского интерфейса → Текст).

Чтение данных из ПЛК возможно только в режиме ПЛК, а чтение данных из архива уставок возможно только в режиме Архив. Для удобства можно блокировать кнопки, функциональность которых не предусмотрена для текущего источника данных. Используйте для этого свойство Включено (Enabled) экземпляра типа Кнопка. Подробнее об этом свойстве можно почитать в документации на Alpha.HMI (Справочное руководство → Компоненты для построения пользовательского интерфейса → Кнопка).

Чтобы при запуске описываемого здесь приложения отобразилась информация о типе источника, а неиспользуемые кнопки были заблокированы, дополните код обработчика события Opened следующими строками:

if(SetPoints.Mode==0)
{
 Text="ПЛК";
 LoadFromArchiveButton.Enabled=false;
}
else
{
 Text="Архив";
 ReadFromPlcButton.Enabled=false;
}

Если в качестве источника данных используется ПЛК, то:

  • в текстовом поле Text появится название этого источника данных;
  • кнопка загрузки данных из архива уставок будет заблокирована.

Если в качестве источника данных используются архивные файлы, то:

  • в текстовом поле Text появится название этого источника данных;
  • кнопка загрузки данных из ПЛК будет заблокирована.