DSManager Tango Device

The Dish Structure Manager.

Properties

DSCFqdn

Data type:: DevString
Default value:: opc.tcp://ds-opcua-server-simulator-001-svc:4840/dish-structure/server/

DSNodeTreesToMonitor

Data type:: DevString
Default value:: Azimuth, CommandArbiter, Elevation, FeedIndexer, Management, Pointing, Safety, Time_cds, Tracking

DSOPCUANamespace

Data type:: DevString
Default value:: http://skao.int/DS_ICD/

GroupDefinitions

Data type:: DevVarStringArray

LoggingLevelDefault

Data type:: DevUShort
Default value:: 4

LoggingTargetsDefault

Data type:: DevVarStringArray
Default value:: [‘tango::logger’]

SkaLevel

Data type:: DevShort
Default value:: 4

Attributes

State

The operational state of the device as enumeration.

Access:: READ
Data type:: DevState
Data format:: SCALAR

Status

More detailed textual information about the device’s status.

Access:: READ
Data type:: DevString
Data format:: SCALAR

achievedPointing

[0] Timestamp [1] Azimuth [2] Elevation

Access:: READ
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 3

achievedTargetLock

Indicate Actual “On Sky” rms tracking error of device.

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

actStaticOffsetValueEl

Actual elevation static offset (arcsec)

Access:: READ
Data type:: DevDouble
Data format:: SCALAR

actStaticOffsetValueXel

Actual cross-elevation static offset (arcsec)

Access:: READ
Data type:: DevDouble
Data format:: SCALAR

adminMode

Read 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

ambTOnInput

Value to be used for AmbTOn when the next pointing model is applied. Setting this to True will enable ambient temperature corrections.

Access:: READ_WRITE
Data type:: DevBoolean
Data format:: SCALAR

applicationState

Reflect the Application State node’s state.

Access:: READ
Data type:: DevEnum
Data format:: SCALAR

azimuthSpeed

Sets the Azimuth rotation speed during slew in degrees per second.

Access:: READ_WRITE
Data type:: DevDouble
Data format:: SCALAR

band0PointingModelParams

Parameters for (local) Band 0 pointing models used by Dish to do pointing corrections.

When writing to this attribute, the selected band for correction will be set to B1.

Band pointing model parameters are: [0] IA, [1] CA, [2] NPAE, [3] AN, [4] AN0, [5] AW, [6] AW0, [7] ACEC, [8] ACES, [9] ABA, [10] ABphi, [11] IE, [12] ECEC, [13] ECES, [14] HECE4, [15] HESE4, [16] HECE8, [17] HESE8

Access:: READ_WRITE
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 18

band1PointingModelParams

Parameters for (local) Band 1 pointing models used by Dish to do pointing corrections.

When writing to this attribute, the selected band for correction will be set to B1.

Band pointing model parameters are: [0] IA, [1] CA, [2] NPAE, [3] AN, [4] AN0, [5] AW, [6] AW0, [7] ACEC, [8] ACES, [9] ABA, [10] ABphi, [11] IE, [12] ECEC, [13] ECES, [14] HECE4, [15] HESE4, [16] HECE8, [17] HESE8

Access:: READ_WRITE
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 18

band2PointingModelParams

Parameters for (local) Band 2 pointing models used by Dish to do pointing corrections.

When writing to this attribute, the selected band for correction will be set to B2.

Band pointing model parameters are: [0] IA, [1] CA, [2] NPAE, [3] AN, [4] AN0, [5] AW, [6] AW0, [7] ACEC, [8] ACES, [9] ABA, [10] ABphi, [11] IE, [12] ECEC, [13] ECES, [14] HECE4, [15] HESE4, [16] HECE8, [17] HESE8

Access:: READ_WRITE
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 18

band3PointingModelParams

Parameters for (local) Band 3 pointing models used by Dish to do pointing corrections.

When writing to this attribute, the selected band for correction will be set to B3.

Band pointing model parameters are: [0] IA, [1] CA, [2] NPAE, [3] AN, [4] AN0, [5] AW, [6] AW0, [7] ACEC, [8] ACES, [9] ABA, [10] ABphi, [11] IE, [12] ECEC, [13] ECES, [14] HECE4, [15] HESE4, [16] HECE8, [17] HESE8

Access:: READ_WRITE
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 18

band4PointingModelParams

Parameters for (local) Band 4 pointing models used by Dish to do pointing corrections.

When writing to this attribute, the selected band for correction will be set to B4.

Band pointing model parameters are: [0] IA, [1] CA, [2] NPAE, [3] AN, [4] AN0, [5] AW, [6] AW0, [7] ACEC, [8] ACES, [9] ABA, [10] ABphi, [11] IE, [12] ECEC, [13] ECES, [14] HECE4, [15] HESE4, [16] HECE8, [17] HESE8

Access:: READ_WRITE
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 18

band5aPointingModelParams

Parameters for (local) Band 5a pointing models used by Dish to do pointing corrections.

When writing to this attribute, the selected band for correction will be set to B5a.

Band pointing model parameters are: [0] IA, [1] CA, [2] NPAE, [3] AN, [4] AN0, [5] AW, [6] AW0, [7] ACEC, [8] ACES, [9] ABA, [10] ABphi, [11] IE, [12] ECEC, [13] ECES, [14] HECE4, [15] HESE4, [16] HECE8, [17] HESE8

Access:: READ_WRITE
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 18

band5bPointingModelParams

Parameters for (local) Band 5b pointing models used by Dish to do pointing corrections.

When writing to this attribute, the selected band for correction will be set to B5b.

Band pointing model parameters are: [0] IA, [1] CA, [2] NPAE, [3] AN, [4] AN0, [5] AW, [6] AW0, [7] ACEC, [8] ACES, [9] ABA, [10] ABphi, [11] IE, [12] ECEC, [13] ECES, [14] HECE4, [15] HESE4, [16] HECE8, [17] HESE8

Access:: READ_WRITE
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 18

band6PointingModelParams

Parameters for (local) Band 6 pointing models used by Dish to do pointing corrections.

When writing to this attribute, the selected band for correction will be set to B6.

Band pointing model parameters are: [0] IA, [1] CA, [2] NPAE, [3] AN, [4] AN0, [5] AW, [6] AW0, [7] ACEC, [8] ACES, [9] ABA, [10] ABphi, [11] IE, [12] ECEC, [13] ECES, [14] HECE4, [15] HESE4, [16] HECE8, [17] HESE8

Access:: READ_WRITE
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 18

buildState

Get DS manager and DSC version structure.

Access:: READ
Data type:: DevString
Data format:: SCALAR

commandedState

Read 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 start of the Off(), Standby(), On() or Reset() long running commands.

Access:: READ
Data type:: DevString
Data format:: SCALAR

configureTargetLock

Threshold level the rms on-sky vector error between the desired Azimuth & Elevation and actual Azimuth & Elevation. Note: The attributes onSourceThreshold (Tracking.Status.OnSourceThreshold) and thresholdTimePeriod (Tracking.Status.ThresholdTimePeriod) can be accessed via configureTargetLock, as elements in the list: [onSourceThreshold, thresholdTimePeriod].

Access:: READ_WRITE
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 2

connectionState

Displays connection status to DSC device

Access:: READ
Data type:: DevEnum
Data format:: SCALAR

controlMode

Read the Control Mode of the device.

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

currentMode

Reflect the Current Mode node’s state.

Access:: READ
Data type:: DevEnum
Data format:: SCALAR

currentPointing

List consisting of pointing information: [ [0] TAIoffset, [1] Azimuth.p_Act, [2] Elevation.p_Act, [3] Azimuth.p_Enc, [4] Elevation.p_Enc, [5] TiltCorrVal_Az, [6] TiltCorrVal_El ]

Access:: READ
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 7

desiredPointingAz

[0] Timestamp [1] Azimuth

Access:: READ
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 2

desiredPointingEl

[0] Timestamp [1] Elevation

Access:: READ
Data type:: DevDouble
Data format:: SPECTRUM
Max_dim_x:: 2

displayedDiagnosis

Indicate dsc DisplayedDiagnosis.

Access:: READ
Data type:: DevString
Data format:: SCALAR

dscCmdAuth

Indicate DSC command authority.

Access:: READ
Data type:: DevEnum
Data format:: SCALAR

dscCtrlState

Indicate dsc control state.

Access:: READ
Data type:: DevEnum
Data format:: SCALAR

dscPowerLimitKw

DSC Power Limit (kW). Note that this attribute can also be set by calling SetPowerMode. This value does not reflect the power limit in reality because the current PowerLimit(kW) is not reported as it cannot be read from the DSC.

Access:: READ_WRITE
Data type:: DevDouble
Data format:: SCALAR

dscState

Dish Structure Controller State

Access:: READ
Data type:: DevEnum
Data format:: SCALAR

elevationSpeed

Sets the Elevation rotation speed during slew in degrees per second.

Access:: READ_WRITE
Data type:: DevDouble
Data format:: SCALAR

errAuthLost

The actual control authority is not communicating

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errAzimuth

Azimuth Axis error

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errCmd

Command Arbiter error

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errElevation

Elevation Axis error

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errFeedindexer

FeedIndexer Axis error

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errGeneral

General error

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errMngmnt

Dish Management Controller error

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errPoint

Pointing Controller error

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errPwr24VDC

Power error on 24 VDC

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errPwr400VAC

Power error on 400 VAC

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errPwr600VDC

Power error on 600 VDC

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errPwrMeterComms

Comms lost to Power meter

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errSafety

Safety System Controller error

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errStwPin

StowPin Controller error

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errTiltOneComms

Comms lost to Tiltmeter One

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errTiltOneIoUnit

IO unit error Tiltmeter One

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errTiltTwoComms

Comms lost to Tiltmeter Two

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errTiltTwoIoUnit

IO unit error Tiltmeter Two

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errTime

Time Controller error

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

errTrack

Tracking Controller error

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

healthState

Returns the current Health State

Access:: READ
Data type:: DevEnum
Data format:: SCALAR

hhpConnected

Indicates whether the hand held pendant is connected

Access:: READ
Data type:: DevBoolean
Data format:: SCALAR

indexerPosition

Indicate operating mode of device.

Access:: READ
Data type:: DevEnum
Data format:: SCALAR

lastCommandInvoked

Stores the name and timestamp (in UNIX UTC format) of the last invoked command.

Access:: READ
Data type:: DevString
Data format:: SPECTRUM
Max_dim_x:: 2

lastCommandUpdate

This attribute tracks the last tango & opcua commands called on the Dish Structure and the results of the OPCUA command

Access:: READ
Data type:: DevString
Data format:: SPECTRUM
Max_dim_x:: 25

loggingLevel

Read the logging level of the device.

Initialises to LoggingLevelDefault on startup. See LoggingLevel

Access:: READ_WRITE
Data type:: DevEnum
Data format:: SCALAR

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.

Access:: READ_WRITE
Data type:: DevString
Data format:: SPECTRUM
Max_dim_x:: 4

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

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

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

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

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

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

lrcExecuting

Read info of the currently executing long running commands.

Returns a list of info JSON blobs of the currently executing commands.

Access:: READ
Data type:: DevString
Data format:: SPECTRUM
Max_dim_x:: 3

lrcFinished

Read info of the finished long running commands.

Access:: READ
Data type:: DevString
Data format:: SPECTRUM
Max_dim_x:: 100

lrcProtocolVersions

Return supported protocol versions.

Access:: READ
Data type:: DevLong64
Data format:: SPECTRUM
Max_dim_x:: 2

lrcQueue

Read info of the long running commands in queue.

Returns a list of info JSON blobs of the commands in queue.

Access:: READ
Data type:: DevString
Data format:: SPECTRUM
Max_dim_x:: 66

operatingMode

Indicate operating mode of device.

Access:: READ
Data type:: DevEnum
Data format:: SCALAR

pointingState

Indicate operating mode of device.

Access:: READ
Data type:: DevEnum
Data format:: SCALAR

powerState

Indicate power state of device.

Access:: READ
Data type:: DevEnum
Data format:: SCALAR

simulationMode

Read the Simulation Mode of the device.

Some devices may implement both modes, while others will have simulators that set simulationMode to True while the real devices always set simulationMode to False.

Access:: READ_WRITE
Data type:: DevEnum
Data format:: SCALAR

staticOnInput

Value to be used for StaticOn when the next pointing model is applied. Setting this to True will enable static pointing model corrections.

Access:: READ_WRITE
Data type:: DevBoolean
Data format:: SCALAR

testMode

Read the Test Mode of the device.

Either no test mode or an indication of the test mode.

Access:: READ_WRITE
Data type:: DevEnum
Data format:: SCALAR

tiltOnInput

Value to be used for TiltOn when the next pointing model is applied. Options: OFF (0), TILTMETER_ONE (1), TILTMETER_TWO (2).

Access:: READ_WRITE
Data type:: DevEnum
Data format:: SCALAR

trackInterpolationMode

Selects the type of interpolation to be used in program tracking.

Access:: READ_WRITE
Data type:: DevEnum
Data format:: SCALAR

trackProgramMode

Selects the type of tracking mode to be used.

Access:: READ_WRITE
Data type:: DevEnum
Data format:: SCALAR

trackTableCurrentIndex

Actual used index in the track table

Access:: READ
Data type:: DevLong64
Data format:: SCALAR

trackTableEndIndex

End index in the track table

Access:: READ
Data type:: DevLong64
Data format:: SCALAR

versionId

Read the Version Id of the device.

Access:: READ
Data type:: DevString
Data format:: SCALAR

Commands

Abort() → DevVarLongStringArray: Abort

AbortCommands() → DevVarLongStringArray: Abort commands

CheckLongRunningCommandStatus(DevString) → DevString: Check long running command status

DebugDevice() → DevUShort

Debug device

Returns:: The TCP port the debugger is listening on.

ExecuteOPCUACommand(DevVarStringArray) → DevVarLongStringArray

Execute an OPC-UA command on the DSC.

The argument to this command is a list of strings. With the first value being the OPC-UA command node path (in dot notation & relative to the PLC_PRG node), followed by the list of arguments for the given command.

ExecutePendingOperations() → DevVoid: Execute pending operations

GetCurrentTAIOffset() → DevDouble

Returns the current TAIoffset as read from the DSC.

If the read for the TAIoffset fails on the DSC then the TAI offset will be calculated manually by the DSManager device.

GetVersionInfo() → DevVarStringArray: Get version info

Init() → DevVoid: Reinitialise the Tango device server.

InterlockAck() → DevVarLongStringArray: Clear the interlock status once interlocks or E-Stops have been cleared.

Off() → DevVarLongStringArray: Off

On() → DevVarLongStringArray: On

ReleaseAuth() → DevVarLongStringArray: Release command authority of the dish.

Reset() → DevVarLongStringArray: Reset

ResetAxesCommand() → DevVarLongStringArray: Resets the axes errors.

SetIndexPosition(DevLong64) → DevVarLongStringArray: Set index position

SetPointMode() → DevVarLongStringArray: Set point mode

SetPowerMode(DevVarDoubleArray) → DevVarLongStringArray

Sets mode to Low or Full Power.

The current low or full power active is reported by the powerState attribute. The current PowerLimit (kW) is not reported as it cannot be read from the DSC. LowPowerOn represented by a boolean where True(1.0) sets LowPowerOn to True , and False(0.0) sets LowPowerOn to False. [0] LowPowerOn (Boolean): True (1.0), False (0.0)

[1] Power limit(kW): Maximum power consumption allowed.

SetStandbyMode() → DevVarLongStringArray: Set standby mode

Slew(DevVarDoubleArray) → DevVarLongStringArray: [0]: Azimuth [1]: Elevation

Standby() → DevVarLongStringArray: Standby

Stow() → DevVarLongStringArray: Stow

TakeAuthority() → DevVarLongStringArray: Take authority.

Track() → DevVarLongStringArray: Track

TrackLoadStaticOff(DevVarDoubleArray) → DevVarLongStringArray

Load (global) static tracking offsets.

The offset is loaded immediately and is not cancelled between tracks. The static offset introduces a positional adjustment to facilitate reference pointing and the five-point calibration. The static offsets are added the output of the interpolator before the correction of the static pointing model.

Note: If the static pointing correction is switched off, the static offsets remain as an offset to the Azimuth and Elevation positions and need to be set to zero manually.

Static offset parameters are: [0] Off_Xel, [1] Off_El

TrackLoadTable(DevVarDoubleArray) → DevVarLongStringArray

[0]: LoadMode

[1]: SequenceLength,

[2 - end]: TrackTable, length should be a multiple of 3 values:

(timestamp, azimuth coordinate, elevation coordinate) NB. Load mode enum might be different from that accepted by the dish controller and is dynamically mapped at runtime based on OPCUA enum values.

TrackStop() → DevVarLongStringArray: Track stop

Unstow() → DevVarLongStringArray: Unstow the dish