{{{#!comment
[[Include(wiki:802.11/beta-note)]]
}}}

[[TracNav(802.11/TOC)]]

= 802.11 Reference Design: Aggregate Throughput Example = 

This example of the Experiments Framework uses two WARP v3 nodes, one configured as an AP, the other as a STA. The script steps through PHY rates, measuring unidirectional throughput for ~10 seconds for each rate. This script demonstrates how to:
 * Control two WARP v3 nodes from one wlan_exp script
 * Use the wlan_exp framework Local Traffic Generator (LTG) to create traffic
 * Read Tx/Rx packet counts from nodes to calculate per-flow throughput

The flow of the script is:
 1. Initialize two WARP v3 nodes
 1. Ensure nodes are configured as one AP, one STA and that the STA is associated with AP
 1. Start a fully-backlogged locally generated traffic (LTG) flow from AP -> STA
 1. For each WLAN rate:
   1. Read current Tx/Rx packet counts at STA
   1. Wait 10 seconds
   1. Read current Tx/Rx packet counts at STA again
   1. Calculate throughput for 10 second window
 1. Stop the traffic flow
 1. Print the results

To run this example:
 * Setup wlan_exp (see [wiki:../../GettingStarted Getting Started] for details)
 * Configure two WARP v3 nodes with the 802.11 Reference Design bitstream- one AP, one STA
 * Open a Python shell
 * CD to the '''Python_Reference/Examples''' directory from the expanded 802.11 Reference design archive
 * Run {{{python throughput_two_nodes.py}}}

The script will run for ~80 seconds, then display its results:
{{{
RESULS GO HERE
}}}

----
'''Source:''' the script is included in the 802.11 Reference Design archive at '''Python_Reference/examples/throughput_two_nodes.py'''.

The [source:/ReferenceDesigns/w3_802.11/python/examples/throughput_two_nodes.py latest version of the throughput_two_nodes.py script] is also shown below.

[[Include(source:/ReferenceDesigns/w3_802.11/python/examples/throughput_two_nodes.py)]]