korg/bluez
0
0
Fork 0
mirror of https://git.kernel.org/pub/scm/bluetooth/bluez.git synced 2024-11-26 05:34:23 +08:00
Code Issues Packages Projects Releases Wiki Activity

doc: Add extra mode for a reduced LE privacy mode

Browse Source
This commit is contained in:
Marcel Holtmann 2014-06-22 22:05:51 +02:00
parent 5b77287e01
commit 0df3313c07
1 changed files with 34 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/mgmt-api.txt
View File

@ -1661,8 +1661,29 @@ Set Privacy Command
This command is used to enable Low Energy Privacy feature using
resolvable private addresses.
The value 0x00 disables privacy mode, the value 0x01 enables
privacy mode.
The value 0x00 disables privacy mode, the values 0x01 and 0x02
enable privacy mode.
With value 0x01 the kernel will always use the privacy mode. This
means resolvable private address is used when the controller is
discoverable and also when pairing is initiated.
With value 0x02 the kernel will use privacy mode with resolvable
private address. In case the conroller is pairable and discoverable
the identity address is used. Also when pairing is initiated, the
connection will be established with the identity address.
Exposing the identity address when pairable and discoverable or
during initated pairing can be a privacy issue. For dual-mode
controllers this can be neglected since its public address will
be exposed over BR/EDR anyway. The benefit of exposing the
identity address for pairing purposes is that it makes matching
up devices with dual-mode topology during device discovery now
possible.
If the privacy value 0x02 is used, then also the GATT database
should expose the Privacy Characteristic so that remote devices
can determine if the privacy feature is in use or not.
When the controller has a public address (mandatory for dual-mode
controllers) it is used as identity address. In case the controller
@ -2333,6 +2354,17 @@ New Identity Resolving Key Event
This event also indicates that now the identity address should
be used for commands instead of the resolvable random address.
It is possible that some devices allow discovering via its
identity address, but after pairing using resolvable private
address only. In such a case Store_Hint will be 0x00 and the
Random_Address will indicate 00:00:00:00:00:00. For these devices,
the Privacy Characteristic of the remote GATT database should
be consulted to decide if the identity resolving key must be
stored persistently or not.
Devices using Set Privacy command with the option 0x02 would
be such type of device.
Possible values for the Address_Type parameter:
0 Reserved (not in use)
1 LE Public