Wildcard tournament experiment eaxmple #1

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. 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 ​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 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: