Initial commit

Author: sidwarkd

examples/Basic/Basic.ino

@@ -0,0 +1,39 @@
+/*
+  GP20U7 GPS Library - Basic
+ Demonstrates the use of the GP20U7 GPS unit by retrieving the latitude
+ and longitude of your current position.
+
+ The circuit:
+ * GP20U7 TX pin to digital pin 0/RX
+ * GP20U7 VCC pin to 3.3V
+ * GP20U7 GND pin to ground
+ */
+
+// include the library code:
+#include <gp20u7.h>
+
+// initialize the library with the serial port to which the device is
+// connected
+GP20U7 gps = GP20U7(Serial);
+
+// Set up a Geolocation variable to track your current Location
+Geolocation currentLocation;
+
+void setup() {
+  // Start the GPS module
+  gps.begin();
+}
+
+void loop() {
+  // The call to read() checks for new location information and returns 1
+  // if new data is available and 0 if it isn't. It should be called
+  // repeatedly.
+  if(gps.read()){
+    currentLocation = gps.getGeolocation();
+    Serial.println("Your current location is:");
+    Serial.print("    Latitude: ");
+    Serial.println(currentLocation.latitude,5);
+    Serial.print("    Longitude: ");
+    Serial.println(currentLocation.longitude,5);
+  }
+}

keywords.txt

@@ -0,0 +1,21 @@
+#######################################
+# Syntax Coloring Map For GP20U7
+#######################################
+
+#######################################
+# Datatypes (KEYWORD1)
+#######################################
+
+GP20U7	KEYWORD1	GP20U7
+Geolocation	KEYWORD1	Geolocation
+
+#######################################
+# Methods and Functions (KEYWORD2)
+#######################################
+
+getGeolocation	KEYWORD2
+read	KEYWORD2
+
+#######################################
+# Constants (LITERAL1)
+#######################################

library.properties

@@ -0,0 +1,9 @@
+name=GP20U7 GPS Library
+version=1.0.0
+author=Kevin Sidwar
+maintainer=Kevin Sidwar <kevin@sidwar.com>
+sentence=A simple library for the GP20U7 GPS unit
+paragraph=A simple library for the GP20U7 GPS unit
+category=Sensors
+url=
+architectures=*

src/api/gps.h

@@ -0,0 +1,21 @@
+#ifndef TOI_API_GPS
+#define TOI_API_GPS
+
+typedef struct _Geolocation
+{
+  double latitude;
+  double longitude;
+} Geolocation, *PGeolocation;
+
+class GeolocationDevice{
+public:
+  virtual ~GeolocationDevice(){}
+  virtual Geolocation getGeolocation(void) = 0;
+  virtual int read(void) = 0; // used for polling only
+  virtual void begin(void) = 0;
+
+protected:
+  Geolocation _currentLocation;
+};
+
+#endif

src/devices/gps/gp20u7.cpp

@@ -0,0 +1,39 @@
+#include "gp20u7.h"
+// TODO: Handle uninitialized _currentLocation
+
+GP20U7::GP20U7(PlatformStream &s){
+  _stream = &s;
+}
+
+GP20U7::GP20U7(PlatformStream *s){
+  _stream = s;
+}
+
+Geolocation GP20U7::getGeolocation(){
+    return _currentLocation;
+}
+
+int GP20U7::read(){
+  long lat, lon;
+  unsigned long fix_age;
+
+  while(_stream->available()){
+    int c = _stream->read();
+    if(_gps.encode(c)){
+      _gps.get_position(&lat, &lon, &fix_age);
+
+      // Map tinygps values into Geolocation struct
+      _currentLocation.latitude = lat / 1000000.0;
+      _currentLocation.longitude = lon / 1000000.0;
+      return 1;
+    }
+  }
+
+  return 0;
+}
+
+void GP20U7::begin(){
+  #if defined (ARDUINO_PLATFORM)
+    reinterpret_cast<HardwareSerial *>(_stream)->begin(9600);
+  #endif
+}

src/devices/gps/gp20u7.h

@@ -0,0 +1,28 @@
+#ifndef TOI_GP20U7
+#define TOI_GP20U7
+
+#ifndef SPARK
+#include "../../platforms/platform.h"
+#include "../../api/gps.h"
+#include "tinygps.h"
+#else
+#include "platform.h"
+#include "gps.h"
+#include "tinygps.h"
+#endif
+
+class GP20U7 : public GeolocationDevice
+{
+  private:
+    PlatformStream *_stream;
+    TinyGPS _gps;
+
+  public:
+    GP20U7(PlatformStream &s);
+    GP20U7(PlatformStream *s);
+    Geolocation getGeolocation(void);
+    int read(void);
+    void begin(void);
+};
+
+#endif