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

Введение в события и обратные вызовы

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

В то время как объект прибора связан с прибором, события можно использовать для просмотра сообщения, просмотра данных, анализа данных и т.д. Управление обратными вызовами осуществляется с помощью свойств обратного вызова и функций обратного вызова. Все типы событий имеют связанное свойство обратного вызова. Функции обратного вызова - это функции 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 команда.

Типы событий и свойства обратного вызова

Типы событий 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 Event Information. Эта информация о событии относится только к событию, вызвавшему выполнение функции обратного вызова. Заголовок функции для 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 для отображения связанной с событием информации в командной строке, когда событие, доступное в байтах, происходит во время операции двоичного чтения: