Cellular 5G test

You can run the Cellular 5G test to certify that a 5G modem successfully establishes and maintains a data connection. You can also optionally evaluate network throughput.

What the test covers
The Cellular 5G test validates Global System for Mobile Communications (GSM) device detection and connection activation through NetworkManager. It also validates network connectivity. You can optionally run the iperf3-based performance test after you configure a test server.
RHEL version supported
  • RHEL 9
  • RHEL 10
What the test does

The test performs the following actions:

  • Planning phase - The test detects all GSM devices through the nmcli device (type gsm) and creates a separate test instance for each detected modem. This enables independent testing of multiple cellular modems on the same system.
  • Detect GSM device - The test re-enables Universal Serial Bus (USB) devices and waits up to 100 seconds for the ModemManager service to initialize and for the GSM modem to become available.
  • Enable GSM connection - The test creates and activates a GSM connection profile, Access Point Name (APN) internet, by using the nmcli utility on the wwp or wwan interface.
  • Test GSM connection - The test verifies cellular data connectivity by pinging an external host over the cellular interface.
  • Cellular performance test (optional) - If a test server is configured, the test runs an iperf3 throughput test for 30 seconds, reporting every 10 seconds, over the cellular connection. The test compares the bandwidth against 80% of the target speed for the 2 Gbps interface.
Key differences from Cellular 4G
Attribute Cellular 4G Cellular 5G

Supported generation

Long-Term Evolution (LTE)

5G New Radio (NR)

Interface speed target

1 Gbps

2 Gbps

Preparing for the test

Ensure that the following requirements are met to prepare for the test:

  • The system has a 5G NR-capable cellular modem.
  • An active Subscriber Identity Module (SIM) card with a data plan is installed.
  • The NetworkManager-wwan RPM package is installed.
  • The ModemManager and NetworkManager services are enabled.
  • Optional: A test server is configured for iperf3-based performance testing.
Running the test
Run the test by using the rhcert-cli tool. To enable the performance subtest, configure a test server. The iperf3 server is started and stopped automatically on the remote host.