Rail Test Introduction
§ Reference: UG409: RAILtest User’s Guide
The RAILtest application (RAILtest) provides you with a simple tool for testing the radio and the functionality of the RAIL library.
1. Functionality of the Rail Test Introduction
• Transmit and receive packets
• Schedule transmits at a specific time in the RAIL timebase
• Configure RAIL address filtering to receive only specific packets
• Enable CCA mechanisms (CSMA/LBT) to validate that a channel is clear before transmit
• Set a timer callback in the RAIL timebase to see how the RAIL timer API works
• Change the transmit channel within the current configuration’s band
• Change the transmit power level
• Enable RF energy sensing of a specified duration across the 2.4 GHz and/or Sub 1-GHz bands, and sleep to wake on this event.
• Output a continuous unmodulated tone for debugging
• Output a continuous modulated PN9 stream for debugging
• Enter into direct mode where data can be sent and received using asynchronous GPIOs as input and output
2. Mode of the Rail Test
| Mode | Description | |
| None |
The app is doing nothing, but the radio may be on. Parameters can be set in this mode based on the current radio state, and the timer can be used. |
|
| Stream | Send a stream of pseudo-random bits. | |
| Tone | Send a tone at the carrier frequency. | |
| ContinuousTx | Send an unending stream of packets, separated by a configurable delay. | |
| DirectMode | Send data to and from a GPIO, without any packet handling. | |
| PacketTx | Send a specific number of packets, with a summary print at the end. | |
| ScheduledTx | Send one packet scheduled in the future. | |
| TxAfterRx | Schedule a packet after each RX after a specific delay. | |
| RxOverflow | Overflow on receive by delaying in RAILCb_RxPacketReceived. | |
| TxUnderflow | Underflow by not loading data for the next TX sequence. | |
| TxCancel | Cancel a single packet transmit to force an error callback. | |
| RfSense | Sense RF energy to wake the radio. | |
| PER (Packet Error Rate) test | A GPIO is toggled, and stats are gathered on received packets. | |
| BER (Bit Error Rate) test | Statistics are gathered on received bits. |
WiFi IoT Module
Bluetooth Module
5G/LTE/CAT-M1/NB-IoT
