wiki:Resources/Services/RFSwitch

Service: RF Switch

This service is used to configure the RF switch boxes attached to certain nodes in sb1.cosmos-lab.org and sb2.cosmos-lab.org allowing the experimenter to select how nodes and antennas are connected.

RF Switch Boxes:

Name Location Connected Nodes/Devices
rfsw1-in1.sb1.cosmos-lab.org COSMOS Sandbox 1 (see domain specific page)
rfsw1-in2.sb1.cosmos-lab.org COSMOS Sandbox 1 (see domain specific page)
rfsw-s1-lg1.sb2.cosmos-lab.org COSMOS Sandbox 2 sdr1-s1-lg1, sdr2-s1-lg1
rfsw-md1.sb2.cosmos-lab.org COSMOS Sandbox 2 sdr1-md1, sdr2-md1

Please visit the individual sandbox specific pages in the wiki for detailed block diagrams of the possible RF connections that can be made.


Usage

All the available methods are accessible from the a testbed console via an HTTP API located at am1.cosmos-lab.org:5054/rf_switch. This API can be interacted with via a command line tool such as "curl" or any script using a "REST client" library.


Get the current configuration

This API call is used to get the current configuration of the RF switch box(es). The response will specify the switch/port configurations of the RF switch box(es) in question.

HTTP API Path: am1.cosmos-lab.org:5054/rf_switch/status

Parameters:

Name Decription Required Acceptable Input
name Comma separated list of RF switch box FQDNs Y (list of RF switch boxes)


Example 1

HTTP Request:

am1.cosmos-lab.org:5054/rf_switch/status?name=rfsw1.sb1.cosmos-lab.org

Response:

<response status="OK">
  <rf_switch name="rfsw1.sb1.cosmos-lab.org" num_of_switches="4">
    <switch number="1" port="1"/>
    <switch number="2" port="1"/>
    <switch number="3" port="1"/>
    <switch number="4" port="1"/>
  </rf_switch>
</response>


Example 2

HTTP Request:

am1.cosmos-lab.org:5054/rf_switch/status?name=rfsw1.sb1.cosmos-lab.org,rfsw2.sb1.cosmos-lab.org

Response:

<response status="OK">
  <rf_switch name="rfsw1.sb1.cosmos-lab.org" num_of_switches="4">
    <switch number="1" port="1"/>
    <switch number="2" port="1"/>
    <switch number="3" port="1"/>
    <switch number="4" port="1"/>
  </rf_switch>
  <rf_switch name="rfsw2.sb1.cosmos-lab.org" num_of_switches="4">
    <switch number="1" port="1"/>
    <switch number="2" port="1"/>
    <switch number="3" port="1"/>
    <switch number="4" port="1"/>
  </rf_switch>
</response>


Configure the RF switch

HTTP API Path: am1.cosmos-lab.org:5054/rf_switch/set

Parameters:

Name Decription Required Acceptable Input
name Comma separated list of RF switch box FQDNs Y (list of RF switch boxes)
switch Comma separated list of switch(es) to configure Y (list of switch numbers)
port Port to select on RF switch Y 1, 2


Example 1

For rfsw1.sb1.cosmos-lab.org and rfsw2.sb1.cosmos-lab.org, configure switches 2 and 3 to the second port.

HTTP Request:

am1.cosmos-lab.org:5054/rf_switch/set?name=rfsw1.sb1.cosmos-lab.org,rfsw2.sb1.cosmos-lab.org&switch=2,3&port=2

Response:

<response status="OK">
  <message>OK</message>
</response>
Last modified 3 years ago Last modified on Jan 18, 2022, 8:39:37 PM
Note: See TracWiki for help on using the wiki.