| | 1 | {{{#!comment |
| | 2 | [[Include(wiki:802.11/beta-note)]] |
| | 3 | }}} |
| | 4 | |
| | 5 | [[TracNav(802.11/TOC)]] |
| | 6 | |
| | 7 | = 802.11 Reference Design: Experiment Framework Setup = |
| | 8 | |
| | 9 | == Quick Start == |
| | 10 | * Install a suitable Python distribution (may be already be installed on your PC; see below) |
| | 11 | * Download the 802.11 Reference Design Python packages and examples from the repository: [browser:/ReferenceDesigns/w3_802.11/python /ReferenceDesigns/w3_802.11/python] |
| | 12 | * Choose an example script ([source:/ReferenceDesigns/w3_802.11/python/warpnet_example_wlan_throughput.py warpnet_example_wlan_throughput.py] for example) |
| | 13 | * Edit the script header to match your setup (IP address of your PC and serial numbers of your WARP nodes) |
| | 14 | * Open a terminal to the directory containing the example script |
| | 15 | * Run the script with Python; for example {{{python warpnet_example_wlan_throughput.py}}} |
| | 16 | |
| | 17 | == System Requirements == |
| | 18 | * '''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. |
| | 19 | |
| | 20 | * '''Connectivity''': the framework requires the host PC and every WARP v3 node be connected to a common 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. |
| | 21 | |
| | 22 | == Python Versions == |
| | 23 | 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. |
| | 24 | |
| | 25 | We have tested the framework and example scripts using the operation systems and Python distributions listed below. |
| | 26 | |
| | 27 | '''Mac OS X''' |
| | 28 | * Python 2.7.4 bundled with Mac OS X 10.9 Mavericks |
| | 29 | * Python 2.7.6 in [http://continuum.io/downloads Anaconda] |
| | 30 | |
| | 31 | '''Windows''': |
| | 32 | * Python 2.7.6.2 (64 bit) in [http://winpython.sourceforge.net/ WinPython] |
| | 33 | * Python 3.? (64 bit) in ??? |
| | 34 | |
| | 35 | === Useful Packages === |
| | 36 | * '''ipython''': |
| | 37 | |
| | 38 | * '''numpy''': Some of the wlan_log examples use [http://www.numpy.org/ numpy 1.7] for processing large arrays of node log entries. numpy is included in many Python distributions. You can check by running this on your command line: {{{python -c "import numpy; print numpy.version.version"}}}. This will print a version number if numpy is installed or an error if it is not. |
| | 39 | |
| | 40 | * '''pandas''': |
| | 41 | |
| | 42 | * '''spyder''': |
