From ae38782197b126e9680b0ae8ff356b4c1e7f3ef7 Mon Sep 17 00:00:00 2001
From: Marcel Holtmann <marcel@holtmann.org>
Date: Thu, 12 Mar 2015 18:53:28 -0700
Subject: [PATCH] doc: Add extra mode for Set Advertising management command

---
 doc/mgmt-api.txt | 31 ++++++++++++++++++++++++++-----
 1 file changed, 26 insertions(+), 5 deletions(-)

diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index d4df8d942..fdca60fc6 100644
--- a/doc/mgmt-api.txt
+++ b/doc/mgmt-api.txt
@@ -1565,12 +1565,33 @@ Set Advertising Command
 	Return Parameters:	Current_Settings (4 Octets)
 
 	This command is used to enable LE advertising on a controller
-	that supports it. The allowed values for the Advertising
-	command parameter are 0x00 and 0x01. All other values will
-	return Invalid Parameters.
+	that supports it. The allowed values for the Advertising command
+	parameter are 0x00, 0x01 and 0x02. All other values will return
+	Invalid Parameters.
 
-	A pre-requisite is that LE is already enabled, otherwise
-	this command will return a "rejected" response.
+	The value 0x00 disables advertising, the value 0x01 enables
+	advertising with considering of connectable setting and the
+	value 0x02 enables advertising in connectable mode.
+
+	Using value 0x01 means that when connectable setting is disabled,
+	the advertising happens with undirected non-connectable advertising
+	packets and a non-resovable random address is used. If connectable
+	setting is enabled, then undirected connectable advertising packets
+	and the identity address or resolvable private address are used.
+
+	Devices configured via Add Device command have no affect when using
+	value 0x01 since only the connectable setting is taken into account.
+
+	To utilize undirect connectable advertising without changing the
+	connectable setting, the value 0x02 can be utilized. It makes the
+	device connectable via LE without the requirement for being
+	connectable on BR/EDR (and/or LE).
+
+	The value 0x02 should be the preferred mode of operation when
+	implementing peripheral mode.
+
+	A pre-requisite is that LE is already enabled, otherwise this
+	command will return a "rejected" response.
 
 	This command generates a Command Complete event on success or a
 	Command Status event on failure.