Skip to content

Commit 9801130

Browse files
committed
doc: known_issues: add HID configurator issue related to BlueZ
Added a new known issue related to the HID configurator script. The HID configurator may return I/O error in the Linux environment during a long exchange of HID feature reports. The issue is caused by the BlueZ stack and its overflow bug for the packet identifiers. Ref: NCSDK-35817 Signed-off-by: Kamil Piszczek <Kamil.Piszczek@nordicsemi.no>
1 parent 0acb547 commit 9801130

File tree

2 files changed

+21
-0
lines changed

2 files changed

+21
-0
lines changed

doc/nrf/links.txt

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1635,6 +1635,10 @@
16351635
.. _`Linux - Ubuntu 22.04 LTS`: https://releases.ubuntu.com/22.04/
16361636
.. _`Linux - Ubuntu 20.04 LTS`: https://releases.ubuntu.com/20.04/
16371637

1638+
.. ### Source: bugs.launchpad.net
1639+
1640+
.. _`Ubuntu bug report`: https://bugs.launchpad.net/ubuntu/+source/bluez/+bug/2130724
1641+
16381642
.. ### Source: apple.com
16391643

16401644
.. _`macOS 26`: https://www.apple.com/os/macos/

doc/nrf/releases_and_maturity/known_issues.rst

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2386,6 +2386,23 @@ NCSDK-25928: :ref:`nrf_desktop_hid_state` keeps sending empty HID reports to low
23862386

23872387
.. rst-class:: wontfix v3-1-1 v3-1-0 v3-0-2 v3-0-1 v3-0-0 v2-9-0-nRF54H20-1 v2-9-2 v2-9-1 v2-9-0 v2-8-0 v2-7-0 v2-6-4 v2-6-3 v2-6-2 v2-6-1 v2-6-0 v2-5-3 v2-5-2 v2-5-1 v2-5-0 v2-4-4 v2-4-3 v2-4-2 v2-4-1 v2-4-0 v2-3-0 v2-2-0 v2-1-4 v2-1-3 v2-1-2 v2-1-1 v2-1-0 v2-0-2 v2-0-1 v2-0-0 v1-9-2 v1-9-1 v1-9-0 v1-8-0 v1-7-1 v1-7-0 v1-6-1 v1-6-0 v1-5-2 v1-5-1 v1-5-0 v1-4-2 v1-4-1 v1-4-0 v1-3-2 v1-3-1 v1-3-0 v1-2-1 v1-2-0 v1-1-0 v1-0-0
23882388

2389+
2390+
NCSDK-35817: The HID configurator returns an Input/Output error (EIO) in the Linux environment during a long exchange of HID feature reports
2391+
The BlueZ stack passes an incorrect report exchange identifier to the Linux Userspace HID driver (UHID), which causes an EIO.
2392+
The issue is caused by the 16-bit unsigned integer overflow and appears after devices exchange more than 65535 HID feature reports.
2393+
The 16-bit variable overflow can be observed in BlueZ versions 5.73 or lower.
2394+
2395+
The overflow for BlueZ versions from 5.74 to 5.84 happens even earlier.
2396+
It appears after devices exchange more than 255 HID feature reports (8-bit unsigned integer overflow).
2397+
2398+
For more details, see the `Ubuntu bug report`_.
2399+
2400+
**Workaround:** Build the BlueZ stack from sources using the ``master`` branch to replace your default BlueZ package.
2401+
Alternatively, use the ``sudo systemctl restart bluetooth`` command to restart the counter used to identify HID feature report exchanges.
2402+
After using the command, an interrupted configuration channel DFU operation can be resumed.
2403+
2404+
.. rst-class:: wontfix v3-1-1 v3-1-0 v3-0-2 v3-0-1 v3-0-0 v2-9-0-nRF54H20-1 v2-9-2 v2-9-1 v2-9-0 v2-8-0 v2-7-0 v2-6-4 v2-6-3 v2-6-2 v2-6-1 v2-6-0 v2-5-3 v2-5-2 v2-5-1 v2-5-0 v2-4-4 v2-4-3 v2-4-2 v2-4-1 v2-4-0 v2-3-0 v2-2-0 v2-1-4 v2-1-3 v2-1-2 v2-1-1 v2-1-0 v2-0-2 v2-0-1 v2-0-0 v1-9-2 v1-9-1 v1-9-0 v1-8-0 v1-7-1 v1-7-0 v1-6-1 v1-6-0 v1-5-2 v1-5-1 v1-5-0 v1-4-2 v1-4-1 v1-4-0 v1-3-2 v1-3-1 v1-3-0 v1-2-1 v1-2-0 v1-1-0 v1-0-0
2405+
23892406
NCSDK-8304: HID configurator issues for peripherals connected over Bluetooth LE to Linux host
23902407
Using :ref:`nrf_desktop_config_channel_script` for peripherals connected to host directly over Bluetooth LE might result in receiving improper HID feature report ID.
23912408
In such case, the device will provide HID input reports, but it cannot be configured with the HID configurator.

0 commit comments

Comments
 (0)