ble

Подключение к периферийному устройству Bluetooth Low Energy

Описание

A ble объект представляет соединение с Bluetooth® Низкоэнергетическое периферийное устройство с вашего компьютера. Поиск ближайших подключаемых устройств с помощью blelist.

Создание

Описание

пример

b = ble(name) подключается к устройству Bluetooth Low Energy по его имени.

пример

b = ble(address) подключается к устройству Bluetooth Low Energy по его адресу.

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

расширить все

Имя устройства, заданное как вектор символов или строковый скаляр. Идентифицируйте имя периферийного устройства, к которому вы хотите подключиться, используя информацию, возвращенную blelist. Если устройство не имеет name, затем используйте его адрес, чтобы подключиться к нему.

Пример: b = ble("Tile") соединяется с периферийным устройством с именем "Tile".

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

Адрес устройства, заданный как вектор символов или строковый скаляр. Идентифицируйте адрес периферийного устройства, к которому вы хотите подключиться, используя информацию, возвращенную blelist. Если устройство не имеет name, затем используйте его адрес, чтобы подключиться к нему.

Пример: b = ble("5A8769A09DA6") соединяется с периферийным устройством с помощью MAC-адреса "5A8769A09DA6"в Windows® компьютер.

Пример: b = ble("121B0BAC-0DE7-4FB1-909A-EEA6877DBC5C") соединяется с периферийным устройством со случайным назначенным ОС адресом "121B0BAC-0DE7-4FB1-909A-EEA6877DBC5C"на компьютере с macOS.

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

Свойства

расширить все

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

Имя периферийного устройства, возвращаемое как строковый скаляр.

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

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

Адрес периферийного устройства, возвращенный как строковый скаляр. В Windows это значение является 48-битным MAC-адресом Bluetooth устройства. В macOS это значение является случайным 128-битным адресом OS, назначенным.

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

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

Состояние подключения периферийного устройства, возвращаемое как число или логическое 1 (true) или 0 (false).

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

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

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

СтолбецОписание
ServiceNameИмя службы, включенной в периферийное устройство, возвращаемое в виде строки
ServiceUUIDUUID услуги, входящей в состав периферийного устройства, возвращаемый как строка

Полный список стандартных сервисов и их UUID см. на сайте Bluetooth SIG. Все пользовательские службы имеют имя "Custom"и дифференцируются по значениям UUID.

Примечание

На macOS "Generic Access«и» Generic Attributes"услуги и их характеристики скрыты. The Services и Characteristics свойства не отображают их.

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

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

Характеристики, включенные в периферийное устройство, возвращаются как таблица. Чтобы получить доступ к определенному признаку, перечисленному в таблице, создайте объект с помощью characteristic. Эта таблица содержит следующие столбцы.

СтолбецОписание
ServiceNameИмя службы, включенной в периферийное устройство, возвращаемое в виде строки
ServiceUUIDUUID услуги, входящей в состав периферийного устройства, возвращаемый как строка
CharacteristicNameИмя характеристики, включенной в периферийное устройство, возвращаемое в виде строки
CharacteristicUUIDUUID характеристики, включенной в периферийное устройство, возвращаемый как строка
AttributesПоддерживаемые операции с характеристикой, возвращенные как массив ячеек. Смотрите свойство Attributes для возможных значений

Полный список стандартных характеристик и как их интерпретировать смотрите на сайте Bluetooth SIG. Все пользовательские характеристики имеют имя "CustomCharacteristics Таблицы и дифференцируются их значениями UUID.

Примечание

На macOS "Generic Access«и» Generic Attributes"услуги и их характеристики скрыты. The Services и Characteristics свойства не отображают их.

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

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

characteristicДоступ к характеристике на периферийном устройстве Bluetooth Low Energy

Примеры

свернуть все

Поиск и установка соединения с периферийным устройством Bluetooth Low Energy.

Скан ближайших периферийных устройств с именем "Gear Fit2 (E16A)" использование blelist.

blelist("Name","Gear Fit2 (E16A)")
ans=1×5 table
    Index           Name              Address        RSSI    Advertisement
    _____    __________________    ______________    ____    _____________

      1      "Gear Fit2 (E16A)"    "8498663EE16A"    -61     [1×1 struct] 

Создайте соединение с устройством.

b = ble("Gear Fit2 (E16A)")
b = 
  ble with properties:

               Name: "Gear Fit2 (E16A)"
            Address: "8498663EE16A"
          Connected: 1
           Services: [2×2 table]
    Characteristics: [3×5 table]

Show services and characteristics

Поиск и установка соединения с периферийным устройством Bluetooth Low Energy.

Скан ближайших периферийных устройств с именем "Gear Fit2 (E16A)" использование blelist.

blelist("Name","Gear Fit2 (E16A)")
ans=1×5 table
    Index           Name              Address        RSSI    Advertisement
    _____    __________________    ______________    ____    _____________

      1      "Gear Fit2 (E16A)"    "8498663EE16A"    -58     [1×1 struct] 

Создайте подключение к устройству с адресной "8498663EE16A". На компьютере с Windows этот адрес представляет 48-битный MAC-адрес Bluetooth периферийного устройства.

b = ble("8498663EE16A")
b = 
  ble with properties:

               Name: "Gear Fit2 (E16A)"
            Address: "8498663EE16A"
          Connected: 1
           Services: [2×2 table]
    Characteristics: [3×5 table]

Show services and characteristics

Поиск и установка соединения с периферийным устройством Bluetooth Low Energy.

Скан ближайших периферийных устройств с именем "Gear Fit2 (E16A)" использование blelist.

blelist("Name","Gear Fit2 (E16A)")
ans=1×5 table
    Index           Name                          Address                    RSSI    Advertisement
    _____    __________________    ______________________________________    ____    _____________

      1      "Gear Fit2 (E16A)"    "2F4AFADA-1F14-4BBD-A1F1-E7E64C0CF5BA"    -49     [1×1 struct] 

Создайте подключение к устройству с адресной "2F4AFADA-1F14-4BBD-A1F1-E7E64C0CF5BA". На компьютере macOS этот адрес представляет собой случайный 128-битный адрес, назначенный ОС периферийного устройства.

b = ble("2F4AFADA-1F14-4BBD-A1F1-E7E64C0CF5BA")
b = 
  ble with properties:

               Name: "Gear Fit2 (E16A)"
            Address: "2F4AFADA-1F14-4BBD-A1F1-E7E64C0CF5BA"
          Connected: 1
           Services: []
    Characteristics: []

Show services and characteristics
Введенный в R2019b