Re: [RFC PATCH] doc/mgmt-api: Add appearance command and event specification

Hi Marcel,

On 23 August 2016 at 14:06, Marcel Holtmann [off-list ref] wrote:

Hi Michal,

quoted

---
doc/mgmt-api.txt | 39 +++++++++++++++++++++++++++++++++++++++
1 file changed, 39 insertions(+)

diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index 3f593f9..f7e760d 100644
--- a/doc/mgmt-api.txt
+++ b/doc/mgmt-api.txt

@@ -2811,6 +2811,31 @@ Start Limited Discovery Command
                              Invalid Index


+Set Appearance Command
+======================
+
+     Command Code:           0x0042
+     Controller Index:       <controller id>
+     Command Parameters:     Appearance (2 Octets)
+     Return Parameters:      Appearance (2 Octets)
+
+     This command is used to set the appearance value of a controller.
+
+     This command can be used when the controller is not
+     powered and all settings will be programmed once powered.
+
+     The value of appearance will be remembered when switching
+     the controller off and back on again. So the appearance only
+     have to be set once when a new controller is found and will
+     stay until removed.
+
+     This command generates a Command Complete event on success
+     or a Command Status event on failure.
+
+     Possible errors:        Invalid Parameters
+                             Invalid Index

what is this good for?

This is needed to handle appearance flag in "Add Advertising" as well as
being able to generate LE OOB data with it.

-- 
pozdrawiam
Szymon K. Janc