D-Bus интерфейс GattDescriptor1
Интерфейс позволяет получать информацию о GATT-дескрипторах.
| Шина: | системная |
| Служба: | org.bluez |
| Объект: | [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX/serviceXX/charYYYY/descriptorZZZ |
| Интерфейс: | org.bluez.GattDescriptor1 |
Свойства
- Characteristic : object [только для чтения]
- Flags : array{string} [только для чтения]
- Handle : uint16 [опционально, только для сервера]
- UUID : string [только для чтения]
- Value : array{byte} [только для чтения, опционально]
Методы
- array{byte} ReadValue(dict flags)
- WriteValue(array{byte} value, dict flags)
Подробное описание
Интерфейс содержит методы и свойства для получения информацию о GATT-дескрипторах.
Описание свойств
Characteristic : object [только для чтения]
Путь к объекту у службы GATT, которой принадлежит дескриптор.
Flags : array{string} [только для чтения]
Определяет, как может использоваться значение дескриптора.
Допустимые значения:
read,write,encrypt-read,encrypt-write,encrypt-authenticated-read,encrypt-authenticated-write,secure-read(только для сервера),secure-write(только для сервера),authorize.
Handle : uint16 [опционально, только для сервера]
Дескриптор характеристики. Когда он доступен на сервере, его попытаются использовать для выделения памяти в базе данных, что может привести к сбою. Для автоматического выделения должно использоваться значение 0x0000, что приведёт к установке выделенного дескриптора после регистрации.
UUID : string [только для чтения]
128-битный UUID дескриптора.
Value : array{byte} [только для чтения, опционально]
Кэшированное значение дескриптора.
Свойство обновляется только после успешного запроса на чтение и при получении уведомления
или индикации, после чего будет отправлен сигнал PropertiesChanged.
Описание методов
array{byte} ReadValue(dict flags)
Отправляет запрос на чтение значения характеристики и возвращает значение, если операция прошла успешно.
Возможные ключи:
offset- начальное смещение
device- объект устройства (только для сервера)
link- тип ссылки (только для сервера)
Возможные ошибки:
org.bluez.Error.Failed,org.bluez.Error.InProgress,org.bluez.Error.NotPermitted,org.bluez.Error.NotAuthorized,org.bluez.Error.NotSupported.
WriteValue(array{byte} value, dict flags)
Отправляет запрос на запись значения характеристики.
Возможные ключи:
offset- начальное смещение
device- объект устройства (только для сервера)
link- тип ссылки (только для сервера)
prepare-authorize- истинно, если готовится запрос на авторизацию
Возможные ошибки:
org.bluez.Error.Failed,org.bluez.Error.InProgress,org.bluez.Error.NotPermitted,org.bluez.Error.InvalidValueLength,org.bluez.Error.NotAuthorized,org.bluez.Error.NotSupported.