Skip to content

Commit 0e5dd39

Browse files
Filip Jagodzinskic1728p9
authored andcommitted
Tests: USB: Add a README for Linux users
Explain how to overcome xHCI limitations in kernels prior to v4.17 and successfully run USB tests.
1 parent a216796 commit 0e5dd39

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

TESTS/usb_device/basic/README.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# Testing the USB device data toggle reset with a Linux host
2+
3+
When you run the `tests-usb_device-basic` test suite on a Linux machine, please make
4+
sure that at least one of the following prerequisites are met:
5+
* using the Linux kernel ***4.17* or newer**,
6+
* using the ***eHCI*** USB driver instead of *xHCI*.
7+
8+
Implementations of the *xHCI* driver prior to version 4.17 of the Linux kernel did
9+
not have the functionality necessary to test `"endpoint test data toggle reset"`.
10+
Even though the data toggle is correctly reset on the device side, the host side will
11+
not be synchronized and the test will falsely fail.
12+
13+
Further reading:
14+
1. [the Linux kernel patch adding missing xHCI behavior](https://github.com/torvalds/linux/commit/f5249461b504d35aa1a40140983b7ec415807d9e),
15+
1. [LKML discussion explaining the details of this issue](https://lkml.org/lkml/2016/12/15/388).

0 commit comments

Comments
 (0)