From 5e9859c731e0b32a9457c5c1168c464db50491fe Mon Sep 17 00:00:00 2001 From: Milanka Ringwald Date: Wed, 29 Sep 2021 10:23:43 +0200 Subject: [PATCH] docs: update GATT profile --- doc/manual/docs-template/profiles.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/doc/manual/docs-template/profiles.md b/doc/manual/docs-template/profiles.md index 33a8cd3df..68d4ffdc5 100644 --- a/doc/manual/docs-template/profiles.md +++ b/doc/manual/docs-template/profiles.md @@ -574,7 +574,7 @@ are forwarded to the application via callback. Otherwise, the Characteristics cannot be written and it will return the specified constant value. -Adding NOTIFY and/or INDICATE automatically creates an addition Client +Adding NOTIFY and/or INDICATE automatically creates an additional Client Configuration Characteristic. Property | Meaning @@ -598,6 +598,16 @@ WRITE_ENCRYPTED | Write operations require Encryption WRITE_AUTHENTICATED | Write operations require Authentication ENCRYPTION_KEY_SIZE_X | Require encryption size >= X, with W in [7..16] +For example, Volume State Characteristic (Voice Control Service) requires: +- Mandatory Properties: Read, Notify +- Security Permittions: Encryption Required + +In addition, its read is handled by application. We can model this Characteristic as follows: + +~~~~ + CHARACTERISTIC, ORG_BLUETOOTH_CHARACTERISTIC_VOLUME_STATE, DYNAMIC | READ | NOTIFY | ENCRYPTION_KEY_SIZE_16 +~~~~ + To use already implemented GATT Services, you can import it using the *#import * command. See [list of provided services](gatt_services.md).