I think that RSSI_Threshold should be per UUID: + Command Parameters: Address_Type (1 Octet) + Num_Filters (1 Octet) + Filter1 { + RSSI_Threshold (1 Octet) + UUID[i] (16 Octets) + } + Filter2 {} + ... On Fri, Oct 10, 2014 at 3:49 AM, Marcel Holtmann <marcel@xxxxxxxxxxxx> wrote: > --- > 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 > > -- > To unsubscribe from this list: send the line "unsubscribe linux-bluetooth" in > the body of a message to majordomo@xxxxxxxxxxxxxxx > More majordomo info at http://vger.kernel.org/majordomo-info.html -- To unsubscribe from this list: send the line "unsubscribe linux-bluetooth" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html