Exponenta Banner
exponenta event banner

bleGAPDataBlockConfig

Объект конфигурации для блока данных BLE GAP

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

Для использования bleGAPDataBlockConfig сначала загрузите библиотеку Communications Toolbox™ Library для протокола Bluetooth ®. Дополнительные сведения см. в разделе Получение надстроек и управление ими. Кроме того, см. библиотеку Communications Toolbox Library для обмена файлами по протоколу Bluetooth.

Описание

bleGAPDataBlockConfig создает объект конфигурации для блока данных общего профиля доступа (GAP) Bluetooth с низким энергопотреблением (BLE) типа advertising data (AD) или scan response data (SRD). Блок данных BLE GAP можно сконфигурировать с помощью применимых свойств bleGAPDataBlockConfig.

Создание

Синтаксис

cfgGAP = bleGAPDataBlockConfig
cfgGAP = bleGAPDataBlockConfig (имя, значение)

Описание

пример

cfgGAP = bleGAPDataBlockConfig создает объект конфигурации, cfgGAP, для блока данных BLE GAP типа AD или SRD со значениями по умолчанию.

пример

cfgGAP = bleGAPDataBlockConfig(Name,Value) задает свойства, используя одну или несколько пар имя-значение. Заключите каждое имя свойства в кавычки. Например, bleGAPDataBlockConfig('AdvertisingDataTypes','Tx power level') настраивает cfgGAP с типом данных рекламы блочных данных как 'Tx power level'.

Свойства

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

Примечание

Для получения дополнительной информации о свойствах блоков данных BLE GAP и их соответствующих значениях см. том 3, часть C, раздел 4 спецификации ядра Bluetooth [2].

Типы данных рекламы данных блоков, заданные как вектор символов или скаляр строк или массив ячеек, содержащий список типов данных рекламы для блока данных BLE GAP. Можно указать AdvertisingDataTypes как одно из следующих значений:

  • 'Flags'

  • 'UUIDs'

  • 'Local name'

  • 'Tx power level'

  • 'Connection interval range'

  • 'Advertising interval'

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

Режим обнаружения LE, заданный как вектор символов или строковый скаляр, описывающий режим обнаружения LE устройства. Можно указать LEDiscoverability как одно из следующих значений:

  • 'None'

  • 'General'

  • 'Limited'

  • 'Limited and general'

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

Поддержка базовой скорости (BR) или расширенной скорости передачи данных (EDR), указанная как true или false. A true значение указывает на поддержку BR или EDR. Используется при AdvertisingDataTypes имеет значение 'Flags'.

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

Одновременная поддержка LE и BR/EDR, заданная как символьный вектор или строковый скаляр. Можно указать 'LE' как одно из следующих значений:

  • 'None'

  • 'Host'

  • 'Controller'

  • 'Host and controller'

Это свойство применимо только в том случае, если BREDR имеет значение true. Установить для этого свойства значение 'Host' или 'Controller' для указания одновременной поддержки LE и BR или EDR на хосте или контроллере соответственно. Установить для этого свойства значение 'Host and Controller' для одновременной поддержки LE и BR или EDR на хосте и контроллере.

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

Используется укороченное локальное имя, указанное как скалярное логическое значение false или true. Задайте для этого значения значение true значение указывает, что имя устройства сокращено.

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

UTF-8 кодированное понятное для пользователя описательное имя, указанное как вектор символов или строковый скаляр, состоящий из UTF-8 символов. Это свойство указывает локальное имя, назначенное устройству.

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

Тип 16-разрядных идентификаторов службы или класса службы, указанный как 'Incomplete' или 'Complete'. Если это значение равно 'Incomplete', то список 16-разрядных идентификаторов услуг или классов услуг является неполным.

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

Список 16-разрядных идентификаторов служб или классов служб, указанных как массив символов n-by-4. Значение n должно находиться в диапазоне [0, 127]. Каждая строка в массиве символов n-на-4 представлена в виде четырехэлементного символьного вектора или строкового скаляра, обозначающего двухоктетное (16-битное) шестнадцатеричное значение универсально уникального идентификатора службы или класса службы (UUID). Эти UUID присваиваются Bluetooth Special Interest Group (SIG).

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

Интервал рекламы, указанный как целое число в диапазоне [32, 65535]. Это свойство обозначает интервал между началом двух последовательных рекламных мероприятий. Инкрементные единицы составляют 0,625 мс шагов, поэтому результирующий диапазон для [32 65 535] равен [20, 40,959375].

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

Уровень мощности пакетной передачи в дБм, заданный как целое число в диапазоне [-127, 127]. Это свойство вычисляет значение параметра pathloss как pathloss = Tx Power Level - RSSI, где RSSI является индикатором уровня принимаемого сигнала.

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

Диапазон интервалов соединения, заданный как двухэлементный числовой вектор [MIN, MAX], где MIN и MAX должны находиться в диапазоне [63200]. MIN и MAX определяют минимальное и максимальное значения для интервала соединения соответственно. MIN должен быть меньше или равен MAX. Инкрементные единицы составляют 1,25 мс шагов, так что результирующий диапазон для [6, 3200] равен [7,5, 4,0].

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

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

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

bleGAPDataBlockСоздание блока данных BLE GAP
bleGAPDataBlockDecodeДекодирование блока данных BLE GAP

Примеры

свернуть все

В этом примере используются:

Открыть сценарий в реальном времени

Создать два уникальных объекта конфигурации BLE GAP AD: один с типами AD 'Flags' и 'Tx power level' и другой с типом AD 'Flags' и одновременная поддержка LE и BR или EDR в хосте.

Создайте объект конфигурации блока BLE GAP AD, используя параметры по умолчанию. Задайте значения типов AD как 'Flags' и 'Tx power level', возможность обнаружения LE 'Limited' и уровень мощности Tx как 45. Просмотр свойств соответствующего объекта конфигурации.

cfgGAP = bleGAPDataBlockConfig;
cfgGAP.AdvertisingDataTypes = {'Flags';'Tx power level'};
cfgGAP.LEDiscoverability = 'Limited';
cfgGAP.TxPowerLevel = 45
cfgGAP = 
  bleGAPDataBlockConfig with properties:

    AdvertisingDataTypes: {2x1 cell}
       LEDiscoverability: 'Limited'
                   BREDR: 0
            TxPowerLevel: 45

Создание другого объекта конфигурации блока BLE GAP AD с использованием параметров по умолчанию, на этот раз с типом AD 'Flags' и с одновременной поддержкой LE и BR/EDR. Установите значения обнаруживаемости LE как 'Limited', включить поддержку BR или EDR как true и включить одновременную поддержку LE и BR или EDR в качестве 'Host'. Просмотр свойств соответствующего объекта конфигурации.

cfgGAP = bleGAPDataBlockConfig;
cfgGAP.LEDiscoverability = 'Limited and general';
cfgGAP.BREDR = true;
cfgGAP.LE = 'Host'
cfgGAP = 
  bleGAPDataBlockConfig with properties:

    AdvertisingDataTypes: {'Flags'}
       LEDiscoverability: 'Limited and general'
                   BREDR: 1
                      LE: 'Host'

В этом примере используются:

Открыть сценарий в реальном времени

Создайте объект конфигурации для блока BLE GAP AD, используя пары имя-значение. Задайте значения типов AD как 'Advertising interval' и 'Local name', интервал рекламы как 48, локальное имя как 'MathWorks' и укорочение локального имени как true. Просмотр свойств соответствующего объекта конфигурации.

cfgGAP = bleGAPDataBlockConfig('AdvertisingDataTypes', ...
    {'Advertising interval', ...
    'Local name'});
cfgGAP.AdvertisingInterval = 48;
cfgGAP.LocalName = 'MathWorks';
cfgGAP.LocalNameShortening = true
cfgGAP = 
  bleGAPDataBlockConfig with properties:

    AdvertisingDataTypes: {2x1 cell}
               LocalName: 'MathWorks'
     LocalNameShortening: 1
     AdvertisingInterval: 48

В этом примере используются:

Открыть сценарий в реальном времени

Создайте объект конфигурации для блока BLE GAP AD, используя пары имя-значение. Задайте значения типов AD как 'Advertising interval' и 'Local name', интервал рекламы как 48, локальное имя как 'MathWorks'и укорочение локального имени как true. Просмотр свойств соответствующего объекта конфигурации.

cfgTx = bleGAPDataBlockConfig('AdvertisingDataTypes',{'Advertising interval','Local name'});
cfgTx.AdvertisingInterval = 48;
cfgTx.LocalName = 'MathWorks';
cfgTx.LocalNameShortening = true
cfgTx = 
  bleGAPDataBlockConfig with properties:

    AdvertisingDataTypes: {2x1 cell}
               LocalName: 'MathWorks'
     LocalNameShortening: 1
     AdvertisingInterval: 48

Создание блока BLE GAP AD с помощью объекта конфигурации 'cfgTx'.

dataBlock = bleGAPDataBlock(cfgTx);

Декодировать сформированный блок BLE GAP AD. Возвращенное состояние указывает на успешное декодирование. Просмотр выходных данных 'status' и 'cfgRx'.

[status, cfgRx] = bleGAPDataBlockDecode(dataBlock)
status = 
Success

cfgRx = 
  bleGAPDataBlockConfig with properties:

    AdvertisingDataTypes: {2x1 cell}
               LocalName: 'MathWorks'
     LocalNameShortening: 1
     AdvertisingInterval: 48

Ссылки

[1] Веб-сайт технологии Bluetooth. «Веб-сайт Bluetooth Technology | Официальный веб-сайт Bluetooth Technology». Доступно 22 ноября 2019 года. https://www.bluetooth.com/.

[2] Группа специальных интересов Bluetooth (SIG). «Спецификация ядра Bluetooth». Версия 5.1. https://www.bluetooth.com/.

[3] Группа специальных интересов Bluetooth (SIG). «Дополнение к спецификации ядра Bluetooth». CSS версии 7 (2016).

Расширенные возможности

Создание кода C/C + +
Создайте код C и C++ с помощью MATLAB ® Coder™

.

См. также

Функции

Темы

Представлен в R2019b

Документация по инструментам связи

Поддержка