... under development...

The installation requires some hardware and software work.

Follow the referenced pages from the README and install:

• TFT display from Adafruit (2.8" or 3.5", both are working)
• Ultimate GPS from Adafruit with UART (other GPS receivers might work, too); PPS is wired!
• Make sure that your TFT is working and that you receive GPS data (i.e. with cgps -s -u m)

t.b.d.

• Download and extract or clone the gpstrace software
• Install and configure gpstrace
• Install and configure navit (optional)

The gpstrace files should be stored in the same structure on the operating system, starting with / (see File Tree in README). This can be achieved by copying them from the distribution to the OS:

The following steps assume that you have downloaded the v1.0.zip archive, i.e. with wget https://github.com/kruthoff/gpstrace/archive/v1.0.zip. All commands are executed as user pi or with sudo pi.

unzip v1.0.zip

Create a backup archive of the existing OS files first. Run this command on one line:

cd gpstrace-1.0; find . -type d \( -name .git -or -name wiki \) -prune -o -type f \( ! -name README.md -and ! -name LICENSE \) -print | (cd / && tar cvfj /home/pi/gpstrace-backup-<backtick>date -Idate<backtick>.tar.bz2 -T -)

while <backtick> should be replaced with `.

There will be a lot of errors on the console, but this doesn't matter. We have stored the original in a backup archive in your home. This archive can be used to replace the modified files with the original ones, if required.

Being in gpstrace-master, extract the important gpstrace files into the OS:

tar cf - --exclude README.md --exclude LICENSE . --exclude .keep . | (cd / && sudo tar xvf -)

Install the following package to enable some X server features:

sudo apt-get install x11-xserver-utils

Install navit, a navigation software, if you want to use it (not required):

sudo apt-get install navit

The following steps depend on your TFT display, and assume that you've installed navit, too.

Please configure the terminal font through the desktop preferences, i.e. monospace 8. /home/pi/gps/startgpstrace.sh sets the terminal window to full screen.

The TFT backlight is controlled through the script /home/pi/tft/toggle.sh which is launched from the navit software via touchscreen. Note: the script isn't used for the 2.8" TFT.

It is possible to shutdown the Raspberry Pi via the touchscreen, if required.

Initialize the TFT buttons to shut down the Raspberry Pi, and to switch on/off the backlight. Note: these steps aren't used for the 3.5" TFT.

cd /etc/init.d && sudo update-rc.d tftbuttons defaults

The script can be controlled within /etc/default/tftbuttons

Please configure the smallest possible terminal font through the preferences, i.e. monospace 7. Enable the appropriate line in /home/pi/gps/startgpstrace.sh which sets the terminal window to full screen.

Run the following commands if you want to run gpstrace in console mode only, without starting the graphical desktop.

Initialize the gpstrace init script to run in the boot console. A desktop isn't started, navit isn't required. This installation is a bare bone installation which reduces gpstrace to the minimum.

cd /etc/init.d && sudo update-rc.d gpstrace defaults

Some defaults can be defined in /etc/default/gpstrace

All traces are stored in /home/pi/gps/traces and can be copied for further analysis, i.e. gpsprune.

Q: My TFT screen is black, altough I've enabled to boot into the desktop via sudo raspi-config?

A: Disable to boot into the desktop via sudo raspi-config and start X from /etc/rc.local: su -l -c "startx" pi instead (default).