nRF5 SDK v15.3.0
Radio Test Example

The Radio Test Example demonstrates how to configure the radio as the constant RX or TX carrier, the modulated TX carrier, or the RX or TX sweep.

The tests are controlled with Command Line Interface (CLI) by the serial port. At any time during the tests, you can set the radio parameters output power, bit rate, and channel. You can also set the time on each channel in the sweep mode, in steps of 1 millisecond to 99 milliseconds, every 1 millisecond. The application also allows you to send a data pattern to another board.

The application starts with enabling the high frequency crystal oscillator and configuring CLI. Calling a console command causes the appropriate action.

For the IEEE 802.15.4 mode, the start channel and the end channel must be within the channel range of 11 to 26.

CLI commands

The following table lists the available main CLI commands, in alphabetical order.

Command Argument Description
cancel Cancel the sweep or the carrier.
data_rate <sub_cmd> Set the data rate.
end_channel <channel> End the channel for the sweep.
output_power <sub_cmd> Output power set.
parameters_print Print current delay, channel, and other parameters.
print_rx Print the received RX payload.
start_channel <channel> Start the channel for the sweep or the channel for the constant carrier.
start_duty_cycle_modulated_tx <duty_cycle> Duty cycle in percent (two decimal digits, between 01 and 99).
start_rx Start RX.
start_rx_sweep Start the RX sweep.
start_tx_carrier Start the TX carrier.
start_tx_modulated_carrier Start the modulated TX carrier.
start_tx_sweep Start the TX sweep.
time_on_channel <time> Time on each channel (between 1 ms and 99 ms).
toggle_dcdc_state <state> Toggle DC/DC converter state.
transmit_pattern <sub_cmd> Set transmission pattern.

You can find the source code and the project file of the example in the following folder: <InstallFolder>\examples\peripheral\radio_test


You can test this application with one of the following methods:

When using a second board, both boards must have the same radio mode, channel, and transmission pattern to receive data. Receiving data is not possible in a random transmission pattern.

Test the Radio Test Example application by performing the following steps:

  1. Compile and program the application.
  2. Start a terminal emulator like PuTTY (recommended) with the related Terminal settings and UART and USB settings. The text "Radio test example started." appears at the top of the terminal.
  3. Open a serial connection to the COM port used by the tester board. A command prompt is displayed.
  4. Type any of the CLI commands described above. An output text is displayed in the terminal emulator window, and the sweep or the signal is started.
  5. Depending on the testing method:
    • Use a spectrum analyzer to confirm the behavior of the radio module.
    • Use a second board configured in the same mode as the first one to receive the transmission, and type print_rx to print the RX data received from the other board.

If you use the spectrum analyzer, the testing is successful when the spectrum is displayed correctly.

If you use two boards, the testing is successful when the data is displayed correctly.

If the spectrum or the data does not display correctly, verify the configuration.

Documentation feedback | Developer Zone | Subscribe | Updated