Installing QLandkarte GT on Gentoo Linux

Daniel Bernhardt

Creative Commons Attribution-Noncommercial-Share Alike 3.0 Germany License

Abstract

This manual explains how to install the latest version of QLandkarte GT on Gentoo Linux and how to use a Garmin GPS device with the software.


Revision History
Revision 1.02010-02-19Daniel Bernhardt
initial manual release
Revision 1.12010-02-20Daniel Bernhardt
removed usage of version from portage

Preperations

For GPS users only

Skip this step if you do not want to use a Garmin GPS device.

If you are going to use a Garmin GPS device with QLandkarte GT you need to prevent the kernel module garmin_gps from loading. This can be achieved by either removing the module from your kernel (It's called CONFIG_USB_SERIAL_GARMIN or by blacklisting it from the autoloading process of modules.

Example 1. Blacklisting garmin_gps module

This step is only necessary if you want to use a Garmin GPS device and you do not want to recompile your kernel without the garmin_gps module. Open /etc/modprobe.conf and add blacklist garmin_gps to the end of the file.

# prevent garmin kernel module from loading
blacklist garmin_gps
			

To let QLandkarte GT perform read/write operations on your GPS device you need to modify some permissions. This is done by adding a udev rule to your system. Create a file named /etc/udev/rules.d/71-garmin.rules and put the following into it.

# allow read/write for garmin gps devices
SYSFS{idVendor}=="091e", SYSFS{idProduct}=="0003", MODE="666"
		

Each time you plug in your GPS device udev will make the necessary permission changes so QLandkarte GT can access the device and work with it.

Installation

At the time of writing the latest version of QLandkarte GT is not available in the portage repository. If you don't know how to setup a portage overlay, consult the Gentoo handbook.

Note

Do not install QLandkarte GT which comes with portage. The ebuild does not pull in all the required dependencies to make QLandkarte GT work as expected. Use the ebuild below.

Prior to installing QLandkarte GT create the file /usr/local/portage/sci-geosciences/qlandkartegt/qlandkartegt-0.17.1.ebuild and fill it with

DESCRIPTION="View and upload map files, track and waypoint data to your Garmin GPS."
HOMEPAGE="http://www.qlandkarte.org/"
SRC_URI="mirror://sourceforge/${PN}/${P}.tar.gz"
LICENSE="GPL-2"
SLOT="0"
KEYWORDS="~amd64 ~x86"
IUSE=""
DEPEND="x11-libs/qt-core:4
        x11-libs/qt-gui:4
        x11-libs/qt-opengl:4
        x11-libs/qt-sql:4
        >=sci-libs/proj-4.7.0
        >=sci-libs/gdal-1.6.1"
RDEPEND="${DEPEND}
        sci-geosciences/gpsbabel"
			

ebuild /usr/local/portage/sci-geosciences/qlandkartegt/qlandkartegt-0.17.1.ebuild digest will prepare the ebuild and you are good to go to install QLandkarte GT with emerge qlandkartegt.

If you want to use a Garmin GPS device you also need qlandkartegt-garmindev. Create the file /usr/local/portage/sci-geosciences/qlandkartegt-garmindev/qlandkartegt-garmindev-0.3.3.ebuild and put the following in it.

inherit cmake-utils

DESCRIPTION="Garmin drivers for qlandkartegt."
HOMEPAGE="http://www.qlandkarte.org/"
SRC_URI="mirror://sourceforge/qlandkartegt/${P/qlandkartegt-/}.tar.gz"
LICENSE="GPL-2"
SLOT="0"
KEYWORDS="~amd64 ~x86"
IUSE=""
DEPEND="sci-geosciences/qlandkartegt
        dev-libs/libusb"
RDEPEND="${DEPEND}"
S="${WORKDIR}/${P/qlandkartegt-/}"		
			

Repeat the steps from above to prepare and install the ebuild.

Configuration

Start QLandkarte GT by typing qlandkarte and go to Setup -> General. Switch to the Device & Xfer tab and select your Garmin GPS device from the dropdown list.

Enjoy using QLandkarte GT.