bluetooth

Подключение к устройству Bluetooth Classic

Описание

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

Создание

Описание

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

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

пример

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

device = bluetooth(address) создает подключение к устройству Bluetooth Classic по его адресу. Область входа address устанавливает Address свойство.

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

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 Sensor.

Типы данных: 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" установите порядок байтов на little-endian.

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

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

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

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

Чтение и запись свойств

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

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

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

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

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

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

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

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

Terminator символа для чтения и записи данных, оконечных по 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 Classic.

Скан ближайших устройств.

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"         

Создайте соединение с устройством Pixel 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