wiki:WARPLab6

Version 17 (modified by mduarte, 15 years ago) (diff)

--

WARPLab

WARPLab is a framework which brings together WARP and MATLAB. With WARPLab, you can interact with WARP nodes directly from the MATLAB workspace.

This documentation is a work in progress. Please check back as we improve it.

Requirements

  • At least two WARP nodes
  • A PC with MATLAB
  • An Ethernet switch

Note about WARPLab files

There are four versions of the WARPLab files. FOR NEW USERS WE RECOMMEND USING VERSION 4. Versions 1, 2 and 3 will be deprecated soon.

  • Version 1: Posted on November 2007. Supports SISO communication. This was the version used at the Fourth WARP Workshop held at Rice on Nov 1-2 2007 and the Fifth WARP Workshop held at IIT Madras on Dec 1-2 2007.
  • Version 2: Posted on April 2008. Supports SISO and MIMO (2x2) communication and allows continuous transmission mode. This was the version used at the Sixth WARP Workshop held at Nile University on April 16-17 2008. Two bitstreams are provided, one bitstream to program the boards in the SISO configuration and another bitstream to program the boards in the 2x2 MIMO configuration. The MATLAB Reference functions support both SISO and 2x2 MIMO.
  • Version 3: Posted on July 2008. Supports MIMO 4x4 communication and allows continuous transmission mode for 2x2 MIMO. This was the version used at the Seventh WARP Workshop held at Rice University on July 14-15 2008. Two bitstreams are provided, one bitstream to program the boards in the 2x2 MIMO configuration and another bitstream to program the boards in the 4x4 MIMO configuration. Continuous transmission mode and reading of RSSI values is supported by the 2x2 MIMO bitstream but not by the 4x4 MIMO bitstream. When the boards are programmed with the 4x4 MIMO bitstream 2x2 MIMO communication is possible but continuous transmission mode and reading of RSSI values is not possible. The MATLAB Reference functions support both 2x2 and 4x4 MIMO bitstreams.
  • Version 4: Posted on November 2008, this was the version used at the eighth WARP workshop held at Rice University on November 13-14 2008. The WARPLab MIMO 2x2 Reference Design has been updated to version 10 of the Xilinx tools. This update required some changes in the Sysgen model resulting in minor changes in the Reference M code. The Capture Offset parameter has been changed to a Transmitter Delay parameter (look at the warplab_defines.m code and the WARPLab examples), the Capture Offset was a receiver parameter, the Transmitter Delay is a transmitter parameter and should be downloaded to the transmitter node. The WARPLab MIMO 4x4 Reference Design has not been updated to version 10 of the Xilinx tools but will be updated soon.

Getting Started

  1. Install Peter Rydesäter's open-source TCP/UDP toolbox for MATLAB (get it free from MATLAB Central).
  2. Download the WARPLab Reference M code to your PC. The instructions are available here. In the final step you can choose the appropriate version to add to the path.
  1. Connect your PC and two WARP boards to a common Ethernet switch. Ideally, nothing else should be connected to the same switch.
  2. Set your PC's IP address to 10.0.0.200
  3. Set the DIP switches on two boards to 0 and 1
  4. Download the WARPLab bitstream to both boards.
  1. Try one of the examples. The GUI (warplab_mimo_2x2_GUI and the warplab_siso_example_TxRx) are the best ones to start with.

XPS Reference Design

The XPS Reference Designs used to generate the bitstreams that work with version 3 of the Reference M code are available here?. These xps projects were generated with version 9.1 of the Xilinx tools.

Attachments (2)

Download all attachments as: .zip