bluetooth

Свяжите с устройством Классики Bluetooth

Описание

A bluetooth объект представляет связь с устройством Bluetooth® Classic от вашего использующего компьютеры Профиля последовательного порта (SPP) Bluetooth. Идентифицируйте соседние устройства, чтобы соединиться с "Ready to connect" состояние в bluetoothlist вывод . Необходимо соединить устройство с компьютером сначала прежде, чем соединиться с ним от MATLAB®.

Создание

Описание

device = bluetooth создает связь с последним успешно соединенным устройством Классики Bluetooth.

device = bluetooth(name) создает связь с устройством Классики Bluetooth с помощью его имени. Канал является каналом SPP по умолчанию 1. Вход name устанавливает Name свойство.

пример

device = bluetooth(name,channel) создает связь с заданным каналом SPP channel из устройства Классики Bluetooth. Вход channel устанавливает Channel свойство.

device = bluetooth(address) создает связь с устройством Классики Bluetooth с помощью его адреса. Вход address устанавливает Address свойство.

device = bluetooth(address,channel) создает связь с заданным каналом SPP channel из устройства Классики Bluetooth.

device = bluetooth(address,channel,Name,Value) создает связь и устанавливает дополнительные свойства с помощью одного или нескольких аргументов пары "имя-значение". Установите ByteOrder и Timeout аргументы пары "имя-значение" использования свойств. Заключите каждое имя свойства в кавычки, сопровождаемые желаемым значением свойства.

Пример: device = bluetooth("23E16522A7C0",2,"ByteOrder","little-endian","Timeout",10) подключения к bluetooth-устройству с прямым порядком байтов и периодом тайм-аута 10 секунд.

Свойства

развернуть все

Свойства создания объекта

Имя bluetooth-устройства в виде вектора символов или строкового скаляра. Идентифицируйте имя устройства, которым вы хотите соединить к использованию информации, возвращенной bluetoothlist. Это свойство может быть установлено только при создании объекта.

Пример: device = bluetooth("CO2 Sensor") подключения к bluetooth-устройству назвали Датчик CO2.

Типы данных: char | string

Адрес устройства Bluetooth в виде вектора символов или строкового скаляра. Идентифицируйте адрес устройства, которым вы хотите соединить к использованию информации, возвращенной bluetoothlist. Это свойство может быть установлено только при создании объекта.

Пример: device = bluetooth("23E16522A7C0"), device = bluetooth("23:E1:65:22:A7:C0"), и device = bluetooth("23-E1-65-22-A7-C0") все подключение к bluetooth-устройству с адресом 23E16522A7C0.

Типы данных: char | string

Канал bluetooth-устройства в виде положительного числа. Идентифицируйте канал устройства, которым вы хотите соединить к использованию информации, возвращенной bluetoothlist. Это свойство может быть установлено только при создании объекта.

Пример: device = bluetooth("CO2 Sensor",2) подключения к каналу 2 на Датчике CO2.

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

Последовательный порядок, в котором байты располагаются в большие численные значения в виде "little-endian" или "big-endian". Установите это свойство при создании объекта с помощью аргумента пары "имя-значение". Можно также изменить его после создания объекта с помощью записи через точку.

Пример: device = bluetooth("23E16522A7C0",2,"ByteOrder","little-endian") и device.ByteOrder = "little-endian" установите порядок байтов на прямой порядок байтов.

Типы данных: char | string

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

Пример: device.Timeout = 60 устанавливает период тайм-аута на 60 секунд.

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

Считайте и запишите свойства

Это свойство доступно только для чтения.

Количество байтов, доступных в чтение, возвращенное как числовое значение.

Пример: device.NumBytesAvailable возвращает количество байтов, доступных в чтение.

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

Это свойство доступно только для чтения.

Общее количество байтов записано в устройство, возвращенное как числовое значение.

Пример: device.NumBytesWritten возвращает количество записанных байтов.

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

Символ Терминатора для чтения и записи отключенных ASCII данных, возвращенных как "LF", "CR", или "CR/LF", или номер от 0 до 255, включительно. Если чтение и терминаторы строки записи отличаются, Terminator возвращен как 1x2 массив ячеек этих значений. Установите это свойство с configureTerminator функция.

Пример: configureTerminator(device,"CR") наборы оба чтение и терминаторы строки записи к CR.

Пример: configureTerminator(device,"CR",10) устанавливает терминатор строки чтения на CR и терминатор строки записи к 10.

Типы данных: double | char | string | cell

Свойства коллбэка

Байты доступный триггерный режим коллбэка, возвращенный как "off", "byte", или "terminator". Эта установка определяет, выключен ли коллбэк, инициирован количеством байтов, заданных BytesAvailableFcnCount, или инициированный терминатором строки задан Terminator. Установите это свойство с configureCallback функция.

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

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

Пример: configureCallback(device,"off") выключает коллбэки.

Типы данных: char | string

Количество байтов данных, чтобы инициировать коллбэк, заданный BytesAvailableFcn, возвращенный как двойное. Это значение используется только когда BytesAvailableFcnMode свойством является "byte". Установите эти свойства с configureCallback функция.

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

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

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

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

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

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

Пример: device.ErrorOccurredFcn = @myErrorFcn

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

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

Пример: device.UserData

Функции объекта

readСчитайте данные из bluetooth-устройства
readlineПрочитайте строку данных о строке ASCII из bluetooth-устройства
writeЗапишите данные к bluetooth-устройству
writelineЗапишите линию данных о ASCII к bluetooth-устройству
configureTerminatorУстановите терминатор строки для связи строки ASCII с bluetooth-устройством
configureCallbackУстановите функцию обратного вызова и инициируйте условие для связи с bluetooth-устройством
flushОчистите буферы bluetooth-устройства

Примеры

свернуть все

Ищите и установите связь со своим устройством Классики Bluetooth.

Отсканируйте для соседних устройств.

bluetoothlist
list=5×4 table
        Name            Address        Channel          Status      
    _____________    ______________    _______    __________________

    "Pixel 3"        "3C286DD533CA"    8          "Ready to connect"         
    "HC-06"          "98D331FB3B77"    1          "Requires pairing"
    "mjin-maci"      "A886DDA44062"    3          "Requires pairing"
    "DMTDevice"      "B0B448F47A4C"    Unknown    "Unknown"         

Создайте связь с Пикселем 3 устройства в канале 8.

device = bluetooth("Pixel 3",8)
device = 
  bluetooth with properties:

                 Name: "Pixel 3"
              Address: "3C286DD533CA"
              Channel: 8
    NumBytesAvailable: 0
      NumBytesWritten: 0

  Show all properties

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

Введенный в R2020b