Add decisions and specifications documents; include logo image

Author: andre-stefanov

assets/documents/decisions.md

@@ -0,0 +1,19 @@
+# Pending Decisions
+
+## Hardware
+- Do we have a default board?
+- What steppers/drivers are we supporting? Same as before?
+- Do we want to support a hand controller of some sort? I2C via Network cable? Serial via USB cable?
+
+## Software
+- How do we support hardware variations? #defines like before, or include everything?
+- What do we use for the menu system? Needs UX designer input or we use an industry standard.
+- What subsystems can/should run on their own threads with minimal synchronization issues.
+- Are we supporting the full LX200 command set from OAT/OAM V1?
+ 
+# Made Decisions
+
+## Hardware
+- 32bit boards only, no 8-bit board support.
+- At least 4GB memory
+- I2C required

assets/documents/specifications.md

@@ -0,0 +1,55 @@
+# Requirements for Firmware running a mount
+
+## Time/Date/Location
+- Must be aware of date, time and location in order to calculate HA
+- Support for Northern and Southern hemisphere
+
+## RA axis
+- Must be able to slew by a given number of degrees
+- Must be able to slew at various rates until requested to stop
+- Must run at a constant speed without changing coordinate (tracking)
+- Must be able to run faster or slower for some duration (with millisecond accuracy) without changing coordinate (guiding)
+- Must be able to have new coordinate sync'd from connected software
+- All these operations must be done without losing home position
+- Should support homing operations with a sensor to home on
+
+## DEC axis
+- Must be able to slew by a given number of degrees
+- Must be able to slew at various rates until requested to stop
+- Must be able to run forward or reverse for some duration (with millisecond accuracy) without changing coordinate (guiding)
+- Must be able to have new coordinate sync'd from connected software
+- All these operations must be done without losing home position
+- Should support homing operations with a sensor to home on
+
+## ALT/AZ
+- Must be able to slew by a given number of degrees
+- Must be able to slew at various rates until requested to stop
+- Should support slewing at various rates until requested to stop
+
+## Focuser
+- Must be able to slew at various rates until requested to stop
+- Must support slewing to a specific target position
+
+## General
+- RA and DEC operations must be independent, but can overlap
+- Stepper operations must be async
+- Would be nice to get an event when the stepper stops
+- Serial message processing mst be sequential, but async and in the background
+- Serial connection default speed should be 115200
+- Must be able to convert from RA/DEC coordinates to stepper target positions (must use solution with longest safe time)
+- Meade Protocol support for OAT/OAM/OAE
+
+## Menu/Display
+- Support Info-only displays to show mount status
+- Support LCD?
+- Input devices? Buttons, joysticks, touch?
+- List of operations possible from interactive display devices
+
+## Sensors
+- Support for RA and DEC end switches
+- Support for RA/DEC homing switches
+- Temperature sensor?
+
+## Improvements from 1.0
+- Support meridian flip? (how is this done when using camera in another app?)
+- Dew heater support?