[[TOC(Software/eAM*, depth=2, heading=Aggregate Managers)]] [[TOC(Software/eAM/mInstr*, depth=4, heading=Instrumentation AM)]] == 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. The service also controls selection of which devices (eg. node or basestation) are connected to the RF test system on a per port basis. Current state of SB4 is available at [http://www.orbit-lab.org/status/sb4 visualization page]. === set: Set a single attenuator value === Set the attenuation value on given port pairs: [[CollapsibleStart(set)]] {{{ This service sets attenuation for ports pair. Port number Port number attenuation }}} [[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)]] {{{ This service gets attenuation for ports pair. Port number Port number }}} [[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)]] {{{ This service load default configuration. }}} [[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)]] {{{ This service outputs attenuation for all pairs. }}} [[CollapsibleEnd]] {{{ $ wget -O status http://internal2dmz.orbit-lab.org:5054/instr/status }}} === list: List all stored configurations === [[CollapsibleStart(list)]] {{{ This service list configurations from database. }}} [[CollapsibleEnd]] === load: Load named configuration === Load attenuator setting from the internal database of configurations. [[CollapsibleStart(load)]] {{{ This service load configuration from database. Name of configuration. }}} [[CollapsibleEnd]] === save: Save current attenuator settings === Store current attenuator settings under with the '''name''' into internal database . [[CollapsibleStart(save)]] {{{ This service saves current configuration to database. Name of configuration. }}} [[CollapsibleEnd]] === delete: Delete named configuration === [[CollapsibleStart(delete)]] {{{ This service deletes configuration from database. }}} [[CollapsibleEnd]] === show: Show named configuration === [[CollapsibleStart(show)]] {{{ Show named configuration from database. Name of configuration. }}} [[CollapsibleEnd]] === selDevice: Select device connected to the matrix port=== [[CollapsibleStart(selDevice)]] {{{curl "internal2dmz.orbit-lab.org:5054/instr/selDevice?switch=4&port=2"}}} {{{ This service selects one of the two devices connected to the matrix port. Switch number (switch=1 => matrix port 1, switch=2 => matrix port 2, switch=3 => matrix port 8, switch=4 => matrix port 9) Port number (port=1 => node, port=2 => USRP) }}} [[CollapsibleEnd]] === 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") ... }}} [[CollapsibleStart(Catalog of topologies)]][[Include(Software/eAM/mInstr/Topologies)]][[CollapsibleEnd]]