exponenta event banner

Bluetooth

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

Описание

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

Создание

Описание

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

device = bluetooth(name) создает подключение к устройству Bluetooth Classic, используя его имя. Канал является каналом 1 SPP по умолчанию. Вход 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 с порядком байтов little-endian и периодом тайм-аута 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

Символ терминатора для чтения и записи данных, завершенных 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