Instrumentation Aggregate Manager ¶

This service controls the RF test system that is the core of Sandbox 4. It is used to control attenuation values between pairs of ports (ie. the eight (8) nodes and wimax BS) through the standard OMF URL based services. Current state of SB4 is available at ​visualization page.

set: Set a single attenuator value ¶

Set the attenuation value on given port pairs:

set

  <service name="set">
     <info>This service sets attenuation for ports pair.</info>
     <args>
       <arg name="portA" isRequired="true" value="port">
         <info>Port number </info>
       <arg name="portB" isRequired="true" value="port">
         <info>Port number </info>
       </arg>
       <arg name="att" isRequired="true" value="att">
         <info>attenuation </info>
       </arg>
      </arg>
    </args>
  </service>

Example: set the attenuation value between node1-1 and node1-2 to 20 dB

$ wget -O status http://internal2dmz.orbit-lab.org:5054/instr/set?portA=1\&portB=2\&att=20

get: Get a single attenuation value ¶

Get the attenuation between a given pair of ports

get

  <service name="get">
    <info>This service gets attenuation for ports pair.</info>
    <args>
       <arg name="portB" isRequired="true" value="port">
         <info>Port number </info>
       </arg>
       <arg name="portA" isRequired="true" value="port">
         <info>Port number </info>
       </arg>
    </args>
  </service>

Example: get the attenuation between node1-1 and node1-8

$ wget -O status http://internal2dmz.orbit-lab.org:5054/instr/get?portA=1\&portB=8

default: Set all attenuators to default values ¶

default

  <service name="default">
     <info>This service load default configuration.</info>
  </service>

The default configuration sets all attenuators to 0 dB attenuation (i.e. full connectivity between all of the nodes including the WiMAX basestation).

status: Get all attenuator values ¶

Get attenuation values on all port pairs

status

  <service name="status">
     <info>This service outputs attenuation for all pairs.</info>
  </service>

$ wget -O status http://internal2dmz.orbit-lab.org:5054/instr/status 

list: List all stored configurations ¶

list

  <service name="list">
     <info>This service list configurations from database.</info>
  </service>

load: Load named configuration ¶

Load attenuator setting from the internal database of configurations.

load

  <service name="load">
    <info>This service load configuration from database.</info>
    <args>
      <arg name="name" isRequired="true" value="name">
        <info>Name of configuration.</info>
      </arg>
    </args>
  </service>

save: Save current attenuator settings ¶

Store current attenuator settings under with the name into internal database .

save

  <service name="save">
    <info>This service saves current configuration to database.</info>
    <args>
       <arg name="name" isRequired="true" value="name">
         <info>Name of configuration.</info>
       </arg>
    </args>
  </service>

delete: Delete named configuration ¶

delete

  <service name="delete">
    <info>This service deletes configuration from database.</info>
  </service>

show: Show named configuration ¶

show

  <service name="show">
     <info>Show named configuration from database.</info>
     <args>
       <arg name="name" isRequired="true" value="name">
          <info>Name of configuration.</info>
       </arg>
     </args>
  </service>

OEDL Support ¶

How to use instrumentation AM from your OEDL script; Attenuator values are between 0 and 63 dB.

Using attenuation for link matrix ¶

...
require "matrix"

c8 = Matrix[
  [ 63, 0,63,63,63,63,63, 0,63 ],
  [  0,63, 0,63,63,63,63,63,63 ],
  [ 63, 0,63,63,63,63,63,63,63 ],
  [ 63,63, 0,63, 0,63,63,63,63 ],
  [ 63,63,63, 0,63, 0,63,63,63 ],
  [ 63,63,63,63, 0,63, 0,63,63 ],
  [ 63,63,63,63,63, 0,63, 0,63 ],
  [  0,63,63,63,63,63, 0,63,63 ],
  [ 63,63,63,63,63,63,63,63,63 ]
]

set_att_matrix(c8)
...

Using gain for link matrix ¶

...
require "matrix"

c8 = Matrix[
  [  0,63, 0, 0, 0, 0, 0,63, 0 ],
  [ 63, 0,63, 0, 0, 0, 0, 0, 0 ],
  [  0,63, 0,63, 0, 0, 0, 0, 0 ],
  [  0, 0,63, 0,63, 0, 0, 0, 0 ],
  [  0, 0, 0,63, 0,63, 0, 0, 0 ],
  [  0, 0, 0, 0,63, 0,63, 0, 0 ],
  [  0, 0, 0, 0, 0,63, 0,63, 0 ],
  [ 63, 0, 0, 0, 0, 0,63, 0, 0 ],
  [  0, 0, 0, 0, 0, 0, 0, 0, 0 ]
]

set_neg_att_matrix(c8)
...

Loading saved configurations ¶

...
load_att_matrix("cycle-8")
...

Catalog of topologies

Ready-made Topologies ¶

Based on ​small graphs page

Topology visualization	Topology Name	Topology visualization	Topology Name
	2diamonds		cycle-8
	3-pan		p3u2k
	4-fan		5-fan
	6-fan		7-fan
	x121		x135
	x138		s3
	x55		x88
	k33uk1		p3up4