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

Введение

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