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 как идентификатор отдельного элемента или как массив ячеек с идентификаторами элементов.

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

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

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

Примечание

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

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

IObj = additem (GObj,'IName','DataType','Active') добавляет элементы к групповому объекту GObj с активным статусом, заданным 'Active'. Вы задаете 'Active' как массив ячеек из векторов символов, по одному для каждого идентификатора элемента. '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