$ rspctl --statistics=beamlet
or array covariance matrix at a selected subband with
$ rspctl --xcsubband= rspctl --xcstatistics.
The above commands also allow the signal statistics to be recorded in files. Users who want to send raw beamlet data to CEP or some other network device can switch the UDP data stream off/on and query its status with
$ rspctl --datastream[=0|1|2|3].
Only the options 0 (off) and 1 (on) are used in international stations. The options 2 and 3 are used in core stations, where the ring of RSP boards can be split in two halves, and data output from both of these need to be controlled separately.
If the user wants to use the receivers without forming beams, they need to be started manually with a couple of rspctl commands. In order to guarantee that the beam server does not reset the user-defined settings, one should begin with switching to software level 2, which disables the beam server,
$ swlevel 2
and then wait for register update, i.e. wait until the output of
$ rspctl --regstat
consists only of the characters ’*’ and ’.’.
The current receiver mode can be queried with
$ rspctl --rcu
If one wants to switch to one of the receiver modes 1 – 4, the mode can be changed with
$ rspctl --rcumode=1|2|3|4
Do not use the command rspctl –rcumode=5|6|7! This command will switch on the 48 V power supply of all HBA tiles simultaneously. The resulting rush-in current drawn from the station power supply drops its voltage down to 44 V which, in turn, causes freezing RSP boards. In order to switch to the higher receiver modes, which use the HBA array, one should use the script poweruphba.sh 5|6|7, which performs the startup slowly enough to maintain a high enough voltage. The script should be available at all stations.
After the previous commands the receivers are running in correct mode, but the data stream from the receivers to the RSP boards still needs to be started with
$ rspctl --rcuenable[=1|0]
If running in receiver mode 5, the received spectrum will be inverted, and one might be interested in inverting it back with
$ rspctl –specinv=[1|0]
Notice that this command is not needed if the receiver mode is selected with beamctl, which automatically inverts the spectrum if receiver mode 5 is selected.
After these commands one can check that the system is running properly with the commands
$ rspctl --rcu
$ rspctl --status
$ rspctl --statistics
The rspctl command allows the user to set and query numerous parameters.
Back to the I-LOFAR User’s Guide