Configure

  1. CSP Leaf Node provides API for Configure workflow.

  2. The CSP Leaf Node accepts the command if :-

    1. Operational state of the CSP Leaf node is ON/OFF/INIT/STANDBY/ALARM

    2. CSP Subarray is responsive.

  3. The CSP Leaf Node rejects the command if :-

    1. Operational state of CSP Leaf node is FAULT/UNKNOWN/DISABLE .

    2. CSP Subarray is not responsive.

  4. The following state requirements are applied for the command execution :-

    1. CSP Subarray is in ‘observation state’ READY or IDLE .

    2. CSP Subarray node is available .

  5. The command execution involves below key operations :-

    1. Any existing delay threads are stopped

    2. Delay model attribute value is reinitialized to initial default value then progressively updated by running delay threads using timing cadence.

      • Delay is calculated for mid-cbf timings beams.

      • Please refer - Delay Calculation in TMC for detailed view of delay calculation

    3. Configuration parameters related to assigned resources such as :-

      • Create Katpoint Antenna objects from antenna params

      • Update assigned_receptors to be passed on to Katpoint DelayCorrection

    4. From input JSON “pointing” section is removed before sending command to CSP Subarray.

    5. The command is then invoked on the CSP Subarray.

      • If CSP Subarray raises exception , command failure is reported as ‘RESULT_CODE - FAILED’ on Long Running Command Result attribute of the CSP leaf node.

      • If CSP Subarray accept command , the TMC CSP leaf node will wait for command completion.

  6. The CSP leaf node monitors the progress of command via the CSP sub-array node ObsState transitions and the long running command results.

    1. Command is successful when the CSP Subarray Node transitions to READY ObsState. This is reported as ‘RESULT_CODE - OK’ on Long Running Command Result attribute of the TMC CSP Subarray node.

    2. Command failure is reported in any of the below cases as ‘RESULT_CODE - FAILED’ on Long Running Command Result attribute of the TMC CSP Subarray leaf node.

      • The CSP Subarray reports ‘RESULT_CODE - FAILED’ on its Long Running Command Result attribute

      • The command times out if CSP SubarrayNode does not transition to READY within the timeout period specified by CommandTimeOutDefault property specified in helm chart of the CSP Leaf Node .

  7. Input JSON to CSP Subarray is as per schema detailed at - https://developer.skao.int/projects/ska-schemas/en/latest/schemas/csp/mid/configure/index.html