Linux bluetooth development
 help / color / mirror / Atom feed
* [PATCH] doc: Add commands for Start Service Discovery and Stop Service Discovery
@ 2014-10-10 10:49 Marcel Holtmann
  2014-10-20 17:02 ` Jakub Pawlowski
  0 siblings, 1 reply; 8+ messages in thread
From: Marcel Holtmann @ 2014-10-10 10:49 UTC (permalink / raw)
  To: linux-bluetooth

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

diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index daf036b4c1ec..2038f883cc95 100644
--- a/doc/mgmt-api.txt
+++ b/doc/mgmt-api.txt
@@ -2135,6 +2135,89 @@ Set Public Address Command
 				Invalid Index
 
 
+Start Service Discovery Command
+===============================
+
+	Command Code:		0x003a
+	Controller Index:	<controller id>
+	Command Parameters:	Address_Type (1 Octet)
+				RSSI_Threshold (1 Octet)
+				Num_UUID (1 Octet)
+				UUID[i] (16 Octets)
+	Return Parameters:	Address_Type (1 Octet)
+
+	This command is used to start the process of discovering remote
+	devices with a specific UUID. A Device Found event will be sent
+	for each discovered device.
+
+	Possible values for the Address_Type parameter are a bit-wise or
+	of the following bits:
+
+		0	BR/EDR
+		1	LE Public
+		2	LE Random
+
+	By combining these e.g. the following values are possible:
+
+		1	BR/EDR
+		6	LE (public & random)
+		7	BR/EDR/LE (interleaved discovery)
+
+	The service discovery uses active scanning for Low Energy scanning
+	and will search for UUID in both advertising data and scan response
+	data.
+
+	Found devices that have a RSSI value smaller than RSSI_Threshold
+	are not reported via DeviceFound event. Setting a value of 127
+	will cause all devices to be reported.
+
+	The list of UUIDs identifies a logical OR. Only one of the UUIDs
+	have to match to cause a DeviceFound event. Providing an empty
+	list of UUIDs with Num_UUID set to 0 which means that DeviceFound
+	events are send out for all devices above the RSSI_Threshold.
+
+	In case the RSSI_Threshold is set to 127 and the Num_UUID is 0,
+	then this command behaves exactly the same as Start Discovery.
+
+	When the discovery procedure starts the Discovery event will
+	notify this similar to Start Discovery.
+
+	This command can only be used when the controller is powered.
+
+	This command generates a Command Complete event on success
+	or failure.
+
+	Possible errors:	Busy
+				Not Supported
+				Invalid Parameters
+				Not Powered
+				Invalid Index
+
+
+Stop Service Discovery Command
+==============================
+
+	Command Code:		0x003b
+	Controller Index:	<controller id>
+	Command Parameters:	Address_Type (1 Octet)
+	Return Parameters:	Address_Type (1 Octet)
+
+	This command is used to stop the service discovery process started
+	using the Start Service Discovery command.
+
+	When the discovery procedure stops the Discovery event will
+	notify this similar to Stop Discovery.
+
+	This command can only be used when the controller is powered.
+
+	This command generates a Command Complete event on success
+	or failure.
+
+	Possible errors:	Rejected
+				Invalid Parameters
+				Invalid Index
+
+
 Command Complete Event
 ======================
 
@@ -2555,7 +2638,10 @@ Discovering Event
 
 	This event indicates that the controller has started discovering
 	devices. This discovering state can come and go multiple times
-	between a StartDiscover and a StopDiscovery command.
+	between a Start Discover and a Stop Discovery commands.
+
+	The Start Service Discovery and Stop Service Discovery commands
+	will also trigger this event.
 
 	The valid values for the Discovering parameter are 0x01
 	(enabled) and 0x00 (disabled).
-- 
1.9.3


^ permalink raw reply related	[flat|nested] 8+ messages in thread

end of thread, other threads:[~2014-11-23 10:47 UTC | newest]

Thread overview: 8+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2014-10-10 10:49 [PATCH] doc: Add commands for Start Service Discovery and Stop Service Discovery Marcel Holtmann
2014-10-20 17:02 ` Jakub Pawlowski
2014-10-20 18:06   ` Marcel Holtmann
2014-11-21 19:49     ` Jakub Pawlowski
2014-11-22  2:16       ` Marcel Holtmann
2014-11-22  3:19         ` Jakub Pawlowski
2014-11-23  8:04           ` Jakub Pawlowski
2014-11-23 10:47             ` Marcel Holtmann

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox