From ba8a3e83e4a5655efdfd6e6cc8119f2bea4c9aa3 Mon Sep 17 00:00:00 2001 From: Marcel Holtmann Date: Tue, 28 Jan 2014 18:30:53 -0800 Subject: [PATCH] doc: Add the mgmt interface versions and how the map to kernel releases --- doc/mgmt-api.txt | 25 +++++++++++++++++++++---- 1 file changed, 21 insertions(+), 4 deletions(-) diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt index dd71b787b..44ff12676 100644 --- a/doc/mgmt-api.txt +++ b/doc/mgmt-api.txt @@ -4,12 +4,29 @@ Bluetooth Management API Copyright (C) 2008-2009 Marcel Holtmann +Overview +======== + This document describes the format of data used for communicating with the kernel using a so-called Bluetooth Management sockets. These sockets -are available starting with Linux kernel version 3.4, and can be created -by setting the hci_channel member of struct sockaddr_hci to -HCI_CHANNEL_CONTROL (3) when creating a raw HCI socket. In C the needed -code would look something like the following: +are available starting with Linux kernel version 3.4 + +The following kernel versions introduced new commands to the Bluetooth +Management API: + +Linux kernel v3.4 Version 1.0 +Linux kernel v3.5 Version 1.1 +Linux kernel v3.7 Version 1.2 +Linux kernel v3.9 Version 1.3 +Linux kernel v3.13 Version 1.4 + + +Example +======= + +The Bluetooth management sockets can be created by setting the hci_channel +member of struct sockaddr_hci to HCI_CHANNEL_CONTROL (3) when creating a +raw HCI socket. In C the needed code would look something like the following: int mgmt_create(void) {