From bca5998f2a8d872f117088e75ef2d597ada09445 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Fri, 4 Jul 2014 12:15:02 +0200 Subject: [PATCH] doc: Add comments on how blocked devices interact with auto-connection --- doc/mgmt-api.txt | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt index 0a95a0e6d..e5f9ff304 100644 --- a/doc/mgmt-api.txt +++ b/doc/mgmt-api.txt @@ -1411,6 +1411,15 @@ Block Device Command 1 LE Public 2 LE Random + For Low Energy devices, the blocking of a device take presedence + over auto-connection actions provided by Add Device. Blocked + devices will not be auto-connected or even reported when found + during background scanning. If the controller is connectable + direct advertising from blocked devices will also be ignored. + + Connections created from advertising of the controller will + be dropped if the device is blocked. + This command can be used when the controller is not powered. This command generates a Command Complete event on success @@ -1439,6 +1448,9 @@ Unblock Device Command 1 LE Public 2 LE Random + When the Address parameter is 00:00:00:00:00:00, then all + previously blocked devices will be unblocked. + This command can be used when the controller is not powered. This command generates a Command Complete event on success @@ -1874,6 +1886,10 @@ Add Device Command then devices using undirected advertising will only connect when using Action 1 or Action 2. + When a device is blocked using Block Device command, then it is + valid to add the device here, but all actions will be ignored + until the device is unblocked. + This command can be used when the controller is not powered and all settings will be programmed once powered. @@ -1904,7 +1920,7 @@ Remove Device Command 2 LE Random When the Address parameter is 00:00:00:00:00:00, then all - previously added devices wil be removed. + previously added devices will be removed. This command can be used when the controller is not powered and all settings will be programmed once powered. -- 2.47.3