wiki:WARPLab/Examples/OFDM

Version 20 (modified by chunter, 8 years ago) (diff)

--

WARPLab 7 Example: SISO OFDM

File: wl_example_siso_ofdm_txrx.m

This WARPLab example implements a simple OFDM transmitter and receiver. The script can run with or without WARP hardware in the loop and does not require any extra MATLAB toolboxes.

Important: this script is not intended as a tutorial of OFDM. If you're not already familiar with the basics of OFDM please start with one of the many good OFDM tutorials available online. You will need to know the basics of OFDM before understanding the Tx and Rx processing in this example.

Transmitter

The OFDM transmitter code implements the following functions:

  • Random data generation
  • Modulation of random data to complex constellation symbols
  • Mapping of symbols to data-bearing subcarriers
  • Insertion of pilot tones in pilot subcarriers
  • Inverse fast Fourier transform (IFFT)
  • Cyclic prefix insertion
  • Preamble construction and insertion
  • Interpolation by 2x

Receiver

The OFDM receiver code implements the following functions:

  • LTS correlation for synchronization
  • CFO estimation and correction use time-domain estimation from LTS
  • Cyclic prefix removal
  • Fast Fourier transform (FFT)
  • Channel estimation from frequency-domain LTS
  • Residual phase error estimation from frequency-domain pilot tones
  • SFO estimation and correction from frequency-domain pilot tones
  • Equalization of data-bearing subcarriers using channel estimates and phase error estimates
  • Demodulation of complex symbols to data values

Running the Example

The WARPLab OFDM example can be used in simulation only mode and in hardware-in-the-loop mode.

Simulation

To use the example in simulation mode set the top-level param USE_WARPLAB_TXRX = 0;, then run the m-script. When the script finishes 6 plots will show:

Simulation Plots

Transmitted waveform

Received waveform

Preamble correlation results
(peaks indicate locations of preamble LTS)

Channel estimate per subcarrier
(I/Q components and complex magnitude)

Phase error estimates
(per OFDM symbol)

Tx and Rx constellations

By default the simulation script applies AWGN with an arbitrary fixed SNR. You can change the simulated propagation characteristics in the m-code. Search for AWGN and apply whatever Tx->Rx degradations you like.

For example to simulate a perfect (noiseless) link, set the noise power to zero:

rx_vec_air = tx_vec_air + 0*complex(randn(1,length(tx_vec_air)), randn(1,length(tx_vec_air)));

The script also prints statistics about the experiment to the MATLAB command prompt:

Results:
Num Bytes:  4560
Sym Errors:  0 (of 9120 total symbols)
Bit Errors:  0 (of 36480 total bits)
EVM:        3.779%
LTS CFO Est: -0.07 kHz

Hardware in the Loop

Requirements: 2 WARP v3 kits, 1 antenna each.

To use the example with WARP hardware you will need two WARP nodes each running WARPLab 7.3 (or later) and a WARPLab environment setup on your PC. Refer to the WARPLab Quick Start if you have not yet setup WARPLab.

To target WARP hardware set the top-level param USE_WARPLAB_TXRX = 1;, then run the m-script. When the script finishes 6 plots will show:

Hardware in the Loop Plots

Transmitted waveform

Received waveform

Preamble correlation results
(peaks indicate locations of preamble LTS)

Channel estimate per subcarrier
(I/Q components and complex magnitude)

Phase error estimates
(per OFDM symbol)

Tx and Rx constellations

The script also prints statistics about the experiment to the MATLAB command prompt:

Results:
Num Bytes:  4560
Sym Errors:  0 (of 9120 total symbols)
Bit Errors:  0 (of 36480 total bits)
EVM:        4.541%
LTS CFO Est: 2.64 kHz

CFO, Phase Error, and SFO

Typically, a transmitter and receiver are each clocked independently. This independence manifests in three different degradations that must be dealt with by a wireless receiver:

  • Carrier Frequency Offset (CFO) - The center frequency of the transmitter will not perfectly match the center frequency of the receiver. Unless corrected, this will de-orthogonalize the OFDM subcarriers and cause inter-carrier interference (ICI). CFO is typically corrected in the time domain via multiplication with a digital carrier whose frequency negates the CFO estimate.
  • Phase Error - Even after CFO is corrected in the time domain, there is typically a residual phase error component that must be corrected in the frequency domain.
  • Sampling Frequency Offset (SFO) - The temporal duration of a sample is slightly different at the receiver and transmitter due to different sampling clocks. Over the course of a reception, the relative sample periods will drift apart from one another. This manifests as larger phase error for the outer subcarriers.

At the top of the script, there are three control variables that toggle three different recovery systems: DO_APPLY_CFO_CORRECTION, DO_APPLY_PHASE_ERR_CORRECTION, DO_APPLY_SFO_CORRECTION. In this section, we will explore what happens when different combinations of these recovery systems are enabled or disabled.

CFO Recovery: Enabled, Phase Error Recovery: Enabled, SFO Recovery: Enabled


1. Phase Error Estimates and SFO Recovery Matrix

2. Rx Constellation

3. Error Vector Magnitude (EVM)
and effective SNR

The above plots are provided for reference. They show an example of how the receiver performs when all three recovery systems are enabled.

  1. The "Phase Error Estimates" plot shows a nominal phase twist for each OFDM symbol over the course of the reception. The "SFO Recovery Matrix" shows a phase correction that increases for outer subcarriers over the course of the reception.
  2. The "Rx Constellation" plot shows each received symbol overlaid on each transmitted symbol.
  3. The "EVM and SNR" plot shows that EVM is small and has little dependence on OFDM symbol index or subcarrier index. Furthermore, the red line shows the effective SNR of the reception (calculated from the EVM values themselves).

CFO Recovery: Disabled, Phase Error Recovery: Enabled, SFO Recovery: Enabled


1. Phase Error Estimates and SFO Recovery Matrix

2. Rx Constellation

3. Error Vector Magnitude (EVM)
and effective SNR

By disabling time-domain CFO correction, we have increased the burden on the phase error recovery system. In effect, the residual CFO to be corrected is now considerably larger. This can be observed in the "Phase Error Estimates" plot in the first figure above. The number of 2π wraps is considerably larger than the previous scenario where time-domain CFO correction was enabled. Ultimately, however, phase error recovery can only go so far. By the time the system is applying phase corrections in the frequency domain, ICI has already occurred. This can be observed in the "EVM and SNR" plots where the effective SNR is a couple of dB worse than the previous case.

CFO Recovery: Disabled, Phase Error Recovery: Enabled, SFO Recovery: Enabled


1. Phase Error Estimates and SFO Recovery Matrix

2. Rx Constellation

3. Error Vector Magnitude (EVM)
and effective SNR

CFO Recovery: Enabled, Phase Error Recovery: Enabled, SFO Recovery: Disabled


1. Phase Error Estimates and SFO Recovery Matrix

2. Rx Constellation

3. Error Vector Magnitude (EVM)
and effective SNR

Limitations

This example is intended as a starting point for researchers wishing to use WARPLab to prototype a wireless communications link. This examples does not implement some some blocks common in deployed OFDM systems, such as scrambling, interleaving and error correcting coding. For an example of a real-time OFDM implementation that implements all of these subsystems, please see the PHY in the 802.11 Reference Design.

Attachments (28)

Download all attachments as: .zip