[[TracNav(WARPLab/TOC)]] = WARPLab Quick Start = == System Requirements == * Check your [wiki:../../repositoryAccess WARP Repository] is set up and up to date * Review the [wiki:../Requirements WARPLab 7 System Requirements] * Review the [wiki:../../GettingStarted Getting Started Guide] for hardware basics and the [wiki:../HardwareConfiguration WARPLab Hardware Configuration Guide] for WARPLab specific uses of WARP hardware. * Review the [wiki:../MEX WARPLab Mex Compilation Guide] for additional WARPLab features [[br]] == Setting up the WARPLab 7 Framework == 1. Download the latest WARPLab Reference Design Release ([wiki:../Downloads Download]) and unzip it to a location of your choosing. 1. Open MATLAB and change the current path to the {{{M_Code_Reference}}} directory from the downloaded archive. 1. Run {{{wl_setup}}} on the MATLAB command line. 1. Follow the prompts to configure your WARPLab environment. [[br]] == Hardware Setup == * For your PC: 1. Assign one of your NICs to the manual IP address specified in the {{{wl_setup}}} step above (default: (10.0.0.250, 255.255.255.0)) 1. Connect the NIC to a 1Gb Ethernet switch * For WARP v3 nodes: 1. Connect ETH_A to the 1Gb Ethernet switch your PC is connected to. 1. Set the user DIP switch to a unique value on each node, starting at 0 1. Configure the FPGA with the Reference Design. The reference bitstreams are included in the Bitstreams_Reference folder from the downloaded archive. Find the bitstream appropriate for your hardware and program the .bit file to the board using the Xilinx iMPACT tool. The .bin file can be used to configure an SD card with the design (see the [wiki:howto/SD_Config SD config howto] for help using the .bin file). 1. On boot each node will display the last digit of its IP address ({{{N}}} for IP address {{{10.0.0.N}}}) on the right hex display. By default IP addresses are assigned as {{{10.0.0.N}}} for {{{N = node_ID + 1}}}. 1. The bottom green LED will blink until the Ethernet link is up 1. All four green LEDs will blink when the node is ready to accept commands from MATLAB [[br]] == Examples == 1. Confirm everything is ready by copying and pasting the following lines to the MATLAB command line: {{{ clear N = 1; nodes = wl_initNodes(N); wl_nodeCmd(nodes,'identify'); disp(nodes) }}} Note: {{{N}}} can be changed to the number of nodes in your network. When you run these lines of code, you should see the User I/O LEDs on your {{{N}}} nodes blink as a result of the [wiki:../Reference/Commands/Node#identify 'identify'] command. Additionally, you should see your {{{nodes}}} object vector print status messages to the screen. For {{{N = 2}}}, your status display should be similar to: {{{ Displaying properties of 2 wl_node objects: | ID | WLVER | HWVER | Serial # | Ethernet MAC Addr | ------------------------------------------------------------ | 0 | 7.0.0 | 3 | W3-a-00027 | 40-D8-55-04-20-36 | ------------------------------------------------------------ | 1 | 7.0.0 | 3 | W3-a-00041 | 40-D8-55-04-20-52 | ------------------------------------------------------------ }}} 2. If the previous stepped work, you should now try one of the [wiki:../Examples M-Code Examples]. [[br]] == Getting Help == There are a few resources for getting help with using WARPLab for your own designs: 1. The [wiki:../Reference/Utility#wl_cmd_list wl_cmd_list] is a function that allows you to display all commands than an object supports. 1. The [wiki:../Reference/Utility#wl_cmd_doc wl_cmd_doc] is a function that will display documentation for a particular command. 1. The WARP forums ([http://warpproject.org/forums/]) are a great place to ask questions.