wiki:WARPLab6

Version 22 (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 five versions of the WARPLab files. FOR NEW USERS WE RECOMMEND USING VERSION 5. Versions 1, 2, 3, and 4 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, modified January 2009. The WARPLab MIMO 2x2 and 4x4 Reference Designs have been updated to version 10 of the Xilinx tools. The 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. 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. Reading of RSSI values is supported by the 2x2 MIMO bitstream but not by the 4x4 MIMO bitstream. Continuous transmission mode is supported by both the 2x2 and 4x4 bitstreams. When the boards are programmed with the 4x4 MIMO bitstream 2x2 MIMO communication is possible but reading of RSSI values is not possible. The MATLAB Reference functions support both 2x2 and 4x4 MIMO bitstreams.
  • Version 5: Posted on September 2009. The WARPLab MIMO 2x2 and 4x4 Reference Designs have been updated to include Automatic Gain Control (AGC). Previous versions of WARPLab required Manual Gain Control (MGC), the user was required to set receiver gains manually. In this new Version 5 release the user can choose between AGC or MGC mode using simple m-code functions. 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. AGC and MGC are supported by both bitstreams. Reading of RSSI values is supported by the 2x2 MIMO bitstream but not by the 4x4 MIMO bitstream. Continuous transmission mode is supported by both the 2x2 and 4x4 bitstreams. When the boards are programmed with the 4x4 MIMO bitstream 2x2 MIMO communication is possible but reading of RSSI values is not possible. The MATLAB Reference functions support both 2x2 and 4x4 MIMO bitstreams.

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 for different versions of the Reference M code are available here?.

Attachments (2)

Download all attachments as: .zip