linux-bluetooth.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Chevallier Maxime <maxime.chevallier@openwide.fr>
To: linux-bluetooth@vger.kernel.org, marcel@holtmann.org
Subject: [RFC][PATCH 1/1 v2] mgmt : Add Set Advertising Parameters command
Date: Wed, 17 Feb 2016 10:18:26 +0100	[thread overview]
Message-ID: <20160217091826.GA12061@vps217108.ovh.net> (raw)

---
 doc/mgmt-api.txt | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)

diff --git a/doc/mgmt-api.txt b/doc/mgmt-api.txt
index 731a088..d46b28c 100644
--- a/doc/mgmt-api.txt
+++ b/doc/mgmt-api.txt
@@ -2801,6 +2801,57 @@ Start Limited Discovery Command
 				Invalid Index
 
 
+Set Advertising Parameters Command
+==================================
+
+	Command Code:		0x0042
+	Controller Index:	<controller id>
+	Command Parameters:	Adv_Interval_Min (2 Octets)
+					Adv_Interval_Max (2 Octets)
+	Return Parameters:
+
+	This command is used to set Advertising Parameters.
+
+	This command sets global advertising parameters that will be
+	applied on advertisings started both with the Set Advertising
+	and the Add Advertising commands.
+
+	The Adv_Interval_Min parameter and Adv_Interval_Max are
+	lower and upper bounds for the controller to issue advertising
+	packets. The exact momet the packet is actually issued is up to
+	the controller.
+
+	The Adv_Interval_Min and Adv_Interval_Max are expressed in units
+	so that : Time ( milliseconds ) = N x 0.625.
+
+	Their default value is 0x0080 (1.28s).
+
+	Both Adv_Interval_Min and Adv_Interval_Max must be within the
+	range [ 0x0020 0x4000 ] (20 ms to 10.24 s).
+
+	Adv_Interval_Min must be less or equal than Adv_Interval_Max.
+
+	If advertisement is not connectable, that is if Set Advertising
+	is set with Advertising 0x01 and we are set as not connectable,
+	then Adv_Interval_Min and Adv_Interval_Max parameters must not
+	be less than 0x00A0 (100 ms). If this is the case, these
+	parameters are restored to their default value until we are
+	connectable again.
+
+	A pre-requisite is that LE is already enabled, otherwise this
+	command will return a "rejected" response.
+
+	This command can be used when the controller is not powered and
+	all settings will be programmed once powered.
+
+	This command generates a Command Complete event on success or a
+	Command Status event on failure.
+
+	Possible errors:	Rejected
+				Invalid Parameters
+				Invalid Index
+
+
 Command Complete Event
 ======================
 
-- 
2.1.4

                 reply	other threads:[~2016-02-17  9:18 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

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=20160217091826.GA12061@vps217108.ovh.net \
    --to=maxime.chevallier@openwide.fr \
    --cc=linux-bluetooth@vger.kernel.org \
    --cc=marcel@holtmann.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).