kstars

celestronprotocol.h

00001 /*
00002 * Header File for the Telescope Control protocols for the Meade LX200
00003 * Author:  John Kielkopf (kielkopf@louisville.edu)
00004 *
00005 * This file contains header information used in common with xmtel.
00006 *
00007 * 15 May 2003 -- Version 2.00
00008 *
00009 */
00010 
00011 
00012 #ifndef CELESTRON_PROTOCOL_H
00013 #define CELESTRON_PROTOCOL_H
00014 
00015 /* These are user defined quantities that set the limits over which it */
00016 /* is safe to operate the telescope.  */
00017 
00018 
00019 /* LOWER is the number of degrees from the zenith that you will allow. */
00020 /* Use 80, for example, to keep the eyepiece end out of the fork arm space */
00021 /* of an LX200 telescope. */
00022 
00023 #define LOWER         90.
00024 
00025 /* HIGHER is the horizon.  0 is an unobstructed horizon in every direction. */
00026 /* Use 10, for example, to limit sighting below 10 degrees above the horizon. */
00027 
00028 #define HIGHER         0.
00029 
00030 
00031 /* Set this if a slew to the north sends the telescope south. */
00032 
00033 #define REVERSE_NS  0   /* 1 for reverse; 0 for normal. */
00034 
00035 
00036 /* Set this for maximum slew rate allowed in degree/sec. */
00037 
00038 #define MAXSLEWRATE 4   /* 2 for safety; 4 for 16-inch; 8 otherwise. */
00039 
00040 
00041 
00042 
00043 /* The following parameters are used internally to set speed and direction. */
00044 /* Do not change these values. */
00045 
00046 
00047 #define SLEW        0
00048 #define FIND        1
00049 #define CENTER      2
00050 #define GUIDE       3
00051 
00052 #if REVERSE_NS > 0
00053 #define NORTH       3
00054 #define SOUTH       0
00055 #else
00056 #define NORTH       0
00057 #define SOUTH       3
00058 #endif
00059 
00060 #define EAST        2
00061 #define WEST        1
00062 
00063 /* Slew speed defines */
00064 
00065 # define SLEWRATE8     8    /* should be 8 degrees per second (not 16-inch) */
00066 # define SLEWRATE4     4    /* should be 4 degrees per second */
00067 # define SLEWRATE3     3    /* should be 3 degrees per second */
00068 # define SLEWRATE2     2    /* should be 2 degrees per second */
00069 
00070 /* Reticle defines */
00071 
00072 #define BRIGHTER        16  /* increase */
00073 #define DIMMER          8   /* decrease */
00074 #define BLINK0          0   /* no blinking */ 
00075 #define BLINK1          1   /* blink rate 1 */
00076 #define BLINK2          2   /* blink rate 2 */
00077 #define BLINK3          4   /* blink rate 3 */
00078  
00079 
00080 /* Focus defines */
00081 
00082 #define FOCUSOUT        8   /* positive voltage output */
00083 #define FOCUSIN         4   /* negative voltage output */
00084 #define FOCUSSTOP       0   /* no output */ 
00085 #define FOCUSSLOW       1   /* half voltage */
00086 #define FOCUSFAST       2   /* full voltage */
00087 
00088 
00089 /* Rotator defines */
00090 
00091 #define ROTATORON        1   /* image rotator on */
00092 #define ROTATOROFF       0   /* image rotator off */
00093 
00094 
00095 /* Fan defines */
00096 
00097 #define FANON        1   /* cooling fan on */
00098 #define FANOFF       0   /* cooling fan off */
00099 
00100 #ifdef __cplusplus
00101 extern "C" {
00102 #endif
00103 
00104 int ConnectTel(char *port);
00105 void DisconnectTel(void);
00106 int  CheckConnectTel(void);
00107 
00108 void SetRate(int newRate);
00109 void SetLimits(double limitLower, double limitHigher);
00110 void StartSlew(int direction);
00111 void StopSlew(int direction);
00112 double GetRA(void);
00113 double GetDec(void);
00114 int  SlewToCoords(double newRA, double newDec);
00115 int  SyncToCoords(double newRA, double newDec);
00116 int  CheckCoords(double desRA, double desDec);
00117 
00118 void StopNSEW(void);
00119 int  SetSlewRate(void);
00120 
00121 int  SyncLST(double newTime);
00122 int  SyncLocalTime();
00123 
00124 void Reticle(int reticle);
00125 void Focus(int focus);
00126 void Derotator(int rotate);
00127 void Fan(int fan);
00128 
00129 #ifdef __cplusplus
00130 }
00131 #endif
00132 
00133 #endif
00134
kstars

celestronprotocol.h

kstars

API Reference
