ble

Соедините к Bluetooth Низкое энергетическое периферийное устройство

Описание

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

Создание

Описание

пример

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

пример

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

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

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

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

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

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

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

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

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

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

Свойства

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

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

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

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

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

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

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

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

Состояние связи периферийного устройства, возвращенное как числовой или логический 1 TRUE) или 0 ложь).

Типы данных: логический

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

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

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

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

Примечание

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

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

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

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

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

Для полного списка стандартных характеристик и как интерпретировать их, смотрите веб-сайт SIG Bluetooth. Все пользовательские характеристики имеют имя "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-битный Мак адрес 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