Changes between Version 7 and Version 8 of 802.11/wlan_exp/GettingStarted


Ignore:
Timestamp:
Apr 10, 2014, 2:03:00 PM (10 years ago)
Author:
murphpo
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • 802.11/wlan_exp/GettingStarted

    v7 v8  
    99The basic steps to setup and use the 802.11 Reference Design Experiments Framwork are listed below, and explained in detail in the following sections.
    1010
    11 1. Install a suitable version of Python
    12 1. Install the wlan_exp Python package
    13 1. Configure and connect WARP v3 nodes via Ethernet
    14 1. Test the hardware and setup
     11 1. Install a suitable version of Python
     12 1. Install the wlan_exp Python package
     13 1. Configure and connect WARP v3 nodes via Ethernet
     14 1. Test the hardware and setup
    1515
    16 == Python ==
     16There are two sets of instructions below- one for Python beginners, one for Python experts.
    1717
    18 The wlan_exp package requires '''Python 2 (version 2.7.5 or later)''' or '''Python 3 (version 3.3.5 or later)'''.
     18== For Python Beginners ==
    1919
    20 === For Beginners ===
     20New Python users should start with the [https://store.continuum.io/cshop/anaconda/ Anaconda Scientific Python Distribution] from [http://www.continuum.io/ Continuum Analytics]. This distribution bundles known-good versions of Python, third-party packages for data processing and great IDE tools.
    2121
    22 If you're not already using Python, we suggest using the [https://store.continuum.io/cshop/anaconda/ Anaconda Scientific Python Distribution] from [http://www.continuum.io/ Continuum Analytics]. This distribution bundles known-good versions of Python, third-party packages for data processing and IDE tools.
    23 
    24 The installers for Mac OS X, Windows and Linux are available on the [http://continuum.io/downloads Anaconda downloads page].
     22The installers for Mac OS X, Windows and Linux are available on the '''[http://continuum.io/downloads Anaconda downloads page]'''.
    2523
    2624We strongly recommend a 64-bit Python installation to fully utilize the 802.11 Reference Design logging framework. A 32-bit Python cannot handle the large log files generated by nodes during long experiments.
    … …  
    3028If your Windows PC and OS is 64-bit, you should use the 64-bit Anaconda distribution.
    3129
    32 === Python Package Requirements ===
     30== Install wlan_exp Package ==
     31
     32A core component of 802.11 Reference Design Experiments Framework is the wlan_exp Python package. You must use a wlan_exp version that matches the 802.11 Reference Design version running in your WARP v3 nodes.
     33
     34We '''strongly recommend''' using the wlan_exp package bundled in the reference design .zip archive. This version of the package is tested with the C code, FPGA designs and pre-compiled bitstreams bundled in the same release. The wlan_exp package is located in the '''/Python_Reference''' folder in the reference design .zip archive.
     35
     36To install the wlan_exp package in your Python environment:
     37 1. Launch the Spyder IDE in your Anaconda installation (Start Menu -> Anaconda (64-bit) -> Spyder)
     38 1. Select Tools -> PYTHONPATH Manager
     39 1. If the PYTHONPATH window shows any existing '''wlan_exp''' entries, remove them
     40 1. Click Add
     41 1. Navigate to the '''wlan_exp''' folder in the expanded reference design archive (for example "C:\work\Mango_802.11_RefDes_v0.9_beta\Python_Reference\wlan_exp")
     42 1. Click Select Folder
     43 1. Click Synchronize, then Yes
     44 1. Click Close
     45
     46== Configure and Connect WARP v3 Nodes ==
     47
     48The 802.11 Reference Design Experiments Framework communicates with WARP v3 nodes via Ethernet. Your PC (with Python and the wlan_exp package) and all WARP v3 nodes must be connected to the same Ethernet switch.
     49
     50We recommend using a dedicated NIC for wlan_exp experiments. This NIC should have a static IP address in the 10.0.0.x subnet. This is the same recommended setup as for WARPLab.
     51
     52'''Ethernet Setup:'''
     53 1. Set your PC NIC IP address to 10.0.0.250 and subnet mask to 255.255.255.0
     54 1. Connect the NIC to a 1Gb Ethernet switch
     55 1. Connect '''ETH_B''' of each WARP v3 node to the same switch
     56
     57'''Important:''' do '''not''' connect '''ETH_A''' of multiple WARP v3 nodes to the same switch. The 802.11 Reference Design wired-wireless portal will attempt to bridge ETH_A to the wireless interface. Mixing this behavior with wlan_exp traffic will have unpredictable results.
     58
     59'''Nodes Configuration:'''
     60 1. If you have one WARP v3 node, configure this node as an 802.11 AP using the AP bitstream from the Bitstream_Reference folder
     61 1. If you have multiple WARP v3 nodes, configure one as an AP (AP bitstream) and the rest as stations (STA bitstream)
     62
     63'''Testing the Setup:'''
     64 1. Launch a Python shell (Start Menu -> Anaconda (64-bit) -> Anaconda Command Prompt)
     65 1. Change directory to the Python_Reference/Examples folder ({{{cd C:\work\Mango_802.11_RefDes_v0.9_beta\Python_Reference\examples}}})
     66 1. Run the blink_node_leds.py example: {{{python blink_node_leds.py}}}
     67
     68All of your WARP v3 nodes should blink their green LEDs for 5 seconds.
     69
     70----
     71
     72== For Python Experts ==
     73
     74The wlan_exp package requires '''Python 2 (version 2.7.5 or later)''' or '''Python 3 (version 3.3.5 or later)'''.
    3375
    3476Most functions of the wlan_exp package only require the Python standard library. These functions include node initialization, control, monitoring and retrieval of log data.
     77
     78The wlan_exp package supports Python 2.7+ and 3.3+.
     79
     80A 32-bit Python installation will work for all wlan_exp usage '''except''' processing large (multi-gigabyte) log files. When possible we recommend a 64-bit installation.
    3581
    3682Some of the log parsing utilities and examples use third-party packages. To run all of our examples, your Python installation must have:
    … …  
    4086 * h5py (version 2.2 or later)
    4187
    42 === Recommendations ===
    43 
    44 A 32-bit Python installation will work for all wlan_exp usage '''except''' processing large log (multi-gigabyte) files. When possible we recommend a 64-bit installation.
     88In our testing the wlan_exp examples that use these packages work in both Python 2.7 and 3.3.
    4589
    4690
    47 
    48 We have tested wlan_exp with a few specific Python distributions. If you do not already have Python installed, we recommended one of the distributions below.
    49 
    50 This is not an exhaustive list. The wlan_exp package and associated examples should work with any standard distribution.
    51 
    52 '''Mac OS X'''
    53  * Python 2.7.5 (64-bit) bundled with Mac OS X 10.9 Mavericks
    54  * Anaconda Python 2.7.6 in [http://continuum.io/downloads Anaconda]
    55 
    56 
    57 
    58 == System Requirements ==
     91----
     92'''OLD'''
    5993
    6094