= Wildcard tournament experiment eaxmple #1 =

[[TOC(DSC*,depth=2)]]

== Objective ==
Use OEDL script to execute competitive game in wildcard with the simple house bot. 

== Hardware / Software Resources Used ==
 1. Four grid nodes with USRPs.
 2. ''dsc-bot.ndz'': disk image loaded onto one pair of nodes. This image has all the prerequisite software to configure the USRPs and execute a house radio. 
 3. ''team-image.ndz'': disk image with team radio. 
 4. Scoring packet server: This is server that resides on the grid console (for the practice) and is used by a transmitting nodes to send data packets over the air via USRP as well as by the receiving nodes to submit received packets for scoring.
 5. [attachment:dsc-wildcard.rb]: this is the OEDL experiment script to execute the game.

== Setting up the nodes ==
 * To get started first make a reservation on the [https://www.orbit-lab.org/loginService/ControlPanel Orbit Scheduler] for using the Grid.

 * After logging into grid console, make sure all nodes are turned off (in the example below, turn off all the nodes in the grid):
{{{
username@console.grid:~$ omf tell -a offh -t system:topo:all
}}}

 * Verify state of node before continuing. Make sure nodes are in the POWEROFF state.
{{{
username@console.grid:~$ omf stat
}}}

 * Image the two nodes to be used for first team radios (in this case team A nodes): 
{{{
username@console.grid:~$ omf load -i dsc-bot.ndz -t system:topo:dsc-teamA
}}}

 * Image the two nodes to be used for house radios (in this case team C nodes): 
{{{
username@console.grid:~$ omf load -i dsc-bot.ndz -t system:topo:dsc-teamC
}}}

 * Turn nodes back on and verify they are in POWERON state
{{{
username@console.grid:~$ omf tell -a on -t system:topo:teamA
username@console.grid:~$ omf tell -a on -t system:topo:teamC
}}}

 * Download the [attachment:dsc-wildcard.rb OEDL experiment script for this tutorial] to your local directory.
{{{
username@console.grid:~$ wget http://www.orbit-lab.org/raw-attachment/wiki/DSC/dc_trial2/dsc-wildcard.rb
}}} 

== Running the experiment script ==

By default, the experiment script will execute '''/root/gnuradio/gr-digital/examples/narrowband/bot1_tx.py''' and '''/root/gnuradio/gr-digital/examples/narrowband/bot1_rx.py''' on transmitter and receiver respectively. Each team will use a separate set of parameters for a very simple bot: brute-force radio that sends a random number of packets at random intervals. The sender module draws packets from a packet server, while the receiver module delivers packets to the same packet server.  The code is based on the same benchmark radio that was used for Hurdle 3.


 * Type to following command to run the experiment. This will start the packet server, start the transmitter and receiver for both teams and release the packet source. The actual transmission/reception will run for 100 seconds (which can be adjusted with the property at the top of the script) or until one radio successfully transmits the file.
{{{
username@console.grid:~$ omf exec dsc-wildcard.rb -- --team1 dsc-teamA --team2 dsc-teamC
}}}

 * The output should look similar to the following:
{{{
username@console.grid:~# omf exec dsc-wildcard.rb
...
}}}

 * Turn the nodes off
{{{
username@console.grid:~$ omf tell -a offh -t system:topo:all
}}}

NOTES: