Metadata-Version: 2.1
Name: obdtracker
Version: 0.2.4
Summary: Library to read data from http://www.aika168.com and other cloud services to track cars with GPS trackers installed
Home-page: https://github.com/nyxnyx/gps_obd2_tracker
Author: Grzegorz Szostak
Author-email: szostak.grzegorz@gmail.com
License: UNKNOWN
Description: # GPS OBD2 tracker
        This project is for Chinese GPS tracker for cars.
        
        # Which GPS ODB2 trackers are supported?
        This is good question and very hard to find proper answer. It was developed and tested on devices bought on 
        AliExpress which looks like this one:
        ![GPS ODB2 Tracker](/doc/images/gps_tracker.png)
        After reading attached instruction - I have found error - they say to connect to 3.tkstargps.net side but app is AIKA. What I found - that device is connecting (after sending SMS to it) to XX.aika168.com - and communication between mobile app and server is open (no ssl). This was an invitation to create this library. Other GPS OBD2 Trackers that work with AIKA mobile app should work with this library too. How to check that? Look at pictures of 
        mobile app that usuary is shown on pages where somebody is selling device. If you see something like:
        ![AIKA APP](/doc/images/OBD-II-GPS-Tracker.jpg)
        
        Map with blue top bar with reload button on right and back arrow on left. This is AIKA app. And here is a link to Google app store: [AIKA app](https://play.google.com/store/apps/details?id=com.fw.gps.xinmai&hl=en_US).
        
        # How to use this code?
        It's a library. To integrate with your code you have to write something like this:
        ```
        from obdtracker import api, device_status, obd, location
        import logging
        
        def main():
            la = api.API("http://www.aika168.com/")
            la.registerUpdater(location.Location(la))
            la.registerUpdater(device_status.DeviceStatus(la))
        
            loop = asyncio.get_event_loop()
        
            loop.run_until_complete(la.doLogin('<Your device id>', '<Your server password>') )
            loop.run_until_complete(la.doUpdate())
        
            attrs = vars(la)
            print(', '.join("%s: %s" % item for item in attrs.items()))
        
        if __name__ == "__main__":
            main()
        ```
        
        # NEW: list of UNSUPPORTED mobile applications
        If you are going to buy GPS OBD2 Tracker checkout this list to see which mobile apps are unsupported. Acually it means that those mobile apps use cloud service that is not supported with this tool:
        (Unsupported cloud / OBD2 GPS Trackers)[/doc/unsupported.md]
        
        # Supported apps / cloud services:
        1. aika168.com / www.aika168.com - developed using this cloud service - works
        1. gpscj.net / gps18.com - not sure - possibly it is working
        
        # What is next step?
        Right now I'm working on:
        - Home Assistant device tracker
        - App for getting information about protocol between device and gateway at XX.aika168.com
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
