Quality of Service module
The Quality of Service (QoS) module provides the QoS information through the Bluetooth® GATT service.
The module can be used only by nRF Desktop peripheral with the SoftDevice Link Layer (CONFIG_BT_LL_SOFTDEVICE
).
The module is made available in case the peripheral is meant to be paired with a third-party dongle. In such case, the vendor can use the Quality of Service data provided by the nRF Desktop peripheral to improve the link quality.
Note
There is no need to enable the Quality of Service module if you want to pair the peripheral device with the nRF Desktop dongle. The dongle does not depend on the service provided by the Quality of Service module on peripheral devices.
For more information about the format of the Quality of Service data, see the Bluetooth LE Quality of Service module documentation.
Module events
Source Module |
Input Event |
This Module |
Output Event |
Sink Module |
---|---|---|---|---|
|
|
|||
|
||||
|
Note
See the Overview: Firmware architecture for more information about the event-based communication in the nRF Desktop application and about how to read this table.
Configuration
The module requires the basic Bluetooth® configuration, as described in Bluetooth in nRF Desktop.
The module is enabled with CONFIG_DESKTOP_QOS_ENABLE
option.
The module is available on the peripheral devices only and requires the Bluetooth LE Quality of Service module to be enabled.
Implementation details
The module uses BT_GATT_SERVICE_DEFINE
to define a custom GATT Service.
The UUID of the service is located in the module source file, qos.c
.
For more information about GATT, see Zephyr’s Generic Attribute Profile (GATT) documentation.
The module uses the Quality of Service data read from the SoftDevice Link Layer.
This data is delivered in the form of a ble_qos_event
event by the Bluetooth LE Quality of Service module.
This is the same data that is used by the nRF Desktop dongle to avoid congested RF channels.