bleL2CAPFrameConfig

Объект Configuration для системы координат BLE L2CAP

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

Описание

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

Создание

Описание

пример

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

пример

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

Свойства

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

Примечание

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

Идентификатор для логической конечной точки канала в виде четырехэлементного вектора символов или строкового скаляра, обозначающего 2D октет шестнадцатеричное значение. 'ChannelIdentifier' обозначает локальное имя, представляющее логическую конечную точку канала. Это свойство используется, чтобы идентифицировать системы координат данных и команда. Системы координат команды используют '0005' как 'ChannelIdentifier'. Использование B-систем-координат L2CAP зафиксировало '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

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

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

Целевая логическая конечная точка канала в виде четырехэлементного вектора символов или строкового скаляра, обозначающего 2D октет шестнадцатеричное значение. Это свойство задает целевую конечную точку канала, от которой отправлен запрос, или ответ получен. Когда канал создается с помощью основанной на кредите процедуры связи, пакеты данных, текущие месту назначения запроса, отправляются в 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,0 с].

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

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

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

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

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

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

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

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

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

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

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

Количество систем координат LE взаимодействует с устройством, может отправить или получить в виде целого числа в области значений [0, 65,535] октеты. Это свойство указывает на количество систем координат 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Сгенерируйте систему координат BLE L2CAP
bleL2CAPFrameDecodeДекодируйте систему координат BLE L2CAP

Примеры

свернуть все

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

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

    ChannelIdentifier: '0004'

Создайте объект настройки BLE L2CAP, 'bleL2CAPFrameConfig', сгенерировать систему координат данных BLE L2CAP (B-система-координат). Установите значение идентификатора канала as'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'

Декодируйте сгенерированную систему координат данных BLE L2CAP (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 | официальный сайт Технологии Bluetooth”. Полученный доступ 22 ноября 2019. https://www.bluetooth.com/.

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

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

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

Введенный в R2019b

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