Changes between Version 13 and Version 14 of 802.11/Usage

Timestamp:

Oct 11, 2013, 1:24:48 PM (11 years ago)

Author:

chunter

Comment:

--

802.11/Usage

@@ -5 +5 @@
 = 802.11 Reference Design: Usage =
 
-By default, the Reference Design implements an 802.11 compatible access point with SSID "WARP-AP". To use the design in this configuration:
+The 802.11 Reference Design contains two implementations that share much of the same MAC and PHY. These implementations are an 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).
+
+== 802.11 AP ==
+
+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. Download the 802.11 Reference Design and program a WARP v3 board with the provided bitstream.
+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.
+
+== 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,
+
+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.
+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.
+
+== Using the UART Menu ==
+
+Both the AP and STA implementations include extensive control of parameters via UART. The instructions [wiki:howto/USB_UART provided here] show how to connect to the USB UART on WARP v3. The 802.11 Reference Design uses a baud rate of 115200 for all UART interactions.
+
+=== AP UART Capabilities ===
+
+ * Change the advertised SSID
+ * Change the channel
+ * Change the rate used for unicast transmissions
+ * Print the current status of transmit queues
+ * Enter an interactive AP menu where
+  * individual station statistics can be observed (e.g. last received power, packet counts, etc)
+  * traffic can be locally generated for any number of connected stations
+
+
+=== STA UART Capabilities ===
+
+ * Perform an active scan and details about nearby access points
+ * Associate with an access point displayed during the active scan
+ * Change the rate used for unicast transmissions
+ * Enter an interactive STA menu where
+  * statistics about the associated AP can be observed (e.g. last received power, packet counts, etc)
+  * traffic can be locally generated for the associated AP
+
+
+
 
 == Creating the SDK Workspace ==
@@ -20 +60 @@
 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 5 SDK projects provided by the reference design
+1. Import the 7 SDK projects provided by the reference design
   1. Select File -> Import
   1. Expand General -> Existing Projects into Workspace, click Next
@@ -29 +69 @@
 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 6 projects are checked and click Finish
+  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}}}