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

Timestamp:

Apr 10, 2014, 12:23:31 PM (10 years ago)

Author:

murphpo

Comment:

--

802.11/wlan_exp/GettingStarted

@@ -6 +6 @@
 
 = 802.11 Reference Design: Experiment Framework Setup =
+
+The basic steps to setup and use the 802.11 Reference Design Experiments Framwork are listed below, and explained in detail in the following sections.
+
+1. Install a suitable version of Python
+1. Install the wlan_exp Python package
+1. Configure and connect WARP v3 nodes via Ethernet
+1. Test the hardware and setup
+
+== Python ==
+
+The wlan_exp package requires '''Python 2 (version 2.7.5 or later)''' or '''Python 3 (version 3.3.5 or later)'''.
+
+=== For Beginners ===
+
+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.
+
+The installers for Mac OS X, Windows and Linux are available on the [http://continuum.io/downloads Anaconda downloads page].
+
+We 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.
+
+The Anaconda Mac OS X distribution is always 64-bit. 
+
+If your Windows PC and OS is 64-bit, you should use the 64-bit Anaconda distribution.
+
+=== Python Package Requirements ===
+
+Most functions of the wlan_exp package only require the Python standard library. These functions include node initialization, control, monitoring and retrieval of log data.
+
+Some of the log parsing utilities and examples use third-party packages. To run all of our examples, your Python installation must have:
+ * NumPy (version 1.8 or later)
+ * Pandas (version 0.13 or later)
+ * matplotlib (version 1.3.1 or later)
+ * h5py (version 2.2 or later)
+
+=== Recommendations ===
+
+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.
+
+
+
+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.
+
+This is not an exhaustive list. The wlan_exp package and associated examples should work with any standard distribution.
+
+'''Mac OS X'''
+ * Python 2.7.5 (64-bit) bundled with Mac OS X 10.9 Mavericks
+ * Anaconda Python 2.7.6 in [http://continuum.io/downloads Anaconda]
+
+
+
+== System Requirements ==
+
 
 == Quick Start ==