SKA Low CBF¶
TANGO device servers that perform monitor and control functions for the SKA-Low telescope’s Correlator and Beam-Former.
Developer’s Guide¶
The Makefiles here are inherited from ska-cicd-makefile.
Refer to docs at that repo, or use
make help
for details.This link is via a git submodule, so use the
--recursive
flag when cloning this repository, or rungit submodule update --init --recursive
afterwards.
A pre-commit config is provided to try and format your code before it gets rejected by the CI pipeline lint checkers.
Install pre-commit -
pip3 install pre-commit
Activate the pre-commit checks for the repo -
pre-commit install
From now on your commits will be formatted automatically. Note that you have to add & commit again any files changed by pre-commit.
Tests¶
tests/unit
contains tests for our ‘business logic’ (the non-Tango code), as well as basic Tango device tests that don’t need to interact with other devices. Allocation algorithm tests print some debug files:Allocation visualisations in files dbg-alloc …
Switch routing table entries for LFAA->Alveo routes in files rules- …
Switch routing table entries for Alveo->PST server in files rules-pst …
VCT table entries for each used alveo in files vct_ …
tests/integration
contains tests that involve interaction between multiple Tango devices.To this end, the LowCbfProcessor Tango device is deployed as part of the Helm charts. Its code resides in ska-low-cbf-proc.
Changelog¶
(Unreleased Changes)¶
Various edits to improve lint score (shouldn’t change operation…)
0.5.3¶
Subarray: Update attribute names used on Processor device
Allocation Algorithm
calculate routes from LFAA to FPGAs and from FPGAs to PST
calculate virtual channel tables
0.5.2¶
Allocation Algorithm can report allocated FPGAs for a subarray
Allocator device RequestAllocation command return value is derived from allocation (Processor devices only)
A very rough implementation, needs work on mapping ID to FQDN
0.5.1¶
Add tests for Allocator device
test-parent chart: add ska-low-cbf-proc chart, for integration tests
0.5.0¶
Allocator TANGO device created
RequestAllocation
return value is hard-coded
Subarray passes on information from resource assignment requests to Allocator, expects to receive details of assigned Processor devices in response
0.4.0¶
Subarray can assign (hard-coded) Processor resource for 1 PST beam and turn on PSR test packet generation
0.3.4¶
Move FPGA-related code to ska-low-cbf-proc