I needed to test some XBee long-range radios. Hmm, how can we make this test useful and fun at the same time? Well, let’s put one end of the radio in the lab connected to a computer, and wander around with the other radio while transmitting the current position obtained from a GPS.
Using the XBee evaluation kit, my (t)rusty eTrex GPS, a 12V battery and some cables, the hardware was quickly in place. Now, what to transmit over the link? Full NMEA? Hmm, maybe this is a bit overkill. Sending the position once a second ought to be enough. But then I need a microcontroller between the GPS and the radio to reformat the NMEA into simple position beacons. There has to be an easier way…
Going through the option menu of the eTrex, various output formats can be selected for the data output port. One of them is called ‘Text out’. Garmin has nicely documented this format (kudos!). When selecting this output mode, a simple ASCII string reporting position and speed is sent once a second. There we go!
Now, I also wanted to be able to plot the logged samples on a map to get a quick view on how far the link actually works fine. Enter GPS Visualizer. The only thing required to plot the logs on a map is a small format conversion.
Time to put together a small Perl script to re-write the output of the serial port of the XBee module into a format that is understood by GPS Visualizer.
Manpage is listed below.
NAME garmin_simpletext_parser - Perl script to convert a Garmin simple text logfile into a CSV file for GPS Visualiser SYNOPSIS garmin_simpletext_parser [options] <inputfile>
where valid options are --o <fname> - force output file name --help - display this help --debug - print debug messages
# Convert the file using the default outputfile garmin_simpletext_parser log1.txt
DESCRIPTION This script is converts a logfile written in the Garmin simpletext format into a comma separated value file that can be used to plot a map on GPS Visualiser. By default the outputfile name is equal to the input filename, but the extension is changed to 'csv'. If the output file exists, the output of the script is appended to the existing files. Resources: Garmin simple text format: http://www8.garmin.com/support/text_out.html GPS Visualiser: http://www.gpsvisualizer.com/ BUGS/LIMITATIONS This script assumes the log was made in the year 2000 or later. It prepends '20' before the date generated by the GPS. If the outputfile exists, it is overwritten. SEE ALSO Project website: http://electronics.lika.be/ AUTHOR Lieven Hollevoet COPYRIGHT Copyright (C) 2010 by Lieven Hollevoet This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.