Graphtft-plugin

Aus VDR Wiki
Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

Beschreibung

Autor: Lars Tegeler, Jörg Wendel

Plugin welches über ein Framebuffer-Device, directFB, einer zweiten Full-featured-DVB-Karte oder, via graphtft-fe, einem X-Server die VDR Menüs und EPG Informationen ausgibt.

Um die Wiedergabe via directFB nutzen zu können benötigt man eine Grafikkarte, die diese Funktion auch unterstützt. Eine Übersicht entsprechender Grafikkarten findet ihr hier.

Versionsübersicht

Aktuelle graphTFT Version: 0.3.1

Zur Version 0.3.1

Ab der Version 0.3.x sind, neben einer Reihe von Fehlerbehebungen und anderen Neuerungen, auch die Funktionen des touchTFT Plugins fester Bestandteil von graphTFT. Dies ermöglicht eine deutlich bessere Zusammenarbeit der Funktionen, als es bisher über Schnittstelle möglich war. Auch die annährend gleichen Setup-Parameter müssen nun nicht mehr doppelt gepflegt werden. graphTFT verfügt über eine optimierte Kalibrierung, welche neben der selbstständigen Berechnung von Offset und Umrechnungsfaktoren z.B. auch vertauschte X/Y Koordinaten selbstständig erkennt. Ferner ist eine Testfunktion zum Koordinatencheck enthalten.

Für das neue graphTFT Plugin sind auch wieder neue Themes notwendig.

Enthaltenes Feature: Einblendbare Mausbuttons. Die Maus-Buttons sind nicht wie bisher ständig sichtbar und belegen somit keinen ständigen Anzeigeplatz mehr. Statt dessen kann man über einen Button ein Buttonmenü aufrufen, welches sich - ähnlich wie die Lautstärkeregelungsanzeige, über die Menü- oder EPG Informationen legt. Die Buttons können nach Gebrauch manuell ausgeblendet werden oder verschwinden nach einer einstellbaren Zeit wieder automatisch. Die einblendbaren Mausbuttons werden in den Themes eingerichtet. Sie sind also ein KANN - kein MUSS. So kann sich jeder Theme-Autor nach seinem Geschmack frei entfalten. Der Umfang der Buttons entspricht etwa denen der touchTFT-DeepBlue Version.

Weiter enthalten:

- Animation von bis zu 10 Bildern möglich. Der Bildwechsel-Intervall ist in Millisekunden konfigurierbar (damit ist das in der 0.0.8er Version enthaltene umschalten zwischen zwei Bildern wieder verfügbar).

- Über SVRDSEND können die Darstellungsarten (NormalView) jetzt auch durchgeblättert werden.

- Regelmäßiges Neuzeichnen der ganzen graphTFT Darstellung zur Beseitigung unerwünschter Konsolenmeldungen (z.B. runlevel 2).

- Neue Funktionen zur Maus/Touchsteuerung für die Themes.

- Bugfix 0.3.0->0.3.1: Unterstützung eGalaxy Touchscreens.

- Bugfix 0.3.0->0.3.1: Absturz bei Ansichtenwechsel über keymacros bei ausgeblendeten Hauptmenü-Eintrag behoben.

Neue graphTFT Features in den 0.3.1 Themes umgesetzt

- Neue Standardanzeige "Detail" - Zeigt die EPG Informationen des laufenden Programms großformatig an.

- Bessere Unterstützung von UTF-8 Darstellungen

Touch- & Maus-Erweiterungen:

- Klick auf das Senderlogo in der Standardansicht öffnet das Menü

- Klick auf den Sendungstitel in der Standardansicht öffnet die EPG-Informationen

(Bisher) nur Maus (graphtft-fe):

- Scrollen der EPG-Informationen über Mausrad und 'ziehen' mit der Maus (für touch-Device in Planung)

Bilder

Plugin >= 0.3.0

Theme "Alien vs. Predator"
Touchscreen-Kalibrierung
Theme "Alien vs. Predator"
Maustasten
Theme "Alien vs. Predator"
Detail-Ansicht
Theme "DeepBlue"
Touchscreen-Kalibrierung
Theme "DeepBlue"
Maustasten
Theme "DeepBlue"
Detail-Ansicht

Plugin >= 0.2.0

Theme "Alien vs. Predator" Standard-Ansicht
Theme "Alien vs. Predator" Auswahlmenü
Theme "Alien vs. Predator" Kanalauswahl
Theme "Alien vs. Predator" Was läuft jetzt
Theme "Alien vs. Predator" EPG Programmübersicht
Theme "Alien vs. Predator" Wiedergabe Aufnahme
Theme "Alien vs. Predator" Sysinfo Ansicht
Theme "Alien vs. Predator" Clock Ansicht
Theme "Alien vs. Predator" music Plugin
Theme "Alien vs. Predator" music Plugin - Morone-Skin

Plugin >= 0.0.14

Theme "deepblue"
Theme "deepblue"
Theme "deepblue"
Theme "deepblue"
Theme "deepblue"
Theme "deepblue"
Theme "deepblue"
Theme "deepblue"
Theme "Alien vs. Predator"
Theme "Alien vs. Predator"
Theme "Alien vs. Predator"
Theme "Alien vs. Predator"
Theme "Alien vs. Predator"
Theme "Alien vs. Predator"
Theme "Alien vs. Predator"
Theme "Alien vs. Predator"
Theme "Alien vs. Predator"
Theme "Alien vs. Predator" - Morone-Skin
Theme "poetter"
Theme "poetter"
Theme "poetter"
Theme "poetter"
Theme "poetter"
Theme "poetter"


Hardwareanforderungen

Softwareanforderungen

Installation

Allgemeines

Für das Plugin ab Version 0.1.x muss der VDR gepatched werden. Der Patch ist im Extension Patch enthalten und nicht einzeln verfügbar. Andere Plugins wie epgsearch, extrecmenu und arhgDirector beinhalten in ihrer aktuellen Version bereits die nötigen Erweiterungen bzw. Anpassungen. Ggf. muss dort ein 'make'-Schalter gesetzt werden dazu bitte die Makefiles und README dieser Plugins beachten! Ab Version 0.2.1 wurde der VDR- sowie der epgsearch-Patch erweitert, dies ist noch nicht im Extension Patch bzw. dem aktuellen epgsearch-Plugin enthalten, sie liegen den graphTFT Sourcen im Verzeichnis patch bei.
Siehe dazu auch das Kapitel Zusammenspiel mit anderen Plugins. Nach dem patchen des VDR müssen immer ALLE Plugins neu übersetzt werden!
Bei einem Upgrade von graphTFT 0.2.1 ist kein weiteres Patch erforderlich.

Hier eine kleine Liste der notwendigen Schritte:

  1. VDR patchen (sofern erforderlich)
  2. epgserach-0.9.24 patchen (sofern erforderlich)
  3. graphTFT >= 0.2.1 Sourcen nach .../VDR/PLUGINS/src kopieren und verlinken
  4. alte Themes unter .../vdr/plugins/graphTFT/themes/ entfernen (nicht nur umbenennen - wirklich entfernen)
  5. zur graphTFT Version passenden Theme unter .../vdr/plugins/graphTFT/themes/ ablegen.
  6. EPG Bilder werden unter /video0/epgimages gesucht. Sollten die Images wo anders liegen, bitte in /video0 entsprechend verlinken. Ab 0.3.0 sind weitere Suchpfade vorgesehen.
  7. Nun den VDR selbst und ALLE vorhandenen Plugins übersetzen, in die Ausführungsverzeichnisse kopieren und den VDR verlinken.

Für easyVDR findet ihr im easyVDR-Wiki unter Entwicklung auch eine schöne Beschreibung. Vielleicht nutzt sie dem einem oder anderen.

Make Optionen

In der aktuellen Version ermittelt das Makefile die verfügbaren Libraries und Pfade weitestgehend automatisch. Kann eine Library nicht gefunden werden wird ein entsprechender Hinweis ausgegeben. In diesem Fall ist die fehlende Library zu installieren und der Build-Prozess erneut anzustoßen. Bei Optionalen Funktionen kann alternativ auf die entsprechende Library/Funktion verzichtet werden.

Bei einigen Distributionen können die Pfade nicht automatisch ermittelt werden, in diesen Fällen ist leider eine manuelle Anpassung des Makefile nötig. Dies passiert in der Regel wenn pkg-config nicht oder nicht richtig eingerichtet ist. Leider ist ffmpeg (libavcode) hiervon des öfteren betroffen, die Installationspfade der einzelnen Versionen und Distributionen unterscheiden sich hier leider sehr stark. In manchen Fällen muss sogar der relative Pfad der include Direktive angepasst werden :(

Patches

  • vdr >= 1.3.18 Patch ist für das Plugin 0.0.8.

Source

cd $SOURCEDIR
tar xvzf imlib2-<VERSION>.tar.gz
cd imlib2-<VERSION>
./configure --prefix=/usr/local
make
make install
ldconfig
cd -

tar xvzf ffmpeg-<VERSION>.tar.gz
ln -s ffmpeg-<VERSION> ffmpeg
cd ffmpeg
./configure --prefix=/usr/local \
            --enable-shared
make
make install
ldconfig

Arch-Linux

pacman -S imlib2 ffmpeg

Crux

prt-get depinst imlib2 ffmpeg

Debian

Quelle: http://www.vdrwiki.com/index.php/M%C3%B3dulo_osdpip

apt-get install libimlib2-dev ffmpeg libavcodeccvs51 libavcodeccvs51-dev

Gentoo

emerge a52dec imlib2 ffmpeg

SuSE

yast -i imlib2-devel <BITTE ERGÄNZEN>

Konfiguration

Spezielle Fonts

Ab 0.2.0 ist der Font-Suchpfad im Theme frei konfigurierbar. Theme Entwickler sollten die vom ihrem Theme benötigten Fonts, um Abhängigkeiten so gering wie möglich zu halten, mit dem Theme ausliefern.
Aktuelle Versionen von DeepBlue und Alien vs. Predator liefern einen eigenen auf die graphTFT Belange zugeschnittenen Font (graphTFT.ttf) mit.

Bis zur Version 0.2.0 müssen alle von den Thems benötigten Fonts in folgendem Ordner bereit gestellt werden (am Beispiel Vera):

mkdir -p $VDRCONFIG/plugins/graphTFT/fonts
locate Vera.ttf
/usr/X11R6/lib/X11/fonts/truetype/Vera.ttf
cp /usr/X11R6/lib/X11/fonts/truetype/Vera.ttf $VDRCONFIG/plugins/graphTFT/fonts

Findet Ihr mit dem Suchtool (locate) keine Fonts auf dem System, kann man sie auch nachinstallieren.

Debian -> apt-get install ttf-bitstream-vera
SuSE   -> yast -i bitstream-vera
Gentoo -> emerge ttf-bitstream-vera

Oder mal google bemühen ...

Themes

Themes werden vom graphTFT Plugin im Verzeichnis $VDRCONFIG/plugins/graphTFT/themes erwartet.

mkdir -p $VDRCONFIG/plugins/graphTFT/themes
tar jxvf /wo/auch/immer/standard-theme-<VERSION>.tar.bz2 -C $VDRCONFIG/plugins/graphTFT/themes

Zusammenspiel mit anderen Plugins

Um graphTFT zur Zusammenarbeit mit anderen Plugins wie z.B. epgsearch oder extrecmenu zu bewegen müssen auch diese, je nach Version, gepatched werden. In neueren Versionen von epgsearch, extrecmenu und music sind die nötigen Erweiterungen bereits enthalten, hier ist nur darauf zu achten, dass sie ggf. mit der entsprechenden Makefile Schaltern übersetzt wurden bzw. werden.

Die Darstellung von ID3Tag Daten in Zusammenspiel mit dem music Plugin, funktioniert erst ab der music Plugin Version 0.4.0-b3. music Plugin Version 0.4.0-b3 wiederum läuft erst ab VDR 1.6.0.

Ab Version 0.2.0 bitte auch unbedingt den Abschnitt Probleme beachten.

Ab Version 0.3.0 unterstützt graphTFT Plugin auch direkt Touchscreens. Das touchTFT Plugin wird dann nicht mehr benötigt und muss, um Kollisionen zu vermeiden, deinstalliert werden. Siehe auch Touchscreen Einrichtung

Einstellungen

Folgende Einstellungen gibt es im Setup

Parameter Funktion
Aussehen: Theme Auswahl
Hauptmenueintrag verstecken: OSD-Hauptmenü Eintrag ausblenden
Konvertiere ISO zu UTF-8: Texte vor der Anzeige in UTF-8 konvertieren. Nur aktivieren wenn UTF-8 Konvertierung nötig und der der VDR nicht schon mit UTF-8 läuft!
Spectrum Analyzer: Spektrum Analyzer aktivieren
Dump Bild
Dump Bild in Datei speichern: Die graphTFT Ausgabe automatisch in regelmäßigen Abständen als graphTFT.png Datei unter /tmp abspeichern
Einmal eingestellt werden die Dump Bilder selbstständig, bis zum ausschalten der Funktion hier im Setup, immer wieder unter gleichen Namen, wobei sie sich gegenseitig überschreiben damit der Plattenplatz nicht ausgeht, erstellt. Zur Erzeugung ist außer diesem Eintrag hier, keine weitere manuelle Aktion notwendig.
Da diese Funktion den VDR kontinuierlich belastet, sollte sie nur dann aktiviert werden, wenn man auch Dump Images, z.B. zur Theme erstellung oder Fehlerdokumentation, benötigt.
Dump alle [Sek] erneuern: In welchem Zyklus (Sekunden) soll der graphTFT Screenshot erstellt werden?
Dump Bild Breite: Breite der abgespeicherten Grafik.
Dump Bild Hoehe: Höhe der abgespeicherten Grafik.
Snapshot Schnappschüsse für Bilder von Sendungen und Aufnahmen zur Anzeige in den OSD Menüs
Snapshot Breite: Gewünschte Breite der Snapshot-Bilddatei
Snapshot Hoehe: Gewünschte Höhe der Snapshot-Bilddatei
Snapshot JPEG Qualitaet: Kompression/Qualität des Snapshot Bildes von 0-100%. Je höher die Qualität, desto größer das Bild.
Snapshot Ablagepfad: Ordner in welchem die Snapshots abgelegt werden sollen.
DVB Device
Benutze StillPicture: Die Pausefunktion des DVB-Treibers wird benutzt, um die Grafik anzuzeigen.
Aktualisieren: Refresh Rate der DVB Ausgabe
DVB/FB Device
Tausche OSD: Bild 180° spiegeln
Breite: Display Breite
Hoehe: Display Höhe
X Koordinaten Abweichung: Bildposition vertikal
Y Koordinaten Abweichung: Bildposition horizontal
Rahmen zur Hoehe: Rahmen oben/unten
Rahmen zur Breite: Rahmen rechts/links
TCP Verbindung Parameter der TCP Verbindung zum optionalen X-Frontend
JPEG Qualitaet: JPEG Übertragungsqualität (0-100); schlechtere Qualität -> schnellere Übertragung ;)
touch Device
Device: Device des Touch-Displays z.B. /dev/input/event?
Debug
Log Device: Auswahl des Log-Device
Debug Level: Wie viel soll geloggt werden.

Parameter

Unterstützte Kommandozeilenparameter:

Parameter (kurz) Parameter (lang) Ausgabe über <DEV> Wert
-d <DEV> --device=<DEV> FF-DVB-Karte:
DirectFB:
Framebuffer (Grafikkarte):
Aus:
vdr/1
directFB
/dev/fb0
none

Ist kein Device angegeben wird beim Start automatisch in dieser Reihenfolge gesucht: freie FF-DVB Karte, directFB, FB.
Die X Ausgabe funktioniert, sofern ein-compiliert, parallel und muss nicht extra angegeben werden.

OSD-Hauptmenüeintrag

graphTFT verfügt, sofern es im Setup enstprechend aktiviert wird, über ein eigenes OSD-Menü mit folgenden Punkten:

OSD-Menü Verwendung
Themes neu laden Lädt das eingestellte Theme File neu, ohne das der VDR neu gestartet werden muss. Sehr hilfreich bei der Erstellung neuer Themes.
Entspricht SVDRP Befehl: RELOAD
Anzeige aktualisieren Aktiviert/Deaktiviert die Anzeigeaktualisierung.
Entspricht SVDRP Befehl: ACTIVE
Standardanzeige Umschaltung und Festlegung der graphTFT Standardanzeige (wird in setup.conf als Default gespeichert).
Die Darstellung der gewählten Anzeige wird in den Theme Files in den Abschnitten [normal...] festgelegt. Default verfügbare Darstellungen sind: Standard, Dia, Detail, Clock und Sysinfo.
Entspricht SVDRP Befehl: VIEW
Snapshot (Roter Button) Erzeugt ein Bildschirmfoto der laufenden Wiedergabe (TV-Bild) in dem im Setup festgelegten Verzeichnis (Snapshot path).
Snapshot erzeugt kein Bild der graphTFT Ausgabe. Ein graphTFT-Screenshot wird nur über die im Setup unter Dump Image vorzunehmenden Einstellungen erreicht.

SVDRP Unterstützung

Einige graphTFT Funktionen lassen sich auch über SVDRP Befehle ausführen.

Allgemeiner Aufruf:

 svdrpsend.pl plug graphtft [Befehl] [Option]
Befehl Optionen Verwendung
ACTIVE Aktiviert/Deaktiviert die Anzeigeaktualisierung. ACTIVE funktioniert nur zusammen mit einer der folgenden Optionen
ACTIVE on Aktiviert die Anzeigeaktualisierung.
ACTIVE off Deaktiviert die Anzeigeaktualisierung.
NORMALVIEW Wurde mit graphTFT 0.2.2 gegen den Befehl VIEW ersetzt. Die Optionen sind die gleichen wie bei VIEW.
REFRESH Bewirkt eine erzwungene Aktualisierung der angezeigten Informationen.
RELOAD Lädt das eingestellte Theme File neu, ohne das der VDR neu gestartet werden muss. Sehr hilfreich bei der Erstellung neuer Themes.
VIEW Umschaltung und Festlegung der graphTFT Standardanzeige (wird in setup.conf als Default gespeichert).
Die Darstellung der gewählten Anzeige wird in den Theme Files in den Abschnitten [normal...] festgelegt. VIEW funktioniert nur zusammen mit einer der folgenden Optionen.
Ab 0.3.1.:Wird der VIEW Befehl ohne weiteren Parameter aufgerufen, wird auf die jeweils nächste Ansicht umgeschaltet. Einzeln kann man die Ansichten mit den nachfolgenden folgenden Optionen gezielt umschalten.
VIEW Standard Schaltet die Darstellung des Displays auf Standard-Ansicht um.
Die Standardansicht zeigt eine Übersicht über das laufende und nachfolgende Programm sowie Programmoptionen wie z.B. Dolby Digital oder Zweikanal Tonübertragung.
VIEW Detail Ab 0.3.1.: Schaltet die Darstellung des Displays auf EPG-Detail-Ansicht um.
Die EPG-Detailansicht zeigt die EPG-Informationen und EPG-Bilder zum laufenden Programm großformatig an. Liegen für die Sendung mehrere EPG-Bilder vor, wird die Anzeige in regelmäßigen Abständen neue Bilder des Programms anzeigen.
VIEW Dia Schaltet die Darstellung des Displays auf Dia-Ansicht um.
Die Dia Darstellung dient zur Ausgabe von beliebigen Bildern auf dem TFT. Mit diesem SVDRP Befehl ist es - durch Einsatz eines externen Scripts - möglich, das Display zusätzlich zur Programmanzeige auch als digitalen Bilderrahmen nutzen zu können. Ein kommentiertes Beispielscript liegt den graphTFT Sourcen unter scripts/dia.sh bei.
VIEW Clock Schaltet die Darstellung des Displays auf Uhren-Ansicht um.
Bei der Clock-Ansicht bildet eine große Uhren- und Datumsanzeige den Bildmittelpunkt. Darüber hinaus zeigt eine Übersicht über das laufende und nachfolgende Programm an.
VIEW Sysinfo Schaltet die Darstellung des Displays auf Systeminfo-Ansicht um.
Sysinfo bietet einen Überblick über die genutzten und freien Systemressourcen, wie z.B. der aktuellen Prozessorauslastung, des VDRs. Es werden keine Angaben zum laufenden Programm angezeigt.

Touchscreen Einrichtung

Ab Version 0.3.0 verfügt graphTFT über eine eigene Schnittstelle für Touchscreen Displays.
Das bisher dafür notwendige touchTFT Plugin wird nun nicht mehr benötigt und muss, um Kollisionen zu vermeiden, sofern vorhanden deinstalliert werden.

Zur Einrichtung des Touchscreens ist im graphTFT-Setup zunächst das Event-Device des Touchscreens anzugeben.
Die Speicherung und Aktivierung aller Einstellungen erfolgt erst, nachdem das graphTFT Setup mit OK verlassen wurde.
Ist dies geschehen, folgt die Kalibrierung. Diese wird durch den gelben "Kalibrierung" Button gestartet.
Es erscheint ein Kalibrierungsbildschirm mit entsprechenden Anweisungen, welche mit dem Anklicken des Kalibrierungssymbols in der linken oberen Ecke beginnen.

Bei einigen Touchscreens sind die X und Y Koordinaten vertauscht. Das Kalibrierungsprogramm erkennt dies automatisch, sobald die rechte obere Ecke "getouched" wurde. Ist dieser der Fall, springt der Cursor in die linke obere Ecke zurück und die Kalibrierung beginnt, diesmal unter Berücksichtigung der getauschten X/Y Koordinaten, erneut.

Ist der Cursor in allen vier Ecken berührt worden, ist die Kalibrierung abgeschlossen.

Nun kann zum Test der Funktion und Genauigkeit wahllos auf dem Bildschrim "rumgetouched" werden. Die gewählten Koordinaten werden angezeigt und wenn alles richtig Funktioniert hat, sollte der Cursor auch an die berührte Stelle springen. Tut er es nicht, sollte die Kalibrierung noch einmal wiederholt werden.

Der Kalibrierungsvorgang wird wieder mit dem gelben Button (jetzt mit "Stop" beschriftet) beendet.

Möchte man die Kalibrierung seines Displays später noch einmal testen, gelangt man über den grünen Button "Test" in einen entsprechenden Testmodus. Es erscheint das gleiche Bild wie bei der Kalibrierung, es werden hier aber nur Koordinaten angezeigt und keine vorhandenen Werte überschrieben. Auch hier beendet der gelbe Button den Testvorgang.

Ein recht ausführliches Beispiel mit vielen Tipps für ein System mit TouchTFT Display findet man auch hier im Wiki.

Dauerhaftes Touch Device

Bei einem Reboot wird für jedes am Linux-System angeschlossene Gerät ein entsprechendes Device zugeteilt. Die Device/Gerätezuteilung wird dynamisch bei jedem reboot erneut vorgenommen. In einigen Fällen ist es daher möglich, dass sich dabei die Devicenummer des Touchscreens nach einem reboot ändert.

Um das Touchscreen immer wieder auf dem gleichen Device ansprechen zu können, lohnt sich die Einrichtung einer udev Event-Regel.

Diese Regel erkennt das gesuchte Gerät und erstellt einen Link auf das automatisch vom System zugeteilte Device.
Angesprochen wird dann nur noch dieser Link und nicht mehr das automatisch zugeteilte Device.

Das Vorgehen (die Beschreibung erfolgt auf Basis von easyVDR 0.6.2. Sie kann auf anderen Systemen leicht anders aussehen.):

Zunächst muss man ein eindeutiges Identifikationskriterium für das Touchscreen ermitteln. Dies geschieht durch den Befehl

lsusb -v | more

Man erhält eine Ausgabe in etwas dieser Form

Bus 004 Device 002: ID 15c2:0034 SoundGraph Inc.
Device Descriptor:
  bLength                18
  bDescriptorType         1
  bcdUSB               1.10
  bDeviceClass            0 (Defined at Interface level)
  bDeviceSubClass         0
  bDeviceProtocol         0
  bMaxPacketSize0         8
  idVendor           0x15c2 SoundGraph Inc.
  idProduct          0x0034
  bcdDevice            0.14
  iManufacturer           0
  iProduct                0
  iSerial                 0
  bNumConfigurations      1

Eindeutig identifizieren ließe sich dieser (Soundgraph) Touchscreen über die

idVendor = 15c2
idProdukt = 0034

Hieraus lässt sich nun eine entsprechende Regel erstellen:

KERNEL=="event*", SUBSYSTEM=="input", SYSFS{idVendor}=="15c2", SYSFS{idProduct}=="0034", SYMLINK+="input/mein_touch_device"

Das am meisten verwendete Touchscreen Display ist das eGalax Display. Für dieses Display sieht die Einrichtung so aus:

KERNEL=="event*", SUBSYSTEM=="input", SYSFS{idVendor}=="0eef", SYSFS{idProduct}=="0001", SYMLINK+="input/mein_touch_device"

Alternativ kann die Identifikation grundsätzlich auch durch andere Werte erfolgen. Dies ist z.B. dann notwendig, wenn ein USB-Gerät über mehrere Devices, wie z.B. Fernsteuerungsempfänger oder Tastaturen (Gehäusetasten), verfügt.
Das könnte dann wie folgt aussehen:

KERNEL=="event*", SUBSYSTEM=="input", ATTRS{name}=="USB Touchscreen 15c2:0034", SYMLINK+="input/mein_touch_device"

Diese Regel wird in einer udev-Datei hinterlegt:

vi /etc/udev/10-remotes.rules

Inhalt ist die oben ermittelte Regel, also z.B.:

KERNEL=="event*", SUBSYSTEM=="input", SYSFS{idVendor}=="15c2", SYSFS{idProduct}=="0034", SYMLINK+="input/mein_touch_device"

Anschließend wird diese Regeldatei noch als Regel bekannt gemacht. Dies geschieht über einen Link.

cd /etc/udev/rules.d
ln -s ../10-remotes.rules

Zur Aktivierung ist nun ein reboot erforderlich.

Nach dem reboot müsste nun in der Liste nach

ls -1 /dev/input

eine Zeile mein_touch_device stehen.

Als Device dient nun /dev/input/mein_touch_device
Dieses Device wird nun über das graphTFT OSD Setup unter Device hinterlegt.

Alternativ kann das auch direkt in der /etc/vdr/setup.conf Datei hinter graphtft.touchDevice = eingetragen werden.

graphtft.touchDevice = /dev/input/mein_touch_device

Achtung: Vor dem Bearbeiten der setup.conf muss der VDR gestoppt werden, da die manuellen Änderungen ansonsten beim Neustart überschrieben werden können.

graphtft-fe - Das X-Frontend

Über den X-Server, respektive über das dem Plugin beiligende X-Frontend AddOn graphtft-fe, kann der VDR mittels Tastatur und Maus bedient werden.
graphtft-fe liegt im Sourcenverzeichen des graphTFT Plugins und muss gesondert übersetzt und gestartet werden.

Die Unterstützung der Schnittstelle zum graphtft-fe X-Frontend kann im graphTFT Makefile durch auskommentieren von WITH_X_COMM deaktiviert werden. Bei aktiver Schnittstelle muss für das X-Frontend einmalig die Tastatur angelernt werden.
Daher verlangt das VDR System nach dem nächsten reboot das Anlernen der dafür benötigten Tasten, wozu ein entsprechendes Anlernmenü auf dem Bildschirm erscheint.

Möchte oder kann man die Tasten nicht anlernen aber dennoch die X-Frontend Unterstützung mit übersetzen, kann die Anlernfunktion durch hinzufügen einer Dummy-Zeile aus der nachfolgenden Liste in der /etc/vdr/remote.conf ausgetrickst werden. Zum unterdrücken der anlernfunktion würde schon eine Zeile reichen. Die übrigen stellen ein Beispiel einer weitgehend angelernteren Tastatur dar, was auch nicht schaden kann.

graphtft-fe.Up         0000000000000062
graphtft-fe.Down       0000000000000068
graphtft-fe.Menu       0000000000000047
graphtft-fe.Ok         0000000000000024
graphtft-fe.Back       0000000000000016
graphtft-fe.Left       0000000000000064
graphtft-fe.Right      0000000000000066
graphtft-fe.Red        0000000000000043
graphtft-fe.Green      0000000000000044
graphtft-fe.Yellow     0000000000000045
graphtft-fe.Blue       0000000000000046
graphtft-fe.0          0000000000000013
graphtft-fe.1          000000000000000A
graphtft-fe.2          000000000000000B
graphtft-fe.3          000000000000000C
graphtft-fe.4          000000000000000D
graphtft-fe.5          000000000000000E
graphtft-fe.6          000000000000000F
graphtft-fe.7          0000000000000010
graphtft-fe.8          0000000000000011
graphtft-fe.9          0000000000000012
graphtft-fe.Info       0000000000000048
graphtft-fe.Volume+    0000000000000063
graphtft-fe.Volume-    0000000000000069
graphtft-fe.Mute       0000000000000067

Damit denkt der VDR es wurde bereits angelernt und das Anlernmenü wird nicht gestartet(dann funktionieren natürlich die Tasten nicht). Möchte man die Tasten später dann doch mal anlernen, entfernt man diese Zeile(n) wieder aus der remote.conf und startet den VDR neu. Nun würde der Anlernvorgang erneut beginnen.

graphtft-fe kann mit folgenden Parametern gestartet werden:

-h <host>       vdr host no default, please specify
-p <port>       plugin port  (default 2039)
-e <eloquence>  log level    (default 0)
-W <width>      width        (default 720)
-H <height>     height       (default 576)
-d <file>       dump each image to file (default off)
-n              not managed  (default managed)
-r              resize image (default off)
?, --help       help


Ausgabe unter Windows

Um graphtft-fe über einen Windows PC ausgeben und bedienen zu können, wird ein X-Server für Windows benötigt. Ein solcher X-Server ist z.B. Xming.
Zusätzlich zu Xming benötigt man einen ssh-Client der X11 Forwarding beherrscht, wie etwa Putty - den man u.a. auch über das Xming Projekt downloaden kann.

Xming muss nicht extra konfiguriert werden, was z.B. über XLaunsch erfolgen würde. Es reicht wenn es auf dem Windows PC im Hintergrund gestartet wird.
Zur Einrichtung der X11 Weiterleitung in Putty wird unter

Configurations -> Connection -> SSH -> X11

die Option Enable X11 Forwarding aktiviert und im Feld X display location der Wert localhost:0 eingetragen.

Nun kann man in einer Putty Session graphtft-fe mit dem Parameter -h localhost starten

graphtft-fe -h localhost

Es sollte sich nun direkt ein Fenster mit der graphTFT Ausgabe auf dem Windows-PC öffnen.
Die größe des Fensters lässt sich ebenfalls über graphtft-fe Parameter variieren. Dies ist z.B. dann notwendig, wenn die Anzeige bzw. Auflösung der graphTFT Anzeige von der Fenstergröße abweicht. Das könnte dann z.B. so aussehen:

graphtft-fe -h localhost -W 800 -H 600

Alternativ dazu (oder wenn aus irgendwelchen Gründen die X11 Weiterleitung nicht funktioniert) kann man wie folgt vorgehen:

Die "Access - Control" von Xming ausschalten. Dazu startet man 'Xlaunch'-> Display settings (hier das gewünschte Fensterverhalten eingeben) -> Start no client -> Additional Parameters Checkbox "No Access Control" anhaken -> Save Configuration -> es wird ein File config.xlaunch gespeichert.

Nun Xming mit Doppelklick auf <config.xlaunch> starten. Der Xserver startet.

Nun mit Putty auf den VDR verbinden. $DISPLAY - Variable setzen und graphtft-fe starten.

export DISPLAY=<ip-adresse des Windows PC>:0.0
graphtft-fe -h localhost -W 800 -H 600 &

Sonstiges

Plasmoid

Für den KDE Desktop ist auch ein Plasmoid (KDE Plasma Desktop Widget) zur VDR Bedienung über graphtft verfügbar.

Mehr dazu unter http://www.kde-look.org/content/show.php?content=98815

Probleme

Fehlermeldung bei 64Bit Linux/VDR

Beim Start des VDR erscheint die Fehlermeldung

terminate called after throwing an instance of 'std::out_of_range'
what(): basic_string::erase

Die graphTFT-Version 0.3.1 funktioniert nicht auf 64Bit Linux/VDR Systemen. Der Fehler wird mit der nächsten Version behoben. Die Anwender von 64Bit Systemen nehmen bitte einstweilen diese Version

vdr-graphtft-0.3.2-rc2 oder den aktuellsten SVN snapshot

Alles andere gilt wie für 0.3.1.

Keine EPG Daten mit graphTFT >= 0.2.x

Mit graphTFT 0.2.x wurde die EPG-Daten-Anzeige in Zusammenarbeit mit dem epgsearch Plugin stark überarbeitet. Die Darstellung ist nun auch unabhängig von der Verwendung des epgsearch Plugins und der epgsearch.conf, somit muss das Theme diesbezüglich nicht mehr an euer System angepasst werden.

Damit diese Änderungen genutzt werden können, muss der vdr (mit vdr-1.7.0-extension-59-graphTFT-0.2.0.diff, dieses Passt zum VDR 1.7.0 mit Extension Patch) und das epgsearch-Plugin (mit epgsearch-0.9.24.diff) gepatcht werden.
Die notwendigen Patches werden im ./patch Verzeichnis des graphTFT Plugins mitgeliefert. Das VDR Patch ist auch im Extensions-Patch 65 enthalten, welches alternativ auch installiert werden kann.
Die Änderungen am epgsearch Plugin wurden in die Version 0.9.25 (ab Beta6) mit aufgenommen. Von da an, ist ein gesonderter Patch nicht mehr erforderlich.

Für andere Versionen muss man ggf. selbst Hand anlegen und ein paar Rejects auflösen.

Anschließend müssen der vdr und ALLE Plugins neu übersetzt und installiert werden.

Dargestellte Spalten stimmen nicht

Einige OSD Darstellungen, wie z.B. den Umfang der angezeigten Daten im Aufnahmemenü, können individuell am OSD vorgenommen werden. In den graphTFT Themes sind für einige Bereiche jedoch feste Spalten vorgesehen. Wählt ein Benutzer nun für das OSD eine andere Einstellung, kommt es zur Verschiebung und unsauberen Darstellung der Informationen auf der graphTFT Ausgabe.

Dies gilt besonders für die Anzeige der Aufnahmemenü's (mit und ohne extRecMenu Plugin) sowie des ArghDirector Plugins.
Wünscht man sich nun eine andere Darstellung, muss auch das jeweilige Theme File manuell angepasst werden.
Falls die Unterstützung der WarEagleIcons aktiviert ist, ist erst ab graphTFT 0.3.0 eine fehlerfreie Darstellung zu gewährleisten.

Ein Beispiel anhand der Aufnahmemenü Sektion im theme File.

//***************************************************************************
// Aufnahmemenü (VDR Standardversion)
//***************************************************************************
[MenuRecordings]
...
// Date
// conditon example
Column number=1,width=150;
// Time
Column number=2,width=120;
// length
Column number=3,width=120;
// text
Column number=4,dots=yes;
// Select Entry
...

Die Syntax entspricht graphTFT ab Version 0.3.0. Bei kleineren Versionen ist ein item= an Zeilenanfang, sowie ein Komma nach dem ersten Wort einzufügen.

Beispiel graphTFT < 0.3.0:

item=Column,number=1,width=150;

Beispiel graphTFT >= 0.3.0:

Column number=1,width=150;

Dieser Abschnitt ist so aufgebaut, dass die ersten vier Spalten (number) der OSD Anzeige ausgegeben werden.

width beschreibt dabei die Breite der Spalte. Wird kein width angegeben, wird automatisch die max. mögliche Spaltenbreite genommen.

Legt man im OSD Setup nun fest, dass z.B. die Aufnahmezeit (Time) nicht mehr angezeigt werden soll, gäbe es keine vier sondern nur noch drei angezeige Spalten, welche erneut durchnummeriert werden. Der Effekt ist nun, dass die ehemals 4. Spalte (text) nun die Nummer 3 (vormals length) trägt. Für die Spalte 3 ist aber eine width von 120 Pixeln festgelegt, wohingegen die ursprüngliche Spalte 4 keine Längenbegrenzung besaß. In Folge dessen wird der Text (der Sendungstitel) nun nach 120 Pixeln abgeschnitten.

Um das zu korrigieren enpfielt es sich, die nun mehr gewünschte Spalte auszukommentieren, und die Spaltenzähler der nachfolgenden Zeilen entsprechend der OSD Position zu korrigieren.
Für unser Beispiel sähe das so aus:

// Date
// conditon example
Item=Column,number=1,width=150;
// Time
Item=Column,number=2,width=120;
// length
// Item=Column,number=3,width=120;
// text
Item=Column,number=3,dots=yes;
// Select Entry
...

Nach Änderungen am Themefile muss dieses neu geladen werden. Siehe hierzu die o.g. Abschnitte OSD-Menü oder SVDRP.

Kompilieren unter SuSE

Wenn man die Fehlermeldung "cannot find -lX11" bekommt, muss das xorg-x11-devel Paket nachinstalliert werden.

yast -i xorg-x11-devel

Themes

Alien vs. Predator Theme

Dieses Theme wurde für die Auflösung von 800x600 Pixeln erstellt. Es kann aber auch mit kleineren Auflösungen verwandt werden, da graphTFT die Darstellung dann automatisch skalliert.

Um die entsprechenden TFTs optimal nutzen zu können, sollten im GraphTFT folgende Einstellungen vorgenommen werden:

Width 800
Height 600
X Offset 0
Y Offset 0
Border to Height 0
Border to Width 0

Im Theme selbst gibt es ebenfalls einige Einstellungsmöglichkeiten wie z.B. eine alternative Ansicht für das music plugin oder wählbare Maus-Buttons.
Einstellbar ist das ganze über einen Editor in der avp.theme Datei. Die entsprechenden Abschnitte sind in der Datei selbst dokumentiert.


Nur für AvP kleiner Version 0.8 / graphTFT kleiner 0.2.0:

Für das Theme wurden die beiden Schriftarten Vera und Enigma des DeepBlue Themes verwandt.

Von diesen Schriften gibt es mehrere Versionen, daher sind die hier genutzen ebenfalls auf der graphTFT Downloadseite zu beziehen.

Die Schriftarten gehören in das fonts Verzeichnis des Plugins unter ../plugins/graphTFT/fonts

Neuere Plugin/Theme Versionen verfügen über einen eigenen internen Zeichensatz (graphTFT.ttf). Hier müssen keine Fonts mehr kopiert werden.


Versionzuordnung

Folgende graphTFT und Theme Versionen passen zu einander:

graphTFT DeepBlue Theme AvP Theme DeepPurple Theme Poetter Theme izeman Theme
0.3.1
0.3.2-rc2 (Für 64Bit Systeme)
0.3.1 0.3.1 Kommt bald (data) Kommt bald (data) ???
0.3.0 0.3.0 0.3.0 n.a. n.a. ???
0.2.1 & 0.2.2 0.0.11 0.0.11 n.a. n.a. Beta Thread
0.2.0 0.0.10 0.0.10 n.a. n.a. n.a.
0.1.19 - .21alpha 0.0.8 (benötigt Fonts) 0.0.8 (benötigt Fonts) n.a. n.a. n.a.
<0.1.19alpha 0.0.7 (benötigt Fonts) n.a. n.a. n.a. n.a.


Entwicklungsversionen

Das graphTFT-Plugin wird als SourceForge Projekt gepflegt. Die aktuellste (Beta-)Entwicklungsversion (Revision) erhält man über die Syntax

svn co https://vdr-graphtft.svn.sourceforge.net/svnroot/vdr-graphtft vdr-graphtft


Links

  1. Imlib2
  2. FFmpeg
  3. Daten / Schaltungen - speziell für das PSone LCD
  4. Vorlage:Spiegel 2

Plugin >= 0.0.14

  1. Homepage des Plugins
  2. Theme deepblue
  3. Theme Alien vs. Predator (800x600)
  4. Theme poetter


Ältere Versionen

Plugin = 0.0.8

Die hier aufgeführten Themes funktionieren in neueren graphTFT Versionen nicht mehr. Sie sind aber auf jeden Fall sehenswert und zumindest eine Inspiration für interessierte Authoren. Darum bleiben Sie hier im Wiki erhalten.

Einstellungen
Theme "standard"
Theme "brst"
Theme "motz"
Theme "enigma"
Theme "deepblue"
Theme "bluepenguin"
VMware + Debian + VDR + xine + graphtft im x fenster
7", 800x480 Pixel
PSOne
  1. Homepage des Plugins
  2. Theme MetalShinyBlue
  3. Theme Enigma
  4. Theme MOTZ
  5. Theme Blue Penguin

Wünsche für Erweiterungen

Bild-in-Bild Funktion (von duc)
Im kleinen display den Kanal mit der Werbung laufen lassen und am grossen was anderes gucken. Wenn die werbung zu Ende ist, Taste drücken und den Grossen wieder auf den vorherigen kanal zurückschalten und graphtft zeigt wieder seine üblichen Infos an.

Mausrads / Powemates (von gnapheus)
Ein Button ist immer im Fokus, der mit Drehung des Mausrads / Powemates immer einen Button weiter hüpft. Beim Klick wird das entsprechende Event zum Button im Fokus ausgeführt.

REC Anzeige erweitern (von brabax22)
Aufnahmestatus, wo jetzt "REC" erscheint - nur eben als "REC1" und "REC2", der einzelnen Karten getrennt anzeigen lassen. Hintergrund: Ich habe EINE DVBS2- und eine 'normale' Karte im System und bräuchte die Info bei spontanen HD-Aufnahmen.

Scrollfunktion auf dem Touchscreen (von CafeDelMar)
z.B. wenn man den Finger am rechten Bildschirmrand in einer Liste einfach hoch oder runter zieht/tippt.

In anderen Sprachen