[[TOC(Software/eAM/*, depth=3)]]

== Instrumentation Aggregate Manager ==

This service controls the RF test system that is the core of [wiki:Hardware/bDomains/cSandboxes/dSB4 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.

=== set: Set a single attenuator value ===

Set the attenuation value on given port pairs: 

[[CollapsibleStart(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>
}}}
[[CollapsibleEnd]]

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

[[CollapsibleStart(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>
}}}
[[CollapsibleEnd]]

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 ===

[[CollapsibleStart(default)]]
{{{
  <service name="default">
     <info>This service load default configuration.</info>
  </service>
}}}
[[CollapsibleEnd]]

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

[[CollapsibleStart(status)]]
{{{
  <service name="status">
     <info>This service outputs attenuation for all pairs.</info>
  </service>
}}}
[[CollapsibleEnd]]

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

=== list: List all stored configurations ===

[[CollapsibleStart(list)]]
{{{
  <service name="list">
     <info>This service list configurations from database.</info>
  </service>
}}}
[[CollapsibleEnd]]

=== load: Load named configuration ===
Load attenuator setting from the internal database of configurations.

[[CollapsibleStart(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>
}}}
[[CollapsibleEnd]]

=== save: Save current attenuator settings ===

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

[[CollapsibleStart(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>
}}}
[[CollapsibleEnd]]

=== delete: Delete named configuration ===

[[CollapsibleStart(delete)]]
{{{
  <service name="delete">
    <info>This service deletes configuration from database.</info>
  </service>
}}}
[[CollapsibleEnd]]

=== show: Show named configuration ===

[[CollapsibleStart(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>
}}}
[[CollapsibleEnd]]

=== Named Configurations ===

[[CollapsibleStart(Standard topologies)]][[Include(Topologies)]][[CollapsibleEnd]]

=== OEDL Support ===

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")
...
}}}