Changes between Version 8 and Version 9 of 802.11/Usage/SDK


Ignore:
Timestamp:
Apr 13, 2016, 5:27:35 PM (8 years ago)
Author:
murphpo
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • 802.11/Usage/SDK

    v8 v9  
    991. Ensure your Xilinx tools match the version used to create the reference design (see the [wiki:../../Download download] page for the current versions)
    10101. 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)
    11 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}}}.
    12   * 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
    13   * The text below assumes your expanded EDK project is in {{{<xps_proj>/}}}.
     111. Download the 802.11 Reference Design archive and expand .zip archive
     12  * Be sure the expanded archive path has no spaces; {{{C:/work/w3_802.11/}}} works, {{{C:/Documents and Settings/user/w3_802.11/}}} does not
     13  * The text below uses {{{<xps_proj>/}}} as a placeholder for the XPS Project inside the expanded archive's '''EDK_Projects''' folder
    14141. Launch Xilinx SDK and select {{{<xps_proj>/SDK_Workspace}}} as the active workspace
    15151. 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.
    … …  
    1818  1. Expand General -> Existing Projects into Workspace, click Next
    1919  1. Click Browse and navigate to {{{<xps_proj>/SDK_Workspace}}}
    20   1. 9 projects will be listed:
     20  1. 8 projects will be listed:
    2121{{{
    2222wlan_bsp_cpu_high
    … …  
    2727wlan_mac_low_dcf
    2828wlan_mac_low_nomac
    29 wlan_mac_shared
    30 Mango_802.11_RefDes_vXXX_hw_platform  <- the version number in this project name will change between releases
     29Mango_802.11_RefDes_vX.Y_hw_platform  <- the version number in this project name will change between releases
    3130}}}
    32   1. Ensure all 9 projects are checked and click Finish
     31  1. Ensure all 8 projects are checked and click Finish
    3332  1. In the SDK Project Explorer:
    34     1. Right click on the {{{wlan_mac_high_ap}}} project and select Change Referenced BSP. In the dialog box select {{{wlan_bsp_cpu_high}}} then click OK
    35     1. Right click on the {{{wlan_mac_high_ibss}}} project and select Change Referenced BSP. In the dialog box select {{{wlan_bsp_cpu_high}}} then click OK
    36     1. Right click on the {{{wlan_mac_high_sta}}} project and select Change Referenced BSP. In the dialog box select {{{wlan_bsp_cpu_high}}} then click OK
    37     1. Right click on the {{{wlan_mac_low_dcf}}} project and select Change Referenced BSP. In the dialog box select {{{wlan_bsp_cpu_low}}} then click OK
    38     1. Right click on the {{{wlan_mac_low_nomac}}} project and select Change Referenced BSP. In the dialog box select {{{wlan_bsp_cpu_low}}} then click OK
    39     1. Right click on the {{{wlan_mac_high_ap}}} project and select Clean Project
    40     1. Right click on the {{{wlan_mac_high_ibss}}} project and select Clean Project
    41     1. Right click on the {{{wlan_mac_high_sta}}} project and select Clean Project
    42     1. Right click on the {{{wlan_mac_low_dcf}}} project and select Clean Project
    43     1. Right click on the {{{wlan_mac_low_nomac}}} project and select Clean Project
     33    1. For each CPU High project listed below, right-click the project name, select Change Referenced BSP, in the new dialog select {{{wlan_bsp_cpu_high}}}, then click OK
     34      * {{{wlan_mac_high_ap}}}
     35      * {{{wlan_mac_high_ibss}}}
     36      * {{{wlan_mac_high_sta}}}
     37    1. For each CPU Low project listed below, right-click the project name, select Change Referenced BSP, in the new dialog select {{{wlan_bsp_cpu_low}}}, then click OK
     38      * {{{wlan_mac_low_dcf}}}
     39      * {{{wlan_mac_low_nomac}}}
     40    1. Right click on each software project and select Clean Project
    44411. The 5 software applications (AP, STA, IBSS, DCF and NoMAC) should now build to completion. Click once on each project in the SDK Project Explorer tab and check the console for the message {{{elfcheck passed}}}
    4542
    … …  
    6259
    6360If you want to generate a .bin file for use on SD cards, find the updated {{{download.bit}}} file as described above and follow the usual [wiki:howto/SD_Config#BinaryFormat SD card config] flow.
     61
     62== Updating C Source Code ==
     63
     64The Reference Design SDK Workspace uses software projects with "virtual" source code folders. These virtual folders refer to actual folders containing the source code files. This structure allows multiple software projects to share common source code without duplicating files.
     65
     66As of release v1.5 all C source code is stored in the {{{svn_src}}} folder at the root of the {{{SDK_Workspace}}} folder. The 7 software projects use virtual folders to refer to the application, framework, and common code in the {{{svn_src}}} folder. Thus, if you modify a file shared by multiple projects (such as {{{wlan_mac_low.h}}}) all software projects referring to that file will be updated automatically.
     67
     68The {{{svn_src}}} folder in the reference design archive is '''not''' an SVN working copy. This is intentional, in hopes of avoiding accidental updates from known-good code (from a ref design archive) and in-progress code (from svn). However the organization of the {{{svn_src}}} folder mirrors that of the C code in the SVN repository at [browser:/ReferenceDesigns/w3_802.11/c /ReferenceDesigns/w3_802.11/c]. This facilitates replacing the C code with a copy exported from a specific revision from the SVN repository.