[[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 the attenuation value on given port pairs: 

{{{     
  <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 the attenuation between a given pair of ports

{{{
  <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 ===
{{{
  <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 attenuation values on all port pairs

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

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

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

{{{
  <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>
}}}

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


=== save ===
Store current attenuator settings into internal database under the named configuration.

{{{
  <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 ===
{{{
  <service name="delete">
    <info>This service deletes configuration from database.</info>
  </service>
}}}

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