SKA Low CBF

Documentation Status

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 run git 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.

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