Adaptations to work with PyCom's microPython.

Author: Alexandre Marquet

README.rst

@@ -2,36 +2,26 @@
 Introduction
 ============
 
-.. image:: https://readthedocs.org/projects/adafruit-circuitpython-gps/badge/?version=latest
-    :target: https://circuitpython.readthedocs.io/projects/gps/en/latest/
-    :alt: Documentation Status
-
-.. image :: https://img.shields.io/discord/327254708534116352.svg
-    :target: https://discord.gg/nBQh6qu
-    :alt: Discord
-
-.. image:: https://travis-ci.org/adafruit/Adafruit_CircuitPython_GPS.svg?branch=master
-    :target: https://travis-ci.org/adafruit/Adafruit_CircuitPython_GPS
-    :alt: Build Status
-
 GPS parsing module.  Can parse simple NMEA data sentences from serial GPS
 modules to read latitude, longitude, and more.
 
+Installation
+=============
+
+On a LoPy, just put ``adafruit_gps.py`` into the ``lib/`` directory.
 
 Dependencies
 =============
 This driver depends on:
 
-* `Adafruit CircuitPython <https://github.com/adafruit/circuitpython>`_
-
-Please ensure all dependencies are available on the CircuitPython filesystem.
-This is easily achieved by downloading
-`the Adafruit library and driver bundle <https://github.com/adafruit/Adafruit_CircuitPython_Bundle>`_.
+* `MicroPython <https://github.com/micropython/micropython>`_
 
 Usage Example
 =============
 
 See examples/simple.py for a demonstration of parsing and printing GPS location.
+Please note that ``datalogging.py`` has not been ported from CircuitPython to
+Micropython yet.
 
 Contributing
 ============
@@ -43,27 +33,6 @@ before contributing to help this project stay welcoming.
 Building locally
 ================
 
-To build this library locally you'll need to install the
-`circuitpython-build-tools <https://github.com/adafruit/circuitpython-build-tools>`_ package.
-
-.. code-block:: shell
-
-    python3 -m venv .env
-    source .env/bin/activate
-    pip install circuitpython-build-tools
-
-Once installed, make sure you are in the virtual environment:
-
-.. code-block:: shell
-
-    source .env/bin/activate
-
-Then run the build:
-
-.. code-block:: shell
-
-    circuitpython-build-bundles --filename_prefix adafruit-circuitpython-gps --library_location .
-
 Sphinx documentation
 -----------------------
 
@@ -85,4 +54,4 @@ Now, once you have the virtual environment activated:
 
 This will output the documentation to ``docs/_build/html``. Open the index.html in your browser to
 view them. It will also (due to -W) error out on any warning like Travis will. This is a good way to
-locally verify it will pass.
+locally verify it will pass.

adafruit_gps.py

@@ -26,7 +26,7 @@
 GPS parsing module.  Can parse simple NMEA data sentences from serial GPS
 modules to read latitude, longitude, and more.
 
-* Author(s): Tony DiCola
+* Author(s): Tony DiCola, Alexandre Marquet.
 
 Implementation Notes
 --------------------
@@ -38,14 +38,12 @@
 
 **Software and Dependencies:**
 
-* Adafruit CircuitPython firmware for the ESP8622 and M0-based boards:
-  https://github.com/adafruit/circuitpython/releases
+* MicroPython:
+    https://github.com/micropython/micropython
 
 """
-import time
-
 __version__ = "0.0.0-auto.0"
-__repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_GPS.git"
+__repo__ = "https://github.com/alexmrqt/Adafruit_CircuitPython_GPS.git"
 
 # Internal helper parsing functions.
 # These handle input that might be none or null and return none instead of
@@ -169,12 +167,11 @@ def _parse_gpgga(self, args):
             secs = time_utc % 100
             # Set or update time to a friendly python time struct.
             if self.timestamp_utc is not None:
-                self.timestamp_utc = time.struct_time((
-                    self.timestamp_utc.tm_year, self.timestamp_utc.tm_mon,
-                    self.timestamp_utc.tm_mday, hours, mins, secs, 0, 0, -1))
+                self.timestamp_utc = (
+                    self.timestamp_utc[0], self.timestamp_utc[1],
+                    self.timestamp_utc[2], hours, mins, secs, 0, 0)
             else:
-                self.timestamp_utc = time.struct_time((0, 0, 0, hours, mins,
-                                                       secs, 0, 0, -1))
+                self.timestamp_utc = (0, 0, 0, hours, mins, secs, 0, 0)
         # Parse latitude and longitude.
         self.latitude = _parse_degrees(data[1])
         if self.latitude is not None and \
@@ -205,12 +202,11 @@ def _parse_gprmc(self, args):
             secs = time_utc % 100
             # Set or update time to a friendly python time struct.
             if self.timestamp_utc is not None:
-                self.timestamp_utc = time.struct_time((
-                    self.timestamp_utc.tm_year, self.timestamp_utc.tm_mon,
-                    self.timestamp_utc.tm_mday, hours, mins, secs, 0, 0, -1))
+                self.timestamp_utc = (
+                    self.timestamp_utc[0], self.timestamp_utc[1],
+                    self.timestamp_utc[2], hours, mins, secs, 0, 0)
             else:
-                self.timestamp_utc = time.struct_time((0, 0, 0, hours, mins,
-                                                       secs, 0, 0, -1))
+                self.timestamp_utc = (0, 0, 0, hours, mins, secs, 0, 0)
         # Parse status (active/fixed or void).
         status = data[1]
         self.fix_quality = 0
@@ -237,15 +233,12 @@ def _parse_gprmc(self, args):
                                              # spec and not this code.
             if self.timestamp_utc is not None:
                 # Replace the timestamp with an updated one.
-                # (struct_time is immutable and can't be changed in place)
-                self.timestamp_utc = time.struct_time((year, month, day,
-                                                       self.timestamp_utc.tm_hour,
-                                                       self.timestamp_utc.tm_min,
-                                                       self.timestamp_utc.tm_sec,
-                                                       0,
+                self.timestamp_utc = (year, month, day,
+                                                       self.timestamp_utc[3],
+                                                       self.timestamp_utc[4],
+                                                       self.timestamp_utc[5],
                                                        0,
-                                                       -1))
+                                                       0)
             else:
                 # Time hasn't been set so create it.
-                self.timestamp_utc = time.struct_time((year, month, day, 0, 0,
-                                                       0, 0, 0, -1))
+                self.timestamp_utc = (year, month, day, 0, 0, 0, 0, 0)

examples/gps_simpletest.py

@@ -1,22 +1,13 @@
 # Simple GPS module demonstration.
 # Will wait for a fix and print a message every second with the current location
 # and other details.
-import time
-import board
-import busio
+from machine import UART
+import utime as time
 
 import adafruit_gps
 
-
-# Define RX and TX pins for the board's serial port connected to the GPS.
-# These are the defaults you should use for the GPS FeatherWing.
-# For other boards set RX = GPS module TX, and TX = GPS module RX pins.
-RX = board.RX
-TX = board.TX
-
-# Create a serial connection for the GPS connection using default speed and
-# a slightly higher timeout (GPS modules typically update once a second).
-uart = busio.UART(TX, RX, baudrate=9600, timeout=3000)
+# Create a GPS module instance.
+uart = UART(1, baudrate=9600, timeout_chars=28800000, pins=('P8','P2'))
 
 # Create a GPS module instance.
 gps = adafruit_gps.GPS(uart)
@@ -46,17 +37,19 @@
 #gps.send_command('PMTK220,500')
 
 # Main loop runs forever printing the location, etc. every second.
-last_print = time.monotonic()
+last_print = time.ticks_ms()
 while True:
     # Make sure to call gps.update() every loop iteration and at least twice
     # as fast as data comes from the GPS unit (usually every second).
     # This returns a bool that's true if it parsed new data (you can ignore it
     # though if you don't care and instead look at the has_fix property).
-    gps.update()
+    # gps.update()
     # Every second print out current location details if there's a fix.
-    current = time.monotonic()
-    if current - last_print >= 1.0:
+    current = time.ticks_ms()
+    if time.ticks_diff(last_print, current) >= 1000:
         last_print = current
+
+        gps.update()
         if not gps.has_fix:
             # Try again if we don't have a fix yet.
             print('Waiting for fix...')