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

Обзор задачи ведения журнала

Чтобы проиллюстрировать типовую задачу логгирования, в следующем примере на диск и память записываются шесть записей данных из двух элементов, предоставленных Matrikon™ OPC Simulation Server. Во время задачи регистрации данные извлекаются из памяти. Когда задача останавливается, извлекаются оставшиеся записи.

Шаг 1: Создайте иерархию объектов OPC Toolbox.  Этот пример создает иерархию объектов OPC Toolbox для двух элементов, предоставленных сервером симуляции Matrikon. Чтобы запустить этот пример в вашей системе, необходимо установить сервер симуляции Matrikon. Кроме того, можно заменить значения, используемые при создании объектов, значениями для сервера, к которому можно получить доступ.

da = opcda('localhost','Matrikon.OPC.Simulation.1');
connect(da);
grp = addgroup(da,'CallbackTest');
itm1 = additem(grp,'Triangle Waves.Real8');
itm2 = additem(grp,'Saw-Toothed Waves.Boolean');

Шаг 2: настройте длительность регистрации.  Этот пример устанавливает UpdateRate значение до 1 секунды и RecordsToAcquire свойство для 6. Дополнительные сведения об этом шаге см. в разделе Управление Длительности сеанса Логгировании.

grp.UpdateRate = 1;
grp.RecordsToAcquire = 6;

Шаг 3: настройте место назначения регистрации.  В этом примере данные регистрируются на диске и в памяти. Для имени файла диска задано значение LoggingExample.olf. The LogToDiskMode для свойства задано значение 'overwrite', так что, если имя файла существует, механизм тулбокса должен перезаписать файл. Дополнительные сведения об этом шаге см. в разделе Управление адресатом записанных данных.

grp.LoggingMode = 'disk&memory';
grp.LogFileName = 'LoggingExample.olf';
grp.LogToDiskMode = 'overwrite';

Шаг 4: Запустите задачу регистрации.  Запустите dagroup объект. Задача ведения журнала запускается, и сводные данные групп обновляются, отражая состояние ведения журнала. Дополнительные сведения об этом шаге см. в разделе Запуск задачи ведения журнала.

start(grp)
grp

Шаг 5. Отслеживайте прогресс в ведении журнала.  Примерно через 3 секунды получите и отобразите последнее полученное значение. Спустя еще одну секунду получите первые две записи во время задачи ведения журнала. Затем дождитесь выполнения задачи регистрации. Для получения дополнительной информации об этом шаге см. раздел «Мониторинг прогресса выполнения задачи ведения журнала».

pause(3.5)
sPeek = peekdata(grp, 1);
% Display the local event time, item IDs and values
disp(sPeek.LocalEventTime)
disp({sPeek.Items.ItemID;sPeek.Items.Value})
pause(1)
sGet = getdata(grp, 2);
wait(grp)

Шаг 6: Получите данные.  Этот пример извлекает баланс записей в массив структур. Дополнительные сведения об этом шаге см. в разделе Получение данных из памяти.

sFinished = getdata(grp,grp.RecordsAvailable);

Шаг 7: Очистить.  Когда они вам больше не нужны, всегда удаляйте из памяти какие-либо объекты тулбокса и переменные, которые ссылаются на них. Удаление opcda объект клиента также удаляет группу и daitem объекты.

disconnect(da)
delete(da)
clear da grp itm1 itm2

Управление Длительности сеанса Логгирования

Хотя вы не можете гарантировать, что сеанс логгирования займет определенное время (см. раздел «Как данные журналов программного обеспечения OPC Toolbox»), вы можете управлять частотой обновления элементов сервером и количеством записей, которые должны храниться в задаче регистрации перед автоматической остановкой задачи регистрации. Вы управляете этими аспектами задачи регистрации с помощью следующих свойств dagroup объект:

Можно использовать UpdateRate и RecordsToAcquire свойства для определения минимальной длительности задачи регистрации. Длительность задачи регистрации не менее

Для примера, если UpdateRate свойство имеет значение 10 (секунд) и RecordsToAcquire свойство равно 360, тогда при условии, что событие изменения данных генерируется каждый раз, когда сервер запрашивает значения элемента, задача регистрации занимает 3600 секунд или один час.

Управление адресатом записанных данных

Программное обеспечение OPC Toolbox позволяет записывать данные в память, в файл диска или обе памяти и файл диска. При регистрации данных в памяти можно записать только столько данных, сколько будет помещаться в доступную память. Кроме того, если вы удаляете dagroup объект, который регистрировал данные без извлечения этих данных в MATLAB^® рабочая область, данные будут потеряны. Преимущество логгирования данных в памяти заключается в том, что логгирование в память происходит быстрее, чем использование дискового файла.

Логгирование данных в файл диска обычно означает, что можно записать больше данных, и данные не теряются, если вы выходите из MATLAB или удаляете dagroup объект, который регистрировал данные. Однако чтение данных из файла диска происходит медленнее, чем чтение данных из памяти.

The LoggingMode свойство dagroup объект управляет, где хранятся записанные данные. Можно задать 'memory' (значение по умолчанию), или 'disk', или 'disk&memory' как значение для LoggingMode.

Следующие свойства управляют тем, как программное обеспечение OPC Toolbox регистрирует данные на диске. Вы должны задать LoggingMode свойство к 'disk' или 'disk&memory' для того, чтобы эти свойства вступили в эффект:

Сконфигурируйте логирование коллбэков

Можно сконфигурировать dagroup объект, так что MATLAB будет автоматически выполнять функцию, когда начинается задача регистрации, когда задача регистрации останавливается, и каждый раз, когда заданное количество записей получается во время задачи регистрации. The dagroup объект имеет три свойства коллбэка, которые используются во время сеанса логгирования. Каждое свойство коллбэка определяет действие, которое должно выполняться, когда происходит конкретное событие логгирования:

Пример использования коллбэков в задаче регистрации см. в разделе Просмотр недавно записанных данных.

Запуск задачи ведения журнала

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

start(grp)

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

Отслеживайте прогресс выполнения задачи регистрации

Во время задачи логгирования можно контролировать прогресс задачи, исследуя следующие свойства dagroup объект:

Можно контролировать эти свойства в сводке отображения dagroup объект, путем ввода имени dagroup объект в командной строке.

grp

grp =
Summary of OPC Data Access Group Object: group1
   Object Parameters
      Group Type   : private
      Item         : 1-by-1 daitem object
      Parent       : localhost/Matrikon.OPC.Simulation.1
      Update Rate  : 0.5
      Deadband     : 0%
   Object Status
      Active       : on
      Subscription : on
      Logging      : on
   Logging Parameters
      Records      : 120
      Duration     : at least 60 seconds
      Logging to   : disk
      Log File     : group1log.olf ('index' mode)
      Status       : 5 records acquired since starting.
                     0 records available for GETDATA/PEEKDATA

Остановите задачу регистрации

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

Следующий пример вручную останавливает задачу регистрации для dagroup grp объекта.

stop(grp)

Когда задача регистрации останавливается, Logging для свойства задано значение 'off', генерируется событие остановки и StopFcn коллбэк выполняется.

Получение данных из памяти

Вы извлекаете данные из памяти с помощью getdata функция, передача dagroup объект как первый аргумент и количество записей, которые вы хотите получить как второй аргумент. Данные возвращаются как структура, содержащая данные от каждого события изменения данных в задаче регистрации. Например, чтобы извлечь 20 записей для dagroup grp объекта:

s = getdata(grp, 20);

Если вы не задаете второй аргумент, getdata попытается получить количество записей, заданное RecordsToAcquire свойство dagroup объект. Если модуль OPC Toolbox содержит меньше записей для группы, чем запрошено, генерируется предупреждение, и будут получены все доступные записи.

Чтобы получить данные в формате массива, необходимо указать тип данных возвращаемых значений. Вы передаете вектор символов, определяющий этот тип данных как дополнительный аргумент к getdata функция. Допустимыми типами данных являются любые типы числовых данных MATLAB (для примера 'double' или 'uint32') плюс 'cell' для обозначения типа данных массива ячеек MATLAB.

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

Например, чтобы извлечь 20 записей записанных данных в формате двойного массива из dagroup grp объекта.

[itmID,val,qual,tStamp,evtTime] = getdata(grp,20,'double');

После извлечения данных в рабочее пространство MATLAB с помощью getdataзаписи удаляются из модуля тулбокса, чтобы освободить память для дополнительных записанных записей. Если вы задаете меньшее количество записей, чем доступное в памяти, getdata будет извлекать самые старые записи. Можно использовать RecordsAvailable свойство dagroup объект, чтобы определить, сколько записей сохранено в механизме тулбокса для этой группы.

Во время задачи ведения журнала можно изучить самые последние полученные записи с помощью peekdata функция, передача dagroup объект как первый аргумент и количество записей, которые нужно получить как второй аргумент. Данные возвращаются в структуре. Вы не можете вернуть данные в отдельные массивы, используя peekdata. Вы можете преобразовать структуру, возвращенную peekdata в отдельные массивы с помощью opcstruct2array функция. Данные, извлеченные с помощью peekdata не удаляется из модуля тулбокса.

Для примера использования getdata и peekdata во время задания ведения журнала см. Обзор задачи ведения журнала.

Когда вы удаляете dagroup объект, данные, сохраненные в механизме тулбокса для этого объекта, также удаляются.

Получение данных с диска

Можно получить данные из файла диска в рабочее пространство MATLAB с помощью opcread функция. Имя файла, содержащего записанные в журнал OPC Data, передается в качестве первого аргумента. Данные, хранящиеся в файле журнала, возвращаются как массив структур в том же формате, что и структура, возвращенная getdata. Записи, извлеченные из файла журнала в рабочее пространство MATLAB, не удаляются из файла журнала.

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

В следующем примере данные, записанные во время примера на странице Обзор задачи регистрации, сначала в массив структур, а затем записи 3-6 извлекаются в отдельные массивы для Value, Quality и TimeStamp.

sDisk = opcread('LoggingExample.olf')

sDisk = 
40x1 struct array with fields:
    LocalEventTime
    Items

[i,v,q,t,e] = opcread('LoggingExample.olf', ...
    'records',[3,6], 'datatype','double')
i = 
    'Random.Real8'    'Random.UInt2'    'Random.Real4'
v =
  1.0e+004 *
    0.7819    3.0712    1.4771
    1.5599    2.7792    2.2051
    1.4682    0.4055    0.5315
    0.0235    2.4473    1.5456
q = 
  'Good: Non-specific'  'Good: Non-specific'  'Good: Non-specific'
  'Good: Non-specific'  'Good: Non-specific'  'Good: Non-specific'
  'Good: Non-specific'  'Good: Non-specific'  'Good: Non-specific'
  'Good: Non-specific'  'Good: Non-specific'  'Good: Non-specific'
t =
  1.0e+005 *
    7.3202    7.3202    7.3202
    7.3202    7.3202    7.3202
    7.3202    7.3202    7.3202
    7.3202    7.3202    7.3202
e =
  1.0e+005 *
    7.3202
    7.3202
    7.3202
    7.3202