bleGAPDataBlockConfig

Объект Configuration для блока данных GAP BLE

Загрузите Необходимый: Чтобы использовать bleGAPDataBlockConfig, сначала загрузите Библиотеку Communications Toolbox™ для Bluetooth® Протокол. Для получения дополнительной информации смотрите, Получают и Управляют Дополнениями. В качестве альтернативы смотрите Библиотеку Communications Toolbox для Обмена файлами Протокола Bluetooth.

Описание

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

Создание

Описание

пример

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

пример

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

Свойства

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

Примечание

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

Блокируйте данные рекламные типы данных в виде вектора символов или строкового скаляра или массива ячеек, содержа список рекламных типов данных для блока данных GAP BLE. Можно задать 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. true значение указывает, что BR или EDR поддерживаются. Это используется когда AdvertisingDataTypes установлен в 'Flags'.

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

Одновременный 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 значение указывает, что имя устройства сокращено.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

bleGAPDataBlockСгенерируйте блок данных GAP BLE
bleGAPDataBlockDecodeДекодируйте блок данных GAP BLE

Примеры

свернуть все

Создайте два уникальных объекта настройки БЛА ГЭПА ЭДА: один с AD типами 'Flags' и 'Tx power level' и другой с AD типом 'Flags' и одновременный LE и BR или EDR поддерживают в хосте.

Создайте объект настройки блока BLE GAP AD использование настроек по умолчанию. Установите значения AD типов как 'Flags' и 'Tx power level', LE discoverability как '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

   Read-only properties:
    No properties.

Создайте другой объект настройки блока BLE GAP AD использование настроек по умолчанию, на этот раз с AD типом 'Flags' и наличие одновременной поддержки LE и BR/EDR. Установите значения LE discoverability как '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'

   Read-only properties:
    No properties.

Создайте объект настройки для блока 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

   Read-only properties:
    No properties.

Создайте объект настройки для блока 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

   Read-only properties:
    No properties.

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

dataBlock = bleGAPDataBlock(cfgTx);

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

[status, cfgRx] = bleGAPDataBlockDecode(dataBlock)
status = 
  blePacketDecodeStatus enumeration

    Success

cfgRx = 
  bleGAPDataBlockConfig with properties:

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

   Read-only properties:
    No properties.

Ссылки

[1] Технологический Веб-сайт Bluetooth. “Технологический Веб-сайт Bluetooth | официальный сайт Технологии Bluetooth”. Полученный доступ 22 ноября 2019. https://www.bluetooth.com/.

[2] Специальная группа (SIG) Bluetooth. "Спецификация Ядра Bluetooth". Версия 5.1. https://www.bluetooth.com/.

[3] Специальная группа (SIG) Bluetooth. "Добавьтесь к спецификации ядра Bluetooth". CSS версия 7 (2016).

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

Генерация кода C/C++
Генерация кода C и C++ с помощью MATLAB® Coder™.

Введенный в R2019b
Для просмотра документации необходимо авторизоваться на сайте