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

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

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

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