configureCallback

Установите функцию обратного вызова и инициируйте условие для связи с устройством последовательного порта

Описание

пример

configureCallback(device,"terminator",callbackFcn) устанавливает функцию обратного вызова callbackFcn инициировать каждый раз, когда терминатор строки доступен, чтобы быть считанным из заданного последовательного порта. Синтаксис устанавливает BytesAvailableFcnMode свойство device к "terminator" и BytesAvailableFcn свойство к callbackFcn.

Установите использование символа терминатора строки configureTerminator.

пример

configureCallback(device,"byte",count,callbackFcn) устанавливает функцию обратного вызова callbackFcn инициировать каждый раз, когда новый count количество байтов доступно, чтобы быть считанным. Синтаксис устанавливает BytesAvailableFcnMode свойство device к "byte", BytesAvailableFcnCount свойство к count, и BytesAvailableFcn свойство к callbackFcn.

пример

configureCallback(device,"off") выключает коллбэки. Синтаксис устанавливает BytesAvailableFcnMode свойство device к "off".

Примеры

свернуть все

Создайте связь с устройством последовательного порта.

device = serialport("COM3",9600)
device = 

  Serialport with properties:

                 Port: "COM3"
             BaudRate: 9600
    NumBytesAvailable: 0

  Show all properties, functions

Установите коллбэк инициировать, когда терминатор строки будет доступен, чтобы быть считанным.

configureCallback(device,"terminator",@callbackFcn)

Просмотрите свойства подтвердить изменение.

device.BytesAvailableFcnMode
device.BytesAvailableFcn
ans = 

    "terminator"


ans =

  function_handle with value:

    @callbackFcn

Выключите коллбэк.

configureCallback(device,"off")

Проверьте, что коллбэк выключен.

device.BytesAvailableFcnMode
ans = 

    "off"

Создайте связь с устройством последовательного порта.

device = serialport("COM3",9600)
device = 

  Serialport with properties:

                 Port: "COM3"
             BaudRate: 9600
    NumBytesAvailable: 0

  Show all properties, functions

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

configureCallback(device,"byte",50,@callbackFcn)

Просмотрите свойства подтвердить изменение.

device.BytesAvailableFcnMode
device.BytesAvailableFcnCount
device.BytesAvailableFcn
ans = 

    "byte"


ans =

    50


ans =

  function_handle with value:

    @callbackFcn

Выключите коллбэк.

configureCallback(device,"off")

Проверьте, что коллбэк выключен.

device.BytesAvailableFcnMode
ans = 

    "off"

Создайте связь с устройством последовательного порта.

device = serialport("COM3",9600)
device = 

  Serialport with properties:

                 Port: "COM3"
             BaudRate: 9600
    NumBytesAvailable: 0

  Show all properties, functions

Создайте функцию обратного вызова, которая читает, ASCII отключил данные о строке и сохраняет их в UserData свойство device.

function readSerialData(src,evt)
    data = readline(src);
    src.UserData = data;
end

Установите коллбэк инициировать, когда терминатор строки будет доступен, чтобы быть считанным.

configureCallback(device,"terminator",@readSerialData)

Входные параметры

свернуть все

Связь последовательного порта в виде a serialport объект.

Пример: configureCallback(device,"byte",128,@callbackFcn) устанавливает callbackFcn коллбэк, чтобы инициировать каждый раз 128 байтов новых данных доступен, чтобы быть считанным из связи последовательного порта device.

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

Пример: configureCallback(device,"byte",128,@callbackFcn) устанавливает callbackFcn коллбэк, чтобы инициировать каждый раз 128 байтов новых данных доступен, чтобы быть считанным.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

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

Пример: configureCallback(device,"terminator",@callbackFcn) устанавливает callbackFcn коллбэк, чтобы инициировать, когда терминатор строки доступен, чтобы быть считанным.

Типы данных: function_handle

Смотрите также

Функции

Введенный в R2019b