wiki:DSC/zdc_framework

Version 3 (modified by seskar, 11 years ago) ( diff )

Match Execution Framework

Objective

Use an OEDL script to execute a competitive-style and cooperative-style games for both Wildcard and Preliminary matches. Even though the use of framework is illustrated by using 2 (3) house bots, it the actual competition, the teams will be using their own radio implementations. Teams have to use the script in this framework to certify their image before submission.

The OEDL script uses three pair of nodes: dsc-teamA, dsc-teamB, dsc-teamC (the actual topology descriptions are system:topo:dsc-team{A,B,C,D}). The competitve matches will use teamA and temaC nodes, while cooperative will use teamA, teamB and teamC nodes (contestant radios will be only on teamA nodes for the wildcard tournament while house bots will be using teamB and teamC nodes); configurations should be considered to be fixed and will be changed only in the case of hardware failures.

Hardware / Software Resources Used

  1. Four grid nodes with USRP N210s (two for each team) for competitive match and six nodes with USRP N210s for cooperative match.
  2. dsc-wbot1.ndz,dsc-wbot2.ndz,dsc-wbot3.ndz: house bot disk images with the prerequisite software to configure the USRPs and execute a house radio bot.
  3. team-image.ndz: disk image that contains the team's radio.
  4. Scoring packet server: This is the server that resides on the infrastructure machine and is used as the source of data packets as well as the sink for teams to submit received packets for scoring.
  5. dsc-wildcard.rb: this is the OEDL experiment script to execute the matches.

Setting up the arena

  • 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 the first team's radios (team A nodes):
    username@console.grid:~$ omf load -i dsc-wbot1.ndz -t system:topo:dsc-teamA
    

In the case of wildcard matches these two nodes will receive competitor image

  • Image the two nodes to be used for the second team's radios (in this case team C nodes):
    username@console.grid:~$ omf load -i dsc-wbot2.ndz -t system:topo:dsc-teamC
    
  • FOR COOPERATIVE MATCHES: image the third pair of nodes to be used for the third team's radios (in this case team B nodes):
    username@console.grid:~$ omf load -i dsc-wbot3.ndz -t system:topo:dsc-teamB
    
  • Turn nodes back on and verify they are in POWERON state
    username@console.grid:~$ omf tell -a on -t system:topo:dsc-teamA
    username@console.grid:~$ omf tell -a on -t system:topo:dsc-teamC
    
  • Download the OEDL experiment script to your local directory.
    username@console.grid:~$ wget http://www.orbit-lab.org/raw-attachment/wiki/DSC/zdc_framework/dsc-challenge.rb
    

Running the experiment script ==v

The experiment script will execute /root/dsc-code_tx and /root/dsc-code_rx on the source and sink respectively (please note that there are no suffixes), for both (all three) pairs of nodes. The sender module draws packets from a packet server, while the sink module delivers packets to the same packet server.

Packet Server ==

  • idb2
  • Ports

1440 bytes fixed packets; closes transmit socket on the first packet request after the end-of-file is reached or on the 180 second timeout. It will report the score with the email (if at least one packet is received correctly).

  • Type to following command to run the experiment. This will start the packet server, start the source and sink for all teams and release the packet source, wait for 180 seconds and then terminate the match. The actual transmission/reception will run .
    username@console.grid:~$ omf exec dsc-challenge.rb -- XXXXXXXXXXXXXXXXXXXXXX
    
  • The output should look similar to the following:
    username@console.grid:~# mf-5.4 exec dsc-challenge.rb -- --mode COMP
    
     INFO NodeHandler: OMF Experiment Controller 5.4 (git 5385228)
     INFO NodeHandler: Slice ID: default_slice (default)
     INFO NodeHandler: Experiment ID: default_slice-2013-07-17t10.04.54.210-04.00
     INFO NodeHandler: Message authentication is disabled
     INFO Experiment: load system:exp:stdlib
     INFO property.resetDelay: resetDelay = 220 (Fixnum)
     INFO property.resetTries: resetTries = 1 (Fixnum)
     INFO Experiment: load system:exp:eventlib
     INFO Experiment: load system:exp:winlib
     INFO Experiment: load dsc-challenge.rb
     INFO property.team1: team1 = "dsc-teamA" (String)
     INFO property.team2: team2 = "dsc-teamC" (String)
     INFO property.team3: team3 = "dsc-teamB" (String)
     INFO property.freq: freq = 1700000000 (Bignum)
     INFO property.server: server = "idb2" (String)
     INFO property.port: port = 5123 (Fixnum)
     INFO property.runtime: runtime = 180 (Fixnum)
     INFO property.mode: mode = "COMP" (String)
     INFO Topology: Loaded topology 'system:topo:dsc-teamA'.
     INFO Topology: Loaded topology 'system:topo:dsc-teamC'.
     INFO Topology: Loaded topology 'system:topo:dsc-teamB'.
     INFO exp: Connecting to packet server
     INFO stdlib: Waiting for nodes (Up/Down/Total): 2/2/4 - (still down: node20-19.grid.orbit-lab.org,node19-19.grid.orbit-lab.org) [0 sec.]
     INFO ALL_UP_AND_INSTALLED: Event triggered. Starting the associated tasks.
     INFO exp: Preparing packet server
     INFO exp: Request from Experiment Script: Wait for 2s....
     INFO exp: Start benchmark_rx,tx
     INFO exp: Request from Experiment Script: Wait for 10s....
     INFO exp: Sending signal to packet server to start serving packets
     INFO exp: Running the experiment
     INFO exp: Request from Experiment Script: Wait for 180s....
     INFO exp: Stoping the applcations
     INFO exp: Request from Experiment Script: Wait for 2s....
     INFO EXPERIMENT_DONE: Event triggered. Starting the associated tasks.
     INFO NodeHandler: 
     INFO NodeHandler: Shutting down experiment, please wait...
     INFO NodeHandler: 
     INFO run: Experiment default_slice-2013-07-17t10.04.54.210-04.00 finished after 3:30
    
    username@console.grid:~#
    
  • Turn the nodes off
    username@console.grid:~$ omf tell -a offh -t system:topo:all
    

NOTES:

Note: See TracWiki for help on using the wiki.