Объект Configuration для PDU ATT BLE
Загрузите Необходимый: Чтобы использовать bleATTPDUConfig, сначала загрузите Библиотеку Communications Toolbox™ для Bluetooth® Протокол. Для получения дополнительной информации смотрите, Получают и Управляют Дополнениями. В качестве альтернативы смотрите Библиотеку Communications Toolbox для Обмена файлами Протокола Bluetooth.
bleATTPDUConfig
создает объект настройки для модуля данных о протоколе атрибута Bluetooth низкой энергии (BLE) (PDU ATT). Можно сконфигурировать PDU ATT BLE с помощью применимых свойств bleATTPDUConfig
.
создает cfgATT
= bleATTPDUConfigbleATTPDUConfig
объект настройки, 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.
Opcode
— Код операции PDU ATT BLE'Read request'
(значение по умолчанию) | 'MTU request'
| 'Information request'
| ...
Код операции 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
RequestedOpcode
— Код операции запроса PDU ATT BLE'Read request'
(значение по умолчанию) | вектор символов | строковый скалярКод операции запроса 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
Format
— Формат информационного поля данных'16 bit'
(значение по умолчанию) | '128 bit'
Формат информационного поля данных в виде '16 bit'
или '128 bit'
. Это значение задает формат информационного элемента данных в PDU с кодом операции 'Information Response'
.
Типы данных: char |
string
AttributeHandle
— Обработайте значение атрибута
(значение по умолчанию) | вектор символов шестнадцатеричного 2D октетаОбработайте значение атрибута в виде вектора символов 2D октета шестнадцатеричное значение в области значений [0x0001, 0xFFFF]. Это значение является уникальным идентификатором. Сервер динамически присваивает это значение.
Типы данных: char |
string
ErrorMessage
— Сообщение об ошибке, соответствующее, чтобы запросить PDU ATT BLE'Invalid handle'
(значение по умолчанию) | 'Invalid handle'
| 'Read not permitted'
| ...
Сообщение об ошибке, соответствующее, чтобы запросить 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
MaxTransmissionUnit
— Максимальный размер PDU ATT BLE
(значение по умолчанию) | положительное целое числоМаксимальный размер PDU ATT BLE в виде положительного целого числа в области значений [23,65535]
. Это наборы значений максимальный размер PDU ATT BLE в байтах, которые могут получить клиент или сервер.
Типы данных: double
StartHandle
— Стартовый указатель области значений указателя
(значение по умолчанию) | вектор символов 2D октета шестнадцатеричное значениеСтартовый указатель указателя располагается в виде 2D октета шестнадцатеричное значение в области значений [0x0001,0xFFFF]. Это значение указывает на значение указателя сервиса или характеристического объявления или стартового указателя области значений указателя. Это значение должно быть меньше EndHandle
.
Типы данных: char |
string
EndHandle
— Конечный указатель области значений указателя'FFFF'
(значение по умолчанию) | вектор символов 2D октета шестнадцатеричное значениеКонечный указатель указателя располагается в виде 2D октета шестнадцатеричное значение в области значений [0x0001,0xFFFF]. Это наборы значений значение указателя конца объявления службы или характеристического объявления или конечного указателя области значений указателя. Это значение должно быть больше StartHandle
.
Типы данных: char |
string
AttributeType
— Тип атрибута'2800' (Primary service)
(значение по умолчанию) | четырехэлементный или вектор символов с 32 элементами | строковый скаляр с 16 октетами или с 2 октетамиТип атрибута в виде четырехэлементного или вектора символов с 32 элементами или строкового скаляра, обозначающего or16-октет 2D октета шестнадцатеричное значение.
Типы данных: char |
string
AttributeValue
— Значение атрибута' '
(значение по умолчанию) | вектор символов | строковый скаляр | числовой вектор из элементов в области значений [0,255] | n
- 2 символьных массива максимальной длины 131068
Значение атрибута в виде одного из этих значений:
Вектор символов — Этот вектор представляет октеты в шестнадцатеричном формате.
Строковый скаляр — Этот скаляр представляет октеты в шестнадцатеричном формате.
Числовой вектор из элементов в области значений [0,255] — Этот вектор представляет октеты в десятичном формате. Максимальной длиной числового вектора является 65534
.
n
- 2 символьных массива — Каждая строка представляют октет в шестнадцатеричном формате. Максимальной длиной символьного массива является 131068
.
AttributeValue
указывает на значение атрибута, чтобы храниться в или читать из базы данных атрибута. Задайте это значение в LSB первый формат.
Типы данных: char |
string
| double
Offset
— Смещение следующего октета, который будет считан
(значение по умолчанию) | целое число в области значений [0, 65565]Смещение следующего октета, который будет считан в виде целого числа в области значений [0, 65535]
. Можно использовать это значение в ATT BLE PDUs с кодами операции 'Read blob request'
, 'Prepare write request'
, и 'Prepare write response'
идентифицировать смещение значения атрибута в базе данных атрибута.
Типы данных: double
ExecuteWrite
— Выполните флаг записи'Cancel all prepared writes'
(значение по умолчанию) | 'Write all pending requests'
Выполните флаг записи в виде 'Cancel all prepared writes'
или 'Write all pending requests'
. Можно определить действие (отбрасывание или запись), чтобы быть выполненными, когда это свойство используется.
Типы данных: char |
string
bleATTPDU | Сгенерируйте PDU ATT BLE |
bleATTPDUDecode | Декодируйте PDU ATT BLE |
Этот пример использует:
Создайте два уникальных объекта настройки 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.
Этот пример использует:
Создайте объект настройки 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/.
У вас есть модифицированная версия этого примера. Вы хотите открыть этот пример со своими редактированиями?
Вы щелкнули по ссылке, которая соответствует команде MATLAB:
Выполните эту команду, введя её в командном окне MATLAB.
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.