Exponenta Banner

configureCallback

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

свернуть все на странице

Синтаксис

configureCallback(device,"terminator",callbackFcn)
configureCallback(device,"byte",count,callbackFcn)
configureCallback(device,"off")

Описание

пример

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

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

пример

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

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

Поддержка