Exponenta Banner

blelist

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

свернуть все на странице

Синтаксис

list = blelist
list = blelist(Name,Value)

Описание

пример

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

пример

list = blelist(Name,Value) сканы с помощью дополнительных аргументов пары "имя-значение". Используйте аргументы пары "имя-значение", чтобы отсканировать для определенных устройств или отсканировать в течение более длительного времени.

Примеры

свернуть все

Скрипт Open Live Script

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

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

list = blelist
list=14×5 table
    Index           Name              Address        RSSI    Advertisement
    _____    __________________    ______________    ____    _____________

      1      "Gear Fit2 (E16A)"    "8498663EE16A"    -54     [1×1 struct] 
      2      ""                    "2C4D2724754D"    -69     [1×1 struct] 
      3      ""                    "1B75E09FD18F"    -70     [1×1 struct] 
      4      ""                    "4F7D6DAF9FCE"    -75     [1×1 struct] 
      5      ""                    "7B8ADB5851BD"    -76     [1×1 struct] 
      6      ""                    "1838D92EC312"    -78     [1×1 struct] 
      7      ""                    "6A71507635AC"    -86     [1×1 struct] 
      8      ""                    "68CA4203A060"    -86     [1×1 struct] 
      9      ""                    "65C057AD64E5"    -88     [1×1 struct] 
     10      ""                    "399A1B26F47D"    -88     [1×1 struct] 
     11      ""                    "78BDCC3784C0"    -89     [1×1 struct] 
     12      ""                    "5446498F593E"    -91     [1×1 struct] 
     13      ""                    "67992F048DDB"    -92     [1×1 struct] 
     14      ""                    "3A0DAC7C7DCE"    -94     [1×1 struct]

Значения RSSI указывают на силу сигнала. Таблица приводит устройства с более сильным сигналом сначала. Эти устройства ближе.

Просмотрите данные о рекламе первого устройства.

list.Advertisement(1)
ans = struct with fields:
                            Type: ["Connectable Undirected"    "Scan Response"]
                      Appearance: "Generic Watch"
              ShortenedLocalName: []
               CompleteLocalName: "Gear Fit2 (E16A)"
                    TxPowerLevel: []
    SlaveConnectionIntervalRange: []
        ManufacturerSpecificData: [0 117 1 0 2 0 1 3 0]
                     ServiceData: []
            CompleteServiceUUIDs: []
          IncompleteServiceUUIDs: []
        ServiceSolicitationUUIDs: []

Если ваше устройство имеет больший рекламный интервал, чем значение тайм-аута по умолчанию трех секунд, можно задать большее значение тайм-аута.

list = blelist('Timeout',10);
Скрипт Open Live Script

Можно использовать аргументы пары "имя-значение", чтобы отсканировать для Bluetooth Низкие энергетические периферийные устройства с префиксом указанного имени или рекламой заданных сервисов.

Отсканируйте для периферийных устройств с именами начиная со строки "UA".

list = blelist("Name","UA")
list=2×5 table
    Index           Name               Address        RSSI    Advertisement
    _____    ___________________    ______________    ____    _____________

      1      "UA E39 MODULE"        "84DD20E39AB6"    -84     [1×1 struct] 
      2      "UA Footpod 239AE2"    "0CF3EE239AE2"    -87     [1×1 struct]

Можно также отсканировать для периферийных устройств их сервисами. Отсканируйте для устройств, которые рекламируют Heart Rate сервис.

list = blelist("Services","Heart Rate")
list=1×5 table
    Index    Name       Address        RSSI    Advertisement
    _____    ____    ______________    ____    _____________

      1       ""     "84DD20E39AB6"    -85     [1×1 struct]

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

свернуть все

Аргументы name-value

Задайте дополнительные разделенные запятой пары Name,Value аргументы. Name имя аргумента и Value соответствующее значение. Name должен появиться в кавычках. Вы можете задать несколько аргументов в виде пар имен и значений в любом порядке, например: Name1, Value1, ..., NameN, ValueN.

Пример: list = blelist("Name","UA") возвращает все периферийные устройства с именами, которые запускаются с "UA".

Имя периферийного устройства для фильтрации результатов в виде разделенной запятой пары, состоящей из 'Name' и вектор символов или строковый скаляр. Используя эти списки аргумента пары "имя-значение" только периферийные устройства, которые запускаются с заданного значения на их имена.

Пример: list = blelist("Name","Pebble") возвращает все периферийные устройства с именами, которые запускаются с "Pebble".

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

Сервисное имя или UUID для фильтрации результатов в виде разделенной запятой пары, состоящей из 'Services' и вектор символов, строковый скаляр, массив ячеек из символьных векторов или массив строк. Используя этот аргумент пары "имя-значение" производит список только периферийных устройств, которые рекламируют все заданные сервисы.

Пример: list = blelist("Services",["180a","180d"]) возвращает все периферийные устройства, которые рекламируют оба сервиса с 180a UUIDs и 180d.

Пример: list = blelist("Services","Heart Rate") возвращает все периферийные устройства, которые рекламируют сервис "Heart Rate".

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

Количество времени, чтобы отсканировать для в секундах в виде разделенной запятой пары, состоящей из 'Timeout' и номер. Значение должно быть меньше 10,485. Если вы не можете найти свое использование устройства blelist, попробуйте большее значение за этот параметр.

Пример: list = blelist("Timeout",20) поиски соседних периферийных устройств в течение 20 секунд.

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

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

свернуть все

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

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

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

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

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

Сила сигнала в дБ, возвращенном как двойное. RSSI является полученным индикатором силы сигнала. Таблица приводит устройства с более сильным сигналом сначала. Эти устройства ближе к вашему компьютеру.

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

Данные о рекламе периферийного устройства, возвращенного как структура. Advertisement содержит информацию о связи о каждом периферийном устройстве.

На Windows, Type поле показывает состояние связи, возвращенное как строка. Возможные значения следуют.

ЗначениеОписание периферийного устройства
"Connectable Undirected"Может связать с вашим компьютером
"Connectable Directed"Может связать с вашим компьютером, только если он запрограммирован, чтобы сделать так
"Nonconnectable Undirected"Не может связать с вашим компьютером, но отправляет рекламную информацию
"Scannable Undirected"Не может связать с вашим компьютером, но является поддающимся сканированию
"Scan Response"Отправляет ответ скана на запрос скана

На macOS, Connectable поле показывает состояние связи, возвращенное как номер. 1 указывает верный, или соединяемый, и 0 или любой другой номер указывает на ложь, или несоединяемый.

Остальная часть полей в Advertisement другие данные о рекламе, заданные в Типовом профиле доступа (GAP) SIG Bluetooth. Для полного списка рекламных типов данных и ссылок на их технические требования, смотрите веб-сайт SIG Bluetooth.

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

Смотрите также

Темы

Введенный в R2019b

Документация MATLAB

Поддержка