Changes between Version 25 and Version 26 of 802.11/Usage

Timestamp:

Jul 16, 2014, 11:49:43 AM (10 years ago)

Author:

murphpo

Comment:

--

802.11/Usage

@@ -7 +7 @@
 = 802.11 Reference Design: Usage =
 
-The 802.11 Reference Design contains two implementations that share much of the same MAC and PHY. These implementations are an access point (AP) that can be joined by 802.11 devices and a station (STA) that can be used to join 802.11 APs (WARP or otherwise).
+== Creating the SDK Workspace ==
+
+The 802.11 Reference Design is distributed as a .zip archive. The archive contents are described on the [../Download#ReferenceDesignArchive Download page].
+
+The reference software projects can be modified via the Xilinx SDK. The steps below describe how to create an SDK workspace containing the full software design.
+
+1. Ensure your Xilinx tools match the version used to create the reference design (see the [wiki:../Download download] page for the current versions)
+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)
+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}}}.
+  * 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
+  * The text below assumes your expanded EDK project is in {{{<xps_proj>/}}}. 
+1. Launch Xilinx SDK and select {{{<xps_proj>/SDK_Workspace}}} as the active workspace
+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.
+1. Import the 7 SDK projects provided by the reference design
+  1. Select File -> Import
+  1. Expand General -> Existing Projects into Workspace, click Next
+  1. Click Browse and navigate to {{{<xps_proj>/SDK_Workspace}}}
+  1. Seven projects will be listed:
+{{{
+wlan_bsp_cpu_high
+wlan_bsp_cpu_low
+wlan_mac_ap
+wlan_mac_sta
+wlan_mac_dcf
+wlan_mac_shared
+wlan_xps_XXX_hw_platform  <- the version number in this project name will change between releases
+}}}
+  1. Ensure all 7 projects are checked and click Finish
+  1. In the SDK Project Explorer:
+    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
+    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
+    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
+    1. Right click on the {{{wlan_mac_ap}}} project and select Clean Project
+    1. Right click on the {{{wlan_mac_sta}}} project and select Clean Project
+    1. Right click on the {{{wlan_mac_dcf}}} project and select Clean Project
+1. The 3 software applications (AP, STA and DCF) should now build to completion. Watch the console for the message {{{elfcheck passed}}}
+
+= AP vs STA Applications =
+
+The 802.11 Reference Design contains two implementations that share the same low-level MAC and PHY. These implementations are an access point (AP) that can be joined by 802.11 devices and a station (STA) that can join 802.11 APs (WARP or otherwise).
 
 == 802.11 AP ==
@@ -13 +52 @@
 By default, the AP Reference Design implements an 802.11 compatible access point with SSID "WARP-AP". To use the design in this configuration:
 
-1. Plug ETH A from a WARP v3 board into a router whose WAN port is connected to the Internet. The 802.11 Reference Design is not a router -- it does not have a DHCP server to issue IP addresses to associated stations. It will, however, pass DHCP requests and responses through its Ethernet portal, so connecting WARP v3 to a router will allow DHCP to occur on client stations.
+1. Connect the WARP v3 ETH A interface to a local network, ideally one with a DHCP server and internet access. The 802.11 Reference Design is not a router -- it does not have a DHCP server to issue IP addresses to associated stations. It will pass DHCP requests and responses through its Ethernet portal to the wired network.
 1. Download the 802.11 Reference Design and program a WARP v3 board with the provided bitstream for the AP implementation.
-1. Use any 802.11 device (such as a computer or smartphone) to join the unsecured network with SSID of "WARP-AP." At this point, the 802.11 device should be able to access the network.
+1. Use an 802.11 device (such as a computer or smartphone) to join the open network with SSID of "WARP-AP." The 802.11 device should associated successfully and communicate with the wired network (and internet, if the wired network has internet access).
 
 == 802.11 STA ==
 
-By default, the STA Reference Design will attempt to associate with an AP that is advertising an SSID of "WARP-AP." The stock AP Reference Design meets this criteria, so programming one board with the AP design followed by programming another board with the STA design is sufficient to create a connection. Alternatively, the UART menu on the station can be used to perform an active scan and display the list of all nearby APs and their SSIDs. This menu can then be used to attempt association to one of those APs. TO use this design,
+By default the Reference Design STA application will attempt to associate with an AP advertising the SSID of "WARP-AP." Programming one node with the AP design and one (or more) nodes with the STA design will automatically create a wireless network of associated nodes. The STA and AP node LEDs indicate association status (details below).
 
-1. Plug ETH A from a WARP v3 board into a single Ethernet device such as a laptop or desktop PC. The STA design will bridge the Ethernet link of that device to the 802.11 wireless link. NOTE: do not plug ETH A into a switch if that switch has more than one Ethernet device on it. The current STA implementation assumes that all traffic it receives over Ethernet comes from a single source.
+Alternatively, the UART menu on the station can be used to perform an active scan and display the list of all nearby APs and their SSIDs. This menu can then be used to attempt association to one of those APs. To use this design,
+
+1. Plug ETH A from a WARP v3 board into a single Ethernet device such as a laptop or desktop PC. The STA design will bridge the Ethernet link of that device to the 802.11 wireless link. NOTE: do not plug ETH A into a switch with other devices, especially other WARP v3 nodes running the STA application. This can create a circular bridge (wired-wireless-wired) that will behave badly.
 1. Download the 802.11 Reference Design and program a WARP v3 board with the provided bitstream for the STA implementation.
 1. Use the UART menu to associate with a nearby AP.
-1. Access the wireless network with the device that is plugged into ETH A.
+1. Access the wireless network from the device that is plugged into ETH A.
 
 == Using the UART Menu ==
@@ -58 +99 @@
   * STA: the STA displays the node's current AID (association ID), as assigned by the AP. When associated the STA displays 00.
 
-== Creating the SDK Workspace ==
-
-1. Ensure your Xilinx tools match the version used to create the reference design (see the [wiki:../Download download] page for the current versions)
-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)
-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}}}.
-  * 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
-  * The text below assumes your expanded EDK project is in {{{<xps_proj>/}}}. 
-1. Launch Xilinx SDK and select {{{<xps_proj>/SDK_Workspace}}} as the active workspace
-1. Select Xilinx Tools -> Repositories. In Local Repositories click New, then select {{{<xps_proj>/}}} and click OK.
-1. Import the 7 SDK projects provided by the reference design
-  1. Select File -> Import
-  1. Expand General -> Existing Projects into Workspace, click Next
-  1. Click Browse and navigate to {{{<xps_proj>/SDK_Workspace}}}
-  1. Seven projects will be listed:
-{{{
-wlan_bsp_cpu_high
-wlan_bsp_cpu_low
-wlan_mac_ap
-wlan_mac_sta
-wlan_mac_dcf
-wlan_mac_shared
-wlan_xps_vXX_hw_platform  <- the version number in this project name will change between releases
-}}}
-  1. Ensure all 7 projects are checked and click Finish
-  1. In the SDK Project Explorer:
-    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
-    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
-    1. Right click on the {{{wlan_mac_ap}}} project and select Clean Project
-    1. Right click on the {{{wlan_mac_sta}}} project and select Clean Project
-    1. Right click on the {{{wlan_mac_dcf}}} project and select Clean Project
-1. Both software projects should now build to completion. Watch the console for the message {{{elfcheck passed}}}