SKA CSP Sub-element ObsDevice

CspSubElementObsDevice

General observing device for SKA CSP Subelement.

class ska_tango_base.CspSubElementObsDevice(*args, **kwargs)

General observing device for SKA CSP Subelement.

Properties:

  • Device Property
    DeviceID
    • Identification number of the observing device.
    • Type:’DevUShort’
Abort()

Abort the current observing process and move the device to ABORTED obsState.

Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
class AbortCommand(target, state_model, logger=None)

A class for the CspSubElementObsDevices’s Abort command.

do()

Stateless hook for Abort() command functionality.

Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
ConfigureScan(argin)

Configure the observing device parameters for the current scan.

Parameters:argin ('DevString') – JSON formatted string with the scan configuration.
Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
class ConfigureScanCommand(target, state_model, logger=None)

A class for the CspSubElementObsDevices’s ConfigureScan command.

do(argin)

Stateless hook for ConfigureScan() command functionality.

Parameters:argin (str) – The configuration as JSON formatted string
Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
Raises:CommandError if the configuration data validation fails.
validate_input(argin)

Validate the configuration parameters against allowed values, as needed.

Parameters:argin ('DevString') – The JSON formatted string with configuration for the device.
Returns:A tuple containing a return code and a string message.
Return type:(ResultCode, str)
DeviceID

Used by autodoc_mock_imports.

EndScan()

End a running scan.

Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
class EndScanCommand(target, state_model, logger=None)

A class for the CspSubElementObsDevices’s EndScan command.

do()

Stateless hook for EndScan() command functionality.

Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
GoToIdle()

Transit the device from READY to IDLE obsState.

Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
class GoToIdleCommand(target, state_model, logger=None)

A class for the CspSubElementObsDevices’s GoToIdle command.

do()

Stateless hook for GoToIdle() command functionality.

Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
class InitCommand(target, state_model, logger=None)

A class for the CspSubElementObsDevice’s init_device() “command”.

do()

Stateless hook for device initialisation.

Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
ObsReset()

Reset the observing device from a FAULT/ABORTED obsState to IDLE.

Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
class ObsResetCommand(target, state_model, logger=None)

A class for the CspSubElementObsDevices’s ObsReset command.

do()

Stateless hook for ObsReset() command functionality.

Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
Scan(argin)

Start an observing scan.

Parameters:argin ('DevString') – A string with the scan ID
Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
class ScanCommand(target, state_model, logger=None)

A class for the CspSubElementObsDevices’s Scan command.

do(argin)

Stateless hook for Scan() command functionality.

Parameters:argin (str) – The scan ID.
Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
validate_input(argin)

Validate the command input argument.

Parameters:argin (string) – the scan id
Returns:A tuple containing a return code and a string message indicating status. The message is for information purpose only.
Return type:(ResultCode, str)
always_executed_hook()

Method always executed before any TANGO command is executed.

configurationID

Used by autodoc_mock_imports.

delete_device()

Hook to delete resources allocated in init_device.

This method allows for any memory or other resources allocated in the init_device method to be released. This method is called by the device destructor and by the device Init command.

deviceID

Used by autodoc_mock_imports.

healthFailureMessage

Used by autodoc_mock_imports.

init_command_objects()

Sets up the command objects

lastScanConfiguration

Used by autodoc_mock_imports.

read_configurationID()

Return the configurationID attribute.

read_deviceID()

Return the deviceID attribute.

read_healthFailureMessage()

Return the healthFailureMessage attribute.

read_lastScanConfiguration()

Return the lastScanConfiguration attribute.

read_scanID()

Return the scanID attribute.

read_sdpDestinationAddresses()

Return the sdpDestinationAddresses attribute.

read_sdpLinkActive()

Return the sdpLinkActive attribute.

read_sdpLinkCapacity()

Return the sdpLinkCapacity attribute.

scanID

Used by autodoc_mock_imports.

sdpDestinationAddresses

Used by autodoc_mock_imports.

sdpLinkActive

Used by autodoc_mock_imports.

sdpLinkCapacity

Used by autodoc_mock_imports.

Instance attributes

Here it is reported the list of the instance attributes.

  • scan_id: the identification number of the scan.
    The scan ID is passed as argument of the Scan command.
    The attribute value is reported via TANGO attribute scanID.

  • _sdp_addresses: a python dictionary with the SDP destination addresses for the output products.
    Depending on the sub-element (CBF, PSS, PST) this attribute can specify more than one destination address, as for example in CBF sub-element.
    The SDP destination addresses are specified at configuration. An SDP address specifies the MAC address, IP address and port of the endpoint.
    Below an example of how SDP addresses are specified in a Mid CBF configuration:

    {
  ...
  "outputHost": [[0, "192.168.0.1"], [8184, "192.168.0.2"]],
  "outputMac": [[0, "06-00-00-00-00-01"]],
  "outputPort": [[0, 9000, 1], [8184, 9000, 1]]
  ...
}

    The value of this attribute is reported via the TANGO sdpDestionationAddresses attribute.

    Note

    Not all the Sub-element observing devices are connected to the SDP (for example Mid VCCs).

  • _sdp_links_active: a python list of boolean. Each list element reports the network connectivity of the corresponding link to SDP.

  • _sdp_links_capacity: this attribute records the capacity in GB/s of the SDP link.

  • _config_id: it stores the unique identificator associated to a JSON scan configuration.
    The value of this attribute is reported via the TANGO attriute configID.

  • _last_scan_configuration: this attribute stores the last configuration successully programmed.
    The value is reported via the TANGO attribute lastScanConfiguration.

  • _health_failure_msg: The value is reported via the TANGO attribute healthFailureMesssage.