The QLowEnergyConnectionParameters class is used when requesting or reporting an update of the parameters of a Bluetooth LE connection. More...
|qmake:||QT += bluetooth|
|QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other)|
|QLowEnergyConnectionParameters &||operator=(const QLowEnergyConnectionParameters &other)|
|void||setIntervalRange(double minimum, double maximum)|
|bool||operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)|
|bool||operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)|
The connection parameters influence how often a master and a slave device synchronize with each other. In general, a lower connection interval and latency means faster communication, but also higher power consumption. How these criteria should be weighed against each other is highly dependent on the concrete use case.
Android only indirectly permits the adjustment of this parameter set. The platform separates the connection parameters into three categories (hight, low & balanced priority). Each category implies a predefined set of values for minimumInterval(), maximumInterval() and latency(). Additionally, the value ranges of each category can vary from one Android device to the next. Qt uses the minimumInterval() to determine the target category as follows:
|interval < 30||CONNECTION_PRIORITY_HIGH|
|30 <= interval <= 100||CONNECTION_PRIORITY_BALANCED|
|interval > 100||CONNECTION_PRIORITY_LOW_POWER|
The supervisionTimeout() cannot be changed on Android and is therefore ignored.
Member Function Documentation
QLowEnergyConnectionParameters::QLowEnergyConnectionParameters(const QLowEnergyConnectionParameters &other)
Constructs a new object of this class that is a copy of other.
Constructs a new object of this class. All values are initialized to valid defaults.
QLowEnergyConnectionParameters &QLowEnergyConnectionParameters::operator=(const QLowEnergyConnectionParameters &other)
Makes this object a copy of other and returns the new value of this object.
Destroys this object.
Returns the slave latency of the connection.
See also setLatency().
Returns the maximum connection interval in milliseconds. The default is 4000.
See also setIntervalRange().
Returns the minimum connection interval in milliseconds. The default is 7.5.
See also setIntervalRange().
Sets the range in which the connection interval should be. The actual value will be decided by the controller. Both minimum and maximum are given in milliseconds. If maximum is smaller than minimum, it will be set to the value of minimum. The smallest possible connection interval is 7.5 milliseconds, the largest one is 4000 milliseconds.
Sets the slave latency of the connection (that is, the number of connection events that a slave device is allowed to ignore) to latency. The minimum value is 0, the maximum is 499.
See also latency().
Sets the link supervision timeout to timeout milliseconds. There are several constraints on this value: It must be in the range [100,32000] and it must be larger than (1 + latency()) * 2 * maximumInterval().
On Android, this timeout is not adjustable and therefore ignored.
See also supervisionTimeout().
Returns the link supervision timeout of the connection in milliseconds.
See also setSupervisionTimeout().
void QLowEnergyConnectionParameters::swap(QLowEnergyConnectionParameters &other)
Swaps this object with other.
bool operator!=(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
true if p1 and p2 are not equal with respect to their public state, otherwise returns
bool operator==(const QLowEnergyConnectionParameters &p1, const QLowEnergyConnectionParameters &p2)
true if p1 and p2 are equal with respect to their public state, otherwise returns
© 2023 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.