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

Введение в События и коллбэки

Можно улучшить степень и гибкость инструментального приложения управления при помощи событий. Событие имеет место после того, как условие соблюдают и может привести к одному или нескольким коллбэкам.

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

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

Этот пример использует функцию обратного вызова instrcallback, чтобы отобразить сообщение к командной строке, когда доступное байтам событие имеет место. Событие сгенерировано, когда значение свойства EOSCharCode читается.

g = gpib('ni',0,1);
g.BytesAvailableFcnMode = 'eosCharCode';
g.BytesAvailableFcn = @instrcallback;
fopen(g)
fprintf(g,'*IDN?')
readasync(g)

Получившееся отображение от instrcallback показывают ниже.

BytesAvailable event occurred at 17:30:11 for the object: GPIB0-1.

Закончите сеанс GPIB.

fclose(g)
delete(g)
clear g

Вы видите код для встроенной функции instrcallback при помощи команды type.

Event Types and Callback Properties

Типы событий GPIB и сопоставленные свойства коллбэка описаны ниже.

Ответ на информацию о событии

Можно ответить на информацию о событии в функции обратного вызова или в файле записи. Информация о событии, сохраненная в функции обратного вызова, использует два поля: Type и Data. Поле Type содержит тип события, в то время как поле Data содержит привязанную к конкретному событию информацию. Как описано в Создании и Выполнении Функций обратного вызова, эти два поля сопоставлены со структурой, которую вы задаете в заголовке функции обратного вызова. Обратитесь к Отладке: Запись информации к Диску, чтобы узнать о хранении информации о событии в файле записи.

Типы событий и значения для полей Type и Data приведены ниже.

Значения полей Data описаны ниже.

day-month-year hour:minute:second

Создание и выполнение функций обратного вызова

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

Например, чтобы выполнить функцию обратного вызова mycallback каждый раз значение свойства EOSCharCode читается из вашего инструмента,

g.BytesAvailableFcnMode = 'eosCharCode';
g.BytesAvailableFcn = @mycallback;

Также можно задать функцию обратного вызова как массив ячеек.

g.BytesAvailableFcn = {'mycallback'};

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

function mycallback(obj,event)

Вы передаете дополнительные параметры функции обратного вызова включением и функция обратного вызова и параметры как элементы массива ячеек. Например, чтобы передать переменную MATLAB time mycallback,

time = datestr(now,0);
g.BytesAvailableFcnMode = 'eosCharCode';
g.BytesAvailableFcn = {@mycallback,time};

Также можно задать mycallback как вектор символов в массиве ячеек.

g.BytesAvailableFcn = {'mycallback',time};

Соответствующий функциональный заголовок

function mycallback(obj,event,time)

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

Включение функций обратного вызова после того, как они ошибка

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

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

Используя События и коллбэки, чтобы считать двоичные данные

Этот пример расширяет Чтение и Запись Двоичных данных при помощи функции обратного вызова instrcallback, чтобы отобразить событийную информацию к командной строке, когда доступное байтам событие имеет место во время бинарной операции чтения: