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

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

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

В то время как объект инструмента соединяется с инструментом, можно использовать события для отображения сообщения, отображения данных, анализа данных и так далее. Коллбэки управляются через свойства коллбэка и функции обратного вызова. Все типы событий имеют связанное свойство коллбэка. Функции обратного вызова являются 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. The Type поле содержит тип события, в то время как Data поле содержит информацию о событии. Как описано в разделе Создание и выполнение функций обратного вызова, эти два поля связаны со структурой, которую вы задаете в заголовке функции обратного вызова. Сведения о хранении информации о событиях в файле записи см. в разделе «Отладка: Запись информации на диск».

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

The 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 для отображения связанной с событием информации в командной строке, когда событие, доступное в байтах, происходит во время двоичной операции чтения: