Graphtft-plugin
Aktuelle Version
- Version 0.3.7
- SVN Version svn co https://vdr-graphtft.svn.sourceforge.net/svnroot/vdr-graphtft vdr-graphtft
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.7
Zur Version 0.3.7
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.3
 Standard Ansicht |
 Hauptmenü |
 OSD-Nachrichten |
 Menü |
 Programm |
Plugin >= 0.3.1
 Standard Ansicht |
 Clock Ansicht |
 Maustasten |
 Menü |
 Timer |
 Standard Ansicht |
 Menü |
 Wiedergabe |
 music-Plugin | |
 Standard Ansicht |
 Programmübersicht |
 Wiedergabe |
 music-Plugin |
Plugin >= 0.3.0
 Touchscreen-Kalibrierung |
 Maustasten |
 Detail-Ansicht |
 Touchscreen-Kalibrierung |
 Maustasten |
 Detail-Ansicht |
Plugin >= 0.2.0
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
Plugin >= 0.0.14
 |
 |
 |
 |
 |
 |
 |
 | ||
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
Hardwareanforderungen
- TFT-Display
- Framebuffer-fähige Grafikkarte
- Oder eine zweite Full-featured-DVB-Karte
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:
- VDR patchen (sofern erforderlich)
- epgserach-0.9.24 patchen (sofern erforderlich)
- graphTFT >= 0.2.1 Sourcen nach .../VDR/PLUGINS/src kopieren und verlinken
- alte Themes unter .../vdr/plugins/graphTFT/themes/ entfernen (nicht nur umbenennen - wirklich entfernen)
- zur graphTFT Version passenden Theme unter .../vdr/plugins/graphTFT/themes/ ablegen.
- 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.
- 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 Bibliotheken und Pfade weitestgehend automatisch. Kann eine Bibliothek nicht gefunden werden wird ein entsprechender Hinweis ausgegeben. In diesem Fall ist die fehlende Bibliothek zu installieren und der Build-Prozess erneut anzustoßen. Bei optionalen Funktionen kann alternativ auf die entsprechende Bibliothek/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
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
Fehlen 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
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 Dateien 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 Dateien 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 -l /dev/input
eine Zeile mit 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.
- Sollte nun in der Log-Datei der Fehler "[graphTFT] Error: Opening device '/dev/input/mein_touch_device' failed, errno was (13) 'Keine Berechtigung'" stehen, so fehlen wahrscheinlich die Zugriffsrechte des VDR an der durch mein_touch_device verlinkten Gerätedatei /dev/input/event*. Hier kann der zusätzliche Parameter GROUP="vdr" in der in /etc/udev/10-remotes.rules definierten Regel helfen!
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 $VDRCONFIG/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 $VDRCONFIG/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 &
Beispiel um graphtft-fe mit X automatisch zu starten: http://www.easyvdr-forum.de/forum/index.php/topic,9742.0
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.
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.
Download/Versionzuordnung
Neben den nachfolgend aufgeführten Versionszuordnungen bringt die VDR Distribution yaVDR ein eigenes Theme, das PearlHD Theme, mit. Erste Eindrücke findet man in der obigen Galerie.
Folgende graphTFT und Theme Versionen passen zu einander:
| graphTFT | DeepBlue Theme | AvP Theme | DeepPurple Theme | Poetter Theme | izeman Theme |
|---|---|---|---|---|---|
| 0.3.1-0.3.7 | 0.3.1 | 0.3.1 | 0.3.2 | 0.3.2 | 0.0.9 |
| 0.3.0 | 0.3.0 | 0.3.0 | n.a. | n.a. | n.a. |
| 0.2.1 & 0.2.2 | 0.0.11 | 0.0.11 | n.a. | n.a. | n.a. |
| 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
Das selbe gilt für die zur Entwicklungsversion passenden Themes.
svn co https://vdr-gtft-themes.svn.sourceforge.net/svnroot/vdr-gtft-themes themes
Links
- Imlib2
- FFmpeg
- Daten / Schaltungen - speziell für das PSone LCD
Plugin >= 0.0.14
Ä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.
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
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.
Erweiterung für Radio Plugin (von Ulrich Eckhardt) http://www.vdr-portal.de/board/thread.php?postid=871430#post871430
Anzeige von RDS-Informationen.
Pfad und Typ der EPG-Bilder einstellen (von data)
Erweiterung der OSD Parameter für Ablagepfad und Dateityp (png,jpg) von EPG-Bildern.
Übergabe der Werte als Parameter für die Themes.
http://www.easyvdr-forum.de/forum/index.php/topic,10227.0.html
