class QLowEnergyConnectionParameters#

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

Synopsis#

Methods#

def __init__()
def latency()
def maximumInterval()
def minimumInterval()
def __ne__()
def __eq__()
def setIntervalRange()
def setLatency()
def setSupervisionTimeout()
def supervisionTimeout()
def swap()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

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

CONNECTION_PRIORITY_HIGH

30 <= interval <= 100

CONNECTION_PRIORITY_BALANCED

interval > 100

CONNECTION_PRIORITY_LOW_POWER

`minimumInterval()`	Android priority
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.

See also

requestConnectionUpdate connectionUpdated

__init__()#

Constructs a new object of this class. All values are initialized to valid defaults.

__init__(other)

Parameters:: other – QLowEnergyConnectionParameters

Constructs a new object of this class that is a copy of other.

latency()#

Return type:: int

Returns the slave latency of the connection.

See also

setLatency()

maximumInterval()#

Return type:: float

Returns the maximum connection interval in milliseconds. The default is 4000.

Note

If this object was emitted via connectionUpdated() , then this value is the same as minimumInterval() and refers to the actual connection interval.