V1.6.24 - Updates

- Added Home and Park as additions to the Points of Interest menu.
- Renamed POI to GO menu.
- Merged GO  (old POT) menu with HOME menu.
- If you disable support for the Points Of Interest you still get a GO menu with Home and Park.
- Added ability to disable CTRL menu.
- Added ability to disable INFO menu.

Author: ClutchplateDude

Software/Arduino code/OpenAstroTracker/Globals.h

@@ -38,18 +38,24 @@ extern bool inSerialControl;
 //
 ////////////////////////////////////////////////////////////////
 
-// Uncomment this to support the heating menu
+// Uncomment this to enable the heating menu
 // NOTE: Heating is currently not supported!
 // #define SUPPORT_HEATING
 
 // Uncomment to support Guided Startup 
 #define SUPPORT_GUIDED_STARTUP
 
-// Uncomment to support POI menu. Since memory is running low, this can be disabled in lieu of serial support.
+// Uncomment to support full GO (was POI) menu. 
+// If this is commented out you still have a GO menu that has Home and Park.
 #define SUPPORT_POINTS_OF_INTEREST
 
-// Uncomment to support Serial MEADE support
-// #define SUPPORT_SERIAL_CONTROL
+// Uncomment to support CTRL menu, allowing you to manually slew the mount with the buttons. 
+#define SUPPORT_MANUAL_CONTROL
+
+// Uncomment to support INFO menu that displays various pieces of information about the mount. 
+#define SUPPORT_INFO_DISPLAY
 
+// Uncomment to support Serial Meade LX200 protocol support
+// #define SUPPORT_SERIAL_CONTROL
 
 #endif

Software/Arduino code/OpenAstroTracker/Mount.cpp

@@ -278,6 +278,8 @@ void Mount::startSlewingToTarget() {
 //
 // park
 //
+// Targets the mount to move to the home position and 
+// turns off all motors once it gets there.
 /////////////////////////////////
 void Mount::park()
 {
@@ -288,6 +290,25 @@ void Mount::park()
   _mountStatus |= STATUS_PARKING;
 }
 
+/////////////////////////////////
+//
+// goHome
+//
+// Synchronously moves mount to home position and 
+// sets Tracking mode according to argument
+/////////////////////////////////
+void Mount::goHome(bool tracking)
+{
+  stopSlewing(TRACKING);
+  setTargetToHome();
+  startSlewingToTarget();
+  waitUntilStopped(ALL_DIRECTIONS);
+  setHome();
+  if (tracking) {
+    startSlewing(TRACKING);
+  }
+}
+
 /////////////////////////////////
 //
 // mountStatus
@@ -422,7 +443,7 @@ bool Mount::isParking() {
 //
 // startSlewing
 //
-// Starts manual slewing in one of eight directions or 
+// Starts manual slewing in one of eight directions or
 // tracking, but only if not currently parking!
 /////////////////////////////////
 void Mount::startSlewing(int direction) {
@@ -465,6 +486,7 @@ void Mount::stopSlewing(int direction) {
   if (direction & TRACKING) {
     // Turn off tracking
     _mountStatus &= ~STATUS_TRACKING;
+
     _stepperTRK->stop();
   }
 
@@ -533,11 +555,12 @@ void Mount::loop() {
   bool decStillRunning = false;
 
   unsigned long now = millis();
-  if (now - _lastMountPrint > 2500) {
-    //Serial.println(mountStatusString());
+#ifdef DEBUG_MODE
+  if (now - _lastMountPrint > 1500) {
+    Serial.println(mountStatusString());
     _lastMountPrint = now;
   }
-
+#endif
   if (_mountStatus & STATUS_TRACKING) {
     _stepperTRK->runSpeed();
   }

Software/Arduino code/OpenAstroTracker/Mount.hpp

@@ -93,12 +93,6 @@ class Mount {
     // Same as Arduino delay() but keeps the tracker going.
     void delay(int ms);
 
-    // What is the state of the mount
-    byte mountStatus();
-#ifdef DEBUG_MODE
-    String mountStatusString();
-#endif
-
     // Gets the position in one of eight directions or tracking
     long getCurrentStepperPosition(int direction);
 
@@ -108,11 +102,15 @@ class Mount {
     // Set RA and DEC to the home position
     void setTargetToHome();
 
+    // Synchronously slews the mount to the home position and sets tracking to argument.
+    void goHome(bool tracking);
+
     // Set the current stepper positions to be home.
     void setHome();
 
     // Asynchronously parks the mount. Moves to the home position and stops all motors. 
     void park();
+
 
     // Return a string of DEC in the given format. For LCDSTRING, active determines where the cursor is
     String DECString(byte type, byte active = 0);
@@ -133,6 +131,15 @@ class Mount {
     // Returns NOT_SLEWING, SLEWING_DEC, SLEWING_RA, or SLEWING_BOTH. SLEWING_TRACKING is an overlaid bit.
     byte slewStatus();
 
+    // What is the state of the mount. 
+    // Returns some combination of these flags: STATUS_PARKED, STATUS_SLEWING, STATUS_SLEWING_TO_TARGET, STATUS_SLEWING_FREE, STATUS_TRACKING, STATUS_PARKING
+    byte mountStatus();
+    
+#ifdef DEBUG_MODE
+    String mountStatusString();
+#endif
+
+
   private:
     LcdMenu* _lcdMenu;
     int  _stepsPerRADegree;

Software/Arduino code/OpenAstroTracker/OpenAstroTracker.ino

@@ -16,7 +16,7 @@
 */
 #include "Globals.h"
 
-String version = "V1.6.23";
+String version = "V1.6.24";
 
 ///////////////////////////////////////////////////////////////////////////
 // Please see the Globals.h file for configuration of the firmware.

Software/Arduino code/OpenAstroTracker/Utility.cpp

@@ -38,14 +38,3 @@ float clamp(float current, float minVal, float maxVal)
   if (current < minVal) current = minVal;
   return current;
 }
-/*
-int read_LCD_buttons() {
-  adc_key_in = analogRead(0);
-  if (adc_key_in > 1000) return btnNONE;
-  if (adc_key_in < 50)   return btnRIGHT;
-  if (adc_key_in < 240)  return btnUP;
-  if (adc_key_in < 400)  return btnDOWN;
-  if (adc_key_in < 600)  return btnLEFT;
-  if (adc_key_in < 920)  return btnSELECT;
-}
-*/

Software/Arduino code/OpenAstroTracker/b_setup.ino

@@ -59,17 +59,28 @@ 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);
+  lcdMenu.addItem("GO", POI_Menu);
+#else
+  lcdMenu.addItem("GO", Home_Menu);
 #endif
-  lcdMenu.addItem("HOME", Home_Menu);
+
   lcdMenu.addItem("HA", HA_Menu);
+
 #ifdef SUPPORT_HEATING
   lcdMenu.addItem("HEA", Heat_Menu);
 #endif
+
+#ifdef SUPPORT_MANUAL_CONTROL
   lcdMenu.addItem("CTRL", Control_Menu);
+#endif
+
   lcdMenu.addItem("CAL", Calibration_Menu);
+  
+#ifdef SUPPORT_INFO_DISPLAY
   lcdMenu.addItem("INFO", Status_Menu);
+#endif
 
   while (millis() - now < 750) {
     mount.loop();

Software/Arduino code/OpenAstroTracker/c722_menuPOI.ino

@@ -12,38 +12,51 @@ struct PointOfInterest {
 PointOfInterest pointOfInterest[] = {
   //    Name (15chars)    RA (hms)     DEC (dms)
   //  012345678901234
-  { ">Polaris        ",  2, 57, 56,   89, 21,  2 },
-  { ">Big Dipper     ", 12, 16, 26,   56, 55,  7 },
-  { ">M31 Andromeda  ",  0, 43, 52,   41, 22, 53 },
+  { ">Polaris"        ,  2, 57, 56,   89, 21,  2 },
+  { ">Big Dipper"     , 12, 16, 26,   56, 55,  7 },
+  { ">M31 Andromeda"  ,  0, 43, 52,   41, 22, 53 },
   { ">M81 Bodes Galxy",  9, 57, 13,   68, 58,  1 },
+
+  // Add new items above here, not below.
+  { ">Home"           ,  0,  0,  0,   90,  0,  0 },
+  { ">Park"           ,  0,  0,  0,   90,  0,  0 },
+  // And definitely don't add here.
 };
 
 int currentPOI = 0;
-int lastPOI = sizeof(pointOfInterest) / sizeof(pointOfInterest[0]) - 1;
+int parkPOI = sizeof(pointOfInterest) / sizeof(pointOfInterest[0]) - 1;
+byte homePOI = sizeof(pointOfInterest) / sizeof(pointOfInterest[0]) - 2;
 
 bool processPOIKeys() {
   byte key;
   if (lcdButtons.keyChanged(key)) {
     switch (key) {
       case btnSELECT: {
           mount.stopSlewing(ALL_DIRECTIONS);
-          PointOfInterest* poi = &pointOfInterest[currentPOI];
-          mount.targetRA().set(poi->hourRA, poi->minRA, poi->secRA);
-          mount.targetRA().addTime(mount.getHACorrection());
-          mount.targetRA().subtractTime(mount.HA());
-          mount.targetDEC().set(poi->degreeDEC - (NORTHERN_HEMISPHERE ? 90 : -90), poi->minDEC, poi->secDEC); // internal DEC degree is 0 at celestial poles
-          mount.startSlewingToTarget();
+          if (currentPOI == homePOI) {
+            mount.goHome(true);
+          } else if (currentPOI == parkPOI) {
+            mount.park();
+          }
+          else {
+            PointOfInterest* poi = &pointOfInterest[currentPOI];
+            mount.targetRA().set(poi->hourRA, poi->minRA, poi->secRA);
+            mount.targetRA().addTime(mount.getHACorrection());
+            mount.targetRA().subtractTime(mount.HA());
+            mount.targetDEC().set(poi->degreeDEC - (NORTHERN_HEMISPHERE ? 90 : -90), poi->minDEC, poi->secDEC); // internal DEC degree is 0 at celestial poles
+            mount.startSlewingToTarget();
+          }
         }
         break;
 
       case btnLEFT:
       case btnDOWN: {
-          currentPOI = adjustWrap(currentPOI, 1, 0, lastPOI);
+          currentPOI = adjustWrap(currentPOI, 1, 0, parkPOI);
         }
         break;
 
       case btnUP: {
-          currentPOI = adjustWrap(currentPOI, -1, 0, lastPOI);
+          currentPOI = adjustWrap(currentPOI, -1, 0, parkPOI);
         }
         break;
 

Software/Arduino code/OpenAstroTracker/c725_menuHOME.ino

@@ -1,14 +1,22 @@
+byte subGoIndex = 0;
+
 bool processHomeKeys() {
   byte key;
   if (lcdButtons.keyChanged(key)) {
     switch (key) {
       case btnSELECT: {
-          mount.stopSlewing(TRACKING);
-          mount.setTargetToHome();
-          mount.startSlewingToTarget();
-          mount.waitUntilStopped(ALL_DIRECTIONS);
-          mount.setHome();
-          mount.startSlewing(TRACKING);
+          if (subGoIndex == 0) {
+            mount.goHome(true); // start tracking after home
+          } else {
+            mount.park();
+          }
+        }
+        break;
+
+      case btnUP:
+      case btnDOWN:
+      case btnLEFT: {
+          subGoIndex = 1 - subGoIndex;
         }
         break;
 
@@ -18,10 +26,17 @@ bool processHomeKeys() {
         break;
     }
   }
-  
+
   return true;
 }
 
 void printHomeSubmenu() {
-  lcdMenu.printMenu(">Go Home");
+  char scratchBuffer[16];
+  if (mount.isParked() && (subGoIndex == 1)) {
+    lcdMenu.printMenu("Parked...");
+  } else {
+    strcpy(scratchBuffer, " Home  Park");
+    scratchBuffer[subGoIndex * 6] = '>';
+    lcdMenu.printMenu(scratchBuffer);
+  }
 }

Software/Arduino code/OpenAstroTracker/c75_menuCTRL.ino

@@ -1,3 +1,4 @@
+#ifdef SUPPORT_MANUAL_CONTROL
 bool confirmZeroPoint = false;
 bool setZeroPoint = true;
 
@@ -116,3 +117,4 @@ void printControlSubmenu() {
     mount.displayStepperPositionThrottled();
   }
 }
+#endif

Software/Arduino code/OpenAstroTracker/c78_menuINFO.ino

@@ -1,3 +1,4 @@
+#ifdef SUPPORT_INFO_DISPLAY
 byte infoIndex = 0;
 byte maxInfoIndex = 4;
 byte subIndex = 0;
@@ -81,3 +82,5 @@ void printStatusSubmenu() {
       break;
   }
 }
+
+#endif