exponenta event banner

additem

Добавьте элементы доступа к данным в объект dagroup

Синтаксис

IObj = additem(GObj,'IName')
IObj = additem(GObj,'IName','DataType')
IObj = additem (GObj,'IName','DataType','Active')

Описание

IObj = additem(GObj,'IName') добавляют элементы в групповой объект GObj с полностью определенными идентификаторами элемента, данными IName. Объект IObj является созданным объектом элемента или объектами. Вы задаете IName как один ID элемента или как массив ячеек идентификаторов элемента.

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

По умолчанию IObj активен; то есть, если свойством Subscription группы является on, Value элемента, Quality, и свойства TimeStamp будут обновлены в UpdateRate группы.

Серверы часто требуют, чтобы идентификаторы элемента были заданы в правильном случае. Можно использовать функцию serveritems, чтобы найти допустимые идентификаторы элемента.

Примечание

Вы не можете добавить элементы в общедоступную группу. У общедоступной группы есть фиксированный набор идентификаторов элемента, характерных для всех клиентов, совместно использующих ту группу. Свойство GroupType объекта dagroup указывает на тип группы.

IObj = additem(GObj,'IName','DataType') добавляют элементы в групповой объект GObj с требуемым типом данных, данным ' DataType '. Вы задаете ' DataType ' как массив ячеек из символьных векторов, один для каждого ID элемента. ' DataType ' является типом данных, в котором значение элемента будет храниться в рабочей области MATLAB®. Поддерживаемыми типами данных является 'logical', 'int8', 'uint8', 'int16', 'uint16', 'int32', 'uint32', 'single', 'double', 'char' и 'date'. Обратите внимание на то, что, если требуемый тип данных отклоняется сервером, элемент не добавляется. Требуемый тип данных хранится в свойстве DataType. Канонический тип данных (тип данных, используемый сервером, чтобы сохранить значение элемента), хранится в свойстве CanonicalDataType.

IObj = additem (GObj,'IName','DataType','Active') добавляют элементы в групповой объект GObj с активным состоянием, данным ' Active '. Вы задаете ' Active ' как массив ячеек из символьных векторов, один для каждого ID элемента. ' Active ' может быть 'on' или 'off'. Активное состояние хранится в свойстве Active.

Примеры

Создайте клиент и группу.

da = opcda('localhost','Matrikon.OPC.Simulation');
connect(da);
grp = addgroup(da,'ExAddItem');

Добавьте два элемента с их каноническими типами данных.

itm = additem(grp, {'Random.Real4','Random.Real8'})

Добавьте элемент с типом данных 'double'.

itmDbl = additem(grp,'Random.Int2','double')

Добавьте неактивный элемент.

itmInact = additem(grp,'Random.UInt4','double','off')

Смотрите также

Функции

Представлено до R2006a