Exponenta Banner

bleATTPDUConfig

Объект Configuration для PDU ATT BLE

расширьте все на странице

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

Описание

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

Создание

Синтаксис

cfgATT = bleATTPDUConfig
cfgATT = bleATTPDUConfig(Name,Value)

Описание

пример

cfgATT = bleATTPDUConfig создает bleATTPDUConfig объект настройки, cfgATT, для PDU ATT BLE со значениями по умолчанию.

пример

cfgATT = bleATTPDUConfig(Name,Value) свойства наборов с помощью одной или нескольких пар "имя-значение". Заключите каждое имя свойства в кавычки. Например, bleATTPDUConfig('Opcode','Error response') устанавливает Opcode свойство cfgATT к 'Error response'.

Свойства

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

Примечание

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

Код операции PDU ATT BLE в виде одного из значений в этом списке. Каждое допустимое значение описывает код операции PDU ATT BLE.

  • 'MTU request'

  • 'Error response'

  • 'Information request'

  • 'Find by type value request'

  • 'Read by type request'

  • 'Read request'

  • 'Read response'

  • 'Read blob request'

  • 'Read blob response'

  • 'Read by group type request'

  • 'Write request'

  • 'Write response'

  • 'Write command'

  • 'Prepare write request'

  • 'Prepare write response'

  • 'Execute write request'

  • 'Execute write response'

  • 'Handle value notification'

  • 'Handle value indication'

  • 'Handle value confirmation'

  • 'Information response'

  • 'Find by type value response'

  • 'Read by type response'

  • 'Read by group type response'

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

Код операции запроса PDU ATT BLE в виде одного из значений в этом списке. Каждое допустимое значение описывает запрос PDU ATT BLE (от равноправного устройства), который вызвал ошибку.

  • 'MTU request'

  • 'Information request'

  • 'Find by type value request'

  • 'Read by type request'

  • 'Read request'

  • 'Read blob request'

  • 'Read by group type request'

  • 'Write request'

  • 'Prepare to write request'

  • 'Execute write request'

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

Формат информационного поля данных в виде '16 bit' или '128 bit'. Это значение задает формат информационного элемента данных в PDU с кодом операции 'Information Response'.

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

Обработайте значение атрибута в виде вектора символов 2D октета шестнадцатеричное значение в области значений [0x0001, 0xFFFF]. Это значение является уникальным идентификатором. Сервер динамически присваивает это значение.

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

Сообщение об ошибке, соответствующее, чтобы запросить PDU ATT BLE в виде одного из значений в этом списке. Каждое значение указывает на причину ошибки при соответствии PDU запроса от равноправного устройства.

  • 'Invalid handle'

  • 'Read not permitted'

  • 'Write not permitted'

  • 'Invalid PDU'

  • 'Insufficient authentication'

  • 'Request not supported'

  • 'Invalid offset'

  • 'Insufficient authorization'

  • 'Prepare queue full'

  • 'Attribute not found'

  • 'Attribute not long'

  • 'Insufficient encryption key size'

  • 'Invalid attribute value length'

  • 'Unlikely error'

  • 'Insufficient encryption'

  • 'Unsupported group type'

  • 'Insufficient resources'

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

Максимальный размер PDU ATT BLE в виде положительного целого числа в области значений [23,65535]. Это наборы значений максимальный размер PDU ATT BLE в байтах, которые могут получить клиент или сервер.

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

Стартовый указатель указателя располагается в виде 2D октета шестнадцатеричное значение в области значений [0x0001,0xFFFF]. Это значение указывает на значение указателя сервиса или характеристического объявления или стартового указателя области значений указателя. Это значение должно быть меньше EndHandle.

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

Конечный указатель указателя располагается в виде 2D октета шестнадцатеричное значение в области значений [0x0001,0xFFFF]. Это наборы значений значение указателя конца объявления службы или характеристического объявления или конечного указателя области значений указателя. Это значение должно быть больше StartHandle.

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

Тип атрибута в виде четырехэлементного или вектора символов с 32 элементами или строкового скаляра, обозначающего or16-октет 2D октета шестнадцатеричное значение.

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

Значение атрибута в виде одного из этих значений:

  • Вектор символов — Этот вектор представляет октеты в шестнадцатеричном формате.

  • Строковый скаляр — Этот скаляр представляет октеты в шестнадцатеричном формате.

  • Числовой вектор из элементов в области значений [0,255] — Этот вектор представляет октеты в десятичном формате. Максимальной длиной числового вектора является 65534.

  • n- 2 символьных массива — Каждая строка представляют октет в шестнадцатеричном формате. Максимальной длиной символьного массива является 131068.

AttributeValue указывает на значение атрибута, чтобы храниться в или читать из базы данных атрибута. Задайте это значение в LSB первый формат.

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

Смещение следующего октета, который будет считан в виде целого числа в области значений [0, 65535]. Можно использовать это значение в ATT BLE PDUs с кодами операции 'Read blob request', 'Prepare write request', и 'Prepare write response' идентифицировать смещение значения атрибута в базе данных атрибута.

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

Выполните флаг записи в виде 'Cancel all prepared writes' или 'Write all pending requests'. Можно определить действие (отбрасывание или запись), чтобы быть выполненными, когда это свойство используется.

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

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

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

bleATTPDUСгенерируйте PDU ATT BLE
bleATTPDUDecodeДекодируйте PDU ATT BLE

Примеры

свернуть все

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

Скрипт Open Live Script

Создайте два уникальных объекта настройки PDU ATT BLE: один из типа 'Read by type request' и другой тип 'Error response' использование настроек по умолчанию и пар "имя-значение" соответственно.

Создайте объект настройки PDU ATT BLE с настройками по умолчанию.

cfgATT = bleATTPDUConfig;

Установите код операции PDU ATT BLE как 'Read by type request'. Просмотрите применимые свойства кода операции 'Read by type request'.

cfgATT.Opcode = 'Read by type request'
cfgATT = 
  bleATTPDUConfig with properties:

           Opcode: 'Read by type request'
      StartHandle: '0001'
        EndHandle: 'FFFF'
    AttributeType: '2800'

   Read-only properties:
    No properties.

Создайте другой объект настройки PDU ATT BLE, на этот раз с помощью пар "имя-значение". Измените код операции PDU ATT BLE в 'Error response'. Просмотрите применимые свойства кода операции 'Error response'. 

cfgATT = bleATTPDUConfig('Opcode','Error response')
cfgATT = 
  bleATTPDUConfig with properties:

             Opcode: 'Error response'
    RequestedOpcode: 'Read request'
    AttributeHandle: '0001'
       ErrorMessage: 'Invalid handle'

   Read-only properties:
    No properties.

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

Скрипт Open Live Script

Создайте объект настройки PDU ATT BLE. Измените значение кода операции к 'Read by type request'. Просмотрите применимые свойства заданного значения кода операции.

cfgTx = bleATTPDUConfig;
cfgTx.Opcode = 'Read by type request'
cfgTx = 
  bleATTPDUConfig with properties:

           Opcode: 'Read by type request'
      StartHandle: '0001'
        EndHandle: 'FFFF'
    AttributeType: '2800'

   Read-only properties:
    No properties.

Сгенерируйте PDU ATT BLE от соответствующего объекта настройки.

attPDU = bleATTPDU(cfgTx);

Декодируйте сгенерированный PDU ATT BLE. Возвращенное состояние указывает, что декодирование успешно. Просмотрите применимые свойства кода операции 'Error response'.

[status, cfgRx] = bleATTPDUDecode(attPDU)
status = 
  blePacketDecodeStatus enumeration

    Success


cfgRx = 
  bleATTPDUConfig with properties:

           Opcode: 'Read by type request'
      StartHandle: '0001'
        EndHandle: 'FFFF'
    AttributeType: '2800'

   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/.

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

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

Смотрите также

Функции

Темы

Введенный в R2019b

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

Поддержка