User Tools

Site Tools


tcs:tcsng_command_list

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
tcs:tcsng_command_list [2012/11/14 08:39]
admin
tcs:tcsng_command_list [2019/08/22 18:41]
scott
Line 17: Line 17:
  SECZ(airmass) = XX.xx  SECZ(airmass) = XX.xx
  EPOCH = EEEE.e  EPOCH = EEEE.e
 +
   
                    
- AZ Azmouth+ AZ Azimuth
  Args: N/A  Args: N/A
  Returns: [ddd.dd]  Returns: [ddd.dd]
Line 76: Line 77:
  Args: N/A  Args: N/A
  Returns: [JJJJJJJ.j]  Returns: [JJJJJJJ.j]
 +
 +        FLEXFILE Path and file name of current flex map   Added by Scott 12/2012
 +                 Args: N/A
 +                 Returns: [PATH/][pctcs_.tp]
 +
 +        LIMITPROF Horizon limit profile as a function of azimuth      Added by Scott 12/2012
 +                       The first (and last) value given is the horizon limit at 0 degrees azimuth
 +                       each subsequent value is a horizon limit at increments of 15 degrees of azimuth
 +                       so the 2nd value is the limit at 15 degrees azimuth, the third is the horizon limit 
 +                       at 30 degrees azimuth etc. 
 +                 Args: N/A
 +                 Returns [hh] [hh] [hh] [hh] ... (25 in all)
  
  LIMIT limit status bits (ACCORDING TO JAVA GUI)  LIMIT limit status bits (ACCORDING TO JAVA GUI)
  Args: N/A  Args: N/A
  Returns: this returns an 8 bit integer whose bits represent the following  Returns: this returns an 8 bit integer whose bits represent the following
- bit0(LSB) = RA low limit + bit0(LSB) = RA  
- bit1 = RA upper limit + bit1 = DEC 
- bit2 = DEC low limit + bit2 = Derotator 
- bit3 = DEC upper limit + bit3 = Hardware Horizon 
- bit4-6 = unknown ??????? + bit4 = Software Horizon 
- bit7 = limit warning? + bit5 = Focus Upper 
- bit8 = limit warning?+ bit6 = Focus Lower
  a 1 indicates limit active, 0 indicates limit not active  a 1 indicates limit active, 0 indicates limit not active
  
Line 101: Line 114:
  a 1 indicates limit active, 0 indicates limit not active  a 1 indicates limit active, 0 indicates limit not active
   
 + LIMITINHIBIT   limit inhibit status
 +                       args N/A
 +                       Returns: 0 if limits are active and 1 if limits are inactive
 +===SOFTLIMITS==== 
 +[[tcs:limit_logic| S1 and S2 limits are defined here ]]
 + SOFTLIMITS     Software limit status
 +                       args N/A
 +                       
 +                       Returns : 6 bit software limit status
 +                       
 +                       bit 0 = RA S2          
 +                       bit 1 = RA S1          
 +                       bit 2 = DEC S2         
 +                       bit 3 = DEC S1         
 +                       bit 4 = Horizon S2     
 +                       bit 5 = Horizon S1
 +                       [[tcs:limit_logic|Limit Logic in TCS]]    
 +
 +                       
 +        
  MOTION  Motion status bits  MOTION  Motion status bits
  Args: N/A  Args: N/A
Line 174: Line 207:
  GUIDE(Guide Rate) = +XXXXXXXXX.xxx  GUIDE(Guide Rate) = +XXXXXXXXX.xxx
  DRIFT(Drift Rate) = +XXXXXXXXX.xxx  DRIFT(Drift Rate) = +XXXXXXXXX.xxx
 +
   
  XRA "Extended RA"  XRA "Extended RA"
Line 187: Line 221:
  GUIDE(Guide Rate) = +XXXXXXXXX.xxx  GUIDE(Guide Rate) = +XXXXXXXXX.xxx
  DRIFT(Drift Rate) = +XXXXXXXXX.xxx  DRIFT(Drift Rate) = +XXXXXXXXX.xxx
 +        
 +        
 +===Satellite Requests===        
 +        
 +        
 +       GETSATELAZ Satellite horizontal coordinates
 +                   Args: N/A
 +                   returns [EL] [AZ]
 +                   
 +        GETSATECI  Satellite Earth Centered Inertial Cartesian coords
 +                   Args: N.A
 +                   Returns: [X] [Y] [Z]
 +                   
 +        GETSATECEF Satellite Earth Centered Earth Fixed Cartesian coords
 +                   Args: N.A
 +                   Returns: [X] [Y] [Z]
  
 +===undefined Request===
 + TEST1 ??? >> probably useless but is currently in the command set
 + Args: ???
 + Returns: ???
 +
 + INDEX ???
 + Args: ???
 + Returns: ???
 +
 + PP ???
 + Args: ???
 + Returns: ???
 +
 + SRVFRQ  ???
 + Args: ???
 + Returns: ???
 +
 +
 +===Dome Request===
 +
 + DOME Dome control information
 + Args: "PARAM" returns dome setup parameters, all other strings return control info
 + Returns: 
 + Parameters: [CPD] [SD] [W] [SDW] [NU] [RHO] [PHI] [LOOK] [HOLD]
 + CPD(Counts Per Degree) = XXX.xxxxxxx
 + SD(Stow Degrees)= XXX.xxxxxxx
 + W(Dome Width) = XXX.xxxxxxx
 + SDW(Stow Dome Width)= XXX.xxxxxxx
 + NU = XXX.xxxxxxx
 + RHO = XXX.xxxxxxx
 + PHI = XXX.xxxxxxx
 + LOOK(Lookahead) = XX
 + HOLD(Hold Dome) = XX
 +
 + Control Info: [DEL] [MOD] [INIT] [TELAZ] [AZ] [HOME]
 + DEL(Delta Position) = +XXX.XXXXXXX
 + MOD(Mode) = XX
 + INIT(Initialized) = XX
 + TELAZ(Telescope Azmouth) =  +XXX.XXXXXXX
 + AZ(Dome Azmouth) = +XXX.XXXXXXX
 + HOME(Home Position) = +XXX.XXXXXXX
 +        
 +        
 +        
 +        
 +===Focus Request===
 + FOCSPEED Focus Speed
 + Args: N/A
 + Returns: ["FAST" or "SLOW"]
 +
 + FOCUS Focus position
 + Args: N/A
 + Returns: +XXXXX
 +
 +=== DIO Request ===
 +
 +       DIO All 6 bytes of DIO
 +            Args: N/A
 +            Returns: A1 B1 C1 A2 B2 C2 as hex numbers
 +            A1: 
 +                Bit0: FOCUS UP 
 +                Bit1: FOCUS DN
 +                Bit2: FOCUS F/S
 +                Bit3: ESTOP STATUS
 +                Bit4  HA ALT LIMIT
 +                Bit5  DEC ALT LIMIT
 +                Bit6  DEROT ALT LIMIT
 +                Bit7  SPARE A7A
 +                
 +           B1: Paddle Buttons
 +                Bit0: NORTH
 +                Bit1: SOUTH
 +                Bit2: EAST
 +                Bit3: WEST
 +                Bit4: GUIDE/DRIFT
 +                Bit5: SLEW
 +                Bit6: DOME RIGHT
 +                Bit7  DOME LEFT
 +            
 +            C1: 
 +                Bit0: HA LIMIT
 +                Bit1: DEC LIMIT
 +                Bit2: HOR LIMIT
 +                Bit3: HS NORTH
 +                Bit4: HS EAST
 +                Bit5: Dome Home
 +                Bit6: Focus Up  Limit
 +                Bit7: Focus 
 +                
 +           A2:
 +               Bit0: HA E SLEW 
 +               Bit1: HA W SLEW
 +               Bit2: DEC N SLEW 
 +               Bit3: DEC S SLEW 
 +               Bit4  HOR SLEW LIMIT
 +               Bit5  DEROT CW SLEW LIMIT
 +               Bit6  DEROT CCW SLEW LIMIT
 +               Bit7  REMOTE LOCKOUT
 +
 +           
 +          
 +            
 ==== Commands ==== ==== Commands ====
  
Line 228: Line 380:
  
  ELAZ Move to position in Elevation and Azmouth  ELAZ Move to position in Elevation and Azmouth
- Args: [EEE.EE] [AAA.AA]+ Args: [EE.EE] [AAA.AA]
  Returns: "OK" or "FAILED"  Returns: "OK" or "FAILED"
  
Line 281: Line 433:
  Returns:  "OK" or "FAILED"  Returns:  "OK" or "FAILED"
  
- PAD Software paddle command [Direction] [rate]  or PAD XX for termination+ PAD Software paddle command [Direction] [rate]  or PAD XX for termination  
 +                      This function is not recommended for use near the horizon limits!
  Args: [Direction] [rate]  Args: [Direction] [rate]
  DIRECTION = NORTH, SOUTH, EAST, WEST, NE, NW, SE, SW  DIRECTION = NORTH, SOUTH, EAST, WEST, NE, NW, SE, SW
  RATE = XXXXXXX.xx (arcsecs/sec)  RATE = XXXXXXX.xx (arcsecs/sec)
  any string not described in DIRECTION will terminate paddle   any string not described in DIRECTION will terminate paddle 
 +                        this terminate string must be sent at the end of each movement
 +                        when the button is released. 
  Returns: "OK" or "FAILED"  Returns: "OK" or "FAILED"
  
Line 341: Line 496:
  
  
-Catalogs +===Catalogs Command=== 
-Command+
  ABELL ABELL Catalog object XXXXXXX  ABELL ABELL Catalog object XXXXXXX
  Args: XXXXXXX  Args: XXXXXXX
Line 379: Line 534:
  Returns: "OK" or "FAILED"   Returns: "OK" or "FAILED" 
  
-Planets +===Planets Command=== 
-Command:+
  MERCURY Track Mercury   MERCURY Track Mercury 
  Args: N/A  Args: N/A
Line 421: Line 576:
  Returns: "OK" or "FAILED"  Returns: "OK" or "FAILED"
   
-Dome 
-Request: 
- DOME Dome control information 
- Args: "PARAM" returns dome setup parameters, all other strings return control info 
- Returns:  
- Parameters: [CPD] [SD] [W] [SDW] [NU] [RHO] [PHI] [LOOK] [HOLD] 
- CPD(Counts Per Degree) = XXX.xxxxxxx 
- SD(Stow Degrees)= XXX.xxxxxxx 
- W(Dome Width) = XXX.xxxxxxx 
- SDW(Stow Dome Width)= XXX.xxxxxxx 
- NU = XXX.xxxxxxx 
- RHO = XXX.xxxxxxx 
- PHI = XXX.xxxxxxx 
- LOOK(Lookahead) = XX 
- HOLD(Hold Dome) = XX 
-  
- Control Info: [DEL] [MOD] [INIT] [TELAZ] [AZ] [HOME] 
- DEL(Delta Position) = +XXX.XXXXXXX 
- MOD(Mode) = XX 
- INIT(Initialized) = XX 
- TELAZ(Telescope Azmouth) =  +XXX.XXXXXXX 
- AZ(Dome Azmouth) = +XXX.XXXXXXX 
- HOME(Home Position) = +XXX.XXXXXXX 
  
-Command: 
  DOME Command dome control  DOME Command dome control
  Args: This command takes one argument at a time from the following  Args: This command takes one argument at a time from the following
Line 481: Line 612:
  Returns:   "OK" or "FAILED"  Returns:   "OK" or "FAILED"
  
-Focus 
-Request 
- FOCSPEED Focus Speed 
- Args: N/A 
- Returns: ["FAST" or "SLOW"] 
  
- FOCUS Focus position 
- Args: N/A 
- Returns: +XXXXX 
  
-Command+
  FOCUS move to absolute focus value XXXXXXX  FOCUS move to absolute focus value XXXXXXX
  Args: XXXXXXX  Args: XXXXXXX
Line 520: Line 643:
  Returns: "OK" or "FAILED"  Returns: "OK" or "FAILED"
  
-PEC+[[tcs:periodic_error_correction|Periodic Error Correction]]
 Request Request
  PECSTAT Current PEC operation status  PECSTAT Current PEC operation status
Line 606: Line 729:
  Returns: ???  Returns: ???
  
-undefined??? + SYSSAVE ???
-Request +
- TEST1 ??? >> probably useless but is currently in the command set+
  Args: ???  Args: ???
  Returns: ???  Returns: ???
  
- INDEX ??? + SYSKILL Kills TCS process after disabling stopping all telescope motion. 
- Args: ??? + Args: N/A 
- Returns: ???+ Returns: OK or Failure 
 +         
 +        SYSRESET Restarts TCS process after disbling the telescope       Added by Scott 12/2012 
 +                     Telescope should be stowed before doing this. 
 +                 Args: [TIME] [DD/MM/YY] [HH:MM:SS] 
 +                  
 +                 If no arguments are used the TCS simply restarts  
 +                 as if you had restarted the TCS computer. If for some reason  
 +                 the time is bad on the TCS computer you can add the TIME 
 +                 argument followed by the date and time in UT and TCS will 
 +                 use this and not the computer time for astrometry. 
 +                  
 +                 Returns OK or Failure 
 +                  
 +         
 +       TLE       Gives TCS a new TLE for tracking Earth Satellites 
 +                 Args: Follows this format exactly: [[https://en.wikipedia.org/wiki/Two-line_element_set]] 
 +                  
 +                  
 +       SATTRACK  Tracks the current satellite TLE with the telescope. 
 +                 Args: N/A
  
- PP ??? 
- Args: ??? 
- Returns: ??? 
  
- SRVFRQ  ??? +      NEXTEVENT Gives you rise or set time in hours of coordinates set using the NEXTPOS command.  
- Args: ??? +                Args N.A 
- Returns: ??? +                Returns: Rise/Set (0/1) state and time in decimal hours. 
- +
-Command +
- SYSSAVE ??? +
- Args: ??? +
- Returns: ??? +
- +
- SYSKILL ??? +
- Args: ??? +
- Returns: ??? +
- +
- +
tcs/tcsng_command_list.txt · Last modified: 2019/08/28 13:12 by davner