LowTmcSubarray Tango Device

Provides the monitoring and control interface required by users as well as other TM Components (such as OET, Central Node) for a Subarray.

Device Properties
MccsSubarrayLNFQDN:

This property contains the FQDN of the MCCS Subarray Leaf Node associated with the Subarray Node.

MccsSubarrayFQDN:

This property contains the FQDN of the MCCS Subarray associated with the Subarray Node.

Device Attributes

Properties

LowTmcSubarray.AbortCommandTimeOut
Data type

DevUShort

Default value

40

LowTmcSubarray.CapabilityTypes
Data type

DevVarStringArray

LowTmcSubarray.CommandTimeOutDefault
Data type

DevFloat

Default value

30

LowTmcSubarray.CspAssignResourcesInterfaceURL

This property contains the interface URL of theCSP sub-system for AssignResources command

Data type

DevString

LowTmcSubarray.CspScanInterfaceURL

This property contains the interface URL of theCSP sub-system for Scan command

Data type

DevString

LowTmcSubarray.CspSubarrayFQDN

This property contains the FQDN of the CSP Subarrayassociated with the Subarray Node.

Data type

DevString

LowTmcSubarray.CspSubarrayLNFQDN

This property contains the FQDN of the CSP Subarray Leaf Nodeassociated with the Subarray Node.

Data type

DevString

LowTmcSubarray.DevFamily
Data type

DevString

Default value

leaf-node

LowTmcSubarray.EventSubscriptionCheckPeriod
Data type

DevFloat

Default value

1

LowTmcSubarray.GroupDefinitions
Data type

DevVarStringArray

LowTmcSubarray.IsAutoRecoveryEnabled
Data type

DevBoolean

LowTmcSubarray.JonesURI

This property contains URI for Jones

Data type

DevString

LowTmcSubarray.LivelinessCheckPeriod
Data type

DevFloat

Default value

1

LowTmcSubarray.LoggingLevelDefault
Data type

DevUShort

Default value

4

LowTmcSubarray.LoggingTargetsDefault
Data type

DevVarStringArray

Default value

[‘tango::logger’]

LowTmcSubarray.MCCSControllerFQDN

This property contains the FQDN of the MCCSController associated with the Subarray Node.

Data type

DevString

LowTmcSubarray.MccsConfigureInterfaceURL

This property contains the interface URL of theMCCS sub-system for Configure command

Data type

DevString

Default value

https://schema.skao.int/ska-low-mccs-configure/1.0

LowTmcSubarray.MccsMasterLNFQDN

This property contains the FQDN of the MCCSMaster Leaf Node associated with the Subarray Node.

Data type

DevString

LowTmcSubarray.MccsReleaseInterfaceURL

This property contains the interface URL of theMCCS sub-system for Release command

Data type

DevString

LowTmcSubarray.MccsScanInterfaceURL

This property contains the interface URL of theMCCS sub-system for Scan command

Data type

DevString

Default value

https://schema.skao.int/ska-low-mccs-scan/3.0

LowTmcSubarray.MccsSubarrayFQDN

This property contains the FQDN of theMCCS Subarray associated with the Subarray Node.

Data type

DevString

LowTmcSubarray.MccsSubarrayLNFQDN

This property contains the FQDN of the MCCSSubarray Leaf Node associated with the Subarray Node.

Data type

DevString

LowTmcSubarray.PreRecoveryCheckTimeDuration

Time duration for subsystems to reach to stableobservation states before auto recovery

Data type

DevDouble

Default value

1.0

LowTmcSubarray.ProxyTimeout
Data type

DevUShort

Default value

500

LowTmcSubarray.ScanStartTimeEnabled

Flag to control start_time key injection in Scan cmd interface

Data type

DevBoolean

LowTmcSubarray.SdpScanInterfaceURL

This property contains the interface URL of theSDP sub-system for Scan command

Data type

DevString

LowTmcSubarray.SdpSubarrayFQDN

This property contains the FQDN of the SDP Subarrayassociated with the Subarray Node.

Data type

DevString

LowTmcSubarray.SdpSubarrayLNFQDN

This property contains the FQDN of the SDP Subarray Leaf Nodeassociated with the Subarray Node.

Data type

DevString

LowTmcSubarray.SkaLevel
Data type

DevShort

Default value

4

LowTmcSubarray.SubID
Data type

DevString

LowTmcSubarray.TelmodelPath

Telmodel path for array layout.

Data type

DevString

LowTmcSubarray.TelmodelSource

Telmodel source for array layout.

Data type

DevString

Attributes

LowTmcSubarray.State

The operational state of the device as enumeration.

Access

READ

Data type

DevState

Data format

SCALAR

LowTmcSubarray.Status

More detailed textual information about the device’s status.

Access

READ

Data type

DevString

Data format

SCALAR

LowTmcSubarray.activationTime

The time of activation in seconds since Unix epoch.

Access

READ

Data type

DevDouble

Data format

SCALAR

Unit

s

LowTmcSubarray.adminMode

The Admin Mode of the device. It may interpret the current device condition and condition of all managed devices to set this. Most possibly an aggregate attribute.

Access

READ_WRITE

Data type

DevEnum

Data format

SCALAR

LowTmcSubarray.arrayLayoutUrl

Get the memorized Array Layout URI.

Access

READ_WRITE

Data type

DevString

Data format

SCALAR

LowTmcSubarray.assignedResources

Expose a signal as a Tango attribute.

Access

READ

Data type

DevString

Data format

SPECTRUM

Max_dim_x

1024

LowTmcSubarray.buildState

Read the Build State of the device.

Returns

the build state of the device

Access

READ

Data type

DevString

Data format

SCALAR

LowTmcSubarray.commandFailureInfo

Information about command failure

Access

READ

Data type

DevString

Data format

SCALAR

LowTmcSubarray.commandTimeOut

Command execution time limit.

Access

READ_WRITE

Data type

DevUShort

Data format

SCALAR

LowTmcSubarray.commandedObsState

The last commanded stable Observation State of the device.

Initial value is EMPTY. The only stable states it can change to are EMPTY, IDLE, READY or ABORTED, following the start of any state transition command.

Access

READ

Data type

DevEnum

Data format

SCALAR

LowTmcSubarray.commandedState

The last commanded Operating State of the device. Initial string is “None”. Only other strings it can change to is “OFF”, “STANDBY” or “ON”, following the Off(), Standby() or On() commands. If the state transition commands are long running commands the commanded state will only update when the long running command starts executing.

Access

READ

Data type

DevString

Data format

SCALAR

LowTmcSubarray.configJson

Latest successful configuration json

Access

READ

Data type

DevString

Data format

SCALAR

LowTmcSubarray.configurationDelayExpected

The expected configuration delay of the device in seconds.

Access

READ

Data type

DevUShort

Data format

SCALAR

Unit

seconds

LowTmcSubarray.configurationProgress

The percentage configuration progress of the device.

Access

READ

Data type

DevUShort

Data format

SCALAR

Unit

%

LowTmcSubarray.configuredCapabilities

The cabailities configured in the device.

For example, [“Correlators:512”, “PssBeams:4”, “PstBeams:4”, “VlbiBeams:0”].

Access

READ

Data type

DevString

Data format

SPECTRUM

Max_dim_x

10

LowTmcSubarray.controlMode

The control mode of the device are REMOTE, LOCAL Tango Device accepts only from a ‘local’ client and ignores commands and queries received from TM or any other ‘remote’ clients. The Local clients has to release LOCAL control before REMOTE clients can take control again.

Access

READ_WRITE

Data type

DevEnum

Data format

SCALAR

LowTmcSubarray.healthInfo

Expose a signal as a Tango attribute.

Access

READ

Data type

DevString

Data format

SCALAR

LowTmcSubarray.healthState

Read the Health State of the device. It interprets the current device condition and condition of all managed devices to set this. Most possibly an aggregate attribute.

Access

READ

Data type

DevEnum

Data format

SCALAR

LowTmcSubarray.internalModel

Json String representing the entire internal model.

Access

READ

Data type

DevString

Data format

SCALAR

LowTmcSubarray.isAdminModeEnabled

Return the isAdminModeEnabled attribute value

Returns: bool: True if the admin mode is enabled, False otherwise

Access

READ_WRITE

Data type

DevBoolean

Data format

SCALAR

LowTmcSubarray.isSubarrayAvailable

Shows aggregated value for availability on subarray device

Access

READ

Data type

DevBoolean

Data format

SCALAR

LowTmcSubarray.lastDeviceInfoChanged

Json String representing the last device info changed in the internal model.

Access

READ

Data type

DevString

Data format

SCALAR

LowTmcSubarray.loggingLevel

Read the logging level of the device.

Initialises to LoggingLevelDefault on startup. See LoggingLevel

Returns

Logging level of the device.

Access

READ_WRITE

Data type

DevEnum

Data format

SCALAR

LowTmcSubarray.loggingTargets

Read the additional logging targets of the device.

Note that this excludes the handlers provided by the ska_ser_logging library defaults - initialises to LoggingTargetsDefault on startup.

Returns

Logging level of the device.

Access

READ_WRITE

Data type

DevString

Data format

SPECTRUM

Max_dim_x

4

LowTmcSubarray.longRunningCommandIDsInQueue

Read the IDs of the long running commands in the queue.

Every client that executes a command will receive a command ID as response. Keep track of IDs currently allocated. Entries are removed self._command_tracker._removal_time seconds after they have finished.

Access

READ

Data type

DevString

Data format

SPECTRUM

Max_dim_x

66

LowTmcSubarray.longRunningCommandInProgress

Read the name(s) of the currently executing long running command(s).

Name(s) of command and possible abort in progress or empty string(s).

Access

READ

Data type

DevString

Data format

SPECTRUM

Max_dim_x

2

LowTmcSubarray.longRunningCommandProgress

Read the progress of the currently executing long running command(s).

ID, progress of the currently executing command(s). Clients can subscribe to on_change event and wait for the ID they are interested in.

Access

READ

Data type

DevString

Data format

SPECTRUM

Max_dim_x

4

LowTmcSubarray.longRunningCommandResult

Read the result of the completed long running command.

Reports unique_id, json-encoded result. Clients can subscribe to on_change event and wait for the ID they are interested in.

Access

READ

Data type

DevString

Data format

SPECTRUM

Max_dim_x

2

LowTmcSubarray.longRunningCommandStatus

Read the status of the currently executing long running commands.

ID, status pairs of the currently executing commands. Clients can subscribe to on_change event and wait for the ID they are interested in.

Access

READ

Data type

DevString

Data format

SPECTRUM

Max_dim_x

132

LowTmcSubarray.longRunningCommandsInQueue

Read the long running commands in the queue.

Keep track of which commands are that are currently known about. Entries are removed self._command_tracker._removal_time seconds after they have finished.

Access

READ

Data type

DevString

Data format

SPECTRUM

Max_dim_x

66

LowTmcSubarray.lrcExecuting

Expose a signal as a Tango attribute.

Access

READ

Data type

DevString

Data format

SPECTRUM

Max_dim_x

2

LowTmcSubarray.lrcFinished

Expose a signal as a Tango attribute.

Access

READ

Data type

DevString

Data format

SPECTRUM

Max_dim_x

100

LowTmcSubarray.lrcProtocolVersions

Return supported protocol versions.

Returns

A tuple containing the lower and upper bounds of supported long running command protocol versions.

Access

READ

Data type

DevLong64

Data format

SPECTRUM

Max_dim_x

2

LowTmcSubarray.lrcQueue

Expose a signal as a Tango attribute.

Access

READ

Data type

DevString

Data format

SPECTRUM

Max_dim_x

32

LowTmcSubarray.obsMode

The Observation Mode of the device.

Access

READ

Data type

DevEnum

Data format

SCALAR

LowTmcSubarray.obsState

The Observation State of the device.

Access

READ

Data type

DevEnum

Data format

SCALAR

LowTmcSubarray.sbID

ID of ongoing Scheduling Block

Access

READ

Data type

DevString

Data format

SCALAR

LowTmcSubarray.scanDuration

This attribute is used for exposing the scan duration

of ongoing scan to other subsystems. Returns: float: The scan duration of the ongoing scan

Access

READ

Data type

DevDouble

Data format

SCALAR

LowTmcSubarray.scanID

ID of ongoing SCAN

Access

READ

Data type

DevString

Data format

SCALAR

LowTmcSubarray.scanStartTimeOffset

Offset for start_time for scan command in seconds.

Access

READ_WRITE

Data type

DevFloat

Data format

SCALAR

Unit

s

LowTmcSubarray.simulationMode

When TRUE the device is using a simulator

Access

READ_WRITE

Data type

DevEnum

Data format

SCALAR

LowTmcSubarray.testMode

If TEST the device is using testing logic

Access

READ_WRITE

Data type

DevEnum

Data format

SCALAR

LowTmcSubarray.transformedInternalModel

Json String representing the entire internal model transformed for better reading.

Access

READ

Data type

DevString

Data format

SCALAR

LowTmcSubarray.versionId

Read the Version Id of the device.

Returns

the version id of the device

Access

READ

Data type

DevString

Data format

SCALAR

Commands

LowTmcSubarray.Abort() DevVarLongStringArray

No input parameter (DevVoid)

Returns

information-only string

LowTmcSubarray.AbortCommands() DevVarLongStringArray

No input parameter (DevVoid)

Returns

returns (None): A tuple containing a return code and a string message indicating status. The message is for information purpose only.

LowTmcSubarray.AssignResources(DevString) DevVarLongStringArray

argin (str): the resources to be assigned

Returns

returns (None): A tuple containing a return code and a string message indicating status. The message is for information purpose only.

LowTmcSubarray.CheckLongRunningCommandStatus(DevString) DevString

command id

Returns

TaskStatus

LowTmcSubarray.Configure(DevString) DevVarLongStringArray

argin (str): configuration specification

Returns

returns (None): A tuple containing a return code and a string message indicating status. The message is for information purpose only.

LowTmcSubarray.DebugDevice() DevUShort

No input parameter (DevVoid)

Returns

The TCP port the debugger is listening on.

LowTmcSubarray.End() DevVarLongStringArray

No input parameter (DevVoid)

Returns

returns (None): A tuple containing a return code and a string message indicating status. The message is for information purpose only.

LowTmcSubarray.EndScan() DevVarLongStringArray

No input parameter (DevVoid)

Returns

returns (None): A tuple containing a return code and a string message indicating status. The message is for information purpose only.

LowTmcSubarray.GetVersionInfo() DevVarStringArray

No input parameter (DevVoid)

Returns

returns (None): The result code and the command unique ID

LowTmcSubarray.Init() DevVoid

Init

LowTmcSubarray.ObsReset() DevVarLongStringArray

No input parameter (DevVoid)

Returns

[ResultCode][message or command id]

LowTmcSubarray.Off() DevVarLongStringArray

No input parameter (DevVoid)

Returns

returns (None): A tuple containing a return code and a string message indicating status. The message is for information purpose only.

LowTmcSubarray.On() DevVarLongStringArray

No input parameter (DevVoid)

Returns

returns ((ResultCode, str)): None

LowTmcSubarray.ReleaseAllResources() DevVarLongStringArray

No input parameter (DevVoid)

Returns

returns (None): A tuple containing a return code and a string message indicating status. The message is for information purpose only.

LowTmcSubarray.ReleaseResources(DevString) DevVarLongStringArray

The resources to be released

Returns

[ResultCode][message or command id]

LowTmcSubarray.Reset() DevVarLongStringArray

No input parameter (DevVoid)

Returns

[ResultCode][message or command id]

LowTmcSubarray.Restart() DevVarLongStringArray

No input parameter (DevVoid)

Returns

returns (None): A tuple containing a return code and a string message indicating status. The message is for information purpose only.

LowTmcSubarray.Scan(DevString) DevVarLongStringArray

argin (Array of str): Information about the scan

Returns

returns (None): A tuple containing a return code and a string message indicating status. The message is for information purpose only.

LowTmcSubarray.SetAdminMode(DevString) DevVarLongStringArray

argin (str): The adminMode in json format

Returns

returns (None): A tuple containing a return code and a string message indicating status. The message is for information purpose only.

LowTmcSubarray.Standby() DevVarLongStringArray

No input parameter (DevVoid)

Returns

returns (None): A tuple containing a return code and a string message indicating status. The message is for information purpose only.