Schedule Commands: Difference between revisions

From EOVSA Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
NOTE: All Schedule commands accept as optional arguments a list of antennas to which the command should selectively sent. Accepted syntaxes are:
NOTE: All Schedule commands accept as optional arguments a list of antennas to which the command should selectively sent. Accepted syntaxes are:
Command ant1 ant2 ant3
Command ant1 ant2 ant3
Command ant1-3
Command ant1-3
Command subarray1
Command subarray1
Command subarray2
Command subarray2
If no antenna list is indicated, the command is sent to all antennas currently in subarray1
 
If no antenna list is indicated, the command is sent to all antennas currently in subarray1.


== Commands handled directly by ACC ==
== Commands handled directly by ACC ==


'''ABORT'''
=== ABORT ===


Aborts all commands sent to ACC but not yet executed
Aborts all commands sent to ACC but not yet executed


'''CLEAROFF [antenna list]'''
=== CLEAROFF [antenna list] ===


Sets all AzEl or RaDec offsets to zero
Sets all AzEl or RaDec offsets to zero


'''DCMATTN HPOLattn VPOLattn [antenna list]'''
=== DCMATTN HPOLattn VPOLattn [antenna list] ===


Indicates the VPOL and HPOL attenuations for the DCM modules indicated in the list. The attenuations are applied on the next second start.
Indicates the VPOL and HPOL attenuations for the DCM modules indicated in the list. The attenuations are applied on the next second start.
Line 22: Line 27:
<span style="color: red">Warning:</span>The command is executed only if the DCM modules are in manual mode (see the DCMAUTO-ON and DCMAUTO-OFF command below)
<span style="color: red">Warning:</span>The command is executed only if the DCM modules are in manual mode (see the DCMAUTO-ON and DCMAUTO-OFF command below)


'''DCMAUTO-OFF [antenna list]'''
=== DCMAUTO-OFF [antenna list] ===


Sets the DCM modules in the manual attenuation mode. This mode allows the attenuations requested by the DCMATTN to be applied.
Sets the DCM modules in the manual attenuation mode. This mode allows the attenuations requested by the DCMATTN to be applied.


'''DCMAUTO-ON [antenna list]'''
=== DCMAUTO-ON [antenna list] ===


Sets the DCM modules in the automatic attenuation mode. This mode ignores the manual DCMATTN commands and applies the attenuation set through the DCMREGIME mechanism.
Sets the DCM modules in the automatic attenuation mode. This mode ignores the manual DCMATTN commands and applies the attenuation set through the DCMREGIME mechanism.


'''DCMOFFSET level1 level2…..level50'''
=== DCMOFFSET level1 level2…..level50 ===


Sets the 50 DCM regime states to be cycled during each second, starting with the next second boundary. The command expects up to 50 arguments. If fewer arguments are provided, the existing set is repeated in the same sequence until all 50 slots are filled. This command is only intended for testing. During normal operations, the DCMREGIME states are requested by the DPP computer.
Sets the 50 DCM regime states to be cycled during each second, starting with the next second boundary. The command expects up to 50 arguments. If fewer arguments are provided, the existing set is repeated in the same sequence until all 50 slots are filled. This command is only intended for testing. During normal operations, the DCMREGIME states are requested by the DPP computer.
Line 36: Line 41:
<span style="color: red">Warning:</span> The command is executed only if the DCM modules are in auto mode (see the DCMAUTO-ON and DCMAUTO-OFF command below).
<span style="color: red">Warning:</span> The command is executed only if the DCM modules are in auto mode (see the DCMAUTO-ON and DCMAUTO-OFF command below).


NOTE
NOTE: The DCMREGIME settings are changed on the edge of the next second after a TCP/IP message is received by ACC at the TCP.dpp.port  (default port: 6344-set in ACC.ini file ). The message is expected to be a fixed length binary string having the following format
 
The DCMREGIME settings are changed on the edge of the next second after a TCP/IP message is received by ACC at the TCP.dpp.port  (default port: 6344-set in ACC.ini file ). The message is expected to be a fixed length binary string having the following format


<pre>REGIME + blank space + 50 32bit integers (I32)</pre>
<pre>REGIME + blank space + 50 32bit integers (I32)</pre>


'''DCMTABLE  [antennalist] filename'''
=== DCMTABLE  [antennalist] filename ===


Request the antenna list portion of a specific DCM base attenuation table to be uploaded on the respective DCM modules. The DCM table must have 30 columns and 50 rows, each pair of adjacent columns listing the HPOL-VPOL pairs for each of the 50 slots of a tuning sequence. The DCM table text file must be located in the ACC “c:\parm” directory and its default name is “DCM.txt”.  
Request the antenna list portion of a specific DCM base attenuation table to be uploaded on the respective DCM modules. The DCM table must have 30 columns and 50 rows, each pair of adjacent columns listing the HPOL-VPOL pairs for each of the 50 slots of a tuning sequence. The DCM table text file must be located in the ACC “c:\parm” directory and its default name is “DCM.txt”.  
Line 50: Line 53:
The actual DCM attenuations for a given tuning slot are calculated based on the following formula  
The actual DCM attenuations for a given tuning slot are calculated based on the following formula  


<pre>atten[pol,tuning_index]=base_atten[pol,tuning_index]+regime*2db</pre>
'''''atten[pol,tuning_index]=base_atten[pol,tuning_index]+regime*2db'''''


'''DPPOFFSET-OFF'''
=== DPPOFFSET-OFF ===


Ignores DCM offset attenuation recommendations sent by DPP but still allows setting the offsets via the DCMOFFSET schedule command.
Ignores DCM offset attenuation recommendations sent by DPP but still allows setting the offsets via the DCMOFFSET schedule command.


'''DPPOFFSET-ON'''
=== DPPOFFSET-ON ===


Applies DCM offset attenuation recommendations sent by DPP but still allows setting the offsets via the DCMOFFSET schedule command.  
Applies DCM offset attenuation recommendations sent by DPP but still allows setting the offsets via the DCMOFFSET schedule command.  
Line 62: Line 65:
<span style="color: red">NOTE: This is the default behavior of the system after each hardware ACC reboot or after a REBOOT or RESET command is sent via TCP/IP to the emergency 6543 acc.solar.ini port</span>
<span style="color: red">NOTE: This is the default behavior of the system after each hardware ACC reboot or after a REBOOT or RESET command is sent via TCP/IP to the emergency 6543 acc.solar.ini port</span>


'''FEM-INIT'''
=== FEM-INIT ===


Initialize all front-end module base attenuations with the values read from the ACC initialization file: “c:\ni-rt\startup\acc.ini”.
Initialize all front-end module base attenuations with the values read from the ACC initialization file: “c:\ni-rt\startup\acc.ini”.


'''FEMATTN level [antennalist]'''
=== FEMATTN level [antennalist] ===


Manually selects the front-end attenuation levels for the antennas indicated in the list to be applied on the next second boundary. The attenuation level selects the corresponding entry in the “c:\parms\FEMATTN.txt” attenuation FEM table located on each the cRIOs.
Manually selects the front-end attenuation levels for the antennas indicated in the list to be applied on the next second boundary. The attenuation level selects the corresponding entry in the “c:\parms\FEMATTN.txt” attenuation FEM table located on each the cRIOs.
Line 89: Line 92:
|1
|1
|0
|0
|3
|2
|3
|2
|-
|-
|2
|2
|0
|0
|6
|4
|6
|4
|-
|-
|3
|3
|0
|0
|9
|6
|9
|6
|-
|-
|4
|4
|0
|0
|12
|8
|12
|8
|-
|-
|5
|5
|0
|0
|15
|10
|15
|10
|-
|-
|6
|6
|0
|0
|18
|12
|18
|12
|-
|-
|7
|7
|9
|2
|12
|12
|21
|14
|-
|-
|8
|8
|9
|2
|15
|14
|24
|16
|-
|-
|9
|9
|9
|4
|14
|18
|18
|27
|-
|-
|10
|10
|9
|4
|21
|16
|30
|20
|-
|-
|11
|11
|9
|4
|24
|18
|33
|22
|-
|-
|12
|12
|9
|4
|27
|20
|36
|24
|-
|-
|13
|13
|18
|6
|21
|20
|39
|26
|-
|-
|14
|14
|18
|8
|24
|20
|42
|28
|-
|-
|15
|15
Line 172: Line 175:
Where Attenuation, Base, and FEMATTN.txt(level) are two elements vectors indicating the settings for the First and Second attenuators.
Where Attenuation, Base, and FEMATTN.txt(level) are two elements vectors indicating the settings for the First and Second attenuators.


'''HATTN first second [antennalist]'''
=== HATTN first second [antennalist] ===


Sets the FEM  HPOL_BASE first and second attenuators for the antennas in the list, and overwrites the corresponding  sections in the global “c:\ni-rt\startup\acc.ini” file, as well as in the local “c:\ni-rt\startup\crio.ini” files.
Sets the FEM  HPOL_BASE first and second attenuators for the antennas in the list, and overwrites the corresponding  sections in the global “c:\ni-rt\startup\acc.ini” file, as well as in the local “c:\ni-rt\startup\crio.ini” files.


'''VATTN first second [antennalist]'''
=== VATTN first second [antennalist] ===


Sets the FEM  VPOL_BASE first and second attenuators for the antennas in the list, and overwrites the corresponding  sections in the global “c:\ni-rt\startup\acc.ini” file, as well as in the local “c:\ni-rt\startup\crio.ini” files.
Sets the FEM  VPOL_BASE first and second attenuators for the antennas in the list, and overwrites the corresponding  sections in the global “c:\ni-rt\startup\acc.ini” file, as well as in the local “c:\ni-rt\startup\crio.ini” files.


'''FSEQ-FILE filename'''
=== FSEQ-FILE filename ===


Tells ACC to upload to the Hittite synthesizer the frequency sequence located at  “c:\parm\filename”.  
Tells ACC to upload to the Hittite synthesizer the frequency sequence located at  “c:\parm\filename”.  


'''FSEQ-INIT'''
=== FSEQ-INIT ===


Initializes the Hittite synthesizer according to the settings defined in the [LO Configuration] section of the “c:\ni-rt\startup\acc.ini” file.
Initializes the Hittite synthesizer according to the settings defined in the [LO Configuration] section of the “c:\ni-rt\startup\acc.ini” file.


'''FSEQ-ON'''
=== FSEQ-ON ===


Starts the tuning sequence
Starts the tuning sequence


'''FSEQ-OFF'''
=== FSEQ-OFF ===


Stops the tuning sequence
Stops the tuning sequence


'''FSEQ-SCRIPT filename'''
=== FSEQ-SCRIPT filename ===


Sends, line by line, to the Hittite synthesizer the command sequence listed in the “c:\parm\filename” script file.
Sends, line by line, to the Hittite synthesizer the command sequence listed in the “c:\parm\filename” script file.


'''LO1A-REBOOT'''
=== LO1A-REBOOT ===


Commands the PDU controller to recycle the power on the LO1A Hittite synthesizer
Commands the PDU controller to recycle the power on the LO1A Hittite synthesizer


'''LO1B-REBOOT'''
=== LO1B-REBOOT ===


Not implemented yet
Not implemented yet


'''LO1A-WRITE command'''
=== LO1A-WRITE command ===


Sends the specified command to the LO1A Hittite synthesizer
Sends the specified command to the LO1A Hittite synthesizer


'''LO1B-WRITE command'''
=== LO1B-WRITE command ===


Sends the specified command to the LO1B Hittite synthesizer
Sends the specified command to the LO1B Hittite synthesizer


'''SERVICE [anttenalist]'''
=== SERVICE [anttenalist] ===


Takes the antennas in the list out of subarray1 or subarray2 and drives them to the service position.
Takes the antennas in the list out of subarray1 or subarray2 and drives them to the service position.
Line 222: Line 225:
<span style="color: red">Warning:</span>  Once in service position, the serviced antenna should be put in local operation mode in order to avoid it being controlled by a subsequent schedule command.
<span style="color: red">Warning:</span>  Once in service position, the serviced antenna should be put in local operation mode in order to avoid it being controlled by a subsequent schedule command.


'''SUBARRAY1 antennalist'''
=== SUBARRAY1 antennalist ===


Puts all antennas in the list into subarray1.  All antennas than are not listed, but currently in subarray1, are taken out from subarray1.
Puts all antennas in the list into subarray1.  All antennas than are not listed, but currently in subarray1, are taken out from subarray1.
Line 228: Line 231:
'''<span style="color: red">NOTE: As of Dec 03 2015, this command no longer switches by default the LO connector to an alternative source. To force the LO connector to switch switches, one must use the new explicit command</span> SUBARRAY1_SWITCH antennalist'''  
'''<span style="color: red">NOTE: As of Dec 03 2015, this command no longer switches by default the LO connector to an alternative source. To force the LO connector to switch switches, one must use the new explicit command</span> SUBARRAY1_SWITCH antennalist'''  


'''SUBARRAY2 antennalist'''
=== SUBARRAY2 antennalist ===


Puts all antennas in the list, which are not already in subarray1, into subarray2. In order to move a given antenna from subarray1 to subarray2, one should first redefine subarray1.
Puts all antennas in the list, which are not already in subarray1, into subarray2. In order to move a given antenna from subarray1 to subarray2, one should first redefine subarray1.
Line 234: Line 237:
'''<span style="color: red">NOTE: As of Dec 03 2015, this command no longer switches by default the LO connector to an alternative source. To force the LO connector to switch switches, one must use the new explicit command</span> SUBARRAY2_SWITCH antennalist'''
'''<span style="color: red">NOTE: As of Dec 03 2015, this command no longer switches by default the LO connector to an alternative source. To force the LO connector to switch switches, one must use the new explicit command</span> SUBARRAY2_SWITCH antennalist'''


'''SYNC [anttenalist]'''
=== SYNC [anttenalist] ===


Restarts the real-time executable on all cRIOs corresponding to the antenna list.
Restarts the real-time executable on all cRIOs corresponding to the antenna list.


NOTE: Unlike the general coinvention, not providing a list of antennas commands all cRIOs to restarts their execution.
NOTE: Unlike the general coinvention, not providing a list of antennas commands all cRIOs to restarts their execution.
'''
 
TRACKTABLE filename [antennalist]'''
=== TRACKTABLE filename [antennalist] ===


Uploads to all antennas in the list the tracking table located at “c:\parm\filename”
Uploads to all antennas in the list the tracking table located at “c:\parm\filename”


'''TRAJ-FILE filename [antennalist]'''
=== TRAJ-FILE filename [antennalist] ===


Uploads to all cRIOs corresponding to antennas in the list the trajectory file table located at “c:\parm\filename”
Uploads to all cRIOs corresponding to antennas in the list the trajectory file table located at “c:\parm\filename”
'''
 
UNLISTEDCOMMAND  [antennalist]'''
=== UNLISTEDCOMMAND  [antennalist] ===


Any command not listed above is sent for local execution to all cRIOs corresponding to antennas in the list.
Any command not listed above is sent for local execution to all cRIOs corresponding to antennas in the list.
Line 256: Line 259:
<span style="color: red">NOTE:  These commands are selectively sent by ACC to all antennas in the optional argument antenalist, or, if not present, to all antennas in subarray1</span>
<span style="color: red">NOTE:  These commands are selectively sent by ACC to all antennas in the optional argument antenalist, or, if not present, to all antennas in subarray1</span>


'''AGC active [low [high [samples]]]'''
=== AGC active [low [high [samples]]] ===


Activates (1) or deactivates (0) the front end automatic gain control loop, which adjust the FEMATTN level when both of the HPOL and VPOL voltages, averaged over the given number of consecutive '''''samples''''' , cross the '''''low''''' and '''''high''''' voltage limits.  Missing parameter values are uploaded from the [FEM AGC] section of the local “c:\ni-rt\startup\crio.ini” file. All parameters provided when an AGC command is issued are saved in the same file for further use.
Activates (1) or deactivates (0) the front end automatic gain control loop, which adjust the FEMATTN level when both of the HPOL and VPOL voltages, averaged over the given number of consecutive '''''samples''''' , cross the '''''low''''' and '''''high''''' voltage limits.  Missing parameter values are uploaded from the [FEM AGC] section of the local “c:\ni-rt\startup\crio.ini” file. All parameters provided when an AGC command is issued are saved in the same file for further use.
Line 262: Line 265:
NOTE: At startup, the AGC loop is activated or not according with the latest '''''active''''' value written in the initialization file.
NOTE: At startup, the AGC loop is activated or not according with the latest '''''active''''' value written in the initialization file.


'''AZELOFF azoff eloff'''
=== AZELOFF azoff eloff ===


Sets the Azimuth and Elevation offsets indicated in the argument list
Sets the Azimuth and Elevation offsets indicated in the argument list


'''RADECOFF raoff decoff'''
=== RADECOFF raoff decoff ===


Sets the RA and DEC offsets indicated in the argument list
Sets the RA and DEC offsets indicated in the argument list


'''FLUSH'''
=== FLUSH ===


Flush the existing tracktable from the associated antenna controller
Flush the existing tracktable from the associated antenna controller


'''ND-ON and ND-OFF'''
=== ND-ON and ND-OFF ===


Set on/off the local noise diode.
Set on/off the local noise diode.


'''POSITION azimuth elevation'''
=== POSITION azimuth elevation ===


Requests a given azel position
Requests a given azel position


'''RESTART'''
=== RESTART ===


Reboots the cRIO
Reboots the cRIO


'''DRIVE-RESET'''
=== DRIVE-RESET ===


Resets Antenna controller
Resets Antenna controller


'''STOP'''
=== STOP ===


Stops the antenna
Stops the antenna


'''STOW'''
=== STOW ===


Stows the antenna
Stows the antenna


'''TRACK'''
=== TRACK ===


Sets antenna in track mode
Sets antenna in track mode


'''TEC-LOG'''
=== TEC-LOG ===


Dumps all TEC register values to the local log file “c:\tec.txt” for debugging purposes
Dumps all TEC register values to the local log file “c:\tec.txt” for debugging purposes


'''TEC-INIT'''
=== TEC-INIT ===


Initializes the TEC controller with hard-wired register values read from a working controller.
Initializes the TEC controller with hard-wired register values read from a working controller.


'''TRAJ-ON and TRAJ-OFF'''
=== TRAJ-ON and TRAJ-OFF ===


Starts/Ends the execution of the trajectory script
Starts/Ends the execution of the trajectory script


NOTE: At startup, the WINDSCRAM loop is activated or not according with the latest active written in the initialization file.
NOTE: At startup, the WINDSCRAM loop is activated or not according with the latest '''''active''''' written in the initialization file.


'''BSCRAM-ON'''
=== BSCRAM-ON ===


Activate the BRIGHTSCRAM Monitor
Activate the BRIGHTSCRAM Monitor


'''BSCRAM-OFF'''
=== BSCRAM-OFF ===


Deactivate the BRIGHTSCRAM Monitor
Deactivate the BRIGHTSCRAM Monitor


'''BSCRAM-CLEAR'''
=== BSCRAM-CLEAR ===


Takes the antenna out of the BRIGHTSCRAM Active State independently of the brightness sensor state.
Takes the antenna out of the BRIGHTSCRAM Active State independently of the brightness sensor state.
Line 332: Line 335:
Note: If the BRIGHTSCRAM Monitor is active, the antenna may get back in the Active State depending on the state of the brightness sensor.
Note: If the BRIGHTSCRAM Monitor is active, the antenna may get back in the Active State depending on the state of the brightness sensor.


'''BSCRAM-SET'''
=== BSCRAM-SET ===


Force the antenna into the BRIGHTSCRAM Active State independently of the brightness sensor state.
Force the antenna into the BRIGHTSCRAM Active State independently of the brightness sensor state.


'''BSCRAM-WAIT seconds'''
=== BSCRAM-WAIT seconds ===


Sets the BRIGHTSCRAM Monitor waiting time before clearing the BRIGHSCRAM ACTIVE state.
Sets the BRIGHTSCRAM Monitor waiting time before clearing the BRIGHSCRAM ACTIVE state.
Line 342: Line 345:
Note: This setting is saved in the crio.ini file and remains persistent until changed
Note: This setting is saved in the crio.ini file and remains persistent until changed


'''BSCRAM-OFFSET'''
=== BSCRAM-OFFSET ===
 
Sets the BRIGHTSCRAM operation mode to stow the antenna when in active state.
 
Note: This setting is saved in the crio.ini file and remains persistent until changed
 
'''BSCRAM-OFFSET'''


Sets the BRIGHTSCRAM operation mode to apply offsets
Sets the BRIGHTSCRAM operation mode to apply offsets


Note: This setting is saved in the crio.ini file and remains persistent until changed
Note: This setting is saved in the crio.ini file and remains persistent until changed.


'''BSCRAM-AZELOFF azoff eloff'''
=== BSCRAM-AZELOFF azoff eloff ===


Sets the Azimuth and Elevation Offsets (degrees) for the BRIGHTSCRAM offset operation mode.  
Sets the Azimuth and Elevation Offsets (degrees) for the BRIGHTSCRAM offset operation mode.  
Line 362: Line 359:
<span style="color: red">Warning:</span> No action is taken if less than 2 arguments are provided
<span style="color: red">Warning:</span> No action is taken if less than 2 arguments are provided
   
   
'''WSCRAM-ON'''
=== WSCRAM-ON ===


Activate the WINDSCRAM Monitor
Activate the WINDSCRAM Monitor


'''WSCRAM-OFF'''
=== WSCRAM-OFF ===


Deactivate the WINDSCRAM Monitor
Deactivate the WINDSCRAM Monitor


'''WSCRAM-LIMIT value'''
=== WSCRAM-LIMIT value ===


Sets the wind speed threshold.  
Sets the wind speed threshold.  
Line 376: Line 373:
Note: This setting is saved in the crio.ini file and remains persistent until changed.  
Note: This setting is saved in the crio.ini file and remains persistent until changed.  


'''WSCRAM-WAIT seconds'''
=== WSCRAM-WAIT seconds ===


Sets the WINDSCRAM Monitor waiting time between checking the wind speed.
Sets the WINDSCRAM Monitor waiting time between checking the wind speed.
Line 382: Line 379:
Note: This setting is saved in the crio.ini file and remains persistent until changed.  
Note: This setting is saved in the crio.ini file and remains persistent until changed.  


'''UpdateElevationDiagnostics 1'''
=== UpdateElevationDiagnostics 1 ===


Requests an update of the elevation trip register.
Requests an update of the elevation trip register.


'''UpdateAzimuthDiagnostics 1'''
=== UpdateAzimuthDiagnostics 1 ===


Requests an update of the azimuth trip register.
Requests an update of the azimuth trip register.

Latest revision as of 13:21, 3 November 2016

NOTE: All Schedule commands accept as optional arguments a list of antennas to which the command should selectively sent. Accepted syntaxes are:

Command ant1 ant2 ant3

Command ant1-3

Command subarray1

Command subarray2

If no antenna list is indicated, the command is sent to all antennas currently in subarray1.

Commands handled directly by ACC

ABORT

Aborts all commands sent to ACC but not yet executed

CLEAROFF [antenna list]

Sets all AzEl or RaDec offsets to zero

DCMATTN HPOLattn VPOLattn [antenna list]

Indicates the VPOL and HPOL attenuations for the DCM modules indicated in the list. The attenuations are applied on the next second start.

Warning:The command is executed only if the DCM modules are in manual mode (see the DCMAUTO-ON and DCMAUTO-OFF command below)

DCMAUTO-OFF [antenna list]

Sets the DCM modules in the manual attenuation mode. This mode allows the attenuations requested by the DCMATTN to be applied.

DCMAUTO-ON [antenna list]

Sets the DCM modules in the automatic attenuation mode. This mode ignores the manual DCMATTN commands and applies the attenuation set through the DCMREGIME mechanism.

DCMOFFSET level1 level2…..level50

Sets the 50 DCM regime states to be cycled during each second, starting with the next second boundary. The command expects up to 50 arguments. If fewer arguments are provided, the existing set is repeated in the same sequence until all 50 slots are filled. This command is only intended for testing. During normal operations, the DCMREGIME states are requested by the DPP computer.

Warning: The command is executed only if the DCM modules are in auto mode (see the DCMAUTO-ON and DCMAUTO-OFF command below).

NOTE: The DCMREGIME settings are changed on the edge of the next second after a TCP/IP message is received by ACC at the TCP.dpp.port (default port: 6344-set in ACC.ini file ). The message is expected to be a fixed length binary string having the following format

REGIME + blank space + 50 32bit integers (I32)

DCMTABLE [antennalist] filename

Request the antenna list portion of a specific DCM base attenuation table to be uploaded on the respective DCM modules. The DCM table must have 30 columns and 50 rows, each pair of adjacent columns listing the HPOL-VPOL pairs for each of the 50 slots of a tuning sequence. The DCM table text file must be located in the ACC “c:\parm” directory and its default name is “DCM.txt”.

The DCM/table_timeout key in the ACC.ini files have to be manually edited in order to modify the default timeout (ms) of the DCM modules when a table is broadcasted.

The actual DCM attenuations for a given tuning slot are calculated based on the following formula

atten[pol,tuning_index]=base_atten[pol,tuning_index]+regime*2db

DPPOFFSET-OFF

Ignores DCM offset attenuation recommendations sent by DPP but still allows setting the offsets via the DCMOFFSET schedule command.

DPPOFFSET-ON

Applies DCM offset attenuation recommendations sent by DPP but still allows setting the offsets via the DCMOFFSET schedule command.

NOTE: This is the default behavior of the system after each hardware ACC reboot or after a REBOOT or RESET command is sent via TCP/IP to the emergency 6543 acc.solar.ini port

FEM-INIT

Initialize all front-end module base attenuations with the values read from the ACC initialization file: “c:\ni-rt\startup\acc.ini”.

FEMATTN level [antennalist]

Manually selects the front-end attenuation levels for the antennas indicated in the list to be applied on the next second boundary. The attenuation level selects the corresponding entry in the “c:\parms\FEMATTN.txt” attenuation FEM table located on each the cRIOs.

The attenuation level set by this command is saved in the [FEM AGC] section of the “c:\ni-rt\startup\crio.ini” and it is automatically applied when the module is restarted.

Warning: The attenuation level setting may be overwritten by the AGC loop, if active.

The format of the table is as shown below (column heads are added here for clarity)

FEMATT N level First attenuation Second attenuation Total attenuation
0 0 0 0
1 0 2 2
2 0 4 4
3 0 6 6
4 0 8 8
5 0 10 10
6 0 12 12
7 2 12 14
8 2 14 16
9 4 14 18
10 4 16 20
11 4 18 22
12 4 20 24
13 6 20 26
14 8 20 28
15 31 31 62

The actual FEM attenuations applied as the result of a FEMATTN command are given by

HPOL_ATTENUATION=HPOL_BASE+FEMATTN.txt(level)

VPOL_ATTENUATION=VPOL_BASE+FEMTTTN.txt(level)

Where Attenuation, Base, and FEMATTN.txt(level) are two elements vectors indicating the settings for the First and Second attenuators.

HATTN first second [antennalist]

Sets the FEM HPOL_BASE first and second attenuators for the antennas in the list, and overwrites the corresponding sections in the global “c:\ni-rt\startup\acc.ini” file, as well as in the local “c:\ni-rt\startup\crio.ini” files.

VATTN first second [antennalist]

Sets the FEM VPOL_BASE first and second attenuators for the antennas in the list, and overwrites the corresponding sections in the global “c:\ni-rt\startup\acc.ini” file, as well as in the local “c:\ni-rt\startup\crio.ini” files.

FSEQ-FILE filename

Tells ACC to upload to the Hittite synthesizer the frequency sequence located at “c:\parm\filename”.

FSEQ-INIT

Initializes the Hittite synthesizer according to the settings defined in the [LO Configuration] section of the “c:\ni-rt\startup\acc.ini” file.

FSEQ-ON

Starts the tuning sequence

FSEQ-OFF

Stops the tuning sequence

FSEQ-SCRIPT filename

Sends, line by line, to the Hittite synthesizer the command sequence listed in the “c:\parm\filename” script file.

LO1A-REBOOT

Commands the PDU controller to recycle the power on the LO1A Hittite synthesizer

LO1B-REBOOT

Not implemented yet

LO1A-WRITE command

Sends the specified command to the LO1A Hittite synthesizer

LO1B-WRITE command

Sends the specified command to the LO1B Hittite synthesizer

SERVICE [anttenalist]

Takes the antennas in the list out of subarray1 or subarray2 and drives them to the service position.

Warning: Once in service position, the serviced antenna should be put in local operation mode in order to avoid it being controlled by a subsequent schedule command.

SUBARRAY1 antennalist

Puts all antennas in the list into subarray1. All antennas than are not listed, but currently in subarray1, are taken out from subarray1.

NOTE: As of Dec 03 2015, this command no longer switches by default the LO connector to an alternative source. To force the LO connector to switch switches, one must use the new explicit command SUBARRAY1_SWITCH antennalist

SUBARRAY2 antennalist

Puts all antennas in the list, which are not already in subarray1, into subarray2. In order to move a given antenna from subarray1 to subarray2, one should first redefine subarray1.

NOTE: As of Dec 03 2015, this command no longer switches by default the LO connector to an alternative source. To force the LO connector to switch switches, one must use the new explicit command SUBARRAY2_SWITCH antennalist

SYNC [anttenalist]

Restarts the real-time executable on all cRIOs corresponding to the antenna list.

NOTE: Unlike the general coinvention, not providing a list of antennas commands all cRIOs to restarts their execution.

TRACKTABLE filename [antennalist]

Uploads to all antennas in the list the tracking table located at “c:\parm\filename”

TRAJ-FILE filename [antennalist]

Uploads to all cRIOs corresponding to antennas in the list the trajectory file table located at “c:\parm\filename”

UNLISTEDCOMMAND [antennalist]

Any command not listed above is sent for local execution to all cRIOs corresponding to antennas in the list.

Commands handled directly by cRIOs

NOTE: These commands are selectively sent by ACC to all antennas in the optional argument antenalist, or, if not present, to all antennas in subarray1

AGC active [low [high [samples]]]

Activates (1) or deactivates (0) the front end automatic gain control loop, which adjust the FEMATTN level when both of the HPOL and VPOL voltages, averaged over the given number of consecutive samples , cross the low and high voltage limits. Missing parameter values are uploaded from the [FEM AGC] section of the local “c:\ni-rt\startup\crio.ini” file. All parameters provided when an AGC command is issued are saved in the same file for further use.

NOTE: At startup, the AGC loop is activated or not according with the latest active value written in the initialization file.

AZELOFF azoff eloff

Sets the Azimuth and Elevation offsets indicated in the argument list

RADECOFF raoff decoff

Sets the RA and DEC offsets indicated in the argument list

FLUSH

Flush the existing tracktable from the associated antenna controller

ND-ON and ND-OFF

Set on/off the local noise diode.

POSITION azimuth elevation

Requests a given azel position

RESTART

Reboots the cRIO

DRIVE-RESET

Resets Antenna controller

STOP

Stops the antenna

STOW

Stows the antenna

TRACK

Sets antenna in track mode

TEC-LOG

Dumps all TEC register values to the local log file “c:\tec.txt” for debugging purposes

TEC-INIT

Initializes the TEC controller with hard-wired register values read from a working controller.

TRAJ-ON and TRAJ-OFF

Starts/Ends the execution of the trajectory script

NOTE: At startup, the WINDSCRAM loop is activated or not according with the latest active written in the initialization file.

BSCRAM-ON

Activate the BRIGHTSCRAM Monitor

BSCRAM-OFF

Deactivate the BRIGHTSCRAM Monitor

BSCRAM-CLEAR

Takes the antenna out of the BRIGHTSCRAM Active State independently of the brightness sensor state.

If the BRIGHTSCRAM Monitor’s operation mode is set to STOW, clearing the BRIGHSCRAM ACTIVE state does not have any effect on the mechanical state of the antenna. If the BRIGHTSCRAM Monitor’s operation mode is set to OFFSET, clearing the BRIGHSCRAM ACTIVE state results in removing the AZEL offsets.

Note: If the BRIGHTSCRAM Monitor is active, the antenna may get back in the Active State depending on the state of the brightness sensor.

BSCRAM-SET

Force the antenna into the BRIGHTSCRAM Active State independently of the brightness sensor state.

BSCRAM-WAIT seconds

Sets the BRIGHTSCRAM Monitor waiting time before clearing the BRIGHSCRAM ACTIVE state.

Note: This setting is saved in the crio.ini file and remains persistent until changed

BSCRAM-OFFSET

Sets the BRIGHTSCRAM operation mode to apply offsets

Note: This setting is saved in the crio.ini file and remains persistent until changed.

BSCRAM-AZELOFF azoff eloff

Sets the Azimuth and Elevation Offsets (degrees) for the BRIGHTSCRAM offset operation mode.

Note: This setting is saved in the crio.ini file and remains persistent until changed. Default values re AZOFF=0 and ELOFF=10

Warning: No action is taken if less than 2 arguments are provided

WSCRAM-ON

Activate the WINDSCRAM Monitor

WSCRAM-OFF

Deactivate the WINDSCRAM Monitor

WSCRAM-LIMIT value

Sets the wind speed threshold.

Note: This setting is saved in the crio.ini file and remains persistent until changed.

WSCRAM-WAIT seconds

Sets the WINDSCRAM Monitor waiting time between checking the wind speed.

Note: This setting is saved in the crio.ini file and remains persistent until changed.

UpdateElevationDiagnostics 1

Requests an update of the elevation trip register.

UpdateAzimuthDiagnostics 1

Requests an update of the azimuth trip register.