====== Introduction ======

TrackReader/Android is a simple application which allows a user to connect to tracking modules such as the 
QStar 1000 or the venerable G-Ray. The application allows the user to connect to, configure, and download tracks from the GPS modules.

Protocol reference: [[reference:QStar GPS Tracker]]

===== Story 1 =====
A job site is using QStart (or perhaps G-Ray) tracker devices attached to the various machine. At the end of each day, or perhaps a couple of times a day, a site supervisor needs to download the tracks from the trackers for analysis. The supervisor will use an Android device to sequentially connect, via Bluetooth, to each tracker, download the tracks and then move on to the next tracker. 

(MC-A common scenario is the trackers might be collected by someone who is not the guy downloading them. They pull them all in and put another out as they charge the old ones. Two days + is a normal battery life.)

The supervisor has the option to download tracks to either the Android device, or download and then upload them to the Access server. Uploading will send the files to the "Tracks" directory of the selected project. 

(MC-The server upload is obvious but how does the user get the files off if it's not to the server. I could see supporting "Share" intents so they could move them by a variety of intents right then. The files will be there if they need to use a file editor but that seems like the least preferred method)

Later in the office, a desktop user can use AgtekAccess client to download the files so they can be read into TrackWorks. 

{{:android:trackreader:trackreader-main-screen.png?direct&200|}} Selecting "Configure devices" menu action leads to this screen: {{:android:trackreader:trackreader-config-screen.png?direct&200|}} 

Selecting any one device will bring up the configure dialog, allowing the user to configure (or reconfigure) a device. Checking the "Show all devices" checkbox will show all devices, even if they are configured with different providers (AKA Trimble, although the likely hood of this will be low because TrackReader is to maintain a private list of devices, not shared with other programs like SmartGrade). 

To be specified: What mechanism would be used to upload the tracks as if they are SimpleTrack trackers.



Steps:

  - Open Program, pick tracker (There might be multiple trackers present)
  - Read the Tracker
  - Upload and/or save File
  - Prompt the user to erase tracks (we could automatically erase tracks but we need to make sure we still have the data. Also in testing we often don't want to erase tracks because we don't want to have to collect them again.)



NOTE: This program is NOT a licensed product.

===== Story 2 =====

  * Support G-Ray with same features.