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

Введение

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

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

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

Пример - введение в События и обратные вызовы

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

s = serial('COM1');
s.BytesAvailableFcnMode = 'terminator';
s.BytesAvailableFcn = @instrcallback;
fopen(s)
fprintf(s,'*IDN?')
out = fscanf(s);

Отображения MATLAB:

BytesAvailable event occurred at 17:01:29 for the object: 
Serial-COM1.

Закончите сеанс последовательного порта.

fclose(s)
delete(s)
clear s

Чтобы видеть код для встроенной функции instrcallback, используйте команду type.

Event Types and Callback Properties

Следующая таблица описывает типы событий последовательного порта и свойства коллбэка. Эта таблица имеет два столбца и девять строк. В первом столбце (тип события) второй элемент (доступные байты) применяется к строкам 2 - 4. Кроме того, в первом столбце последний элемент (таймер) применяется к строкам 8 и 9.

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

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

Следующая таблица показывает типы событий и значения для полей Type и Data. Таблица имеет три столбца и 15 строк. Элементы в первом столбце (тип события) промежуток несколько строк, можно следующим образом:

Прерывание пропуска: строки 1 и 2

BytesAvailable: строки 3 и 4

Ошибка: строки 5 - 7

Пустой вывод: строки 8 и 9

PinStatus: строки 10 - 13

Таймер: строки 14 и 15

Следующие темы описывают значения полей Data.

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

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

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

s.BytesAvailableFcnMode = 'terminator';
s.BytesAvailableFcn = @mycallback;

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

s.BytesAvailableFcn = {'mycallback'};

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

function mycallback(obj,event)

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

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

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

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

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

function mycallback(obj,event,time)

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

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

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

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

Пример - Используя События и обратные вызовы

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