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

Обзор задачи логгирования

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

Шаг 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. 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 Software), можно управлять уровнем, на котором сервер обновит элементы и сколько записей задача логгирования должна сохранить прежде автоматически остановить задачу логгирования. Вы управляете этими аспектами задачи логгирования при помощи следующих свойств dagroup объект:

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

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

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

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

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

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

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

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

Можно сконфигурировать dagroup возразите так, чтобы MATLAB автоматически выполнил функцию, когда задача логгирования запустится, когда задача логгирования останавливается, и каждый раз, когда конкретное количество записей получено во время задачи логгирования. 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 функция, то управление записи, которые получены из файла. Дополнительные аргументы должны быть заданы именем опции и значением опции. Следующие опции доступны.

Следующий пример получает данные, регистрируемые во время примера на странице Overview Задачи Логгирования, сначала в массив структур, и затем записывает 3 - 6, получены в отдельные массивы для Значения, Качества и 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