Differences

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

--- tcs:tcsng_command_list [2012/11/14 08:39]
admin
+++ tcs:tcsng_command_list [2019/08/28 13:12] (current)
davner
@@ Line 17: / Line 17: @@
 			SECZ(airmass) = XX.xx
 			EPOCH = EEEE.e
-	AZ	Azmouth
+	AZ	Azimuth
 		Args: N/A
 		Returns: [ddd.dd]
@@ Line 76: / Line 77: @@
 		Args: N/A
 		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)
 		Args: N/A
 		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
@@ Line 101: / Line 114: @@
 			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
 		Args: N/A
@@ Line 174: / Line 207: @@
 			GUIDE(Guide Rate) = +XXXXXXXXX.xxx
 			DRIFT(Drift Rate) = +XXXXXXXXX.xxx
 	XRA	"Extended RA"
@@ Line 187: / Line 221: @@
 			GUIDE(Guide 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 ===
+**TODO make this consistent with Softlimits (use binary, not hex)**
+       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
+         B2:
+               Bit0: HA DIR
+               Bit1: DEC DIR
+               Bit2: FOCUS DIR
+               Bit3: DEROT DIR
+               Bit4: HA INHIBIT
+               Bit5: DEC INHIBIT
+               Bit6: FOCUS INHIBIT
+               Bit7: DEROT INHIBIT
+          C2:
+              Bit0: RING BIT 0
+              Bit1: RING BIT 1
+              Bit2: SLEW PERMIT
+              Bit3: DEROT LIMIT
+              Bit4  DOME RIGHT OUT
+              Bit5  DOME LEFT OUT
+              Bit6  DOME ENABLE OUT
+              Bit7  SPAREC7B
 ==== Commands ====
@@ Line 228: / Line 401: @@
 	ELAZ	Move to position in Elevation and Azmouth
-		Args: [EEE.EE] [AAA.AA]
+		Args: [EE.EE] [AAA.AA]
 		Returns: "OK" or "FAILED"
@@ Line 281: / Line 454: @@
 		Returns:  "OK" or "FAILED"
 	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]
 			DIRECTION = NORTH, SOUTH, EAST, WEST, NE, NW, SE, SW
 			RATE = XXXXXXX.xx (arcsecs/sec)
 			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"
@@ Line 341: / Line 517: @@
-Catalogs
+===Catalogs Command===
-Command
 	ABELL	ABELL Catalog object XXXXXXX
 		Args: XXXXXXX
@@ Line 379: / Line 555: @@
 		Returns: "OK" or "FAILED"
-Planets
+===Planets Command===
-Command:
 	MERCURY	Track Mercury
 		Args: N/A
@@ Line 421: / Line 597: @@
 		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
 		Args: This command takes one argument at a time from the following
@@ Line 481: / Line 633: @@
 				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
 		Args: XXXXXXX
@@ Line 520: / Line 664: @@
 		Returns: "OK" or "FAILED"
-PEC
+[[tcs:periodic_error_correction|Periodic Error Correction]]
 Request
 	PECSTAT Current PEC operation status
@@ Line 606: / Line 750: @@
 		Returns: ???
-undefined???
+	SYSSAVE	???
-Request
-	TEST1	??? >> probably useless but is currently in the command set
 		Args: ???
 		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: ???

MOON

User Tools

Site Tools

Differences

Page Tools