Exponenta Banner
exponenta event banner

bleL2CAPFrameConfig

Объект конфигурации для полки L2CAP BLE

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

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

Описание

bleL2CAPFrameConfig создает объект конфигурации для Bluetooth низкой энергии (BLE) логический контроль за связью и протокол (L2CAP) адаптации, сигнализирующий о структуре или структуре данных, используя дефолт и определенные ценности. Можно сконфигурировать кадр сигнализации BLE L2CAP или кадр данных, используя применимые свойства bleL2CAPFrameConfig.

Создание

Синтаксис

cfgL2CAP = bleL2CAPFrameConfig
cfgL2CAP = bleL2CAPFrameConfig (имя, значение)

Описание

пример

cfgL2CAP = bleL2CAPFrameConfig создает объект конфигурации, cfgL2CAP, для командного кадра сигнализации BLE L2CAP или кадра данных со значениями по умолчанию.

пример

cfgL2CAP = bleL2CAPFrameConfig(Name,Value) задает свойства, использующие одну или несколько пар имя-значение. Заключите каждое имя свойства в кавычки. Например, bleL2CAPFrameConfig('CommandType','Command reject') настраивает cfgL2CAP с типом командного кадра сигнализации как 'Command reject'.

Свойства

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

Примечание

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

Идентификатор для конечной точки логического канала, определяемый как четырехэлементный символьный вектор или строковый скаляр, обозначающий шестнадцатеричное значение в два октета. 'ChannelIdentifier' обозначает локальное имя, представляющее конечную точку логического канала. Это свойство используется для идентификации кадров команд и данных. Использование кадров команд '0005' в качестве 'ChannelIdentifier'. L2CAP B-кадры используют фиксированные 'ChannelIdentifier', '0004' для протокола атрибутов (ATT) и '0006' для протокола диспетчера безопасности (SMP).

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

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

  • 'Command reject'

  • 'Disconnection request'

  • 'Disconnection response'

  • 'Connection Parameter Update request'

  • 'Connection Parameter Update response'

  • 'Credit Based Connection request'

  • 'Credit Based Connection response'

  • 'Flow Control Credit'

Это свойство применимо только при значении ChannelIdentifier имеет значение '0005'(идентификатор канала сигнализации).

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

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

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

Причина отклонения принятого командного кадра сигнализации, заданного как символьный вектор или строковый скаляр. Можно указать CommandRejectReason как одно из следующих значений:

  • 'Command not understood'

  • 'Signaling MTU exceeded'

  • 'Invalid CID in request'

Это свойство определяет причину отклонения командного кадра сигнализации.

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

Исходная конечная точка логического канала, заданная как четырехэлементный символьный вектор или строковый скаляр, обозначающий двухоктетное шестнадцатеричное значение. Это свойство указывает конечную точку исходного канала, с которой отправляется запрос или принимается ответ. Когда канал создается с использованием процедуры соединения на основе кредита, пакеты данных, передаваемые отправителю запроса, отправляются в SourceChannelIdentifier.

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

Конечная точка логического канала назначения, заданная как четырехэлементный символьный вектор или строковый скаляр, обозначающий шестнадцатеричное значение с двумя октетами. Это свойство указывает конечную точку целевого канала, с которой отправляется запрос или принимается ответ. Когда канал создается с использованием процедуры соединения на основе кредита, пакеты данных, поступающие к адресату запроса, посылаются в DestinationChannelIdentifier.

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

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

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

Время ожидания контроля соединения, указанное как целое число в диапазоне [Mct, 3200], где Mct больше 10 и (1 +SlaveLatency)×(ConnectionInterval×1.25) ×2)/10. Это свойство указывает тайм-аут для соединения, если в течение этого времени не получен действительный пакет. Каждый блок принимается равным 10 мс, так что результирующий тайм-аут соединения, (ConnectionInterval× 10), находится в диапазоне [100 мс, 32.0s].

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

Число событий соединения канального уровня, которые подчиненный узел может игнорировать, указанное как целое число в диапазоне [0, Msl], где Msl меньше 499 и ((ConnectionTimeout×10) / ((ConnectionInterval×1.25) ×2))-1. Это свойство указывает количество событий подключения, которые подчиненный узел может игнорировать.

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

Результат обновления параметров соединения, указанный как 'Accepted' или 'Rejected'. Это свойство указывает ответ на 'Connection Parameter Update Request' значение свойства CommandType и определяет результат после обновления параметров соединения.

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

Протокол LE или служебный мультиплексор, заданный как четырехэлементный символьный вектор или строковый скаляр, обозначающий двухоктетное шестнадцатеричное значение. Значение этого свойства является уникальным номером, указанным Специальной группой интересов (SIG) для каждого протокола. SIG назначает значение этого свойства в диапазоне [0x0001, 0x007F] для набора существующих протоколов. SIG динамически присваивает значение этого свойства в диапазоне [0x0080, 0x00FF] реализованным протоколам.

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

Максимальный размер блока служебных данных (SDU), указанный как целое число в диапазоне [23, 65 535] октетов. Это свойство указывает максимально допустимый размер SDU для объекта верхнего уровня.

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

Максимальный размер полезной нагрузки блока протокольных данных (PDU), указанный как целое число в диапазоне [23 65 535] октетов. Это свойство задает максимально допустимые данные полезной нагрузки для объекта уровня L2CAP.

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

Количество одноранговых устройств LE-кадров может посылать или принимать, указанное как целое число в диапазоне [0, 65535] октетов. Это свойство указывает количество LE-кадров, которые может отправить или принять одноранговое устройство. Если значение CommandType свойство имеет значение 'Flow control credit', тогда это свойство не может быть установлено в 0.

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

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

  • 'Successful'

  • 'LEPSM not supported'

  • 'No resources available'

  • 'Insufficient authentication'

  • 'Insufficient authorization'

  • 'Insufficient encryption key size'

  • 'Insufficient encryption'

  • 'Invalid Source CID'

  • 'Source CID already allocated'

  • 'Unacceptable parameters'

Это свойство указывает результат запроса на подключение.

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

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

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

bleL2CAPFrameСоздание кадра L2CAP BLE
bleL2CAPFrameDecodeДекодирование кадра L2CAP BLE

Примеры

свернуть все

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

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

Создание объекта конфигурации BLE L2CAP frame, 'cfgL2CAP', используя свойства по умолчанию. Просмотрите соответствующие применимые свойства. Этот объект конфигурации генерирует кадр сигнализации BLE L2CAP типа 'Credit based connection request'.

cfgL2CAP = bleL2CAPFrameConfig
cfgL2CAP = 
  bleL2CAPFrameConfig with properties:

          ChannelIdentifier: '0005'
                CommandType: 'Credit based connection request'
           SignalIdentifier: '01'
    SourceChannelIdentifier: '0040'
                      LEPSM: '001F'
        MaxTransmissionUnit: 23
          MaxPDUPayloadSize: 23
                    Credits: 1

Установить значение кредита как 10. Просмотр соответствующих свойств 'cfgL2CAP'.

cfgL2CAP.Credits            = 10
cfgL2CAP = 
  bleL2CAPFrameConfig with properties:

          ChannelIdentifier: '0005'
                CommandType: 'Credit based connection request'
           SignalIdentifier: '01'
    SourceChannelIdentifier: '0040'
                      LEPSM: '001F'
        MaxTransmissionUnit: 23
          MaxPDUPayloadSize: 23
                    Credits: 10

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

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

Создание объекта конфигурации BLE L2CAP frame, 'cfgL2CAP', путем установки значения идентификатора канала как '0004'используя пары имя-значение. Просмотрите соответствующие применимые свойства. Этот объект конфигурации генерирует кадр данных BLE L2CAP (B-кадр).

cfgL2CAP = bleL2CAPFrameConfig('ChannelIdentifier','0004')
cfgL2CAP = 
  bleL2CAPFrameConfig with properties:

    ChannelIdentifier: '0004'

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

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

Создание объекта конфигурации BLE L2CAP, 'bleL2CAPFrameConfig', для генерации кадра данных L2CAP BLE (B-кадр). Установка значения идентификатора канала как'0004' и просмотрите соответствующие применимые свойства.

cfgTx = bleL2CAPFrameConfig('ChannelIdentifier','0004')
cfgTx = 
  bleL2CAPFrameConfig with properties:

    ChannelIdentifier: '0004'

Создайте кадр данных BLE L2CAP (B-кадр) с блоком данных услуги (SDU) из ATT, указанного как '0A0100'.

l2capFrame = bleL2CAPFrame(cfgTx,"0A0100")
l2capFrame = 7x2 char array
    '03'
    '00'
    '04'
    '00'
    '0A'
    '01'
    '00'

Декодировать сформированный кадр данных L2CAP BLE (B-кадр). Возвращенное состояние указывает на успешное декодирование. Просмотр выходных данных 'status', 'cfgRx' и 'SDU'.

[status, cfgRx, SDU] = bleL2CAPFrameDecode(l2capFrame)
status = 
Success

cfgRx = 
  bleL2CAPFrameConfig with properties:

    ChannelIdentifier: '0004'


SDU = 3x2 char array
    '0A'
    '01'
    '00'

Ссылки

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

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

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

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

.

См. также

Функции

Темы

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

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

Поддержка