USB4

The USB4 test verifies basic USB4 port functionality. You can run this test to verify enumeration, access, and hot-plugging at 20Gbps and 40Gbps speeds.

What the test covers

The USB4 test covers USB4 ports from a basic functionality standpoint. It ensures that all ports can be enumerated, accessed, and hot plugged by the OS. The USB4 test supports two speed-based tests: 20Gbps and 40Gbps.

Both tests are planned if the system supports USB4. Successful credit for each test adds the corresponding feature to the Red Hat Ecosystem Catalog listing. The tests and their success criteria are as follows:

Success criteria
  • USB4_20Gbps - The test passes when the device transfer speed is 20Gbps.
  • USB4_40Gbps - The test passes when the device transfer speed is 40Gbps.
RHEL version supported
  • RHEL 8
  • RHEL 9
  • RHEL 10
What the test does

This test ensures that all USB4 ports function as expected. It asks for the number of available USB4 ports, minus any in use for a keyboard or mouse. It then asks the tester to plug and unplug a USB4 device into each port.

The test watches for attach and detach events and records them. The test passes if it detects both plug and unplug events for each unique port entered.

Preparing for the test
Count the available USB4 ports and have an available USB4 device to use during the testing. You may need to trace the USB ports from the motherboard header(s) to distinguish between USB2, USB3, and USB4 ports. Ensure that the line speed of the device matches the expected speed of the test, that is, 20Gbps or 40Gbps.
Running the test

The USB4 test is interactive. Run the following command, then select the USB4 test name from the list that displays.

 rhcert-run

When prompted, enter the number of available USB4 ports on the system. Don’t count ports currently used by a keyboard or mouse. The system asks you to plug the test USB4 device into a port.

The system pauses until you press y to continue, then asks you to unplug the device. Press y again to continue. Repeat these steps for each port you entered.

You can test ports in any order, but test each port only once.

Run time
The USB4 test takes about 15 seconds per USB4 port. This includes the time to manually plug in the device, scan the port, unplug the device, and scan the port again. The required supportable test adds about a minute to the overall run time.