Exponenta Banner
exponenta event banner

read

Синхронно считывайте данные из групп или элементов OPC DA

Свернуть все на странице

Синтаксис

S = read(GObj)
S = read(IObj)
S = read(GObj,Src)
S = read(IObj,Src)

Описание

пример

S = read(GObj) и S = read(IObj) считайте данные для всех элементов, содержащихся в dagroup объект, GObj, или для вектора daitem объекты, IObj. Данные считываются из кэша Сервера OPC и назначаются структуре S.

Синхронно считать из кэша можно только в том случае, если Active для свойства задано значение 'on' для элемента и группы, содержащей элемент. Предупреждение выдается, если какой-либо из объектов передан read неактивны. Неактивный элемент все еще возвращается в S, но Quality установлено в 'BAD: Out of Service'.

S = read(GObj,Src) и S = read(IObj,Src) считайте данные из источника, заданного Src. Src можно 'cache' или 'device'. Если Src является 'device', данные возвращаются непосредственно с устройства. Если Src является 'cache', данные возвращаются из кэша Сервера OPC, который содержит копию данных устройства. Обратите внимание, что Active свойство игнорируется при чтении из 'device'. Следует также отметить, что чтение данных с устройства может быть медленным.

Когда read операция успешна, Value, Quality, и TimeStamp свойства связанных элементов обновляются с учетом значений, полученных в операции read.

Примеры

свернуть все

Этот пример считывается с устройства и кэша.

Настройте клиент, группу и элемент для сервера Matrikon™ Simulation Server. Установите частоту обновления для этой группы, чтобы предотвратить частые обновления кэша.

da = opcda('localhost','Matrikon.OPC.Simulation');
connect(da);
grp = addgroup(da,'ExRead');
grp.UpdateRate = 20;
itm = additem(grp,'Random.Real8');

Дважды читайте из кэша, отмечая, что значения совпадают каждый раз.

v1 = read(grp)
v2 = read(grp)

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

v3 = read(grp,'device')
v4 = read(grp,'device')

Входные параметры

свернуть все

Группа постоянного тока OPC, заданная как dagroup объект.

Пример: GObj = addgroup()

Элементы OPC DA, заданные как массив объектов opcda.

Пример: IObj = additem()

Источник данных для чтения, заданный как 'device' или 'cache'.

Пример: 'device'

Типы данных: char | string

Выходные аргументы

свернуть все

Считайте данные, возвращенные как структура, содержащая данные для каждого элемента в следующих полях:

Имя поля

Описание

Напечатать

ItemID

Полное имя элемента

вектор символов

Value

Значение

double, вектор символов

Quality

Качество значения

вектор символов

TimeStamp

Время, когда устройство получило значение и качество (если это доступно), или время, когда сервер обновляет или проверяет значение и качество в своем кэше

Вектор дат

Error

Сообщение об ошибке

вектор символов

См. также

Функции

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

Документация OPC Toolbox

Поддержка