DishManager Tango Device

The Dish Manager of the Dish LMC subsystem.

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

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.

Returns:

Admin Mode of the device

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

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.

Returns:

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

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.

Returns:

commanded operating state string.

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

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.

Returns:

Control Mode of the device

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

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

elementAlarmAddress

FQDN of Element Alarm Handlers

Access:

READ

Data type:

DevString

Data format:

SCALAR

elementDatabaseAddress

FQDN of Element Database device

Access:

READ

Data type:

DevString

Data format:

SCALAR

elementLoggerAddress

FQDN of Element Logger

Access:

READ

Data type:

DevString

Data format:

SCALAR

elementTelStateAddress

FQDN of Element TelState device

Access:

READ

Data type:

DevString

Data format:

SCALAR

frequencyResponse

Returns the frequencyResponse.

Access:

READ

Data type:

DevDouble

Data format:

SPECTRUM

Max_dim_x:

1024

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

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.

Returns:

Health State of the device

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

Returns:

Logging level of the device.

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.

Returns:

Logging level of the device.

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.

Returns:

ID, result.

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.

Returns:

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.

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

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

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

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.

Returns:

Simulation Mode of the device.

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

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

Read the Test Mode of the device.

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

Returns:

Test Mode of the device

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.

Returns:

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

AbortCommands() DevVarLongStringArray

Abort 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”: {…} } }

CheckLongRunningCommandStatus(DevString) DevString

Check long running command status

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.

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

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

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

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

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

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

DebugDevice() DevUShort

Debug device

Returns:

The TCP port the debugger is listening on.

EndScan() DevVarLongStringArray

End scan

ExecutePendingOperations() DevVoid

Execute pending operations

FlushCommandQueue() DevVoid

Flush command queue

GetComponentStates() DevString

Get component states

Returns:

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

GetVersionInfo() DevVarStringArray

Get version info

Init() DevVoid

Init

IsCapabilityAchievable(DevVarLongStringArray) DevBoolean

[nrInstances][Capability types]

Returns:

(ResultCode, ‘Command unique ID’)

Off() DevVarLongStringArray

Off

On() DevVarLongStringArray

On

Reset() DevVarLongStringArray

Reset

ResetTrackTable() DevVarLongStringArray

This command resets the program track table on the controller

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

Scan

SetFrequency(DevLong64) DevVarLongStringArray

Set the frequency on the band 5 down converter.

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

SetHPolAttenuation(DevLong64) DevVarLongStringArray

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

SetKValue(DevLong64) DevVarLongStringArray

Set k value

SetMaintenanceMode() DevVarLongStringArray

Set maintenance mode

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.

SetStandbyFPMode() DevVarLongStringArray

Set standby f p mode

SetStandbyLPMode() DevVarLongStringArray

Set standby l p mode

SetStowMode() DevVarLongStringArray

Set stow mode

SetVPolAttenuation(DevLong64) DevVarLongStringArray

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

Slew(DevVarFloatArray) DevVarLongStringArray

[0]: Azimuth

[1]: Elevation

Standby() DevVarLongStringArray

Standby

StartCommunication() DevVoid

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

StopCommunication() DevVoid

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

SyncComponentStates() DevVoid

Sync component states

Synchronise() DevVoid

Synchronise

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

TrackStop() DevVarLongStringArray

Track stop