Commit Graph

276 Commits

Author SHA1 Message Date
Marcel Holtmann
dab577a767 doc: Add description for New Configuration Options mgmt event 2014-07-04 19:07:06 +02:00
Marcel Holtmann
82539c2f82 doc: Remove the unneeded auto-connect and encrypt action 2014-07-04 13:58:39 +02:00
Marcel Holtmann
5712fbe1a9 doc: Add Set External Configuration management command 2014-07-04 12:54:34 +02:00
Marcel Holtmann
bca5998f2a doc: Add comments on how blocked devices interact with auto-connection 2014-07-04 12:15:02 +02:00
Marcel Holtmann
d74bfda442 doc: Add notes about Add Device Action 0x02 and directed advertising 2014-07-04 11:01:22 +02:00
Marcel Holtmann
1bd220070a doc: Update the controller configuration parameter naming 2014-07-03 23:51:49 +02:00
Marcel Holtmann
a86c69e9f3 doc: Add extra empty line 2014-07-03 19:52:45 +02:00
Marcel Holtmann
f4d07701ba doc: More updates for management version 1.7 features 2014-07-03 18:51:30 +02:00
Marcel Holtmann
3a88a27011 doc: Add support for Unconfigured Index Removed event 2014-07-02 21:43:00 +02:00
Marcel Holtmann
db3aa39448 doc: Add management support for controller configuration 2014-07-02 01:45:11 +02:00
Marcel Holtmann
bce31c8da6 doc: Introduce Non Connectable flag for Device Found event 2014-07-01 12:58:08 +02:00
Marcel Holtmann
88f2b4202e doc: Add notes for management version 1.7 features 2014-06-29 23:42:01 +02:00
Marcel Holtmann
96d3a5b344 doc: Fix event opcode for New Connection Parameter event 2014-06-29 23:25:38 +02:00
Marcel Holtmann
f4db1bca77 doc: Add documentation for Device Added and Device Removed events 2014-06-29 23:24:42 +02:00
Marcel Holtmann
a4c629ce10 doc: Fix note about command complete for success and failure 2014-06-29 20:29:34 +02:00
Marcel Holtmann
65ff7dcdb5 doc: Return address for Add Device and Remove Device commands 2014-06-29 19:40:58 +02:00
Marcel Holtmann
6dac212ae3 doc: Update possible error codes for Add Device and Remove Device 2014-06-29 14:32:47 +02:00
Marcel Holtmann
2dbb42e525 doc: Update command opcode for Load Connection Parameters 2014-06-29 13:55:08 +02:00
Marcel Holtmann
9c76a0a483 doc: Add management commands for Add Device and Remove Device 2014-06-29 13:54:35 +02:00
Marcel Holtmann
8303897686 doc: Move get clock info command to the next available opcode 2014-06-29 13:53:10 +02:00
Marcel Holtmann
4a06d82515 doc: Add management command to get clock information 2014-06-27 14:17:17 +03:00
Marcel Holtmann
e4ad2b67ee doc: Add address type information to get connection info command 2014-06-27 11:44:39 +02:00
Marcel Holtmann
cdbee918b9 doc: Add comment for single mode controllers without public address 2014-06-23 08:56:15 +02:00
Johan Hedberg
155780f210 doc/mgmt-api: Fix a couple of typos 2014-06-23 08:05:13 +03:00
Marcel Holtmann
0df3313c07 doc: Add extra mode for a reduced LE privacy mode 2014-06-22 22:05:51 +02:00
Marcel Holtmann
5b77287e01 doc: Add management support for handling connection parameters 2014-06-22 22:00:42 +02:00
Marcel Holtmann
38b0958aab doc: Add mode for enabling generation of debug keys 2014-06-22 17:31:03 +03:00
Johan Hedberg
aaca6913d3 doc/mgmt-api: Specify valid IO Capability values 2014-06-17 14:55:07 +03:00
Andrzej Kaczmarek
59eda24f59 doc: Fix bit numbering in mgmt-api 2014-06-16 12:37:09 +02:00
Marcel Holtmann
cbea745941 doc: Update management command list for 3.16 kernels 2014-06-08 21:11:58 +02:00
Lukasz Rymanowski
2d4c1d2664 doc: Add description for Get Connection Information command
This patch introduces Get Connection Information command.
2014-05-16 08:06:22 +03:00
Marcel Holtmann
325d9bd48e doc: Mention the deprecated Debug_Keys parameter for Load Link Keys 2014-04-05 11:35:09 -07:00
Marcel Holtmann
c27182079e doc: Add note for new management API version of upcoming 3.15 kernel 2014-04-04 10:18:36 -07:00
Marcel Holtmann
209dcf6cf1 doc: List commands and events added to each management version 2014-03-09 15:17:07 -07:00
Marcel Holtmann
1040b482a1 doc: Fix indentation of management event parameters 2014-03-09 13:21:34 -07:00
Marcel Holtmann
3827e7b553 doc: Add description for New Signature Resolving Key event 2014-03-09 12:12:25 -07:00
Marcel Holtmann
f725b32c36 doc: Mention the identity address handling for pairing commands 2014-02-18 10:47:43 -08:00
Marcel Holtmann
60d28644ca doc: Add management commands and events for privacy support 2014-02-18 10:23:31 +02:00
Marcel Holtmann
9a8ea92652 doc: Add address type information where they were missing 2014-02-17 09:55:15 -08:00
Marcel Holtmann
3aa14496ce doc: Mention that new long term key and new link key completes pairing 2014-02-16 13:05:08 -08:00
Marcel Holtmann
eef32d40be doc: Mention the valid address types for BR/EDR link keys 2014-02-16 12:10:28 -08:00
Marcel Holtmann
41b4c99e49 doc: Fix a few more typos 2014-02-16 11:45:41 -08:00
Marcel Holtmann
bad86f3b3c doc: Fix two minor typos 2014-02-15 02:49:59 -08:00
Johan Hedberg
c16c7b4dea doc: Document Name_Known parameter of mgmt_confirm_name 2014-02-14 20:39:10 +02:00
Marcel Holtmann
47c6cad75f doc: Describe the new debug keys command and setting 2014-02-01 17:49:38 -08:00
Marcel Holtmann
17f7bfba5c doc: Change the authentication parameter into key_type parameter 2014-01-31 17:43:49 -08:00
Marcel Holtmann
484beadea8 doc: List the possible key types for link keys 2014-01-31 17:41:07 -08:00
Marcel Holtmann
ba8a3e83e4 doc: Add the mgmt interface versions and how the map to kernel releases 2014-01-28 18:30:53 -08:00
Marcel Holtmann
aecc71a383 doc: Mention the Secure Connections Only mode 2014-01-11 14:12:13 -08:00
Marcel Holtmann
89695d7bf4 doc: Change the wording a little bit 2014-01-11 14:09:52 -08:00
Marcel Holtmann
14bc777ecb doc: Add documentation for BR/EDR Secure Connections support 2014-01-10 02:03:28 -08:00
Marcel Holtmann
67c8c24824 doc: Mention the connectable support for LE controllers 2013-10-15 15:12:13 -07:00
Marcel Holtmann
ff318d86e6 doc: Mention the limited discoverable mode setting 2013-10-15 15:09:17 -07:00
Marcel Holtmann
92e72b23ff doc: Fix some style issues with the command parameters 2013-10-14 01:47:01 -07:00
Marcel Holtmann
e3aa668ea9 doc: Add section about Set Scan Parameters command 2013-10-14 01:20:33 -07:00
Marcel Holtmann
31324f41b2 doc: Mention that High Speed support depends on Secure Simple Pairing 2013-10-10 04:13:07 -07:00
Marcel Holtmann
603eb343cf doc: Correct a few minor style issues 2013-10-03 23:04:07 -07:00
Marcel Holtmann
aaa9c1dbe4 doc: Add missing title text to static address command 2013-10-03 09:14:07 -07:00
Johan Hedberg
cea02ba8ec doc/mgmt-api: Add definition for Set Static Address 2013-10-02 16:22:14 +03:00
Marcel Holtmann
a29602bc3b doc: Small beautification 2013-10-02 04:01:54 -07:00
Johan Hedberg
0e33783ff4 doc/mgmt-api: Add Set BR/EDR command definition 2013-10-02 12:16:57 +03:00
Marcel Holtmann
0978ffbd6f doc: Update description for Set Advertising command 2013-09-25 09:32:04 -07:00
Johan Hedberg
b06eba4185 doc: Fix mgmt_set_le error code list 2013-09-25 13:51:11 +03:00
Johan Hedberg
2f51cade81 doc: Add mgmt_set_advertising details to mgmt API 2013-09-25 13:51:11 +03:00
Johan Hedberg
5008dc2ba9 doc: Add short explanation for how to create mgmt sockets 2013-02-18 10:37:53 +02:00
Johan Hedberg
311e9cd36d doc: Add note about Debug_Keys parameter for Load Link Keys Command 2013-01-18 12:56:15 +02:00
Marcel Holtmann
15e74b99ee doc: Clarify the error codes of some management commands 2013-01-09 22:59:34 -08:00
Marcel Holtmann
db7db9c884 doc: Add missing empty return parameters for load long term keys 2013-01-09 12:03:45 -08:00
Johan Hedberg
e01141697a doc: Improve documentation of mgmt events 2013-01-08 20:50:14 +02:00
Johan Hedberg
7539255a35 doc: Update descriptions and possible error returns of mgmt commands 2013-01-08 15:52:08 +02:00
Szymon Janc
121befd7d8 mgmt-api: Remove not needed restriction on add/remove OOB data
Those commands don't send any HCI commands to controller so there is no
need to restrict them to only powered up controller. This also clarify
that provided OOB data is persistent over power down/up toggles.
2012-12-13 22:14:36 +02:00
Johan Hedberg
b27b7757d4 mgmt: Remove peripheral setting
It's still not decided how this will be exposed in the end but most
likely it wont be through mgmt (e.g. socket-based enabling is a probable
choice).
2012-11-09 16:52:48 +02:00
Johan Hedberg
e3f677b332 doc: Add missing info of peripheral setting to mgmt API 2012-10-22 18:53:37 +03:00
Johan Hedberg
1b0a4291d1 mgmt: Add support for LE peripheral mode 2012-10-22 17:36:51 +03:00
Szymon Janc
a2d706daa4 mgmt-api: Add missing error code descriptions 2012-10-01 11:17:13 +03:00
Johan Hedberg
a70760e810 mgmt-api: Add event for passkey notification 2012-09-04 16:34:41 +03:00
Mikel Astiz
902e9f2de2 mgmt: Add reason to device disconnect event
Extend the management API with the disconnect reason, as now reported
by the Kernel in MGMT_EV_DEVICE_DISCONNECTED.
2012-08-17 12:26:30 +03:00
Syam Sidhardhan
3e14a20905 doc: Fix typo 2012-04-13 12:45:10 +03:00
Johan Hedberg
36711fb6aa mgmt-api: Add error code descriptions 2012-02-29 19:16:04 -06:00
Luiz Augusto von Dentz
16ac728063 mgmt-api: Format fixes 2012-02-26 19:03:03 +02:00
Marcel Holtmann
d74391573c mgmt-api: Add flags field to Device Connected event 2012-02-23 20:52:12 +01:00
Marcel Holtmann
241181f5eb mgmt-api: Fix parameter list of user confirmation request 2012-02-22 23:15:15 +01:00
Marcel Holtmann
87276365ab mgmt-api: Add comments for commands that require powered controller 2012-02-22 21:43:04 +01:00
Marcel Holtmann
26cce9fe69 mgmt-api: Mention the empty UUID to clear the UUID list 2012-02-22 21:25:19 +01:00
Marcel Holtmann
40802a41d4 mgmt-api: Update comments for commands valid during power off 2012-02-22 21:03:22 +01:00
Marcel Holtmann
c9edc0153f mgmt-api: Mention that setting name is valid when powered off 2012-02-22 20:51:42 +01:00
Marcel Holtmann
169dde65ce mgmt-api: Small clarification 2012-02-21 14:25:59 +01:00
Marcel Holtmann
8dd0820642 mgmt-api: Update comments for setting handling and errors 2012-02-21 14:09:14 +01:00
Marcel Holtmann
4ebdcf49dc mgmt-api: Add comments for valid commands when power off 2012-02-21 13:26:52 +01:00
Marcel Holtmann
40554f5a9d mgmt-api: Add command for setting Device ID details 2012-02-21 00:05:56 +01:00
Marcel Holtmann
0544ed94db mgmt-api: Add address type to stop discovery command and the event 2012-02-20 21:19:25 +01:00
Marcel Holtmann
664df5e25e mgmt-api: The command status is never a positive response 2012-02-20 21:15:06 +01:00
Marcel Holtmann
2d5cb7d730 mgmt-api: Fix a small typo 2012-02-20 21:10:09 +01:00
Marcel Holtmann
81c81ac4e7 mgmt-api: Fix a few entries for command status vs command complete 2012-02-20 21:07:30 +01:00
Marcel Holtmann
be2f0f4024 mgmt-api: Add comments if command status or command complete is returned 2012-02-17 15:31:48 +01:00
Johan Hedberg
aea82119df mgmt-api: Reorder cmd_status parameters
It makes more sense for the opcode to come before the status (since it
is part of the context).
2012-02-17 16:02:40 +02:00
Johan Hedberg
a52fa7b47b mgmt-api: Fix symmetry of (Un)Block command/reply parameters 2012-02-17 16:02:40 +02:00
Johan Hedberg
c1a9aa4aa2 mgmt-api: Fix symmetry of OOB command/reply parameters 2012-02-17 16:02:40 +02:00
Johan Hedberg
e1a5e4c819 mgmt-api: Clarify unpair_device disconnect parameter 2012-02-17 16:02:40 +02:00
Johan Hedberg
7f8ca9ed96 mgmt-api: Fix PIN Code command & reponse parameters 2012-02-17 16:02:40 +02:00
Johan Hedberg
c3e200de65 mgmt-api: Add status parameter to command complete event
Since this is needed by almost all command responses it makes more sense
to just have it part of the command complete event.
2012-02-17 16:02:40 +02:00
Johan Hedberg
497a40796b mgmt-api: Add address_type to start_discovery response 2012-02-17 16:02:40 +02:00
Johan Hedberg
247e54820a mgmt-api: Remove bogus old_key_type parameter 2012-02-17 16:02:40 +02:00
Johan Hedberg
7461fb98e3 mgmt-api: Add Address_Type to all messages with an Address
Strictly speaking the address type isn't needed in all messages (e.g.
those specific to BR/EDR or pre-2.1) but for consistency it's cleaner to
have it everywhere. The only exception is the read_controller_info reply
where it really doesn't make sense to have it.
2012-02-17 13:42:46 +02:00
Johan Hedberg
d578383ada mgmt-api: Fix typo with wrong capitalization 2012-02-17 13:42:46 +02:00
Johan Hedberg
455a27fa3a mgmt-api: Reorder parameters for read_commands
It makes more sense to have the num_commands and num_events parameters
in the beginning so that the message length can be validated up front.
2012-02-10 12:18:12 +02:00
Marcel Holtmann
a6ef9f74f2 mgmt-api: Add proper management supported commands command 2012-02-09 17:18:12 +01:00
Johan Hedberg
0e7476039b mgmt-api: Remove bogus Key_Type field from LTK messages 2012-02-06 22:54:14 +02:00
Johan Hedberg
69a3f061f2 mgmt-api: Update to latest plans
- "Remove Keys" renamed to "Unpair Device" and moved to a more
  appropriate location (after the other pairing commands)
- "Device Unpaired" event added
- Address_Type parameters added the relevant commands and events
- Address_Type vs Key_Type distinction made clearer
- Bogus '0' removed from opcodes
2012-02-06 12:09:55 +02:00
Johan Hedberg
342301d031 mgmt-api: Move New Long Term Key Event to a more logical place 2012-02-01 14:31:59 -08:00
Johan Hedberg
b57bd8757e mgmt-api: Remove unused/implemented commands 2012-02-01 23:15:26 +02:00
Johan Hedberg
5795b7fe40 mgmt-api: Move Load Long Term Keys Command to a more logical place 2012-02-01 23:14:28 +02:00
Johan Hedberg
5401c7c016 mgmt-api: Add missing cancel pairing command 2012-02-01 23:12:22 +02:00
Szymon Janc
10c628830e mgmt-api: Add information about endianness
Management interface use little-endian byte order and this should be
clearly stated in documentation.
2012-01-19 12:40:48 +02:00
Vinicius Costa Gomes
5d0881295e mgmt-api: Update the commands for exchanging LTK's
For restoring the device from storage we need to have the Address type
of the device, the LTK is a good place for this.

In some cases, we may be notified of keys that were generated in the
Host, that key key would be used when the Host is the slave role in
a later connection, we should be able to differentiate this type of
key because it doesn't mean that we have a bonding with the Remote
Device.
2012-01-18 13:55:49 +02:00
Johan Hedberg
e9109fc7ae mgmt-api: Use 2 octets instead of 1 for EIR data length
This allows for future extensibility.
2012-01-16 11:51:09 +02:00
Johan Hedberg
ea3c625302 mgmt-api: Use EIR encoding wherever possible
We can encode the remotee name and class to the EIR data format both in
device_found and device_connected events.
2012-01-15 23:37:40 +02:00
Johan Hedberg
2eef3ae297 mgmt-api: Update to latest plans
- Remove the remote_name event and add the name to the device_connected
event (since we always refresh the name at that point anyway).

- Add Class of Device to device_connected since that's the only point
where we get it when a previously unknown device connects to us for the
first time.

- Add a Flags field to device_found to accommodate for legacy pairing
information (which we get from the remote host features HCI event) and
merge the only other existing boolean parameter (confirm_name) into this
Flags field.
2012-01-13 13:59:49 +02:00
Johan Hedberg
78da89d0c8 mgmt-api: Update Confirm Name return parameters 2011-12-19 14:14:30 +02:00
Johan Hedberg
e7f5c5175b mgmt: Move Set Local Name to it's logical position in the API 2011-12-14 23:03:35 +02:00
Johan Hedberg
538346af2d mgmt-api: Update to match latest plans 2011-12-14 14:21:21 +02:00
Johan Hedberg
6910bb809b mgmt-api: Add missing changes to the mgmt messages
Some changes were missing from the previous patch. This moves the fast
connectable command to the right place, adds a Class_Of_Device parameter
to Set UUID Caching (renamed from Set Service Cache) and adds a Class Of
Device Changed event.
2011-12-09 13:11:58 +02:00
Johan Hedberg
0d552f113e mgmt-api: Update to current plans
This patch updates the mgmt API to match the current plans. This is
hopefully the last major change and because of that the command and
event codes are also reshuffled to match some kind of a logical
ordering.
2011-12-08 16:10:10 +02:00
Johan Hedberg
0573fc7cb1 mgmt: Add address type to mgmt_pair_device
This is important especially in the future when dual-mode devices can be
connected to over LE. It's also important if/when we decide to move the
advertisement cache into user-space.
2011-11-11 00:04:10 +02:00
Johan Hedberg
74b43ba833 mgmt: Add status parameter to disconnect response 2011-11-10 14:17:24 +02:00
Johan Hedberg
60bb8e3586 mgmt: Add bdaddr and status to remove_keys response 2011-11-10 14:04:40 +02:00
Johan Hedberg
f062b128db mgmt: Add LE public/random info to address types 2011-11-09 13:52:05 +02:00
Johan Hedberg
4cb40f8111 mgmt-api: Update get_connections and connect_failed with address type info 2011-11-07 13:22:04 +02:00
Johan Hedberg
9aeb6205fe mgmt-api: Only 4 bytes are needed for the controller settings 2011-11-07 13:45:31 +02:00
Johan Hedberg
2f9b083e9e mgmt-api: Fix typos and consistency issues 2011-11-04 10:14:23 +02:00
Johan Hedberg
7bcf9638e8 Make whitespace usage consistent in mgmt-api.txt 2011-10-24 22:48:14 +02:00
Johan Hedberg
ba69cd1fc8 mgmt: Rename Name Info command to match corresponding flag 2011-10-24 22:44:50 +02:00
Johan Hedberg
dfd9c98a9f mgmt: Allow specifying discovery type for Start Discovery 2011-10-24 18:09:01 +02:00
Vinicius Costa Gomes
82b17d0d00 Add new command and event for LTK storage support
This documents the new command and event that are to be added to
the Management API to add support for persistent pairing of LE
devices.
2011-10-24 16:01:55 +02:00
Johan Hedberg
8459696920 Add device type to found and connected mgmt events 2011-10-24 14:25:58 +02:00
Johan Hedberg
0eeebf4747 Add User Passkey commands and events to mgmt 2011-10-24 14:25:34 +02:00
Johan Hedberg
a6c19f4ead Rename mgmt key commands and events 2011-10-24 14:24:53 +02:00
Johan Hedberg
672fbbe419 Add timeout to Set Discoverable mgmt command 2011-10-24 14:14:53 +02:00
Johan Hedberg
890eb14f94 Update controller info command with current plan 2011-10-24 14:14:16 +02:00
Johan Hedberg
10cbe2aef3 Fix whitespace for fast connectable mgmt command doc 2011-10-24 12:56:55 +02:00
Johan Hedberg
ed4de024ef Add (legacy) name resolution handling to mgmt API 2011-10-24 12:29:41 +02:00
Antti Julku
1dcd74358c Implement fast connectable mode for mgmt interface
Management interface implementation for fast connectable mode.
2011-09-26 15:39:36 +03:00
Antti Julku
a09d1717e4 Add device blocking events to mgmt API documentation 2011-09-24 19:09:29 +09:00
Claudio Takahasi
82d4778b26 Fix typo in mgmt-api 2011-07-26 13:01:46 +03:00
Antti Julku
6c558d3620 Add blacklisting support for management interface
Management interface commands for blocking and unblocking devices.
2011-06-16 21:51:44 +03:00
Waldemar Rymarkiewicz
c33d02148b Update params description of PIN Code Request 2011-05-15 02:12:40 +03:00
Waldemar Rymarkiewicz
e6c56d4e71 Add secure param to mgmt_ev_pin_code_request
Update mgmt interface with secure param in PIN code request event which
is part of secure PIN requirement implementation.
2011-04-28 23:00:20 +03:00
Johan Hedberg
6f7add5435 mgmt: Add support for discovering event 2011-03-31 14:36:43 +03:00
Johan Hedberg
421efd407e mgmt: Add support for start_discovery & stop_discovery 2011-03-31 14:26:20 +03:00
Johan Hedberg
c602de90fb Add device_found and remote_name events to mgmt-api.txt 2011-03-30 13:21:25 +03:00