1 | /* |
---|
2 | * Header File for the Telescope Control protocols for the Meade LX200 |
---|
3 | * Author: John Kielkopf (kielkopf@louisville.edu) |
---|
4 | * |
---|
5 | * This file contains header information used in common with xmtel. |
---|
6 | |
---|
7 | This library is free software; you can redistribute it and/or |
---|
8 | modify it under the terms of the GNU Lesser General Public |
---|
9 | License as published by the Free Software Foundation; either |
---|
10 | version 2.1 of the License, or (at your option) any later version. |
---|
11 | |
---|
12 | This library is distributed in the hope that it will be useful, |
---|
13 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
---|
14 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
---|
15 | Lesser General Public License for more details. |
---|
16 | |
---|
17 | You should have received a copy of the GNU Lesser General Public |
---|
18 | License along with this library; if not, write to the Free Software |
---|
19 | Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA |
---|
20 | * |
---|
21 | * 15 May 2003 -- Version 2.00 |
---|
22 | * |
---|
23 | */ |
---|
24 | |
---|
25 | |
---|
26 | #ifndef CELESTRON_PROTOCOL_H |
---|
27 | #define CELESTRON_PROTOCOL_H |
---|
28 | |
---|
29 | /* These are user defined quantities that set the limits over which it */ |
---|
30 | /* is safe to operate the telescope. */ |
---|
31 | |
---|
32 | |
---|
33 | /* LOWER is the number of degrees from the zenith that you will allow. */ |
---|
34 | /* Use 80, for example, to keep the eyepiece end out of the fork arm space */ |
---|
35 | /* of an LX200 telescope. */ |
---|
36 | |
---|
37 | #define LOWER 90. |
---|
38 | |
---|
39 | /* HIGHER is the horizon. 0 is an unobstructed horizon in every direction. */ |
---|
40 | /* Use 10, for example, to limit sighting below 10 degrees above the horizon. */ |
---|
41 | |
---|
42 | #define HIGHER 0. |
---|
43 | |
---|
44 | |
---|
45 | /* Set this if a slew to the north sends the telescope south. */ |
---|
46 | |
---|
47 | #define REVERSE_NS 0 /* 1 for reverse; 0 for normal. */ |
---|
48 | |
---|
49 | |
---|
50 | /* Set this for maximum slew rate allowed in degree/sec. */ |
---|
51 | |
---|
52 | #define MAXSLEWRATE 4 /* 2 for safety; 4 for 16-inch; 8 otherwise. */ |
---|
53 | |
---|
54 | |
---|
55 | |
---|
56 | |
---|
57 | /* The following parameters are used internally to set speed and direction. */ |
---|
58 | /* Do not change these values. */ |
---|
59 | |
---|
60 | |
---|
61 | #define SLEW 0 |
---|
62 | #define FIND 1 |
---|
63 | #define CENTER 2 |
---|
64 | #define GUIDE 3 |
---|
65 | |
---|
66 | #if REVERSE_NS > 0 |
---|
67 | #define NORTH 3 |
---|
68 | #define SOUTH 0 |
---|
69 | #else |
---|
70 | #define NORTH 0 |
---|
71 | #define SOUTH 3 |
---|
72 | #endif |
---|
73 | |
---|
74 | #define EAST 2 |
---|
75 | #define WEST 1 |
---|
76 | |
---|
77 | /* Slew speed defines */ |
---|
78 | |
---|
79 | # define SLEWRATE8 8 /* should be 8 degrees per second (not 16-inch) */ |
---|
80 | # define SLEWRATE4 4 /* should be 4 degrees per second */ |
---|
81 | # define SLEWRATE3 3 /* should be 3 degrees per second */ |
---|
82 | # define SLEWRATE2 2 /* should be 2 degrees per second */ |
---|
83 | |
---|
84 | /* Reticle defines */ |
---|
85 | |
---|
86 | #define BRIGHTER 16 /* increase */ |
---|
87 | #define DIMMER 8 /* decrease */ |
---|
88 | #define BLINK0 0 /* no blinking */ |
---|
89 | #define BLINK1 1 /* blink rate 1 */ |
---|
90 | #define BLINK2 2 /* blink rate 2 */ |
---|
91 | #define BLINK3 4 /* blink rate 3 */ |
---|
92 | |
---|
93 | |
---|
94 | /* Focus defines */ |
---|
95 | |
---|
96 | #define FOCUSOUT 8 /* positive voltage output */ |
---|
97 | #define FOCUSIN 4 /* negative voltage output */ |
---|
98 | #define FOCUSSTOP 0 /* no output */ |
---|
99 | #define FOCUSSLOW 1 /* half voltage */ |
---|
100 | #define FOCUSFAST 2 /* full voltage */ |
---|
101 | |
---|
102 | |
---|
103 | /* Rotator defines */ |
---|
104 | |
---|
105 | #define ROTATORON 1 /* image rotator on */ |
---|
106 | #define ROTATOROFF 0 /* image rotator off */ |
---|
107 | |
---|
108 | |
---|
109 | /* Fan defines */ |
---|
110 | |
---|
111 | #define FANON 1 /* cooling fan on */ |
---|
112 | #define FANOFF 0 /* cooling fan off */ |
---|
113 | |
---|
114 | #ifdef __cplusplus |
---|
115 | extern "C" { |
---|
116 | #endif |
---|
117 | |
---|
118 | int ConnectTel(char *port); |
---|
119 | void DisconnectTel(void); |
---|
120 | int CheckConnectTel(void); |
---|
121 | |
---|
122 | void SetRate(int newRate); |
---|
123 | void SetLimits(double limitLower, double limitHigher); |
---|
124 | void StartSlew(int direction); |
---|
125 | void StopSlew(int direction); |
---|
126 | double GetRA(void); |
---|
127 | double GetDec(void); |
---|
128 | int SlewToCoords(double newRA, double newDec); |
---|
129 | int SyncToCoords(double newRA, double newDec); |
---|
130 | int CheckCoords(double desRA, double desDec, double tolRA, double tolDEC); |
---|
131 | |
---|
132 | void StopNSEW(void); |
---|
133 | int SetSlewRate(void); |
---|
134 | |
---|
135 | int SyncLST(double newTime); |
---|
136 | int SyncLocalTime(); |
---|
137 | |
---|
138 | void Reticle(int reticle); |
---|
139 | void Focus(int focus); |
---|
140 | void Derotator(int rotate); |
---|
141 | void Fan(int fan); |
---|
142 | |
---|
143 | #ifdef __cplusplus |
---|
144 | } |
---|
145 | #endif |
---|
146 | |
---|
147 | #endif |
---|
148 | |
---|