2016-02-17 09:18:26

by Chevallier Maxime

[permalink] [raw]
Subject: [RFC][PATCH 1/1 v2] mgmt : Add Set Advertising Parameters command

---
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