Exponenta Banner

bleGAPDataBlockConfig

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

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

Требуется загрузка: Чтобы использовать bleGAPDataBlockConfig, сначала загрузите библиотеку Communications Toolbox™ для Bluetooth® Протокол. Для получения дополнительной информации см. раздел «Получение и управление дополнениями». Другой способ см. в разделе Библиотека Communications Toolbox для обмена файлами протокола Bluetooth.

Описание

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

Создание

Синтаксис

cfgGAP = bleGAPDataBlockConfig
cfgGAP = bleGAPDataBlockConfig(Name,Value)

Описание

пример

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

пример

cfgGAP = bleGAPDataBlockConfig(Name,Value) устанавливает свойства с помощью одной или нескольких пар "имя-значение". Заключайте каждое имя свойства в кавычки. Для примера, bleGAPDataBlockConfig('AdvertisingDataTypes','Tx power level') настраивает cfgGAP с блоком data advertising type данных как '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 на 4 символов. Значение n должно быть в области значений [0, 127]. Каждая строка в символьном массиве n-на-4 представлена в виде четырехэлементного вектора символов или строкового скаляра, обозначающего двухоктетное (16-битное) шестнадцатеричное значение универсально уникального идентификатора (UUID) класса услуги или услуги. Эти UUID присваиваются Bluetooth Special Interest Group (SIG).

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

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

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

Уровень степени передачи пакета, в дБм, задается в виде целого числа в области значений [-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Сгенерируйте блок данных BLE GAP
bleGAPDataBlockDecodeДекодируйте блок данных BLE GAP

Примеры

свернуть все

Этот пример использует:

Открыть Live Script

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

Этот пример использует:

Открыть Live Script

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

Этот пример использует:

Открыть Live Script

Создайте объект строения для блока 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 Technology. Bluetooth Technology Website | Официальный сайт Bluetooth Technology. Доступ к 22 ноября 2019 года. https://www.bluetooth.com/.

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

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

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

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

.

См. также

Функции

Темы

Введенный в R2019b

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

Поддержка