[[Vorlage(Archiviert, )]]

{{{#!vorlage Wissen
[:Pakete installieren: Installation von Programmen]
[:Paketquellen_freischalten/PPA: Verwenden eines PPAs]
[:Paketinstallation_DEB: Ein einzelnes Paket installieren]
[:Programme starten: Ein Programm ohne Menüeintrag starten]
[:Programmstarter: Einen Programmstarter erstellen]
[:Packprogramme: Archive entpacken]
[:Terminal: Ein Terminal öffnen]
}}}
[[Inhaltsverzeichnis(1)]]

[[Bild(./karte.jpg, 80, title="Rückseite einer Fahrerkarte", align=left)]]
[sourceforge:fahrlinx.berlios:Fahrerkarte unter Linux] {en} (Fahrlinx) ist ein Programm, mit dem man [wikipedia:Fahrerkarte:Fahrerkarten] unter Linux auslesen kann. Fahrerkarten werden (nicht nur) in Deutschland bei Fahrzeugen ab 3,5 t zur Kontrolle der [http://www.bag.bund.de/DE/Navigation/Rechtsvorschriften/Lenk-Ruhezeiten/lenk-ruhezeiten_node.html Lenk- und Ruhezeiten] {de} eingesetzt.

Auf der Karte sind die Daten für mindestens 28 Tage auslesbar, je nach Nutzung auch deutlich länger, da ältere Datensätze erst überschrieben werden, wenn der Kartenspeicher vollständig belegt ist. So kann es passieren, das sich unter Umständen noch mehrere Jahre alte Daten auf der Karte wiederfinden lassen. Die ausgelesenen Daten kann man mit dem Programm [sourceforge:readesm:Readesm] {de} grafisch darstellen und archivieren.  

= Voraussetzungen =
Um Fahrerkarten auslesen und graphisch darstellen zu können, werden ein Kartenleser (z.B. das oft verwendete Modell [google:Cherry ST 1049UA:] {de}) und folgende Programme benötigt.
 
 * [http://pcsclite.alioth.debian.org/ pcsc] {en} (Gerätetreiber für Kartenleser)
 * [sourceforge2:pyscard:] {en} (zum Auslesen)
 * [sourceforge2:readesm:Readesm] {de} (zum Darstellen und Archivieren)
 * Fahrlinx selbst (zum Auslesen)

Bei Ubuntu [:Precise:Ubuntu 12.04]  kann es sein, dass der Kartenleser automatisch erkannt wird. Nun mit folgendem Befehl [7] prüfen, ob der Kartenleser verwendet werden kann. Hierbei werden alle Geräte angezeigt, die mittels einer USB-Verbindung angeschlossen sind:

{{{#!vorlage Befehl
lsusb
}}}
Ist ein Kartenleser angeschlossen, könnte die Ausgabe wie folgt sein:

{{{
Bus 002 Device 003: ID 046a:002d Cherry GmbH SmartTerminal XX44
}}}

= Installation =
== pcsc ==
Damit Kartenlesegeräte für Fahrerkarten richtig funktionieren, werden folgende Pakete benötigt [1]:

{{{#!vorlage Paketinstallation
pcscd, universe
libccid, universe
}}}
Nun wie oben prüfen, ob der Kartenleser verwendet wird.

== pyscard ==
Zur Installation ist folgendes Paket erforderlich:

{{{#!vorlage Paketinstallation
python-pyscard, universe
}}}

{{{#!vorlage Hinweis
Die im Folgenden beschriebenen Programme Readesm und Fahrlinx sind nicht in den offiziellen Paketquellen enthalten. Zur Installation muss man auf ein "Personal Package Archiv" (PPA) [2] ausweichen. Dieses wird von [launchpad:~k-2005/+archive/ppa:Andreas Gölzer] {en} nur für [:Precise:Ubuntu 12.04] zur Verfügung gestellt.
}}}

== Readesm ==
[[Bild(readesm2.png 100, right)]]
=== Ubuntu 12.04 ===

[[Vorlage(PPA, k-2005/ppa)]]

Nach dem Aktualisieren der Paketquellen kann folgendes Paket installiert werden:

{{{#!vorlage Paketinstallation
readesm, ppa
}}}

##aasche: ungetestet
##=== Ab Ubuntu 12.10 ===
##Um Readesm zu installieren, im PPA die [https://launchpad.net/~k-2005/+archive/ppa aktuelle Version suchen] {en}, herunterladen und manuell installieren [3]. Es empfiehlt sich, für Ubuntu 12.10 das Paket [https://launchpad.net/~k-2005/+archive/ppa/+files/readesm_2011.11pre1ubuntu4_i386.deb readesm_2011.11pre1ubuntu4_i386.deb] {dl} für 32-Bit zu verwenden, welches die Installation vereinfacht.
##
##[[Vorlage(Fremd, Paket, "")]]
##
##Nach dem Download in das Verzeichnis '''Downloads''' gehen und mit einem Doppelklick die Installation starten.

=== Verwendung ===
Nach der Installation kann Readesm über das Terminal aufgerufen werden [4]:

{{{#!vorlage Befehl
readesm
}}}
Für diesen Befehl kann man auch einen Programmstarter anlegen [5]:
 * Name: `Readesm`
 * Beschreibung: `Readesm`
 * Befehl: `readesm`

[[Bild(readesmlogo.png, 48, right)]]
Im Verzeichnis '''/usr/share/pixmaps/''' befinden sich schon die Bilder '''readesm.png''' und '''readesm.svg''', die man als Symbol für den Programmstarter nehmen kann. Das nebenstehende Symbol kann ebenfalls verwendet werden. Dieses herunterladen und mit folgendem Befehl in das Verzeichnis '''/usr/share/pixmaps/''' verschieben:

{{{#!vorlage Befehl
sudo mv ./Downloads/readesmlogo.png /usr/share/pixmaps/
}}}
Mit Readesm können auch gespeicherte Fahrerdaten zu Auswertungszwecken aufgerufen werden, sofern diese Daten im '''.DDD'''-Format vorliegen.

== Fahrlinx ==

=== PPA ===
Das PPA unterstützt nur Ubuntu 12.04.

[[Vorlage(PPA, k-2005/ppa)]]

Nach dem Aktualisieren der Paketquellen kann folgendes Paket installiert werden:

{{{#!vorlage Paketinstallation
fahrlinx, ppa
}}}

##aasche: ungetestet
##=== Ubuntu 13.10 oder neuer ===
##
##=== Manuell ===
##Im Verzeichnis '''~/Dokumente''' ein weiteres Verzeichnis '''fahrlinx''' anlegen. Die Datei [sourceforge:fahrlinx.berlios/files:Fahrlinux-3.1.1.zip] {dl} herunterladen. Die Datei in das Verzeichnis '''Dokumente/fahrlinx/''' entpacken [6]. Darüber hinaus wird das folgende Paket benötigt:
##
##{{{#!vorlage Paketinstallation
##python-wxgtk2.8, universe
##}}}
##
##Nach dem Entpacken kann die Benutzeroberfläche von Fahrlinx über die Datei '''~/Dokumente/fahrlinx/fahrlinx.py''' gestartet werden. Um es komfortabel vom Desktop aus zu starten, kann wiederum ein Programmstarter [5] angelegt werden:
##
## * Name: `Fahrlinx`
## * Beschreibung: `Fahrerkarte auslesen`
## * Befehl: `/home/BENUTZERNAME/Dokumente/fahrlinx/fahrlinx.py`
##
##Zusätzlich kann das Bild am Artikelanfang für den Starter genutzt werden. Dazu die Grafik von oben im Verzeichnis '''~/Downloads''' speichern und in '''fahrlinx.png''' umbenennen. Dann die Datei mit Root-Rechten nach '''/usr/share/pixmaps/''' verschieben.
##
##{{{#!vorlage Befehl
##sudo mv ~/Downloads/fahrlinx.png /usr/share/pixmaps/ 
##}}}

= Bedienung =
== Fahrlinx ==
[[Bild(fahrlinux1.png, 200, right)]]

##aasche: die leider nicht getestet ist
##Die folgende Anleitung orientiert sich an der manuellen Installation. 

 1. Wenn Fahrlinx gestartet wird, erstellt das Programm im Verzeichnis '''~/Dokumente/fahrlinx/''' eine neue Datei '''Fahrlinx.pyc'''
 1. Den Kartenleser anschließen und die Fahrerkarte einstecken
 1. Fahrlinx starten. Im Startfenster auf der linken Seite wird die Fahrerkarte als erkannt angezeigt. Mit einem Doppelklick [[Vorlage(Tasten, lmt)]] die erkannte Fahrerkarte markieren. Im unteren Teil des Startfensters werden weitere Zeilen sichtbar und im rechten Teil steht ''"Selected card"''. Die Schaltfläche ''Start'' ist noch nicht aktiv!

Nun mit einem Linksklick [[Vorlage(Tasten, lmt)]] auf ''"Smartcards"'' die Karte abwählen. Im rechten Teil des Startfensters steht ''"Deselected card: none"''. Durch einen erneuten Linksklick [[Vorlage(Tasten, lmt)]] auf die erkannte Fahrerkarte wird diese wieder markiert und im rechten Teil vom Startfenster die Schaltfläche ''"Start"'' aktiviert.

Nun mit einem Linksklick [[Vorlage(Tasten, lmt)]] auf die Schaltfläche ''"Start"'' das Auslesen der Fahrerkarte starten. Die markierte Fahrerkarte wird dann grau hinterlegt dargestellt. Eine Anzeige, das Fahrlinx fertig ist, erfolgt leider nicht. Die Lampe des Kartenlesers hört nach Beendigung des Auslesens auf zu blinken. Die ausgelesene '''.DDD'''-Datei befindet sich im [:Homeverzeichnis:].

[[Bild(fahrlinux2.png 100, right)]]

Ist Readesm installiert, trägt die Datei bereits das Symbol von Readesm. Die Datei kann bei Sonderzeichen im Namen eine ungültige Kodierung haben. Dann die Datei einfach umbenennen, z.B. in '''Max Mustermann.DDD'''. Nun mit einem Doppelklick [[Vorlage(Tasten, lmb)]] die Datei mit Readesm öffnen und die Daten anzeigen lassen.

== Fahrerkartendatei auswerten ==
Zum Auswerten der Fahrerkartendatei Readesm starten und die Datei öffnen. Die Datei kann dann gespeichert oder in das Format '''.xhtml''' exportiert werden. Die Ansicht ist bei beiden Formaten gleich.

== Legende ==
Die Readesm-Daten werden in der Anzeige farblich markiert:

 * Gelb  = Arbeitszeit
 * Lila  = Karte nicht im Fahrtenschreiber
 * Grün  = Fahren
 * Rot   = gültige Lenkzeitunterbrechung / Ruhezeit / Pause
 * braun = kurze Pause / keine gültige Pause

[[Bild(readesm1.png, 400, align=center)]]
                  
= Links =
 * [sourceforge:fahrlinx.berlios:Projektseite] {en}
  * [launchpad:~cornix/+archive/ubuntu/unsupported-fahrlinx:PPA] {en} für Ubuntu 14.04
 * [http://readesm.sourceforge.net/help.html Readesm Hilfe] {en}

# tag: Grafik, Hardware, Büro, Chipkarte