Создайте объект настройки для PDU ATT BLE
Загрузите Необходимый: Чтобы использовать bleATTPDUConfig, сначала загрузите Библиотеку Communications Toolbox™ для Протокола Bluetooth®. Для получения дополнительной информации смотрите, Получают и Управляют Дополнениями (MATLAB). В качестве альтернативы смотрите Библиотеку 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 в байтах, которые могут получить клиент или сервер.
Типы данных: uint8
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-by-2
символьный массив максимальной длины 131068
Значение атрибута, заданного как одно из этих значений:
Вектор символов — Этот вектор представляет октеты в шестнадцатеричном формате.
Скаляр строки — Этот скаляр представляет октеты в шестнадцатеричном формате.
Числовой вектор элементов в области значений [0,255] — Этот вектор представляет октеты в десятичном формате. Максимальной длиной числового вектора является 65534
.
n-by-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'
Создайте другой объект настройки 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'
Этот пример использует:
Создайте объект настройки 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'
Сгенерируйте PDU ATT BLE от соответствующего объекта настройки.
attPDU = bleATTPDU(cfgTx);
Декодируйте сгенерированный PDU ATT BLE. Возвращенное состояние указывает, что декодирование успешно. Просмотрите применимые свойства кода операции 'Error response'
.
[status, cfgRx] = bleATTPDUDecode(attPDU)
status = Success
cfgRx = bleATTPDUConfig with properties: Opcode: 'Read by type request' StartHandle: '0001' EndHandle: 'FFFF' AttributeType: '2800'
[1] Bluetooth Hompage. https://www.bluetooth.com/.
[2] Специальная группа (SIG) Bluetooth. "Спецификация ядра Bluetooth". Версия 5.0.
У вас есть модифицированная версия этого примера. Вы хотите открыть этот пример со своими редактированиями?
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.