korg/bluez
0
0
Fork 0
mirror of https://git.kernel.org/pub/scm/bluetooth/bluez.git synced 2024-12-19 17:03:26 +08:00
Code Issues Packages Projects Releases Wiki Activity

doc: Add commands for service discovery procedure

Browse Source
This commit is contained in:
Marcel Holtmann 2014-11-23 11:46:25 +01:00
parent f89c46304a
commit aa34c8cdee
1 changed files with 87 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

88
doc/mgmt-api.txt
View File

@ -2151,6 +2151,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
======================
@ -2571,7 +2654,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 Discovery 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).