exponenta event banner

Типы событий

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

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

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

События и свойства функции обратного вызова

Событие

Свойство коллбэка

Описание

Асинхронная отмена

CancelAsyncFcn

Тулбокс генерирует отмену асинхронное событие, когда асинхронная операция отменяется. Вы отменяете асинхронную операцию с помощью функции cancelasync.

Когда отмена, которую асинхронное событие имеет место, тулбокс, выполняет функцию, заданную свойством CancelAsyncFcn. По умолчанию тулбокс выполняет функцию обратного вызова по умолчанию для этого события, opccallback, который отображает информацию об отмене асинхронное событие в командной строке MATLAB®.

Асинхронные события отмены имеют место на уровне объектов dagroup.

Изменение данных

DataChangeFcn

Тулбокс генерирует событие изменения данных, когда сервер уведомляет тулбокс, что данные для группы изменились. Сервер уведомит тулбокс изменений данных, только если свойство Active группы установлено в 'on', и свойство Subscription установлено в 'on'. Для получения дополнительной информации об управлении событиями изменения данных смотрите События Изменения Данных и Подписку.

Когда событие изменения данных имеет место, тулбокс выполняет функцию, заданную свойством DataChangeFcn.

События изменения данных имеют место на уровне объектов dagroup.

Ошибка

ErrorFcn

Тулбокс генерирует ошибочное событие, когда ошибка времени выполнения происходит, такие как ошибка преобразования типа данных или тайм-аут. Ошибки времени выполнения не включают ошибки настройки, такие как установка недопустимого значения свойства.

Когда ошибочное событие имеет место, тулбокс выполняет функцию, заданную свойством ErrorFcn. По умолчанию тулбокс выполняет функцию обратного вызова по умолчанию для этого события, opccallback, который отображает сообщение об ошибке в командной строке MATLAB.

Ошибочные события имеют место на уровне объекта клиента opcda.

Readasync

ReadAsyncFcn

Тулбокс генерирует чтение асинхронное событие, когда асинхронная операция чтения завершается. Вы выполняете асинхронную операцию чтения с помощью функции readasync.

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

Читайте асинхронные события имеют место на уровне объектов dagroup.

Полученные записи

RecordsAcquiredFcn

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

То, когда записи получили событие, происходит, тулбокс выполняет функцию, заданную свойством RecordsAcquiredFcn.

Полученные события записей имеют место на уровне объектов dagroup.

Завершение работы

ShutDownFcn

Тулбокс генерирует событие завершения работы, когда Сервер OPC уведомляет клиент, что сервер собирается закрыться.

Когда событие завершения работы имеет место, тулбокс выполняет функцию, заданную свойством ShutDownFcn, и объект клиента затем отключается от сервера. По умолчанию тулбокс выполняет функцию обратного вызова по умолчанию для этого события, opccallback, который отображает информацию о событии завершения работы в командной строке MATLAB.

Завершите работу события имеют место на уровне объекта клиента opcda.

Запуск

StartFcn

Тулбокс генерирует событие запуска, когда объект запускается. Вы используете функцию start, чтобы запустить объект.

Примечание

Если ошибка происходит в функции обратного вызова запуска, объект не запускается.

Когда событие запуска имеет место, тулбокс выполняет функцию, заданную свойством StartFcn.

Запустите события имеют место на уровне объектов dagroup.

Остановка

StopFcn

Тулбокс генерирует событие остановки, когда объект прекращает запускаться. Объект прекращает запускаться, когда функция stop вызвана, или когда конкретное количество записей получено.

Когда событие остановки имеет место, тулбокс выполняет функцию, заданную свойством StopFcn.

Остановитесь события имеют место на уровне объектов dagroup.

Таймер

TimerFcn

Тулбокс генерирует событие таймера, когда целочисленное кратное заданное количество времени истекает. Вы используете свойство TimerPeriod задать количество времени. Время измеряется относительно того, когда объект клиента opcda соединяется.

Примечание

Некоторые события таймера не могут выполниться, если вашу систему значительно замедляют или если TimerPeriod установлен слишком маленький.

Когда событие таймера имеет место, тулбокс выполняет функцию, заданную свойством TimerFcn.

События таймера имеют место на уровне объекта клиента opcda.

Запишите асинхронный

WriteAsyncFcn

Тулбокс генерирует запись асинхронное событие, когда асинхронная операция записи завершается. Вы выполняете асинхронную операцию записи с помощью функции writeasync.

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

Запишите, что асинхронные события имеют место на уровне объектов dagroup.