Alpha.Community

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

Свойства

Отображаемое имя

Описание объекта (поля объекта). Позволяет указать произвольное (например, русскоязычное) имя для узнаваемости объекта (поля объекта) в проекте. Не мешает использованию базового англоязычного имени объекта (поля объекта) для обращения в коде.

Кардинальное число

Преобразует объект в массив и задает размер массива (количество элементов в массиве).

Значение

1 Одиночный объект.
>1 Массив соответствующей размерности.

Длина

int8 Length

Размер массива (количество элементов в массиве).

Есть только у массивов и доступно только для чтения в режиме рантайма.

Примеры

Записать в текстовое поле длину массива.

TextEdit_1.Text = Str.ToString(SW_1.Length);

Индекс

int8 Index

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

Есть только у массивов и доступно только для чтения в режиме рантайма.

Примеры

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

TextEdit_2.Text = Str.ToString(Index);

Записать в текстовое поле текущее значение элемента массива, у которого сработало событие изменения значения.

TextEdit_3.Text = Str.ToString(penwidth[Index]);

В зависимости от индекса элемента в массиве вывести в текстовое поле запись о включении соответствующего режима работы задвижки.

if (SW_1.Mode.Index == 0)
{
ㅤTextEdit_1.Text = "Включен режим 1";
}
else
{
ㅤTextEdit_1.Text = "Включен режим 2";
}

Хост

string Location

Сетевой адрес OPC DA источника данных. Для локального компьютера используется IP-адрес: 127.0.0.1.

Изменение этого адреса во время рантайма инициирует переподключение к новому хосту.

Примеры

Вывести сетевой адрес источника данных в поле ввода.

TextEdit.Text = OpcSource.Location;

ProgID

string ProgID

ProgID источника данных. Для Alpha.Server данный параметр содержится в конфигурационном файле Alpha.Server.xml. По умолчанию параметр равен AP.OPCDAServer.

Изменение ProgID во время рантайма запускает процесс переподключения к серверу с новым идентификатором.

Примеры

Вывести ProgID источника данных в поле ввода.

TextEdit.Text = OpcSource.ProgId;

Путь

string Path

Путь до целевой ветки дерева сигналов OPC DA источника данных. Если путь не указан, то по умолчанию целевой веткой будет считаться корень дерева сигналов источника данных.

Доступна возможность переопределения пути во время рантайма.

Примеры

Вывести путь до целевой ветки дерева сигналов источника в поле ввода.

TextEdit.Text = OpcSource.Path;

Родительский источник

Свойство для создания иерархии источников данных. Например, на экранной форме можно разместить три компонента Источник OPC, первый из которых будет содержать параметры подключения (свойства Хост и ProgID). Второй и третий источники лишь будут определять конкретные ветки дерева сигналов (свойство Путь), но ссылаться при этом на первый источник как на Родительский источник.

Примеры

Записать в поле ввода сетевой адрес родительского источника.

TextEdit_1.Text = OpcSource_1.ParentSource.Location;

Записать в поле ввода код состояния подключения родительского источника.

TextEdit_1.Text = String.ToString(OpcSource_1.ParentSource.ConnectionState);

Активность

bool Active

Активность источника OPC. С неактивными источниками не происходит обмен данными.

Примеры

Записать текущее состояние OPC DA источника в поле ввода.

TextEdit_1.Text = String.ToString(OpcSource_1.Active);

Период обновления данных

uint8 UpdateRate

Свойство определяет периодичность обновления данных, поступающих из источника. Измеряется в миллисекундах. К примеру, значение свойства 10000 говорит о том, что Alpha.HMI раз в 10 секунд будет обращаться к источнику, чтобы обновить значения по всем сигналам источника, задействованным в проекте. Если значение свойства равно 0, то новые значения сигналов будут отображаться на формах Alpha.HMI сразу же.

Примеры

Записать значение периода обновления в текстовое поле.

TextEdit_1.Text = String.ToString(OpcSource_1.UpdateRate);

Период переподписки

uint8 ReAdvise

Свойство определяет интервал времени, через который будет производиться переподписка на динамические сигналы источника. Измеряется в миллисекундах. К примеру, значение свойства 10000 говорит о том, что Alpha.HMI раз в 10 секунд будет обращаться к источнику, чтобы восстановить подписку на сигналы и подписаться на появившиеся за этот интервал динамические сигналы. Если значение свойства равно 0, то переподписка не выполняется.

Примеры

Записать значение периода переподписки в текстовое поле.

TextEdit_1.Text = String.ToString(OpcSource_1.ReAdvise);

Полный тег

string Tag

Полный путь Источника OPC, формируемый путём конкатенации путей родительских источников.

Доступно только для чтения в режиме рантайма.

Состояние соединения

Код состояния подключения к источнику данных.

Доступно только для чтения в режиме рантайма.

Значение

0 Отключен.
1 В процессе подключения.
2 Подключен.
3 В процессе отключения.

Примеры

Записать код состояния подключения к источнику OPC в текстовое поле.

TextEdit_1.Text = String.ToString(OpcSource_1.ConnectionState);

Тип ошибки

Код ошибки подключения к источнику OPC.

Доступно только для чтения в режиме рантайма.

Значение

0 Ошибок нет.
1 Ошибка инициализации.

Примеры

Записать код ошибки подключения к источнику OPC в поле редактирования.

TextEdit_1.Text = String.ToString(OpcSource_1.ErrorState);

Строковое описание ошибки

string ErrorString

Описание ошибки подключения к источнику данных в текстовом виде.

Доступно только для чтения в режиме рантайма.

Примеры

Записать описание ошибки подключения к источнику OPC в поле редактирования.

TextEdit_1.Text = OpcSource_1.ErrorString;