| 15 | | 1. Ensure your Xilinx tools match the version used to create the reference design (see the [wiki:../Download download] page for the current versions) |
| 16 | | 1. Ensure your local copy of the WARP edk_user_repository is up to date and in the repository search path of XPS (see [wiki:edk_user_repository edk_user_repository] for details) |
| 17 | | 1. Download the 802.11 Reference Design archive and expand the inner .zip archive in {{{<ref_design_archive>/EDK_Projects/w3_802.11_EDK_vXXX.zip}}}. |
| 18 | | * Be sure the expanded EDK project path has no spaces; {{{C:/work/w3_802.11_EDK/}}} works, {{{C:/Documents and Settings/user/w3_802.11_EDK/}}} does not |
| 19 | | * The text below assumes your expanded EDK project is in {{{<xps_proj>/}}}. |
| 20 | | 1. Launch Xilinx SDK and select {{{<xps_proj>/SDK_Workspace}}} as the active workspace |
| 21 | | 1. Select Xilinx Tools -> Repositories. In Local Repositories click New, then select {{{<xps_proj>/}}} and click OK. Be sure to select the root of the XPS project (the folder containing {{{system.mhs}}}, '''not''' the SDK_Workspace folder. |
| 22 | | 1. Import the 7 SDK projects provided by the reference design |
| 23 | | 1. Select File -> Import |
| 24 | | 1. Expand General -> Existing Projects into Workspace, click Next |
| 25 | | 1. Click Browse and navigate to {{{<xps_proj>/SDK_Workspace}}} |
| 26 | | 1. Seven projects will be listed: |
| 27 | | {{{ |
| 28 | | wlan_bsp_cpu_high |
| 29 | | wlan_bsp_cpu_low |
| 30 | | wlan_mac_ap |
| 31 | | wlan_mac_sta |
| 32 | | wlan_mac_dcf |
| 33 | | wlan_mac_shared |
| 34 | | wlan_xps_XXX_hw_platform <- the version number in this project name will change between releases |
| 35 | | }}} |
| 36 | | 1. Ensure all 7 projects are checked and click Finish |
| 37 | | 1. In the SDK Project Explorer: |
| 38 | | 1. Right click on the {{{wlan_mac_ap}}} project and select Change Referenced BSP. In the dialog box select {{{wlan_bsp_cpu_high}}} then click OK |
| 39 | | 1. Right click on the {{{wlan_mac_sta}}} project and select Change Referenced BSP. In the dialog box select {{{wlan_bsp_cpu_high}}} then click OK |
| 40 | | 1. Right click on the {{{wlan_mac_dcf}}} project and select Change Referenced BSP. In the dialog box select {{{wlan_bsp_cpu_low}}} then click OK |
| 41 | | 1. Right click on the {{{wlan_mac_ap}}} project and select Clean Project |
| 42 | | 1. Right click on the {{{wlan_mac_sta}}} project and select Clean Project |
| 43 | | 1. Right click on the {{{wlan_mac_dcf}}} project and select Clean Project |
| 44 | | 1. The 3 software applications (AP, STA and DCF) should now build to completion. Watch the console for the message {{{elfcheck passed}}} |
| | 11 | The Mango 802.11 Reference Design is packaged as a .zip file with the full source code and compiled bitstreams for the reference design. The latest release is available on the [wiki:../Download Dowload] page. You can view the latest source code in the repository ([source:/ReferenceDesigns/w3_802.11]). Please note the code in the repository is under active development. |
| | 12 | |
| | 13 | The contents of the 802.11 Reference Design .zip file are explained below. |
| | 14 | |
| | 15 | === LICENSE.txt === |
| | 16 | This file explains terms under which the 802.11 Reference Design is released. |
| | 17 | |
| | 18 | === Bitstreams_Reference === |
| | 19 | Bitstreams are fully-built designs that are ready to be downloaded onto WARP hardware. Files ending with the extension '.bit' may be downloaded using the Xilinx tool iMPACT. Files ending with the extension .bin may loaded onto an SD card so that the WARP v3 hardware will automatically be programmed whenever it is powered on and has the SD card inserted. Details on how to configure an SD card with a '.bin' file are [wiki:howto/SD_Config provided here]. |
| | 20 | |
| | 21 | === EDK_Projects === |
| | 22 | This folder contains an EDK project built with the Xilinx Embedded Development Kit (EDK) software. The hardware design is constructed and implemented in EDK Xilinx Platform Studio (XPS). The software designs, running in two MicroBlaze processors, are built in the Xilinx SDK. Opening the EDK project requires a copy of the [wiki:edk_user_repository WARP edk_user_repository] at the SVN revision in the table above. |
| | 23 | |
| | 24 | The EDK projects is a combination of an XPS project along with Eclipse software projects that can be imported into an SDK workspace. These software projects are present in the 'SDK_Workspace' subfolder of every XPS project -- we recommend using this folder as the location of the SDK Workspace. These projects can then be imported "in place" and will not need to be copied. |
| | 25 | |
| | 26 | === SysGen_Reference=== |
| | 27 | This folder contains the source System Generator models for the PHY Rx, Tx, AGC and MAC-DCF. Each sub-folder also contains the init scripts and support files required by each model. These scripts and models are configured to run in simulation as-is. To run a simulation, open MATLAB, cd to one of the model directories (wlan_phy_rx_pmd, for example), open the .mdl file and click Run. |
| | 28 | |
| | 29 | === Python_Reference=== |
| | 30 | This folder contains the reference version of the wlan_exp Python package and associated example scripts. See the [wiki:../wlan_exp/GettingStarted wlan_exp Getting Started] page for details on installing the wlan_exp package from this folder. |
| | 31 | |
