summaryrefslogtreecommitdiff
path: root/doc/mgmt-api.txt
diff options
context:
space:
mode:
authorMarcel Holtmann <marcel@holtmann.org>2014-07-04 10:58:53 +0200
committerMarcel Holtmann <marcel@holtmann.org>2014-07-04 11:01:22 +0200
commitd74bfda442080a014026b585d64a749876b1cbf6 (patch)
tree3f92623418870c5ba478bd446a31d72e4c184815 /doc/mgmt-api.txt
parent373b5385c955edde98ae3aec8690f743be43eae4 (diff)
downloadbluez-d74bfda442080a014026b585d64a749876b1cbf6.tar.gz
doc: Add notes about Add Device Action 0x02 and directed advertising
Diffstat (limited to 'doc/mgmt-api.txt')
-rw-r--r--doc/mgmt-api.txt22
1 files changed, 18 insertions, 4 deletions
diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index 5515304bf..0a95a0e6d 100644
--- a/doc/mgmt-api.txt
+++ b/doc/mgmt-api.txt
@@ -347,8 +347,9 @@ Set Connectable Command
and for LE controllers it changes the advertising type. For
dual mode controllers it affects both settings.
- For LE capable controllers the connectable setting only takes
- affect when advertising is enabled.
+ For LE capable controllers the connectable setting takes affect
+ when advertising is enabled (peripheral) or when directed
+ advertising events are received (central).
This command can be used when the controller is not powered and
all settings will be programmed once powered.
@@ -1852,14 +1853,27 @@ Add Device Command
Possible values for the Action parameter:
0 Background scan for device
1 Auto-connect device
+ 2 Auto-connect device and encrypt connection
With the Action 0, when the device is found, a new Device Found
- event will be send indicating this device is available. Devices
- using direct advertising will be connected.
+ event will be send indicating this device is available.
With the Action 1, when the device is found, it will be connected
and if successful a Device Connected event will be send.
+ With the Action 2, when the device is found and it is paired (has
+ a long term key), it will be connected, encryption will be started
+ and if successful a Device Connected event will be send.
+
+ Add a device the requires a encryption, but has no long term
+ key can be added with Action 2, but it will not be connected
+ until it has been paired.
+
+ Devices using directed advertising will be automatically connected
+ if the connectable setting is enabled. If connectable is not set,
+ then devices using undirected advertising will only connect when
+ using Action 1 or Action 2.
+
This command can be used when the controller is not powered and
all settings will be programmed once powered.