ARMmbed
/
mbed-os
mirror of https://github.com/ARMmbed/mbed-os.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

privacy doxygen overview

pull/6932/head
paul-szczepanek-arm 2018-05-17 16:48:49 +01:00
parent 7e69444458
commit a8ac925b4f
1 changed files with 21 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
features/FEATURE_BLE/ble/Gap.h
View File

@ -121,6 +121,27 @@ class GapAdvertisingData;
* gap.startAdvertising(); * gap.startAdvertising();
* @endcode * @endcode
* *
* @par Privacy
*
* Privacy is a feature that allows a device to avoid being tracked by other
* (untrusted) devices. The device achieves it by periodically generating a
* new random address. The random address may be a resolvable random address,
* enabling trusted devices to recognise it as belonging to the same
* device. These trusted devices receive an Identity Resolution Key (IRK)
* during pairing. This is handled by the SecurityManager and relies on the
* other device accepting and storing the IRK.
*
* Privacy needs to be enabled by calling enablePrivacy() after having
* initialised the SecurityManager since privacy requires SecurityManager
* to handle IRKs. The behaviour of privacy enabled devices is set by
* using setCentralPrivacyConfiguration() which specifies what the device
* should be with devices using random addresses. Random addresses
* generated by privacy enabled device can be of two types: resolvable
* (by devices who have the IRK) and unresolvable. Unresolvable addresses
* can't be used for connecting and connectable advertising therefore a
* resolvable one will be used for these regardless of the privacy
* configuration.
*
* @par Scanning * @par Scanning
* *
* Scanning consist of listening for peer advertising packets. From a scan, a * Scanning consist of listening for peer advertising packets. From a scan, a