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

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

Чтобы проиллюстрировать типичную задачу журналирования, следующий пример регистрирует к диску и памяти шесть записей данных из двух элементов, обеспеченных Сервером Симуляции 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