= 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 two versions of the WARPLab files.

 * 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). The MATLAB functions support both SISO and 2x2 MIMO.  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.

== Getting Started ==
 1. Install Peter Rydesäter's open-source TCP/UDP toolbox for MATLAB (get it free from [http://www.mathworks.com/matlabcentral/fileexchange/loadFile.do?objectId=345 MATLAB Central]).
 2. Download the WARPLab source code to your PC. Put the code somewhere in MATLAB's path and then run these commands on the MATLAB command line to force a refresh of the toolbox caches:
{{{
rehash toolboxcache
rehash toolbox
clear all functions
}}}
 * [source:/ResearchApps/PHY/WARPLAB/WARPLAB_SISO/M_code Link to version 1 of the source code].
 * [source:/ResearchApps/PHY/WARPLAB/WARPLab_SISO_MIMO2x2/M_Code Link to version 2 of the source code].
 3. Connect your PC and two WARP boards to a common Ethernet switch. Ideally, nothing else should be connected to the same switch.
 4. Set your PC's IP address to 10.0.0.200
 5. Set the DIP switches on two boards to 0 and 1
 6. Download the WARPLab bitstream to both boards.
 * [source:/ResearchApps/PHY/WARPLAB/WARPLAB_SISO/warplab_siso.bit Link to the SISO bitstream] that works with version 1 of the source code
 * [source:ResearchApps/PHY/WARPLAB/WARPLab_SISO_MIMO2x2/warplab_siso_v02.bit Link to the SISO bitstream] that works with version 2 of the source code.
 * [source:ResearchApps/PHY/WARPLAB/WARPLab_SISO_MIMO2x2/warplab_mimo_2x2_v02.bit Link to the 2x2 MIMO bitstream] that works with version 2 of the source code.
 7. Try one of the examples. The GUI (warplab_siso_Gui) is the best one to start with.