exponenta event banner

ble

Подключение к периферийному устройству Bluetooth с низким энергопотреблением

Описание

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

Создание

Описание

пример

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

пример

b = ble(address) подключается к устройству Bluetooth с низким энергопотреблением по его адресу.

Входные аргументы

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

Имя устройства, указанное как вектор символа или скаляр строки. Определите имя периферийного устройства, к которому требуется подключиться, с помощью информации, возвращенной 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-битным назначенным ОС адресом.

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

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

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

Примечание

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

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

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

characteristicДоступ к характеристике на периферийном устройстве Bluetooth с низким энергопотреблением

Примеры

свернуть все

Найдите и установите подключение к периферийному устройству Bluetooth с низким энергопотреблением.

Поиск близлежащих периферийных устройств с таким именем "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 с низким энергопотреблением.

Поиск близлежащих периферийных устройств с таким именем "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 с низким энергопотреблением.

Поиск близлежащих периферийных устройств с таким именем "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