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


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

--

Legend:

Unmodified
Added
Removed
Modified

  • 802.11/wlan_exp/GettingStarted

    v8 v9  
    3737 1. Launch the Spyder IDE in your Anaconda installation (Start Menu -> Anaconda (64-bit) -> Spyder)
    3838 1. Select Tools -> PYTHONPATH Manager
    39  1. If the PYTHONPATH window shows any existing '''wlan_exp''' entries, remove them
     39 1. If the PYTHONPATH window shows any existing 802.11 Reference Design '''Python_Reference''' entries, remove them
    4040 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")
     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")
    4242 1. Click Select Folder
    4343 1. Click Synchronize, then Yes
    … …  
    6161 1. If you have multiple WARP v3 nodes, configure one as an AP (AP bitstream) and the rest as stations (STA bitstream)
    6262
    63 '''Testing the Setup:'''
     63== Testing Your Setup ==
     64
    6465 1. Launch a Python shell (Start Menu -> Anaconda (64-bit) -> Anaconda Command Prompt)
    6566 1. Change directory to the Python_Reference/Examples folder ({{{cd C:\work\Mango_802.11_RefDes_v0.9_beta\Python_Reference\examples}}})
    … …  
    7677Most functions of the wlan_exp package only require the Python standard library. These functions include node initialization, control, monitoring and retrieval of log data.
    7778
    78 The wlan_exp package supports Python 2.7+ and 3.3+.
     79We recommend a 64-bit installation. A 32-bit Python installation will work for most wlan_exp usage '''except''' processing large (multi-gigabyte) log files.
    7980
    80 A 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.
    81 
    82 Some of the log parsing utilities and examples use third-party packages. To run all of our examples, your Python installation must have:
     81Some of the log parsing utilities and examples use third-party packages. To run all of our examples your Python installation must have:
    8382 * NumPy (version 1.8 or later)
    8483 * Pandas (version 0.13 or later)
    … …  
    8988
    9089
    91 ----
    92 '''OLD'''
    9390
    94 
    95 == Quick Start ==
    96  * Install a suitable Python distribution (may be already be installed on your PC; see below)
    97  * Download the 802.11 Reference Design Python packages and examples from the repository: [browser:/ReferenceDesigns/w3_802.11/python /ReferenceDesigns/w3_802.11/python]
    98  * Choose an example script ([source:/ReferenceDesigns/w3_802.11/python/warpnet_example_wlan_throughput.py warpnet_example_wlan_throughput.py] for example)
    99  * Edit the script header to match your setup (IP address of your PC and serial numbers of your WARP nodes)
    100  * Connect ETH_B of each WARP v3 node to the same gigabit Ethernet switch as your PC
    101  * Open a terminal to the directory containing the example script
    102  * Run the script with Python; for example {{{python warpnet_example_wlan_throughput.py}}}
    103 
    104 == System Requirements ==
    105  * '''802.11 Reference Design''': warpnet support was added to the reference design in v0.8.
    106 
    107  * '''Python''': the warpnet framework supports both Python 2 (2.7+) and Python 3 (3.3+). No third-party Python packages are required. See the Python recommendations below for more details.
    108 
    109  * '''Connectivity''': the framework requires the host PC and every WARP v3 node be connected to a common gigabit Ethernet switch. We recommend you use a dedicated NIC on your PC to avoid superfluous traffic on the experimental network. The WARP v3 nodes must use their '''ETH B''' interfaces for wlan_exp.
    110 
    111  * '''WARP v3 hardware''': warpnet requires at least one WARP v3 node running the 802.11 Reference Design. The framework supports up to 253 nodes.
    112 
    113 == Python Versions ==
    114 The warpnet framework supports Python 2 (2.7.4+) and Python 3 (3.3+). The core warpnet and wlan_exp scripts require only the core Python packages.
    115 
    116 We have tested the framework and example scripts using the operating systems and Python distributions listed below.
    117 
    118 '''Mac OS X'''
    119  * Python 2.7.4 bundled with Mac OS X 10.9 Mavericks
    120  * Python 2.7.5 in [https://code.google.com/p/spyderlib/wiki/Installation Spyder]
    121  * Python 2.7.6 in [http://continuum.io/downloads Anaconda]
    122 
    123 '''Windows''':
    124  * Python 2.7.6.2 (64 bit) in [http://winpython.sourceforge.net/ WinPython]
    125  * Python 3.3.3.2 (64 bit) in [http://winpython.sourceforge.net/ WinPython]
    126 
    127 === Useful Packages ===
     91== Useful Packages ==
    12892 * '''[https://code.google.com/p/spyderlib/ Spyder]''': this IDE for Python code development is extremely useful when editing code / developing scripts.  Besides automatic syntax checking / highlighting, it integrates the python and ipython consoles to allow interactive debug of code. 
    12993