From: johan.hedberg@gmail.com
To: linux-bluetooth@vger.kernel.org
Cc: Johan Hedberg <johan.hedberg@nokia.com>
Subject: [PATCH 1/3] Add initial Bluetooth Management API doc
Date: Mon, 20 Sep 2010 14:07:44 +0300 [thread overview]
Message-ID: <1284980866-3974-2-git-send-email-johan.hedberg@gmail.com> (raw)
In-Reply-To: <1284980866-3974-1-git-send-email-johan.hedberg@gmail.com>
From: Johan Hedberg <johan.hedberg@nokia.com>
---
doc/mgmt-api.txt | 178 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 files changed, 178 insertions(+), 0 deletions(-)
create mode 100644 doc/mgmt-api.txt
diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
new file mode 100644
index 0000000..9281103
--- /dev/null
+++ b/doc/mgmt-api.txt
@@ -0,0 +1,178 @@
+Bluetooth Management API
+*************************
+
+Copyright (C) 2008-2009 Marcel Holtmann <marcel@holtmann.org>
+
+
+Packet Structures
+=================
+
+ Commands:
+
+ 0 4 8 12 16 202 24 28 31
+ +-------------------------------+-----------------------------+
+ | Command Code | Parameter Total Length |
+ +-------------------------------+-----------------------------+
+ | |
+
+ Events:
+
+ 0 4 8 12 16 202 24 28 31
+ +-------------------------------+-----------------------------+
+ | Event Code | Parameter Total Length |
+ +-------------------------------+-----------------------------+
+ | |
+
+
+Read Management Version Information Command
+===========================================
+
+ Command Code: 0x0001
+ Command Parameters:
+ Return Parameters: Status (1 Octet)
+ Version (1 Octets
+ Revision (2 Octets)
+
+Read Management Supported Features Command
+==========================================
+
+ Command Code: 0x0002
+ Command Parameters:
+ Return Parameters: Status (1 Octet)
+ Features (8 Octets)
+
+ Feature Bit 0: Controller Support
+ Feature Bit 1: Tracing Support
+
+Read Controller Index List Command
+==================================
+
+ Command Code: 0x0003
+ Command Parameters:
+ Return Paramters: Status (1 Octet)
+ Num_Controllers (2 Octets)
+ Controller_Index[i] (2 Octets)
+
+Read Controller Information Command
+===================================
+
+ Command Code: 0x0004
+ Command Parameters: Controller_Index (2 Octets)
+ Return Parameters: Status (1 Octet)
+ Controller_Index (2 Octets)
+ Controller_Type (1 Octet)
+ BD_ADDR (6 Octets)
+ Supported_Features (8 Octets)
+
+ Controller_Type:0x00 Reserved
+ 0x01 Bluetooth (BR/EDR)
+ 0x02 802.11 (AMP)
+
+Read Controller Statistics Command
+==================================
+
+ Command Code: 0x0005
+ Command Parameters: Controller_Index (2 Octets)
+ Return Paramters: Status (1 Octet)
+ Controller_Index (2 Octets)
+ ....
+
+Read Controller Mode Command
+============================
+
+ Command Code: 0x0006
+ Command Parameters: Controller_Index (2 Octets)
+ Return Paramters: Status (1 Octect)
+ Controller_Index (2 Octets)
+ Enabled (1 Octet)
+ Mode (1 Octet)
+
+ Enabled: 0x00 Powered off
+ 0x01 Controller Enabled
+
+ Mode: 0x00 Reserved
+ 0x01 Connectable (pairing forbidden)
+ 0x02 Connectable (pairing allowed)
+ 0x03 Discoverable (pairing forbidden)
+ 0x04 Discoverable (pairing allowed)
+
+Write Controller Mode Command
+=============================
+
+ Command Code: 0x0007
+ Command Parameters: Controller_Index (2 Octets)
+ ...
+ Return Parameters: Status (1 Octet)
+ Controller_Index (2 Octets)
+
+
+Read Tracing Buffer Size Command
+================================
+
+ Command Code: 0x0004
+ Command Parameters:
+ Return Parameters: Status (1 Octet)
+ Buffer_Size (2 Octets)
+
+ Buffer Size in Kilobytes
+
+Write Tracing Buffer Size Command
+=================================
+
+ Command Code: 0x0005
+ Command Parameters: Buffer_Size (2 Octets)
+ Return Parameters: Status (1 Octet)
+
+ Buffer Size in Kilobytes
+
+Read Controller Tracing Filter Command
+=======================================
+
+ Command Code: 0x0011
+ Command Parameters: Controller_Index (2 Octects)
+ Return Parameters: Status (1 Octet)
+ Controller_Index (2 Octets)
+ Tracing_Enable (1 Octect)
+ Num_Filters (2 Octect)
+ Protocol_UUID[i] (16 Octets)
+ Protocol_Identifier[i] (16 Octets)
+
+ Tracing_Enable: 0x00 Tracing disabled
+ 0x01 Command and Event tracing
+ 0x02 Command, Event and ACL tracing
+ 0x03 Command, Event, ACL and SCO tracing
+
+Write Controller Tracing Filter Command
+=======================================
+
+ Command Code: 0x0012 (Group 0x0)
+ Command Parameters: Controller_Index (2 Octects)
+ Tracing_Enable (1 Octect)
+ Num_Filters (2 Octect)
+ Protocol_UUID[i] (16 Octets)
+ Protocol_Identifier[i] (16 Octets)
+ Return Paramters: Status (1 Octet)
+ Controller_Index (2 Octets)
+
+
+
+Command Complete Event
+======================
+
+Event Code 0x0001
+Event Parameters Command_Opcode
+ Return_Parameters
+
+
+Command Status Event
+====================
+
+Event Code 0x0002
+Event Parameters Status
+ Command_Opcode
+
+Controller Error Event
+======================
+
+Event Code 0x0003
+Event Parameters Error_Code
--
1.7.0.4
next prev parent reply other threads:[~2010-09-20 11:07 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-09-20 11:07 [RFC] Bluetooth Management Interface johan.hedberg
2010-09-20 11:07 ` johan.hedberg [this message]
2010-09-20 11:07 ` [PATCH 2/3] Add initial definitions for Bluetooth Management API johan.hedberg
2010-09-20 11:07 ` [PATCH 3/3] Add hcimgmt command line test tool johan.hedberg
2010-09-20 13:13 ` Anderson Lizardo
2010-09-20 13:28 ` Johan Hedberg
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1284980866-3974-2-git-send-email-johan.hedberg@gmail.com \
--to=johan.hedberg@gmail.com \
--cc=johan.hedberg@nokia.com \
--cc=linux-bluetooth@vger.kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).