Python 2.7 - 3.5 interface to gpsd
Switch branches/tags
Nothing to show
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples Update Jun 29, 2016
gps3 'GST' name collision of standard deviation latitude and longitude fix Nov 1, 2017
.editorconfig Joining the club May 27, 2016
DESCRIPTION.rst Update Jun 29, 2016
LICENSE Current MIT License Mar 1, 2016
MANIFEST.in License extension Jun 7, 2016
README.md Introduction of _theaded_ client adaptor Jun 1, 2016
setup.cfg Update setup.cfg May 28, 2016
setup.py gps3 does not have any dependencies (#14) Oct 14, 2016

README.md

README

The threading adaptor is a recent addition. The simple and efficient Python2.7-3.5 client, is pre-packaged as a threaded client,

from agps3threaded import AGPS3mechanism

Then engage the thread triumvirate,

agps_thread = AGPS3mechanism()  # This instantiate the mechanism, as I believe it's called.
agps_thread.stream_data()    #  Stream the data from host, port, devicepath.
agps_thread.run_thread()  #  Iterate stream as a thread with throttle control for empty look ups.

Four lines of code that lets you connect, communicate and control most of what you expect a gpsd to do.

while True:  # All data is available via instantiated thread data_stream attributes. Confur
             # lines #140-ff of the client /usr/local/lib/python3.5/dist-packages/gps3/agps.py
      print('----------------')
      print(                   agps_thread.data_stream.time)
      print('Lat:{}   '.format(agps_thread.data_stream.lat))
      print('Lon:{}   '.format(agps_thread.data_stream.lon))
      print('Speed:{} '.format(agps_thread.data_stream.speed))
      print('Course:{}'.format(agps_thread.data_stream.track))
      print('----------------')
      sleep(60)  # Sleep, or do other things for as long as you like.

Without arguments between the parentheses, the threaded client defaults to host='127.0.01', port=2947, gpsd_protocol='json', and usnap=0.2, for a respectable default of 2/10th of a second micro nap after each empty socket lookup.

The rest of the project is in DESCRIPTION.rst, or documented in the files themselves.