korg/bluez
0
0
Fork 0
mirror of https://git.kernel.org/pub/scm/bluetooth/bluez.git synced 2024-12-19 17:03:26 +08:00
Code Issues Packages Projects Releases Wiki Activity

doc: Add extra mode for Set Advertising management command

Browse Source
This commit is contained in:
Marcel Holtmann 2015-03-12 18:53:28 -07:00
parent b3c62f3063
commit ae38782197
1 changed files with 26 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
doc/mgmt-api.txt
View File

@ -1565,12 +1565,33 @@ Set Advertising Command
Return Parameters: Current_Settings (4 Octets)
This command is used to enable LE advertising on a controller
that supports it. The allowed values for the Advertising
command parameter are 0x00 and 0x01. All other values will
return Invalid Parameters.
that supports it. The allowed values for the Advertising command
parameter are 0x00, 0x01 and 0x02. All other values will return
Invalid Parameters.
A pre-requisite is that LE is already enabled, otherwise
this command will return a "rejected" response.
The value 0x00 disables advertising, the value 0x01 enables
advertising with considering of connectable setting and the
value 0x02 enables advertising in connectable mode.
Using value 0x01 means that when connectable setting is disabled,
the advertising happens with undirected non-connectable advertising
packets and a non-resovable random address is used. If connectable
setting is enabled, then undirected connectable advertising packets
and the identity address or resolvable private address are used.
Devices configured via Add Device command have no affect when using
value 0x01 since only the connectable setting is taken into account.
To utilize undirect connectable advertising without changing the
connectable setting, the value 0x02 can be utilized. It makes the
device connectable via LE without the requirement for being
connectable on BR/EDR (and/or LE).
The value 0x02 should be the preferred mode of operation when
implementing peripheral mode.
A pre-requisite is that LE is already enabled, otherwise this
command will return a "rejected" response.
This command generates a Command Complete event on success or a
Command Status event on failure.