V1.6.16 - Updates

- Added ability to comment out features (Serial support, Guided Setup and Points Of Interest due to memory pressure
- Made Up and Down buttons work in the CAL menu
- Added support to Serial for syncing RA and DEC, meaning you can tell the mount that it is currently at a specific RA and DEC.

Author: ClutchplateDude

Software/Arduino code/OpenAstroTracker/Globals.h

@@ -1,10 +1,9 @@
 #ifndef _GLOBALS_H_
 #define _GLOBALS_H_
+
 // Set to 1 if you are in the northern hemisphere.
 #define NORTHERN_HEMISPHERE 1
 
-#define DEBUG_MODE
-
 // Time in ms between LCD screen updates during slewing operations
 #define DISPLAY_UPDATE_TIME 200
 

Software/Arduino code/OpenAstroTracker/Mount.cpp

@@ -211,6 +211,49 @@ const DegreeTime Mount::currentDEC() const {
   return decC;
 }
 
+/////////////////////////////////
+//
+// syncRA
+//
+/////////////////////////////////
+// Set the current RA position to be the given time. We do this by adjusting HA by the
+// difference between the current RA and the RA that we were told we were actually at.
+void Mount::syncRA(int hour, int minute, int second) {
+  // Given the display RA coordinates...
+  DayTime newRA = DayTime(hour, minute, second);
+
+  // ... convert to the system RA values
+  newRA.subtractTime(_HACorrection);
+
+  // Calculate the difference between the new system RA and the current system RA
+  DayTime deltaRA = DayTime(newRA);
+  deltaRA.subtractTime(_currentRA);
+
+  // Now add this difference to HA.
+  DayTime newHA = DayTime(_HATime);
+  newHA.addTime(deltaRA);
+  setHA(newHA);
+
+  float targetRA,targetDEC;
+  calculateRAandDECSteppers(targetRA,targetDEC);
+  _stepperRA->setCurrentPosition(targetRA);
+}
+
+/////////////////////////////////
+//
+// syncDEC
+//
+/////////////////////////////////
+// Set the current DEC position to be the given degrees (which are 0 .. -180 for Northern Hemisphere)
+void Mount::syncDEC(int degree, int minute, int second) {
+  Serial.println("SyncDEC: " + String(degree) + ":" + String(minute) + ":" + String(second));
+  _currentDEC = DegreeTime(degree, minute, second);
+  _targetDEC = _currentDEC;
+  float targetRA,targetDEC;
+  calculateRAandDECSteppers(targetRA,targetDEC);
+  _stepperDEC->setCurrentPosition(targetDEC);
+}
+
 /////////////////////////////////
 //
 // startSlewingToTarget
@@ -223,8 +266,9 @@ void Mount::startSlewingToTarget() {
   // Calculate new RA stepper target (and DEC)
   _currentDECStepperPosition = _stepperDEC->currentPosition();
   _currentRAStepperPosition = _stepperRA->currentPosition();
-
-  calculateRAandDECSteppers();
+  float targetRA,targetDEC;
+  calculateRAandDECSteppers(targetRA,targetDEC);
+  moveSteppersTo(targetRA,targetDEC);
 
   _mountStatus |= STATUS_SLEWING | STATUS_SLEWING_TO_TARGET;
   _totalDECMove = 1.0f * _stepperDEC->distanceToGo();
@@ -577,7 +621,7 @@ float Mount::getSpeed(int direction) {
 //
 // This code tells the steppers to what location to move to, given the select right ascension and declination
 /////////////////////////////////
-void Mount::calculateRAandDECSteppers() {
+void Mount::calculateRAandDECSteppers(float& targetRA, float &targetDEC) {
   float hourPos = _targetRA.getTotalHours();
   // Map [0 to 24] range to [-12 to +12] range
   if (hourPos > 12) {
@@ -614,8 +658,8 @@ void Mount::calculateRAandDECSteppers() {
 
   //    float targetRA = clamp(-moveRA, -RAStepperLimit, RAStepperLimit);
   //    float targetDEC = clamp(moveDEC, DECStepperUpLimit, DECStepperDownLimit);
-  float targetRA = -moveRA;
-  float targetDEC = moveDEC;
+  targetRA = -moveRA;
+  targetDEC = moveDEC;
 
   // Can we get there without physical issues? (not doing anything with this yet)
   //  isUnreachable = ((targetRA != -moveRA) || (targetDEC != moveDEC));
@@ -626,7 +670,8 @@ void Mount::calculateRAandDECSteppers() {
   //  if (stepperDEC.currentPosition() != (targetDEC)) {
   //    Serial.println("Moving DEC from " + String(stepperDEC.currentPosition()) + " to " + targetDEC);
   //  }
-
+}
+void Mount::moveSteppersTo(float targetRA, float targetDEC) {
   // Show time: tell the steppers where to go!
   _stepperRA->moveTo(targetRA);
   _stepperDEC->moveTo(targetDEC);

Software/Arduino code/OpenAstroTracker/Mount.hpp

@@ -59,6 +59,12 @@ class Mount {
     // Get current DEC value.
     const DegreeTime currentDEC() const;
 
+    // Set the current RA position to be the given time
+    void syncRA(int hour, int minute, int second);
+
+    // Set the current DEC position to be the given degrees
+    void syncDEC(int degree, int minute, int second);
+
     float getSpeedCalibration();
 
     void setSpeedCalibration(float val);
@@ -114,10 +120,11 @@ class Mount {
     float getSpeed(int direction);
 
     void displayStepperPositionThrottled();
-  
+
   private:
-    void calculateRAandDECSteppers();
+    void calculateRAandDECSteppers(float& targetRA, float& targetDEC);
     void displayStepperPosition();
+    void moveSteppersTo(float targetRA, float targetDEC);
 
     // Returns NOT_SLEWING, SLEWING_DEC, SLEWING_RA, or SLEWING_BOTH. SLEWING_TRACKING is an overlaid bit.
     byte slewStatus();
@@ -128,15 +135,15 @@ class Mount {
     int _stepsPerDECDegree;
     long _lastHASet;
     DayTime _HAAdjust;
-    
+
     DayTime _targetRA;
     DayTime _currentRA;
     long _currentRAStepperPosition;
-    
+
     DegreeTime _targetDEC;
     DegreeTime _currentDEC;
     long _currentDECStepperPosition;
-    
+
     float _totalDECMove;
     float _totalRAMove;
 

Software/Arduino code/OpenAstroTracker/OpenAstroTracker.ino

@@ -14,7 +14,7 @@
 
   =======================================================================================================================================
 */
-String version = "V1.6.15";
+String version = "V1.6.16";
 
 // See NORTHERN_HEMISPHERE in Globals.h if you not in the northern hemisphere
 
@@ -72,9 +72,39 @@ int s = 25;
 // Comment this out to save some code space
 // #define DEBUG_MODE
 
+// Uncomment to run a key diagnostic. No tracker functions are on at all.
+// #define LCD_BUTTON_TEST
+
+////////////////////////////////////////////////////////////////
+//
+// FEATURE SUPPORT SECTION
+//
+// Since the Arduino Uno has very little memory (32KB code, 2KB data) all features
+// stretch the Uno a little too far. So in order to save memory we allow you to enable 
+// and disable features to help manage memory usage.
+// If you run the tracker with an Arduino Mega, you can uncomment all the features.
+//
+// If you would like to drive your OAT mount with only the LCD Shield, 
+// you should comment out SUPPORT_SERIAL_CONTROL
+//
+// If you feel comfortable with configuring the OAT at startup manually, you should comment 
+// out SUPPORT_GUIDED_STARTUP (maybe after you've used it for a while you know what to do).
+//
+// The POI menu can take a little data memory and you may not need it. If not, you can comment
+// out SUPPORT_POINTS_OF_INTEREST
+//
+////////////////////////////////////////////////////////////////
+
+
 // Uncomment this to support the heating menu
 // NOTE: Heating is currently not supported!
 // #define SUPPORT_HEATING
 
-// Uncomment to run a key diagnostic
-// #define LCD_BUTTON_TEST
+// Uncomment to support Guided Startup 
+// #define SUPPORT_GUIDED_STARTUP
+
+// Uncomment to support Serial MEADE support
+#define SUPPORT_SERIAL_CONTROL
+
+// Uncomment to support POI menu. Since memory is running low, this can be disabled in lieu of serial support.
+#define SUPPORT_POINTS_OF_INTEREST

Software/Arduino code/OpenAstroTracker/a_inits.ino

@@ -40,7 +40,11 @@
 // How many menu items at most?
 #define MAXMENUITEMS 10
 
+#ifdef SUPPORT_GUIDED_STARTUP
 bool inStartup = true;        // Start with a guided startup
+#else
+bool inStartup = false;        // Start with a guided startup
+#endif
 
 // Serial control variables
 bool inSerialControl = false; // When the serial port is in control

Software/Arduino code/OpenAstroTracker/b_setup.ino

@@ -15,11 +15,11 @@ void setup() {
   //Serial.begin(38400);
   Serial.begin(57600);
   //BT.begin(9600);
-  
+
 #ifdef DEBUG_MODE
   Serial.println("Hello");
 #endif
-  
+
   // Show a splash screen
   lcdMenu.setCursor(0, 0);
   lcdMenu.printMenu("OpenAstroTracker");
@@ -59,7 +59,9 @@ void setup() {
   // Create the LCD top-level menu items
   lcdMenu.addItem("RA", RA_Menu);
   lcdMenu.addItem("DEC", DEC_Menu);
+#ifdef SUPPORT_POINTS_OF_INTEREST
   lcdMenu.addItem("POI", POI_Menu);
+#endif
   lcdMenu.addItem("HOME", Home_Menu);
   lcdMenu.addItem("HA", HA_Menu);
 #ifdef SUPPORT_HEATING
@@ -72,8 +74,11 @@ void setup() {
   while (millis() - now < 750) {
     mount.loop();
   }
+
+  lcdMenu.updateDisplay();
+  
 #ifdef DEBUG_MODE
   Serial.println("SetupDone");
 #endif
-
+  
 }

Software/Arduino code/OpenAstroTracker/c65_startup.ino

@@ -1,3 +1,4 @@
+#ifdef SUPPORT_GUIDED_STARTUP
 //////////////////////////////////////////////////////////////
 // This file contains the Starup 'wizard' that guides you through initial setup
 
@@ -120,3 +121,4 @@ void prinStartupMenu() {
       break;
   }
 }
+#endif

Software/Arduino code/OpenAstroTracker/c722_menuPOI.ino

@@ -1,3 +1,4 @@
+#ifdef SUPPORT_POINTS_OF_INTEREST
 struct PointOfInterest {
   char* pDisplay;
   byte hourRA;
@@ -62,3 +63,4 @@ void printPOISubmenu() {
     lcdMenu.printMenu(pointOfInterest[currentPOI].pDisplay);
   }
 }
+#endif

Software/Arduino code/OpenAstroTracker/c72_menuHA.ino

@@ -34,15 +34,21 @@ bool processHAKeys() {
           EEPROM.update(2, mount.HA().getMinutes());
           lcdMenu.printMenu("Stored.");
           mount.delay(500);
+
+#ifdef SUPPORT_GUIDED_STARTUP
           if (startupState == StartupWaitForHACompletion) {
             startupState = StartupHAConfirmed;
             inStartup = true;
           }
+#endif
         }
         break;
 
       case btnRIGHT: {
-          if (startupState != StartupWaitForHACompletion) {
+#ifdef SUPPORT_GUIDED_STARTUP
+          if (startupState != StartupWaitForHACompletion)
+#endif
+          {
             lcdMenu.setNextActive();
           }
         }

Software/Arduino code/OpenAstroTracker/c74_menuHEAT.ino

@@ -1,6 +1,7 @@
-bool processHeatKeys() {
 #ifdef SUPPORT_HEATING
-byte key;
+
+bool processHeatKeys() {
+  byte key;
   switch (key) {
     case btnUP:
     case btnDOWN:
@@ -54,12 +55,10 @@ byte key;
       }
       break;
   }
-#endif
-return true;
+  return true;
 }
 
 void printHeatSubmenu() {
-#ifdef SUPPORT_HEATING
   String menu = format("RA%c%s%c DEC%c%s%c  ",
                        heatselect == 0 ? ">" : ":",
                        RAheat == 0 ? "Off" : "On ",
@@ -69,5 +68,6 @@ void printHeatSubmenu() {
                        heatselect == 1 ? "<" : " "
                       );
   lcdMenu.printMenu(menu);
-#endif
 }
+
+#endif