Re: [PATCH] doc: Add commands for Start Service Discovery and Stop Service Discovery

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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




[Index of Archives]     [Bluez Devel]     [Linux Wireless Networking]     [Linux Wireless Personal Area Networking]     [Linux ATH6KL]     [Linux USB Devel]     [Linux Media Drivers]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [Big List of Linux Books]

  Powered by Linux