diff --git a/docs/source/devices/sdp.rst b/docs/source/devices/sdp.rst index c4d4032f47e7e4988437adb54dc7778bd53dc4b1..2ca1ea6fa95e7295a21041d12242e15cec3b8001 100644 --- a/docs/source/devices/sdp.rst +++ b/docs/source/devices/sdp.rst @@ -62,6 +62,8 @@ Waveform Generator The antenna input of SDP can be replaced by an internal waveform generator for debugging and testing purposes. The generator is configured per antenna per FPGA: +.. note:: The Waveform Generator needs to be toggled off and on using ``FPGA_wg_enable_RW`` for new settings to become active on the station. + :FPGA_wg_enable_RW: Whether the waveform generator is enabled for each input. :type: ``bool[N_fpgas][N_ants_per_fpga]`` @@ -91,5 +93,6 @@ For example, the following code inserts a wave on LBA subband 102 on FPGAs 8 - 1 sdp.FPGA_wg_amplitude_RW = [[0.1] * 12] * 16 sdp.FPGA_wg_frequency_RW = [[102 * 200e6/1024] * 12] * 16 - # enable waveform generator + # toggle and enable waveform generator + sdp.FPGA_wg_enable_RW = [[False] * 12] * 16 sdp.FPGA_wg_enable_RW = [[True] * 12] * 16 diff --git a/docs/source/devices/sst-xst.rst b/docs/source/devices/sst-xst.rst index 092bdda832eb0493f93956f4aec8025410d0bf9b..cce03f691cc488c8c06d8910db9f3bd8da63a828 100644 --- a/docs/source/devices/sst-xst.rst +++ b/docs/source/devices/sst-xst.rst @@ -8,6 +8,8 @@ The statistics are exposed in two ways, as: - *Attributes*, representing the most recently received values, - *TCP stream*, to allow the capture and recording of the statistics over any period of time. +If the statistics are not received or zero, see :ref:`statistics-debugging`. + See the following links for a full description of the SST and XST monitoring and control points: - https://support.astron.nl/confluence/pages/viewpage.action?spaceKey=L2M&title=L2+STAT+Decision%3A+SC+-+SDP+OPC-UA+interface @@ -76,6 +78,25 @@ Conversely, to calculate the block index for an antenna pair ``(a,b)``, use:: def block_nr(a: int, b: int) -> int: return baseline_index(a // 12, b // 12) +Configuring the XSTs +````````````````````````````` + +The XSTs can be configured with several settings: + +.. note:: The XST processing needs to be toggled off and on using ``FPGA_xst_processing_enable_RW`` for new settings to become active on the station. + +:FPGA_xst_processing_enable_RW: Whether XSTs are computed on each FPGA. + + :type: ``bool[N_fpgas]`` + +:FPGA_xst_integration_interval_RW: The time interval to integrate over, per FPGA, in seconds. + + :type: ``float[N_fpgas]`` + +:FPGA_xst_subband_select_RW: The subband to cross correlate, per FPGA. Note: only the entries ``[x][1]`` should be set, the rest should be zero. + + :type: ``uint32[N_fpgas][8]`` + Subscribe to statistics streams ---------------------------------