DishManager Tango Device

The Dish Manager of the Dish LMC subsystem.

Properties

B5DCDeviceFqdn

Data type:

DevString

DSDeviceFqdn

Data type:

DevString

Default value:

mid-dish/ds-manager/SKA001

DefaultActionTimeoutSeconds

The default timeout value (in seconds) for each fanned out action.

Data type:

DevDouble

Default value:

120

DefaultWatchdogTimeout

Data type:

DevDouble

DishId

Data type:

DevString

Default value:

SKA001

GroupDefinitions

Each string in the list is a JSON serialised dict defining the group_name, devices and subgroups in the group. A Tango Group object is created for each item in the list, according to the hierarchy defined. This provides easy access to the managed devices in bulk, or individually.

Data type:

DevVarStringArray

LoggingLevelDefault

Default logging level at device startup.

Data type:

DevUShort

Default value:

4

LoggingTargetsDefault

Default logging targets at device startup.

Data type:

DevVarStringArray

Default value:

[‘tango::logger’]

MaxCapabilities

List of maximum number of instances per capability type provided by this element.

Data type:

DevVarStringArray

MeanWindSpeedThreshold

Threshold value for mean wind speed (in m/s) used to trigger stow.

Data type:

DevDouble

Default value:

11.1

SPFDeviceFqdn

Data type:

DevString

Default value:

mid-dish/simulator-spfc/SKA001

SPFRxDeviceFqdn

Data type:

DevString

Default value:

mid-dish/simulator-spfrx/SKA001

SkaLevel

Indication of importance of the device in the SKA hierarchy to support drill-down navigation: 1..6, with 1 highest.

Data type:

DevShort

Default value:

4

WMSDeviceNames

Data type:

DevVarStringArray

WindGustThreshold

Threshold value for wind gust speed (in m/s) used to trigger stow.

Data type:

DevDouble

Default value:

16.9

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

Indicates whether the Dish is on target or not based on the pointing error and time period parameters defined in configureTargetLock.

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

actionTimeoutSeconds

Timeout (in seconds) to be used for each action. On each action DishManager will wait for the timeout duration for expected subservient device attribute updates. A value <= 0 will disable waiting and no monitoring will occur, commands will be fanned out to their respective subsevient devices and then the DishManager command will return as COMPLETED immediately.

Access:

READ_WRITE

Data type:

DevDouble

Data format:

SCALAR

adminMode

The Admin Mode of the device.

It may interpret the current device condition and condition of all managed devices to set this.

Access:

READ_WRITE

Data type:

DevEnum

Data format:

SCALAR

attenuation1PolHX

The current attenuation value for attenuator 1 on the H/X polarization.

Access:

READ_WRITE

Data type:

DevDouble

Data format:

SCALAR

attenuation1PolVY

The current attenuation value for attenuator 1 on the V/Y polarization.

Access:

READ_WRITE

Data type:

DevDouble

Data format:

SCALAR

attenuation2PolHX

The current attenuation value for attenuator 2 on the H/X polarization.

Access:

READ_WRITE

Data type:

DevDouble

Data format:

SCALAR

attenuation2PolVY

The current attenuation value for attenuator 2 on the V/Y polarization.

Access:

READ_WRITE

Data type:

DevDouble

Data format:

SCALAR

attenuationPolHX

The current total attenuation value across both attenuators on the H/X polarization.

Access:

READ_WRITE

Data type:

DevDouble

Data format:

SCALAR

attenuationPolVY

The current total attenuation value across both attenuators on the V/Y polarization.

Access:

READ_WRITE

Data type:

DevDouble

Data format:

SCALAR

autoWindStowEnabled

Flag to enable or disable auto wind stow on wind speed or wind gust for values exeeding the configured threshold.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

availableCapabilities

A list of available number of instances of each capability type, e.g. ‘CORRELATOR:512’, ‘PSS-BEAMS:4’.

Access:

READ

Data type:

DevString

Data format:

SPECTRUM

Max_dim_x:

20

azimuthOverWrap

Indicates that the Dish has moved beyond an azimuth wrap limit.

Access:

READ

Data type:

DevBoolean

Data format:

SCALAR

b1CapabilityState

Report the device b1CapabilityState

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

b1LnaHPowerState

Status of the Band 1 SPFC LNA H polarization power state.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

b1LnaVPowerState

Status of the Band 1 SPFC LNA V polarization power state.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

b2CapabilityState

Report the device b2CapabilityState

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

b2LnaHPowerState

Status of the Band 2 SPFC LNA H polarization power state.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

b2LnaVPowerState

Status of the Band 2 SPFC LNA V polarization power state.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

b3CapabilityState

Report the device b3CapabilityState

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

b3LnaPowerState

Status of the Band 3 SPFC LNA polarization power state.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

b4CapabilityState

Report the device b4CapabilityState

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

b4LnaPowerState

Status of the Band 4 SPFC LNA H & V polarization power state.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

b5aCapabilityState

Report the device b5aCapabilityState

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

b5aLnaPowerState

Status of the Band 5a SPFC LNA H & V polarization power state.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

b5bCapabilityState

Report the device b5bCapabilityState

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

b5bLnaPowerState

Status of the SPFC LNA H & V polarization power state.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

b5dcConnectionState

Return the status of the connection to the B5DC proxy.

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

b5dcServerConnectionState

Return the status of the connection of the B5dc Proxy device to the B5dc server.

Access:

READ

Data type:

DevEnum

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 B0.

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

band1SamplerFrequency

BAND1 absolute sampler clock frequency (base plus offset).

Access:

WRITE

Data type:

DevDouble

Data format:

SCALAR

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

band2SamplerFrequency

BAND2 absolute sampler clock frequency (base plus offset).

Access:

WRITE

Data type:

DevDouble

Data format:

SCALAR

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

band3SamplerFrequency

BAND3 absolute sampler clock frequency (base plus offset).

Access:

WRITE

Data type:

DevDouble

Data format:

SCALAR

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

band4SamplerFrequency

BAND4 absolute sampler clock frequency (base plus offset).

Access:

WRITE

Data type:

DevDouble

Data format:

SCALAR

band5aPointingModelParams

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

Access:

READ_WRITE

Data type:

DevDouble

Data format:

SPECTRUM

Max_dim_x:

18

band5aSamplerFrequency

BAND5a absolute sampler clock frequency (base plus offset).

Access:

WRITE

Data type:

DevDouble

Data format:

SCALAR

band5bPointingModelParams

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

Access:

READ_WRITE

Data type:

DevDouble

Data format:

SPECTRUM

Max_dim_x:

18

band5bSamplerFrequency

BAND5b absolute sampler clock frequency (base plus offset).

Access:

WRITE

Data type:

DevDouble

Data format:

SCALAR

buildState

Read the Build State of the device.

Access:

READ

Data type:

DevString

Data format:

SCALAR

capturing

Indicates whether Dish is capturing data in the configured band or not.

Access:

READ

Data type:

DevBoolean

Data format:

SCALAR

clkPhotodiodeCurrent

Reports the current flowing through the clock photodiode in the B5DC. Value is in milliamperes (mA).

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

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

configureTargetLock

[0] Pointing error [1] Time period

Access:

WRITE

Data type:

DevDouble

Data format:

SPECTRUM

Max_dim_x:

2

configuredBand

The frequency band that the Dish is configured to capture data in.

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

controlMode

The control mode of the device.

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

Access:

READ_WRITE

Data type:

DevEnum

Data format:

SCALAR

desiredPointingAz

Azimuth axis desired pointing as reported by the dish structure controller’s Tracking.TrackStatus.p_desired_Az field.

Access:

READ

Data type:

DevDouble

Data format:

SPECTRUM

Max_dim_x:

2

desiredPointingEl

Elevation axis desired pointing as reported by the dish structure controller’s Tracking.TrackStatus.p_desired_El field.

Access:

READ

Data type:

DevDouble

Data format:

SPECTRUM

Max_dim_x:

2

dishMode

Dish rolled-up operating mode in Dish Control Model (SCM) notation

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

dsConnectionState

Displays connection status to DS device

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

dscCmdAuth

Indicates who has command authority

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

dscConnectionState

Return the status of the connection of the DSManager device to the dish controller.

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

dscCtrlState

DSC Control State - an aggregation of DSC Command Authority and DSC State

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

dscErrorStatuses

Report the current DSC errors as a semicolon-delimited list. Reports ‘OK’ if no errors are present.

Access:

READ

Data type:

DevString

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

dshMaxShortTermPower

Configures the Max Short Term Average Power (5sec‐10min) in kilowatt that the DSH instance is curtailed to while dshPowerCurtailment is [TRUE]. The default value is 13.5.

Access:

WRITE

Data type:

DevDouble

Data format:

SCALAR

dshPowerCurtailment

The Max Short Term Average Power (5sec‐10min) of each DSH instance is curtailed to the value configured in dshMaxShortTermPower. The default condition is [TRUE] ‐ power curtailment is on. With power curtailment [TRUE], all DSH functionality is available but at reduced performance (for example reduced slew rates). With power curtailment [FALSE], all DSH functionality is available at full performance (for example maximum slew rates).

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

hPolRfPowerIn

Reports the input RF power level for the Horizontal (H) polarization measured at the B5DC RF Control Module (RFCM). Value is in dBm.

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

hPolRfPowerOut

Reports the output RF power level for the Horizontal (H) polarization measured at the B5DC RF Control Module (RFCM). Value is in dBm.

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

healthInfo

Report the reason for healthstate failures.

Access:

READ

Data type:

DevString

Data format:

SPECTRUM

healthState

Read the Health State of the device.

It interprets the current device condition and condition of all managed devices to set this.

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

ignoreB5dc

Flag to disable B5DC device communication. When ignored, no commands will be issued to the device, it will be excluded from state aggregation, and no device related attributes will be updated.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

ignoreSpf

Flag to disable SPF device communication. When ignored, no commands will be issued to the device, it will be excluded from state aggregation, and no device related attributes will be updated.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

ignoreSpfrx

Flag to disable SPFRx device communication. When ignored, no commands will be issued to the device, it will be excluded from state aggregation, and no device related attributes will be updated.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

isKLocked

Check the SAT.RM module to see if the k- value is locked. If not false is returned.

Access:

READ

Data type:

DevBoolean

Data format:

SCALAR

kValue

Returns the kValue for SPFRX

Access:

READ

Data type:

DevLong64

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

lastCommandedMode

Reports when and which was the last commanded mode change (not when completed). Time is a UNIX UTC timestamp.

Access:

READ

Data type:

DevString

Data format:

SPECTRUM

Max_dim_x:

2

lastCommandedPointingParams

Default empty string when not set, and is a JSON stringof the last requested global pointing model when set.

Access:

READ

Data type:

DevString

Data format:

SCALAR

lastWatchdogReset

Returns the timestamp of the last watchdog reset in unix seconds.

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

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.

DEPRECATED: A client can check for the queued command(s) in ‘lrcQueue’.

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).

DEPRECATED: A client can check for the command(s) in progress in ‘lrcExecuting’.

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.

DEPRECATED: A client can check the progress of command(s) in ‘lrcExecuting’.

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 and json-encoded result. Clients can subscribe to on change event and wait for the ID they are interested in.

DEPRECATED: A client can check for the result of a command in ‘lrcFinished’.

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.

DEPRECATED: A client can check for the status of a command in the ‘lrcQueue’, ‘lrcExecuting’ and ‘lrcFinished’ attributes.

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.

DEPRECATED: A client can check for the queued command(s) in ‘lrcQueue’.

Access:

READ

Data type:

DevString

Data format:

SPECTRUM

Max_dim_x:

66

lrcExecuting

A list of info JSON blobs of the currently executing commands.

Access:

READ

Data type:

DevString

Data format:

SPECTRUM

Max_dim_x:

2

lrcFinished

A list of info JSON blobs 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

A list of info JSON blobs of the commands in queue.

Access:

READ

Data type:

DevString

Data format:

SPECTRUM

Max_dim_x:

32

maxCapabilities

Maximum number of instances of each capability type, e.g. ‘CORRELATOR:512’, ‘PSS-BEAMS:4’.

Access:

READ

Data type:

DevString

Data format:

SPECTRUM

Max_dim_x:

20

meanWindSpeed

The average wind speed in m/s of the last 10 minutes calculated from the connected weather stations.

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

noiseDiodeConfig

Returns the noiseDiodeConfig.

Access:

WRITE

Data type:

DevDouble

Data format:

SPECTRUM

noiseDiodeMode

Noise diode mode.

0: OFF, 1: PERIODIC, 2: PSEUDO-RANDOM

Note: This attribute does not persist after a power cycle. A default value is included as a device property on the SPFRx.

Access:

READ_WRITE

Data type:

DevEnum

Data format:

SCALAR

periodicNoiseDiodePars

Periodic noise diode pars (units are in time quanta).

[0]: period, [1]: duty cycle, [2]: phase shift

Note: This attribute does not persist after a power cycle. A default value is included as a device property on the SPFRx.

Access:

READ_WRITE

Data type:

DevULong

Data format:

SPECTRUM

Max_dim_x:

3

pointingBufferSize

Number of desiredPointing write values that the buffer has space for. Note: desiredPointing write values are stored by Dish in a buffer for application at the time specified in each desiredPointing record.

Access:

READ

Data type:

DevLong64

Data format:

SCALAR

pointingState

Returns the pointingState.

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

polyTrack

[0] Timestamp [1] Azimuth [2] Elevation [3] Azimuth speed [4] Elevation speed [5] Azimuth acceleration [6] Elevation acceleration [7] Azimuth jerk [8] Elevation jerk

Access:

WRITE

Data type:

DevDouble

Data format:

SPECTRUM

Max_dim_x:

9

powerState

Returns the powerState.

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

programTrackTable

Timestamp of i-th coordinate in table (max 1000 coordinates) given in milliseconds since TAI epoch, representing time at which Dish should track i-th coordinate. Azimuth of i-th coordinate in table (max 1000 points) given in degrees. Elevation of i-th coordinate in table (max points coordinates) given in degrees

Access:

READ_WRITE

Data type:

DevDouble

Data format:

SPECTRUM

Max_dim_x:

3000

pseudoRandomNoiseDiodePars

Pseudo random noise diode pars (units are in time quanta).

[0]: binary polynomial, [1]: seed, [2]: dwell

Note: This attribute does not persist after a power cycle. A default value is included as a device property on the SPFRx.

Access:

READ_WRITE

Data type:

DevULong

Data format:

SPECTRUM

Max_dim_x:

3

rfTemperature

Reports the temperature of the B5DC RF Control Module (RFCM) RF Printed Circuit Board (PCB). Value is in degrees Celsius.

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

rfcmFrequency

Reports the current output frequency of the B5DC PLL in GHz. The default value is 11.1 GHz.

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

rfcmHAttenuation

Reports the current attenuation setting for the Horizontal (H) polarization on the B5DC RF Control Module (RFCM). Value is in dB.

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

rfcmPllLock

Reports the lock status of the B5DC RF Control Module (RFCM) PLL.Returns B5dcPllState enum indicating if locked or lock lost.

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

rfcmPsuPcbTemperature

Reports the temperature of the B5DC RF Control Module (RFCM) Power Supply Unit (PSU) PCB. Value is in degrees Celsius.

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

rfcmVAttenuation

Reports the current attenuation setting for the Vertical (V) polarization on the B5DC RF Control Module (RFCM). Value is in dB.

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

scanID

Report the scanID for Scan

Access:

READ_WRITE

Data type:

DevString

Data format:

SCALAR

simulationMode

When TRUE the device is using a simulator

Access:

READ_WRITE

Data type:

DevEnum

Data format:

SCALAR

spectralInversion

Spectral inversion to correct the frequency sense of the currently configured band with respect to the RF signal.

Logic 0: Output signal in the same frequency sense as input.

Logic 1: Output signal in the opposite frequency sense as input.

Setting this attribute to true will set the spectrum to be flipped.

Access:

READ_WRITE

Data type:

DevBoolean

Data format:

SCALAR

spectrumSample

Note: This attribute maps to the spectrum sample attribute from the SPFRxReport the SPFRX spectrum sample data Spectrum sample data from the spectrometer as a packed DevFloat array. The array contains a UTC timestamp followed by multiple spectral datasets. Index layout: [0-1]: UTC timestamp in seconds, [2-1026]: P_on,X (1025 floats), [1027-2051]: P_on,Y (1025 floats), [2052-3076]: P_on,XY real (1025 floats), [3077-4101]: P_on,XY imaginary (1025 floats), [4102-5126]: P_off,X (1025 floats), [5127-6151]: P_off,Y (1025 floats), [6152-7176]: P_off,XY real (1025 floats), [7177-8201]: P_off,XY imaginary (1025 floats).

Access:

READ

Data type:

DevDouble

Data format:

SPECTRUM

Max_dim_x:

8202

spfConnectionState

Displays connection status to SPF device

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

spfrxConnectionState

Displays connection status to SPFRx device

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

testMode

If TEST the device is using testing logic

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 track program source (table A, table B, polynomial stream) used in the ACU for tracking. Coordinates given in the programTrackTable attribute are loaded in ACU in the selected table.

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

trackTableLoadMode

Selects track table load mode. With ADD selected, Dish will add the coordinate set given in programTrackTable attribute to the list of pointing coordinates already loaded in ACU. With NEW selected, Dish will delete the list of pointing coordinates previously loaded in ACU when new coordinates are given in the programTrackTable attribute.

Access:

READ_WRITE

Data type:

DevEnum

Data format:

SCALAR

vPolRfPowerIn

Reports the input RF power level for the Vertical (V) polarization measured at the B5DC RF Control Module (RFCM). Value is in dBm.

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

vPolRfPowerOut

Reports the output RF power level for the Vertical (V) polarization measured at the B5DC RF Control Module (RFCM). Value is in dBm.

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

versionId

Read the Version Id of the device.

Access:

READ

Data type:

DevString

Data format:

SCALAR

watchdogTimeout

Sets dish manager watchdog timeout interval in seconds. By writing a value greater than 0, the watchdog will be enabled. If the watchdog is not reset within this interval, the dish will Stow on expiry of the timer. The watchdog timer can be reset by calling the ResetWatchdog() command. The watchdog can be disabled by writing a value less than or equal to 0.

Access:

READ_WRITE

Data type:

DevDouble

Data format:

SCALAR

windGust

The maximum wind speed in m/s of the last 3 seconds calculated from the connected weather stations.

Access:

READ

Data type:

DevDouble

Data format:

SCALAR

wmsConnectionState

Displays connection status to wms device

Access:

READ

Data type:

DevEnum

Data format:

SCALAR

Commands

Abort() → DevVarLongStringArray

Abort currently executing long running command on DishManager including stopping dish movement and transitioning dishMode to StandbyFP. For details consult DishManager documentation

Returns:

A tuple containing a return code and a string message indicating status. The message is for information purpose only.

AbortCommands() → DevVarLongStringArray

Empty out long running commands in queue.

DEPRECATED: A client should call the tracked ‘Abort’ long running command instead.

Returns:

[ResultCode.STARTED][‘Aborting commands’]

ApplyPointingModel(DevString) → DevVarLongStringArray

The command accepts a JSON input (value) containing data to update a particular band’s (b1-b5b). The following 18 coefficients need to be within the JSON object: [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.

The command only looks for the antenna, band and coefficients - everything else is ignored. A typical structure would be: “interface”: “…”, “antenna”: “….”, “band”: “Band_…”, “attrs”: {…}, “coefficients”: { “IA”: {…}, … “HESE8”:{…} }, “rms_fits”: { “xel_rms”: {…}, “el_rms”: {…}, “sky_rms”: {…} } }

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

CheckLongRunningCommandStatus(DevString) → DevString

Check the status of a long running command by ID.

Returns:

Status of the asynchronous task.

ConfigureBand(DevString) → DevVarLongStringArray

The command accepts a JSON string containing data to configure the SPFRx. The JSON structure is as follows: { “receiver_band”: <string>, “band5_downconversion_subband or sub_band”: <string>, “spfrx_processing_parameters”: { “dishes”: List[<string>], “sync_pps”: <bool>, “attenuation_pol_x”: <float>, “attenuation_pol_y”: <float>, “attenuation_1_pol_x”: <float>, “attenuation_1_pol_y”: <float>, “attenuation_2_pol_x”: <float>, “attenuation_2_pol_y”: <float>, “saturation_threshold”: <float>, “noise_diode”: { “pseudo_random”: { “binary_polynomial”: <long>, “seed”: <long>, “dwell”: <long>, }, “periodic”: { “period”: <long>, “duty_cycle”: <long>, “phase_shift”: <long>, } } } } where ‘receiver_band’, ‘dishes’ and ‘sync_pps’ are mandatory fields. when ‘receiver_band’ is set to ‘5b’, the ‘band5_downconversion_subband or sub_band’field is mandatory. The ‘dishes’ field is a list of dish names that the SPFRx should be configured for, if ‘all’ is specified in the list, the SPFRx will be configured for all dishes.

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

ConfigureBand1(DevBoolean) → DevVarLongStringArray

If the synchronise argument is True, the SPFRx FPGA is instructed to synchronise its internal flywheel 1PPS to the SAT-1PPS for the ADC that is applicable to the band being configured, and the band counters are reset. (Should be default to False).

Returns:

A tuple containing a return code and a string message indicating status.

ConfigureBand2(DevBoolean) → DevVarLongStringArray

If the synchronise argument is True, the SPFRx FPGA is instructed to synchronise its internal flywheel 1PPS to the SAT-1PPS for the ADC that is applicable to the band being configured, and the band counters are reset. (Should be default to False).

Returns:

A tuple containing a return code and a string message indicating status.

ConfigureBand3(DevBoolean) → DevVarLongStringArray

If the synchronise argument is True, the SPFRx FPGA is instructed to synchronise its internal flywheel 1PPS to the SAT-1PPS for the ADC that is applicable to the band being configured, and the band counters are reset. (Should be default to False).

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

ConfigureBand4(DevBoolean) → DevVarLongStringArray

If the synchronise argument is True, the SPFRx FPGA is instructed to synchronise its internal flywheel 1PPS to the SAT-1PPS for the ADC that is applicable to the band being configured, and the band counters are reset. (Should be default to False).

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

ConfigureBand5a(DevBoolean) → DevVarLongStringArray

If the synchronise argument is True, the SPFRx FPGA is instructed to synchronise its internal flywheel 1PPS to the SAT-1PPS for the ADC that is applicable to the band being configured, and the band counters are reset. (Should be default to False).

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

ConfigureBand5b(DevBoolean) → DevVarLongStringArray

If the synchronise argument is True, the SPFRx FPGA is instructed to synchronise its internal flywheel 1PPS to the SAT-1PPS for the ADC that is applicable to the band being configured, and the band counters are reset. (Should be default to False).

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

ConfigureBand6() → DevVarLongStringArray

Used by DVS for their KU band, sets IndexerPosition.B6 (7) on the DSC.

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

DebugDevice() → DevUShort

Enable remote debugging of this device.

Returns:

The TCP port the debugger is listening on.

EndScan() → DevVarLongStringArray

This command clears out the scanID from DishManager.

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

FlushCommandQueue() → DevVoid

No input parameter (DevVoid)

Returns:

No output parameter (DevVoid)

GetComponentStates() → DevString

No input parameter (DevVoid)

Returns:

Retrieve the states of SPF, SPFRx and DS as DishManager sees it.

GetVersionInfo() → DevVarStringArray

Get the version information of the device.

Returns:

The device class name and its package information.

Init() → DevVoid

Reinitialise the Tango device.

InterlockAck() → DevVarLongStringArray

Clear the interlock status once interlocks or E-Stops have been cleared on the dish structure controller

Returns:

A tuple containing a return code and a string message indicating status.

IsCapabilityAchievable(DevVarLongStringArray) → DevBoolean

Check if provided capabilities can be achieved by the resource(s).

Parameter:

[No. of instances][Capability types]

Returns:

[ResultCode][Command ID]

Off() → DevVarLongStringArray

Not implemented.

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

On() → DevVarLongStringArray

Not implemented.

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

Reset() → DevVarLongStringArray

Not implemented.

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

ResetComponentConnection(DevString) → DevVarLongStringArray

Reset connections between the Dish Manager and a sub-device.

Parameters:

device_name – sub-device to reconnect [SPF, SPFRX, DS, B5DC]

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

ResetTrackTable() → DevVarLongStringArray

This command resets the program track table on the controller

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

ResetWatchdogTimer() → DevVarLongStringArray

This command resets the watchdog timer. lastWatchdogReset attribute will be updated with the unix timestamp. By default, the watchdog timer is disabled and can be enabled by setting the watchdogTimeout attribute to a value greater than 0.

Returns:

Returns a DevVarLongStringArray with the return code and message.

Scan(DevString) → DevVarLongStringArray

DishManager records the scanID for an ongoing scan.

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

SetFrequency(DevLong64) → DevVarLongStringArray

Set the frequency on the band 5 down converter.

Parameters:

frequency – frequency to set [B5dcFrequency.F_11_1_GHZ(1),

B5dcFrequency.F_13_2_GHZ(2) or B5dcFrequency.F_13_86_GHZ(3)]

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

SetHPolAttenuation(DevLong64) → DevVarLongStringArray

Set the horizontal polarization attenuation on the band 5 down converter.

Parameters:

attenuation_db – value to set in dB [0-31dB]

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

SetKValue(DevLong64) → DevVarLongStringArray

Set the K value on the SPFRx.

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

SetMaintenanceMode() → DevVarLongStringArray

This command triggers the Dish to transition to the MAINTENANCE Dishmode.

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

SetOperateMode() → DevVarLongStringArray

SetOperateMode is a deprecated command, it is recommended to use ConfigureBand or ConfigureBand<N> command instead to trigger the transition to OPERATE dish mode.

Returns:

A tuple containing a return code and a string message indicating status.

SetStandbyFPMode() → DevVarLongStringArray

This command triggers the Dish to transition to the STANDBY‐FP Dishmode.

Returns:

A tuple containing a return code and a string message indicating status.

SetStandbyLPMode() → DevVarLongStringArray

This command triggers the Dish to transition to the STANDBY‐LP Dishmode.

Returns:

A tuple containing a return code and a string message indicating status.

SetStowMode() → DevVarLongStringArray

This command triggers the Dish to transition to STOW.

Returns:

A tuple containing a return code and a string message indicating status.

SetVPolAttenuation(DevLong64) → DevVarLongStringArray

Set the vertical polarization attenuation on the band 5 down converter.

Parameters:

attenuation_db – value to set in dB [0-31dB]

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

Slew(DevVarFloatArray) → DevVarLongStringArray

Slew to Az/EL: [0]: Azimuth [1]: Elevation

Returns:

A tuple containing a return code and a string message indicating status.

Standby() → DevVarLongStringArray

Not implemented.

Returns:

return:

(not documented)

rtype:

DevVarLongStringArray

StartCommunication() → DevVoid

Starts communication with subdevices and starts the watchdog timer, if it is configured via watchdogTimeout attribute.

Returns:

No output parameter (DevVoid)

StopCommunication() → DevVoid

Stops communication with subdevices and stops the watchdog timer, if it is active.

Returns:

No output parameter (DevVoid)

SyncComponentStates() → DevVoid

Sync each subservient device componentstate with the dish manager component state.

Returns:

No output parameter (DevVoid)

Synchronise() → DevVoid

Not Implemented.

Returns:

No output parameter (DevVoid)

Track() → DevVarLongStringArray

Executes TrackStart on the DSC.

Returns:

A tuple containing a return code and a string message indicating status.

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

Returns:

A tuple containing a return code and a string message indicating status.

TrackStop() → DevVarLongStringArray

Executes TrackStop on the DSC.

Returns:

A tuple containing a return code and a string message indicating status.