QLowEnergyConnectionParameters Class

The QLowEnergyConnectionParameters class is used when requesting or reporting an update of the parameters of a Bluetooth LE connection. More...

Header: #include <QLowEnergyConnectionParameters>
qmake: QT += bluetooth
Since: Qt 5.7

This class was introduced in Qt 5.7.

Detailed Description

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:

minimumInterval()Android priority
interval < 30CONNECTION_PRIORITY_HIGH
30 <= interval <= 100CONNECTION_PRIORITY_BALANCED
interval > 100CONNECTION_PRIORITY_LOW_POWER

The supervisionTimeout() cannot be changed on Android and is therefore ignored.

See also QLowEnergyController::requestConnectionUpdate and QLowEnergyController::connectionUpdated.