Seite 1 von 1

Jag's EPG API v1.00 (für TAP-Programmierer)

Verfasst: Mo 20. Feb 2006, 02:05
von Jag
Hallo,

hier nun die Jag?s EPG API v1.00!

Download:
http://gojag.homepage.t-online.de/jagsepg_api100.zip


Systemvorraussetzungen:
  • Jag?s EPG v3.0 pre-Beta 3 (oder besser)
  • Topfield TF 5xx0 PVR
  • TAP API v1.22 kompatible Firmware
  • die ?Client-TAP?s? müssen mindestens mit der TAP API 1.20 kompiliert werden

Was kann man mit der Jag?s EPG API alles anfangen?
  • andere TAP?s können die EPG Datenbank von Jag?s EPG mitbenutzen
    (die internen Jag?s EPG API-Funktionen konvertieren dabei das interne EPG-Datenformat in das Standardformat von TYPE_TapEvent, die erweiterten Infos werden immer parallel dazu übertragen)
  • die EPG Daten können alternativ auch als CSV-Textzeile abgerufen werden
  • die TAP?s die EPG Daten über Jag?s EPG puffern wollen, können jederzeit einen EPG Scan starten und/oder die EPG Daten sichern
  • es können Remote-Kommandos direkt im RAM an Jag?s EPG gesendet werden
  • es können einige Einstellungen von Jag?s EPG geändert werden
  • die autom. Timerprogrammierung nach Suchworte kann ausgelöst werden
  • die EPG Datenbank kann jederzeit gespeichert werden
  • die EPG Daten können jederzeit als CSV- und/oder HTML-Datei exportiert werden
  • das Einlesen der Command.ini kann ausgelöst werden
  • das User-Farbprofil kann individuell angepasst werden
  • für die erweiterten Info?s oder beliebigen Text wird eine Funktion zum darstellen von mehrzeiligen Text bereitgestellt

Welche API Funktionen stehen zur Verfügung?
  1. BufferStatus_JagsEPG(...)
  2. CurrentEventExtInfo_JagsEPG(...)
  3. Disable_JagsEPG_API(...)
  4. EditUserColor_JagsEPG(...)
  5. ExtInfo_JagsEPG(...)
  6. GetSettingVar_JagsEPG(...)
  7. Initialize_JagsEPG_API()
  8. JagsEPG_API_Scan();
  9. JagsEPG_API_Status()
  10. MemFree_JagsEPG();
  11. Read_CSV_Line_JagsEPG(...)
  12. RemoteCommand_JagsEPG(...)
  13. SetSettingVar_JagsEPG(...)
  14. TAP_GetEvent_JagsEPG(...)
  15. TAP_GetCurrentEvent_JagsEPG(...)
  16. TextField_JagsEPG(...)
Genauere Informationen zu den einzelnen Funktionen findet ihr in der Dokumentation!


Welche Funktionen erfüllen die Beispiel-TAP?s?

CurrentEventExtInfo:
demonstriert die Anwendung der Funktion CurrentEventExtInfo_JagsEPG()
um gleichzeitig das CurrentEvent und dessen erweiterte Infos abzurufen

EditUserColorPalette:
ändert das User-Farbprofil von Jag?s EPG und speichert die Einstellungen
(ändert das User-Farbprofil auf ein ?dezentes? Grün :wink: )

EPGScanNow:
zeigt wie man einen EPG Scan auslösen kann

ExtInfo_JagsEPG:
zeigt wie man die erweiterten Infos abrufen kann (mittels ExtInfo_JagsEPG() )

MyOsd:
Das MyOSD TAP so geändert, dass es die EPG Daten von Jag?s EPG nutzt und die erweiterten Info?s anzeigt

QuickEPG:
Das QuickEPG TAP so geändert, dass es entweder die EPG Daten von
Jag?s EPG nutzt (wenn verfügbar) oder die EPG Daten über die TAP API.

QuickEPG_ExtInfo:
Das QuickEPG TAP so geändert, dass es mittels Jag?s EPG auch die erweiterten Info?s anzeigen kann!

Read_CSV_Line:
Testet die Funktion Read_CSV_Line_JagsEPG() und überprüft dessen Datentransferrate.

ReadCommandini_per_Button:
Ein einfaches Beispiel wie man per Tastendruck die Command.ini einlesen kann.

RecordBySearchWordNow:
Ein einfaches Beispiel wie die autom. Timerprogrammierung nach Suchworte per Tastendruck ausgelöst werden kann.

RemoteCommand:
zeigt wie man ein Remote-Kommando per RAM an Jag?s EPG senden kann

RemoteCommandQueue:
zeigt wie man eine ?Warteschlange? programmieren kann, um mehrere Remote-Kommandos nacheinander zu übertragen
(pro ?TAP_EventHandler?-Durchgang kann jeweils nur ein Kommando gesendet werden!)

TAP_GetEvent_JagsEPG:
Testet die Funktion TAP_GetEvent_JagsEPG () und überprüft dessen Datentransferrate.

TextFileViewer:
ein Beispiel-TAP zum anzeigen einer Textdatei (gescrollt wird seitenweise)

TextFileViewer2:
ein Beispiel-TAP zum anzeigen einer Textdatei (gescrollt wird in halben Seiten)

TF5800_Presettings:
ändert die Einstellungen von Jag?s EPG für einen TF 5800
(Tuner: 4, TF5800 Support: ON, LCN Support: ON)


Zusätzliche Hinweise:

Bei den meisten Beispiel-TAP?s handelt es sich nicht um vollständige Programme, sondern nur um laufähige Funktionsbeispiele, so wird der Bildschirm mitunter nicht automatisch gelöscht!

Die Datei "JagsEPG_API100.c" darf nicht geändert werden!

Die Beispiel-TAP?s könnt ihr ohne Einschränkungen direkt für eigene TAP?s ändern und weiterverwenden!


Gruß
Jag

Verfasst: Mo 20. Feb 2006, 11:15
von Harvey
Genial.

Kommt noch etwas, womit man deine DB auch beschreiben kann, nachdem man den topfeigenen EPG mitteld TAP_ControlEIT auf Eis gelegt hat?

Verfasst: Mo 20. Feb 2006, 22:27
von Jag
Hallo,
Harvey hat geschrieben:Kommt noch etwas, womit man deine DB auch beschreiben kann, nachdem man den topfeigenen EPG mitteld TAP_ControlEIT auf Eis gelegt hat?
Der Import von EPG Daten steht noch auf meiner ToDo-Liste! Ob ich dann den Import selbst nur über eine Datei ermögliche oder auch direkt über die API kann ich noch nicht sagen, aber zumindest wird man dann den Import aus der Datei über die API auslösen können!


Gruß
Jag

Verfasst: Mo 20. Feb 2006, 22:54
von Alter Sack
Ich weiss ja nicht, wer diese Beispiel-TAPs ausprobiert, aber vielleicht sollte man noch
erwähnen, dass sich hinter ...
Jag hat geschrieben:TextFileViewer:
ein Beispiel-TAP zum anzeigen einer Textdatei (gescrollt wird seitenweise)
... zusammen mit der enthaltenen "JagsEPG_Manual.txt" ein komplettes Online-Manual
(der Version 2.7a) verbirgt ;) .




Auch die anderen Beispiel-TAPs sind sicher für den Einen oder Anderen interessant.

z.B. QuickEPG (hier mit den erweiterten Info's), liegt auf der Guide-Taste:


Verfasst: Fr 24. Feb 2006, 23:11
von phil-99
Finde es klasse, dass man da nun selbst Dinge ändern kann.

Leider blicke ich da überhaupt nicht durch! Muss ich denn mir erst eine TAP-Entwicklungs-Umgebung zulegen?
Oder kann ich z.B. um die Userfarben zu ändern einfach über den Editor von Windows was abändern?

viele Grüße
phil

Verfasst: Sa 25. Feb 2006, 13:39
von Knutneon
phil-99 hat geschrieben:Finde es klasse, dass man da nun selbst Dinge ändern kann.

Leider blicke ich da überhaupt nicht durch! Muss ich denn mir erst eine TAP-Entwicklungs-Umgebung zulegen?
Oder kann ich z.B. um die Userfarben zu ändern einfach über den Editor von Windows was abändern?

viele Grüße
phil
Das würde mich auch interessieren :confused:

Verfasst: Mo 27. Feb 2006, 00:20
von Jag
Hallo,
phil-99 hat geschrieben:Finde es klasse, dass man da nun selbst Dinge ändern kann.

Leider blicke ich da überhaupt nicht durch! Muss ich denn mir erst eine TAP-Entwicklungs-Umgebung zulegen?
Oder kann ich z.B. um die Userfarben zu ändern einfach über den Editor von Windows was abändern?
ja, um die Beispiel-TAP's zu ändern und zu kompilieren benötigst Du die TAP-Entwicklungsumgebung!
Jag hat geschrieben:Systemvorraussetzungen:
  • Jag?s EPG v3.0 pre-Beta 3 (oder besser)
  • Topfield TF 5xx0 PVR
  • TAP API v1.22 kompatible Firmware
  • die ?Client-TAP?s? müssen mindestens mit der TAP API 1.20 kompiliert werden
Gruß
Jag

Verfasst: Mo 27. Feb 2006, 22:58
von Happy
Hallo Jag,

habe heute ein wenig mit der Deiner API gespielt.
Ziel war das poweroff-TAP so zu verändern, dass vor dem Ausschalten der Puffer gespeichert wird.

Wenn ich im Trockenen probiere, dann klappt das auch prima.

Code: Alles auswählen

i = SetSettingVar_JagsEPG( SaveEpgBufferNow_J, 1 );
setzt das Kommando ab.

Mit

Code: Alles auswählen

GetSettingVar_JagsEPG( SaveEpgBufferNow_J)==0;
kann man kontrollieren, ob der Puffer gespeichert wurde.

Leider wird der Puffer nicht gespeichert, wenn gerade ein Menü angezeigt wird.
Z.B. Wenn das Aufnahmearchiv angezeigt wird, und das Komando ausgeführt wird, dann wird der Puffer erst gespeichert, wenn das Menü verlassen wird.
Wahrscheinlich kontrollierst Du ob der Topf im Normal-Zustand ist.

Beim Poweroff-TAP passiert nun das gleiche: Beim Ausschalten wird schnell eine Dummyaufnahme gestartet, und dann kommt die Frage "Eine Aufnahme läuft wollen Sie wirklich ausschalten ?" Erst wenn man diese Einblendung schliesst, wird der Puffer gespeichert.

Das ist natürlich nicht Sinn der Sache. Kann man da was machen ?


Gruß,
Happy

Verfasst: Di 28. Feb 2006, 18:49
von Jag
Hallo,
Happy hat geschrieben:Leider wird der Puffer nicht gespeichert, wenn gerade ein Menü angezeigt wird.
...
Wahrscheinlich kontrollierst Du ob der Topf im Normal-Zustand ist.
jepp, genau so ist es!
Happy hat geschrieben:Das ist natürlich nicht Sinn der Sache. Kann man da was machen ?
na klar :wink:
werde ich in der nächsten Version gleich ändern!


Gruß
Jag

Verfasst: Di 28. Feb 2006, 18:57
von Happy
Jag hat geschrieben: na klar :wink:
werde ich in der nächsten Version gleich ändern!
Supi, bis denn.
Das neue Power_off TAP wäre schon fertig :wink:

Gruß,
Happy