V1.6.27 - Updates

- Added a directive to compile a headless client. This removes support for the shield (LCD and keyboard).
- Added the Meade commands to support target-less slew in Serial.

Author: ClutchplateDude

Software/Arduino code/OpenAstroTracker/Globals.h

@@ -38,12 +38,16 @@ extern bool inSerialControl;
 //
 ////////////////////////////////////////////////////////////////
 
+// If you do not have a LCD shield on your Arduino Uno, uncomment the line below. This is
+// useful if you are always going to run the mount from a laptop anyway.
+// #define HEADLESS_CLIENT
+
 // 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
+#define SUPPORT_GUIDED_STARTUP
 
 // Uncomment to support full GO (was POI) menu. 
 // If this is commented out you still have a GO menu that has Home and Park.
@@ -53,9 +57,15 @@ extern bool inSerialControl;
 #define SUPPORT_MANUAL_CONTROL
 
 // Uncomment to support INFO menu that displays various pieces of information about the mount. 
-//#define SUPPORT_INFO_DISPLAY
+#define SUPPORT_INFO_DISPLAY
 
 // Uncomment to support Serial Meade LX200 protocol support
+// #define SUPPORT_SERIAL_CONTROL
+
+
+// If we are making a headleass (no screen, no keyboard) client, always enable Serial.
+#ifdef HEADLESS_CLIENT
 #define SUPPORT_SERIAL_CONTROL
+#endif
 
 #endif

Software/Arduino code/OpenAstroTracker/LcdMenu.cpp

@@ -1,6 +1,8 @@
 #include "Utility.h"
 #include "LcdMenu.hpp"
 
+#ifndef HEADLESS_CLIENT
+
 // Class that drives the LCD screen with a menu
 // You add a string and an id item and this class handles the display and navigation
 // Create a new menu, using the given number of LCD display columns and rows
@@ -235,3 +237,33 @@ byte LcdMenu::MinutesBitmap[8] = {
   B00000,
   B00000
 };
+#else
+
+LcdMenu::LcdMenu(byte cols, byte rows, int maxItems) {
+}
+
+MenuItem* LcdMenu::findById(byte id) {
+  return NULL;
+}
+
+void LcdMenu::addItem(const char *disp, byte id) {}
+
+byte LcdMenu::getActive() {
+  return 0;
+}
+
+void LcdMenu::setActive(byte id) {}
+
+void LcdMenu::setCursor(byte col, byte row) {}
+
+void LcdMenu::clear() {}
+
+void LcdMenu::setNextActive() {}
+
+void LcdMenu::updateDisplay() {}
+
+void LcdMenu::printMenu(String line) {}
+
+void LcdMenu::printChar(char ch) {}
+
+#endif

Software/Arduino code/OpenAstroTracker/LcdMenu.hpp

@@ -2,7 +2,9 @@
 #define _LCDMENU_HPP_
 
 #include <Arduino.h>
+#ifndef HEADLESS_CLIENT
 #include <LiquidCrystal.h>
+#endif
 #include "Globals.h"
 
 // A single menu item (like RA, HEAT, POL, etc.)
@@ -67,6 +69,7 @@ class LcdMenu {
     void printChar(char ch);
 
   private:
+#ifndef HEADLESS_CLIENT
     LiquidCrystal _lcd;   // The LCD screen that we'll display the menu on
     MenuItem** _menuItems;  // The first menu item (linked list)
     byte _numMenuItems;
@@ -89,6 +92,7 @@ class LcdMenu {
     static byte DownArrowBitmap[8];
     static byte DegreesBitmap[8];
     static byte MinutesBitmap[8];
+#endif
 };
 
 #endif

Software/Arduino code/OpenAstroTracker/Mount.cpp

@@ -1,4 +1,5 @@
 #include "LcdMenu.hpp"
+
 #include "Mount.hpp"
 
 //mountstatus
@@ -860,6 +861,8 @@ void Mount::moveSteppersTo(float targetRA, float targetDEC) {
 //
 /////////////////////////////////
 void Mount::displayStepperPosition() {
+#ifndef HEADLESS_CLIENT  
+ 
   String disp ;
 
   if ((abs(_totalDECMove) > 0.001) && (abs(_totalRAMove) > 0.001)) {
@@ -914,6 +917,7 @@ void Mount::displayStepperPosition() {
     _lcdMenu->printMenu(disp);
 #endif
   }
+#endif
 }
 
 /////////////////////////////////
@@ -922,11 +926,13 @@ void Mount::displayStepperPosition() {
 //
 /////////////////////////////////
 void Mount::displayStepperPositionThrottled() {
+#ifndef HEADLESS_CLIENT  
   long elapsed = millis() - _lastDisplayUpdate;
   if (elapsed > DISPLAY_UPDATE_TIME) {
     displayStepperPosition();
     _lastDisplayUpdate = millis();
   }
+ #endif
 }
 
 /////////////////////////////////

Software/Arduino code/OpenAstroTracker/OpenAstroTracker.ino

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

Software/Arduino code/OpenAstroTracker/b_setup.ino

@@ -56,6 +56,7 @@ void setup() {
   // Start the tracker.
   mount.startSlewing(TRACKING);
 
+#ifndef HEADLESS_CLIENT
   // Create the LCD top-level menu items
   lcdMenu.addItem("RA", RA_Menu);
   lcdMenu.addItem("DEC", DEC_Menu);
@@ -87,6 +88,7 @@ void setup() {
   }
 
   lcdMenu.updateDisplay();
+#endif
 
 #ifdef DEBUG_MODE
   Serial.println("SetupDone");

Software/Arduino code/OpenAstroTracker/c65_startup.ino

@@ -1,3 +1,4 @@
+#ifndef HEADLESS_CLIENT
 #ifdef SUPPORT_GUIDED_STARTUP
 //////////////////////////////////////////////////////////////
 // This file contains the Starup 'wizard' that guides you through initial setup
@@ -122,3 +123,4 @@ void prinStartupMenu() {
   }
 }
 #endif
+#endif

Software/Arduino code/OpenAstroTracker/c70_menuRA.ino

@@ -1,4 +1,4 @@
-
+#ifndef HEADLESS_CLIENT
 bool processRAKeys() {
   byte key;
   bool waitForRelease = true;
@@ -52,141 +52,4 @@ void printRASubmenu() {
     lcdMenu.printMenu(mount.RAString(LCDMENU_STRING | TARGET_STRING, RAselect));
   }
 }
-
-
-/*
-  WIP for complete OO-ification of code.
-
-  class Processor
-  {
-    Processor *_nextProcessor;
-    int _numSubMenuItems;
-    int _currentSubMenu;
-
-  public:
-    Processor(int numSubMenuItems)
-    {
-      _numSubMenuItems = numSubMenuItems;
-      _currentSubMenu = 0;
-      _nextProcessor = nullptr;
-    }
-
-    void setNext(Processor *nextProcessor) {
-      _nextProcessor = nextProcessor;
-    }
-    virtual const char *display() = 0;
-    virtual void onDownKeyPressed() {}
-    virtual void onUpKeyPressed() {}
-    virtual void onLeftKeyPressed() {
-      adjustSubMenu();
-    }
-    virtual void onRightKeyPressed() { }
-    virtual void onSelectKeyPressed() {}
-    virtual void onKeyReleased(int key) {}
-    virtual void onIdle() {}
-    void adjustSubMenu(int by = 1)
-    {
-      _currentSubMenu = adjustWrap(_currentSubMenu, by, 0, _numSubMenuItems);
-    }
-  };
-
-  class ProcessRA : Processor
-  {
-  public:
-    ProcessRA() : Processor(3)
-    {
-    }
-    const char *display()
-    {
-      return "RA";
-    }
-
-    void onDownKeyPressed()
-    {
-    }
-
-    void onUpKeyPressed()
-    {
-    }
-
-    void onLeftKeyPressed()
-    {
-    }
-
-    void onRightKeyPressed()
-    {
-    }
-
-    void onSelectKeyPressed()
-    {
-    }
-
-    void onIdle()
-    {
-    }
-  };
-
-  class MenuProcessor
-  {
-    Processor *_firstProcessor;
-    Processor *_lastProcessor;
-    Processor *_activeProcessor;
-    int _lastKeyState;
-
-  public:
-    MenuProcessor()
-    {
-      _firstProcessor = nullptr;
-      _lastProcessor = nullptr;
-      _activeProcessor = nullptr;
-      _lastKeyState = btnNONE;
-    }
-
-    void loop()
-    {
-      int keyState = read_LCD_buttons();
-      if ((_lastKeyState == btnNONE) && (keyState != btnNONE))
-      {
-        switch (keyState)
-        {
-          case btnUP:
-            _activeProcessor->onUpKeyPressed();
-            break;
-          case btnDOWN:
-            _activeProcessor->onDownKeyPressed();
-            break;
-          case btnLEFT:
-            _activeProcessor->onLeftKeyPressed();
-            break;
-          case btnRIGHT:
-            _activeProcessor->onRightKeyPressed();
-            break;
-          case btnSELECT:
-            _activeProcessor->onSelectKeyPressed();
-            break;
-        }
-        _lastKeyState = keyState;
-      }
-      else if ((_lastKeyState != btnNONE) && (keyState == btnNONE))
-      {
-        _activeProcessor->onKeyReleased(_lastKeyState);
-      }
-      else if ((_lastKeyState == btnNONE) && (keyState == btnNONE))
-      {
-        _activeProcessor->onIdle();
-      }
-    }
-
-    void addProcessor(Processor *processor)
-    {
-      if (_firstProcessor == nullptr)
-      {
-        _firstProcessor = processor;
-      }
-      else
-      {
-        _firstProcessor->setNext(processor);
-      }
-    }
-  };
-*/
+#endif

Software/Arduino code/OpenAstroTracker/c71_menuDEC.ino

@@ -1,4 +1,4 @@
-
+#ifndef HEADLESS_CLIENT
 bool processDECKeys() {
   byte key;
   bool waitForRelease = true;
@@ -51,3 +51,4 @@ void printDECSubmenu() {
     lcdMenu.printMenu(mount.DECString(LCDMENU_STRING | TARGET_STRING, DECselect));
   }
 }
+#endif

Software/Arduino code/OpenAstroTracker/c722_menuPOI.ino

@@ -1,3 +1,4 @@
+#ifndef HEADLESS_CLIENT
 #ifdef SUPPORT_POINTS_OF_INTEREST
 struct PointOfInterest {
   char* pDisplay;
@@ -79,3 +80,4 @@ void printPOISubmenu() {
   }
 }
 #endif
+#endif