exponenta event banner

Типы событий

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

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

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

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

Событие

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

Описание

Отменить Async

CancelAsyncFcn

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

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

Отмена асинхронных событий происходит в dagroup уровень объекта.

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

DataChangeFcn

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

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

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

Ошибка

ErrorFcn

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

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

События ошибки происходят в opcda уровень клиентского объекта.

Чтение Async

ReadAsyncFcn

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

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

Чтение асинхронных событий происходит в dagroup уровень объекта.

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

RecordsAcquiredFcn

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

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

Записи приобретенных событий происходят в dagroup уровень объекта.

Закрыть

ShutDownFcn

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

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

События завершения работы происходят в opcda уровень клиентского объекта.

Начать

StartFcn

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

Примечание

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

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

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

Стоп

StopFcn

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

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

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

Таймер

TimerFcn

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

Примечание

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

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

События таймера происходят в opcda уровень клиентского объекта.

Запись Async

WriteAsyncFcn

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

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

Запись асинхронных событий происходит в dagroup уровень объекта.