Changes between Initial Version and Version 1 of Resources/Services/Array Mgmt


Ignore:
Timestamp:
Feb 10, 2022, 7:33:30 PM (2 years ago)
Author:
seskar
Comment:

—

Legend:

Unmodified
Added
Removed
Modified

  • Resources/Services/Array Mgmt

    v1 v1  
     1[[Include(WikiToC)]]
     2
     3=== Service: mmWave Array Management
     4
     5This service is used to manage various (IBM PAAM, Sivers 60 GHz and Itnerdigital MHU) mmWave arrays.
     6
     7Array parameters:
     8
     9* Name
     10* Number of antenna elements
     11* TX/RX
     12* Polarization
     13* Number of ICs
     14*
     15
     16==== Connect
     17
     18Connect to the array and initialize it.
     19
     20{{{
     21<service name="connect">
     22<info>Connect to the array</info>
     23<args>
     24<arg isRequired="true" name="dev_name">
     25<info>Device name; choices are: ['rfdev4-in1.sb1.cosmos-lab.org', 'rfdev4-in2.sb1.cosmos-lab.org', 'rfdev2-1.sb2.cosmos-lab.org', 'rfdev2-2.sb2.cosmos-lab.org']</info>
     26</arg>
     27<arg isRequired="false" name="ics">
     28<info>PAAM ICs; choices are: ['all', '0', '1', '2', '3'] (default=all)</info>
     29</arg>
     30<arg isRequired="false" name="num_elements">
     31<info>Number of Antenna Elements; 1 to 16 (default=1)</info>
     32</arg>
     33<arg isRequired="false" name="txrx">
     34<info>TX/RX Mode Selection! Should be either tx (transmit) or rx (receive) (default=tx)</info>
     35</arg>
     36<arg isRequired="false" name="pol">
     37<info>Polarization! Should be either h (horizontal) or v (vertical) (default=v)</info>
     38</arg>
     39<arg isRequired="false" name="verify">
     40<info>Verification (boolean flag); Should be true/false (default=False)</info>
     41</arg>
     42</args>
     43</service>
     44}}}
     45
     46==== Disconnect
     47
     48Disconnect the array from the control
     49
     50{{{
     51<info>Disconnect from the array</info>
     52<args>
     53<arg isRequired="true" name="dev_name">
     54<info>Device name; choices are: ['rfdev4-in1.sb1.cosmos-lab.org', 'rfdev4-in2.sb1.cosmos-lab.org', 'rfdev2-1.sb2.cosmos-lab.org', 'rfdev2-2.sb2.cosmos-lab.org']</info>
     55</arg>
     56</args>
     57</service>
     58}}}
     59
     60==== Steer
     61
     62{{{
     63<service name="steer">
     64<info>Steer the array beam</info>
     65<args>
     66<arg isRequired="true" name="dev_name">
     67<info>Device name; choices are: ['rfdev4-in1.sb1.cosmos-lab.org', 'rfdev4-in2.sb1.cosmos-lab.org', 'rfdev2-1.sb2.cosmos-lab.org', 'rfdev2-2.sb2.cosmos-lab.org']</info>
     68</arg>
     69<arg isRequired="True" name="theta">
     70<info>Theta (Beam) Angle! Integer in range -60 to 60 (default=10)</info>
     71</arg>
     72<arg isRequired="True" name="phi">
     73<info>Phi (Beam) Angle! Integer in range -10 to 10 (default=10)</info>
     74</arg>
     75</args>
     76</service>
     77}}}
     78
     79==== Status
     80{{{
     81<service name="status">
     82<info>Get the status of the array</info>
     83<args>
     84<arg isRequired="true" name="dev_name">
     85<info>Device name; choices are: ['rfdev4-in1.sb1.cosmos-lab.org', 'rfdev4-in2.sb1.cosmos-lab.org', 'rfdev2-1.sb2.cosmos-lab.org', 'rfdev2-2.sb2.cosmos-lab.org']</info>
     86</arg>
     87</args>
     88</service>
     89}}}
     90
     91==== Cleanup
     92
     93{{{
     94<service name="cleanup">
     95<info>Cleanup and shutdown the array</info>
     96<args>
     97<arg isRequired="true" name="dev_name">
     98<info>Device name; choices are: ['rfdev4-in1.sb1.cosmos-lab.org', 'rfdev4-in2.sb1.cosmos-lab.org', 'rfdev2-1.sb2.cosmos-lab.org', 'rfdev2-2.sb2.cosmos-lab.org']</info>
     99</arg>
     100</args>
     101</service>
     102}}}
     103
     104==== Configure
     105{{{
     106<service name="configure">
     107<info>Configure the array</info>
     108<args>
     109<arg isRequired="true" name="dev_name">
     110<info>Device name; choices are: ['rfdev4-in1.sb1.cosmos-lab.org', 'rfdev4-in2.sb1.cosmos-lab.org', 'rfdev2-1.sb2.cosmos-lab.org', 'rfdev2-2.sb2.cosmos-lab.org']</info>
     111</arg>
     112<arg isRequired="false" name="ics">
     113<info>PAAM ICs; choices are: ['all', '0', '1', '2', '3'] (default=all)</info>
     114</arg>
     115<arg isRequired="false" name="num_elements">
     116<info>Number of Antenna Elements; 1 to 16 (default=1)</info>
     117</arg>
     118<arg isRequired="false" name="txrx">
     119<info>TX/RX Mode Selection! Should be either tx (transmit) or rx (receive) (default=tx)</info>
     120</arg>
     121<arg isRequired="false" name="pol">
     122<info>Polarization! Should be either h (horizontal) or v (vertical) (default=v)</info>
     123</arg>
     124<arg isRequired="false" name="theta">
     125<info>Theta (Beam) Angle! Integer in range -60 to 60 (default=10)</info>
     126</arg>
     127<arg isRequired="false" name="phi">
     128<info>Phi (Beam) Angle! Integer in range -10 to 10 (default=10)</info>
     129</arg>
     130<arg isRequired="false" name="verify">
     131<info>Verification (boolean flag); Should be true/false (default=False)</info>
     132</arg>
     133</args>
     134</service>
     135}}}
     136
     137==== Examples
     138
     139===== Single command/static array operation
     140
     141{{{
     142omf tell -a on -t rfdev4-in1.sb1.cosmos-lab.org
     143wget "http:5054/array_mgmt/configure\?dev_name=rfdev4-in1.sb1.cosmos-lab.org\&theta=16"
     144}}}
     145
     146This will set the antenna array in corner 1 with all 4 ICs each with 1 element and vertically polarized in TX mode with phi angle at (default) 10 degrees and theta angle at 16 degrees
     147
     148===== Resetting the array and turning it off
     149
     150{{{
     151wget "http:5054/array_mgmt/cleanup\?dev_name=rfdev4-in2.sb1.cosmos-lab.org"
     152omf tell -a offh -t rfdev4-in2.sb1.cosmos-lab.org
     153}}}
     154
     155
     156===== Dynamic array management
     157
     158{{{
     159omf tell -a on -t rfdev4-in1.sb1.cosmos-lab.org
     160wget "http:5054/array_mgmt/connect\?dev_name=rfdev4-in1.sb1.cosmos-lab.org"
     161...
     162wget "http:5054/array_mgmt/steer\?dev_name=rfdev4-in1.sb1.cosmos-lab.org\&theta=11\&phi=10"
     163...
     164wget "http:5054/array_mgmt/steer\?dev_name=rfdev4-in1.sb1.cosmos-lab.org\&theta=16\&phi=8"
     165...
     166wget "http:5054/array_mgmt/steer\?dev_name=rfdev4-in1.sb1.cosmos-lab.org\&theta=22\&phi=0"
     167...
     168wget "http:5054/array_mgmt/disconnect\?dev_name=rfdev4-in1.sb1.cosmos-lab.org"
     169...
     170wget "http:5054/array_mgmt/cleanup\?dev_name=rfdev4-in1.sb1.cosmos-lab.org"
     171omf tell -a offh -t rfdev4-in1.sb1.cosmos-lab.org
     172}}}