.. _configurelow:

=================
Configure
=================

1. TMC SDP Leaf node provides API for **Configure workflow**.

2. The TMC SDP Leaf node **accepts** the command if:

   a. Operational **state** of the TMC SDP Leaf node is **ON, OFF, INIT, STANDBY**, or **ALARM**.

3. The TMC SDP Leaf node **rejects** the command if:

   a. Operational **state** of the TMC SDP Leaf node is **FAULT** or **UNKNOWN**.

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

   a. SDP Subarray is in observation state **IDLE** or **READY**.

   b. SDP Subarray node is :term:`available`.

5. The **command execution** involves the following **key operations**:

   a. The input JSON is **validated** to ensure required fields like interface **version** and **scan type** are present and properly formatted. If not, the command is failed with an exception message.

   b. The command is invoked on the SDP Subarray.

      i. If the SDP Subarray raises an **exception**, command failure is reported as **RESULT_CODE - FAILED** on the **Long Running Command Result** attribute of the TMC SDP Leaf node.

      ii. If the SDP Subarray **accepts** the command, the TMC TMC SDP Leaf node will wait for command completion.

6. The TMC SDP Leaf node **monitors the progress** of the command via the SDP Subarray node **ObsState transitions** and the **Long Running Command Results**.

   a. Command is **successful** when the SDP Subarray Node transitions to **READY** ObsState. This is reported as **RESULT_CODE - OK** on the **Long Running Command Result** attribute of the TMC SDP Subarray Leaf Node.

   b. Command **failure** is reported in any of the following cases as **RESULT_CODE - FAILED** on the **Long Running Command Result** attribute of the TMC SDP Subarray Leaf Node:

      i. The SDP Subarray reports an **error event** when the command is invoked.

      ii. The command **times out** if the SDP Subarray Node **does not transition** to **READY** within the timeout period specified by the CommandTimeOutDefault property in the Helm chart of the TMC SDP Leaf node.

7. Input JSON to the SDP Subarray must conform to the schema detailed at:

   https://developer.skao.int/projects/ska-telmodel/en/latest/schemas/sdp/ska-sdp-configure.html