2020-09-25 01:14:56

by Daniel Winkler

[permalink] [raw]
Subject: [Bluez PATCH v3 1/9] doc/advertising-api: update API with new interface

This updates the advertising documentation to include the following
features:

LE Advertising Manager:
- New SupportedCapabilities property

LE Advertisement:
- New min/max interval properties
- New tx power property

Reviewed-by: Sonny Sasaka <[email protected]>
Reviewed-by: Alain Michaud <[email protected]>
---

Changes in v3: None
Changes in v2: None

doc/advertising-api.txt | 50 +++++++++++++++++++++++++++++++++++++++++
1 file changed, 50 insertions(+)

diff --git a/doc/advertising-api.txt b/doc/advertising-api.txt
index b0565eab2..3215a52f7 100644
--- a/doc/advertising-api.txt
+++ b/doc/advertising-api.txt
@@ -138,6 +138,33 @@ Properties string Type
"2M"
"Coded"

+ uint32 MinInterval
+
+ Minimum advertising interval to be used by the
+ advertising set, in .625 millisecond slots.
+ Time = N * .625 ms, where N has range
+ [0x000020, 0xFFFFFF]. If the provided MinInterval is
+ larger than the provided MaxInterval, the registration
+ will return failure.
+
+ uint32 MaxInterval
+
+ Maximum advertising interval to be used by the
+ advertising set, in .625 millisecond slots.
+ Time = N * .625 ms, where N has range
+ [0x000020, 0xFFFFFF]. If the provided MinInterval is
+ larger than the provided MaxInterval, the registration
+ will return failure.
+
+ int16 TxPower
+
+ Requested transmission power of this advertising set.
+ The provided value is used only if the "CanSetTxPower"
+ feature is enabled on the Advertising Manager. The
+ provided value must be in range [-127 to +20], where
+ units are in dBm.
+
+
LE Advertising Manager hierarchy
================================

@@ -209,3 +236,26 @@ Properties byte ActiveInstances
Possible values: "1M"
"2M"
"Coded"
+
+ dict SupportedCapabilities
+
+ Enumerates Advertising-related controller capabilities
+ useful to the client.
+
+ Possible Values:
+
+ byte MaxAdvLen
+
+ Max advertising data length
+
+ byte MaxScnRspLen
+
+ Max advertising scan response length
+
+ int16 MinTxPower
+
+ Min advertising tx power (dBm)
+
+ int16 MaxTxPower
+
+ Max advertising tx power (dBm)
--
2.28.0.709.gb0816b6eb0-goog