TF5000Display TAP 1.21, written by DeadBeef


Beschreibung:
=============

TF5000Display TAP modifiziert die Standardanzeige im vierstelligen Display vom PVR,
whrend der Receiver eingeschaltet ist. Das TAP erweitert die Standardanzeige um folgende
Informationen:
- aktuelle Uhrzeit
- Kanalname
- Aufnahmeinfo: Kanalnummer bzw. -name sowie Restdauer
- Wiedergabeinfo: Restdauer oder Wiedergabedauer

Das Konfigurationsmen kann mit der EXIT-Taste (Standard) bzw. mit der im Men eingestellten
Taste aufgerufen werden.

Folgende Optionen stehen zur Verfgung:
o "Mentaste" - hiermit kann die Menaufruftaste eingestellt werden
  (Exit, Subtitle, UHF, Sleep, TV/Sat, TSRCommander)
  Der Wert "TSRCommander" aktiviert die Steuerung mit dem TSRCommander.
  In diesem Fall kann das TAP nur ber TSRCommander konfiguriert bzw. beendet werden.
o "Uhrzeitformat" - diese Einstellung gibt an, in welchem Format die Uhrzeit eingeblendet
  werden soll:
  - "24 Std. (ohne fhrende Null)"  24-Stunden-Anzeige (von "0:00" bis "23:59")
  - "24 Std. (mit fhrender Null)"  24-Stunden-Anzeige (von "00:00" bis "23:59")
  - "12 Std. (ohne fhrende Null)"  12-Stunden-Anzeige (von "1:00" bis "12:59",
    der Punkt nach der letzen Ziffer zeigt Nachmittag/PM an)
  - "12 Std. (mit fhrender Null)"  12-Stunden-Anzeige (von "01:00" bis "12:59",
    der Punkt nach der letzen Ziffer zeigt Nachmittag/PM an)
o "Uhrzeit-Dauer" - diese Einstellung gibt an, wie lange die Uhrzeit eingeblendet werden
  soll, falls die Uhrzeit mit anderen Informationen abwechselnd angezeigt wird
  Zustzliche Werte (nach links scrollen, um zu selektieren):
  "aus" - die Uhrzeitanzeige ist deaktiviert
  "ereignis-gesteuert" - Hauptmodus ist die Uhrzeitanzeige, bei Statusnderungen 
    (Kanalwechsel, Aufnahme-/Wiedergabebeginn) wird die entsprecende Info fr die
    eingestellte Dauer eingeblendet
o "Info-Dauer" - diese Einstellung gibt an, wie lange die zustzlichen Informationen jeweils
  eingeblendet werden sollen. Die Einstellung ist nur wirksam, wenn Zusatzinformationen
  vorliegen bzw. ihre Anzeige aktiviert ist. Darber hinaus wird diese Einstellung ignoriert,
  wenn die Zusatzinformationen gescrollt werden mssen.
o "Kanalinfo" - diese Option whlt den Modus fr die Kanalanzeige aus:
  - "aus" - es werden keine Informationen zum aktuellen Kanal angezeigt
  - "Kanalnummer" - die aktuelle Kanalnummer wird angezeigt
  - "Sendername" - der aktuelle Sendername wird angezeigt
  - "Kanalnummer & Sendername" - die Kanalnummer und der Sendername werden angezeigt
  - "Sendername (nur Radio)" - der aktuelle Sendername wird nur fr Radiokanle angezeigt,
    fr TV-Sender wird nur die Kanalnummer angezeigt
o "Aufnahmeinfo" - diese Option whlt den Modus fr die Aufnahmeanzeige aus:
  - "aus" - es werden keine Informationen zu aktuellen Aufnahmen angezeigt
  - "nur Status" - der aktuelle Aufnahme-Status wird angezeigt ("rEc1/"rEc2")
  - "Kanalnummer" - die Kanalnummer der jeweiligen Aufnahme wird angezeigt
  - "Sendername" - der Sendername der jeweiligen Aufnahme wird angezeigt
  - "Kanalnummer & Restdauer" - die Kanalnummer der jeweiligen Aufnahme wird zusammen mit
     ihrer Restdauer angezeigt
  - "Status & Kanalnummer kompakt" - der Aufnahmenummer ("I"/"II") wird  zusammen mit der
    Kanalnummer der jeweiligen Aufnahme angezeigt. Fr TV-Aufnahmen erscheint die Aufnahmenummer
    in der unteren Hlfte der Anzeige, fr Radio-Aufnahmen in der oberen.
  - "Status & Restdauer kompakt" - der Aufnahmenummer ("I"/"II") wird  zusammen mit der
    Restdauer der jeweiligen Aufnahme angezeigt. Fr TV-Aufnahmen erscheint die Aufnahmenummer
    in der unteren Hlfte der Anzeige, fr Radio-Aufnahmen in der oberen.
o "Wiedergabeinfo" - diese Option whlt den Modus fr die Aufnahmeanzeige aus:
  - "aus" - es werden keine Informationen zur Wiedergabe angezeigt
  - "nur Status" - der aktuelle Wiedergabe-Status wird ggf. angezeigt ("PLAY")
  - "Restdauer" - die Restdauer der Aufzeichnung wird in negativer Notation angezeigt
  - "Status & Restdauer" - "PLAY" wird zusammen mit der Restdauer der Aufzeichnung in negativer
    Notation angezeigt
  - "Wiedergabedauer" - bei Wiedergabe wird die Zeit seit Beginn der Aufzeichnung angezeigt
  - "Status & Wiedergabedauer" - "PLAY" wird zusammen mit der Zeit seit Beginn der Aufzeichnung
    angezeigt
o "Scrollgeschw." - gibt an, wie schnell gescrollt werden soll

Die Einstellungen werden gespeichert, wenn das Konfigurationsmen mit OK oder der eingestellten
Mentaste verlassen wird.

Wird im Konfigurationsmen die Stop-Taste gedrckt, so wird das TAP beendet.

Das TAP untersttzt Kurznamen fr TV-Kanle, die statt der Kanalnummer angezeigt werden.
Die Abbildung der Kanalnamen ist in der Konfigurationsdatei "TF5000Display.chn" im Verzeichnis
ProgramFiles abzulegen.
Das Format der Eintrge ist wie folgt:
<Kanalnummer>=<Kurzname>
Es werden Eintrge fr Kanalnummern unterhalb 1001 untersttzt (ein Eintrag pro Zeile).
Beispiele:
  1 = BBC1
002 = SkyN
3=CNN
P002=abc	=> ungltig
=abc 		=> ungltig
abc=12		=> ungltig
12=		=> ungltig

Kurznamen fr TV-Kanle werden nur in folgenden Modi angezeigt:
"Aufnahmeinfo" = "Kanalnummer" / "Kanalnummer & Restdauer"
"Kanalinfo" = "Kanalnummer"

Einschrnkungen:
----------------

Das TAP benutzt eine versionsabhngige Einsprungadresse. Daher werden nur die folgenden
FW-Versionen untersttzt:
 - TF5100PVRc 03.03.05 (5.11.46), experimentell, noch nicht getestet
 - TF5000PVR 24.03.05 (5.11.55)
 - TF5000PVRt/Eur 30.03.05 (5.11.56)
 - TF5000PVRt/Aus 30.03.05 (5.11.56)
 - TF5000PVRt BP/Aus 22.04.05 (5.11.64)
 - TF5100PVRt 04.05.05 (5.11.70, Test)
 - TF5100PVRc 04.05.05 (5.11.70, Test)
 - TF5000PVRt/Aus 10.05.05 (5.11.71, Test)
 - TF5000PVRt/Aus 12.05.05 (5.11.78)
 - TF5800PVRt 11.05.05 (5.11.79)
 - TF5000PVR 10.06.05 (5.11.88)
 - TF5000PVR BP 13.06.05 (5.11.56), experimentell, noch nicht getestet
 - TF5000PVRt/Aus 14.06.05 (5.11.88)
 - TF5000PVRt/Eur 15.06.05 (5.11.90)

"Wer behauptet fehlerfreie Software zu haben, hat sie nicht genug getestet."
Benutzung auf eigene Gefahr!

Description:
============

The Display TAP enhances the information displayed in the 7-segment display of the
TF5000PVR(t)/TF5800PVRt while the receiver is on. The TAP can be configured to provide the
following information:
- current time
- channel name
- record info: number/name of the channel being recorded and the remaining time
- playback info: the elapsed/remaining playback time

The configuration menu can be entered by pressing the Exit key (by default) or the
configured key.

The following options are supported:
o "Menu key" - specifies the menu activation key (Exit, Subtitle, UHF, Sleep, TV/Sat, TSRCommander)
  The setting "TSRCommander" activates the TAP control by TSRCommander. That is, the
  TAP can only be configured/stopped via TSRCommander.
o "Time format" - specifies the time format to be displayed:
  - "24h (without leading zero)"  24-hour format ("0:00" thru "23:59")
  - "24h (with leading zero)"  24-hour format ("00:00" thru "23:59")
  - "12h (without leading zero)"  12-hour format ("1:00" thru "12:59",
    the dot after the last digit indicates PM)
  - "12h (with leading zero)"  12-hour format ("01:00" thru "12:59",
    the dot after the last digit indicates PM)
o "Clock duration" - specifies the display duration of the current time when altered with
   additional info
   Additional setting values (scroll left to select):
   "off" - the time is not displayed
   "event-driven" - the display shows state changes (start of playback/recording, channel change)
      for the specified number of seconds in the specified format, thereafter the current
      time is displayed
o "Info duration" - specifies the display duration of the additional info items (if any)
   However, this value is ignored if the additional info needs to be scrolled.
o "Channel info" - specifies the mode for displaying channel info:
  - "off" - no information is displayed for the viewed channel
  - "channel number" - the channel number of the viewed channel is displayed
  - "channel name" - the channel name of the viewed channel is displayed
  - "ch. number & name" - both the channel number and name of the viewed channel are displayed
  - "channel name (radio only)" - the channel name of the current channel is displayed for radio
    channels, for TV channels the channel number is displayed
o "Record info" - specifies the mode for displaying record info:
  - "off" - no record info is displayed
  - "status only" - only the record status is displayed ("rEc1/"rEc2")
  - "channel number" - the channel number of the channel being recorded is displayed
  - "channel name" - the channel name of the channel being recorded is displayed
  - "ch. number & remaining time" - the channel number of the channel being recorded is
    displayed along with the remaining time
  - "compact status & ch. number" - the recording status ("I"/"II") is displayed combined with
    the number of the channel being recorded
  - "compact status & remaining time" - the recording status ("I"/"II") is displayed combined
    with the remaining recording time
o "Play info" - specifies the mode for displaying record info:
  - "off" - no record info is displayed
  - "status only" - only the playback status is displayed ("PLAY")
  - "remaining time" - the remaining time is displayed (negative notation)
  - "status & remaining time" - the playback status ("PLAY") is displayed along with the
    remaining time (negative notation)
  - "elapsed time" - the time elapsed since begin of the playback
  - "status & elapsed time" - the playback status ("PLAY") is displayed along with the
    time elapsed
o "scroll speed" - specifies the scrolling speed

Press OK or the menu activation key to leave the configuration menu. On exit the configuration
is stored to HDD.
(If the Exit key was used to exit the configuration menu it is passed to the next TAP if any.)

In order to terminate the TAP press the Stop key in the configuration menu.

The TAP supports TV channel nicknames supplied in the TF5000Display.chn configuration file
being present in the ProgramFiles directory.
TV channel nicknames are displayed instead of the channel number or LCN. The entries have
to be in the following format:
<channel number>=<channel nickname>
The TAP supports entries for channel numbers below 1001 (one entry per line). 
Since only 4 characters can be displayed without scrolling longer channel nicknames are truncated.
Whitespaces are discarded except when used in the middle of the channel nickname.
Examples:
  1 = BBC1
002 = SkyN
3=CNN
P002=abc	=> invalid
=abc 		=> invalid
abc=12		=> invalid
12=		=> invalid

TV channel nicknames can be displayed only in the following modes:
"Record info" = "channel number" / "ch. number & remaining time"
"Channel info" = "channel number"

Limitations:
------------

The TAP works properly only with the following FW versions:
 - TF5100PVRc 03/03/05 (5.11.46), experimental support, not yet tested
 - TF5000PVR 03/24/05 (5.11.55)
 - TF5000PVRt/Eur 03/30/05 (5.11.56)
 - TF5000PVRt/Aus 03/30/05 (5.11.56)
 - TF5000PVRt BP/Aus 04/22/05 (5.11.64)
 - TF5100PVRt 04/05/05 (5.11.70)
 - TF5100PVRc 04/05/05 (5.11.70)
 - TF5000PVRt/Aus 05/10/05 (5.11.71)
 - TF5000PVRt/Aus 05/12/05 (5.11.78)
 - TF5800PVR 05/11/05 (5.11.79)
 - TF5000PVR 06/10/05 (5.11.88)
 - TF5000PVR BP 06/13/05 (5.11.56), experimental support, not yet tested
 - TF5000PVRt/Aus 06/14/05 (5.11.88)
 - TF5000PVRt/Eur 06/15/05 (5.11.90)

"There is no bugfree software. You just did not try hard enough."
The software is provided as is. No warranty of fitness for a particular purpose
is offered. Use this software at your own risk!

Version history:
==========
1.21
 - added a new configuration option for time format to be displayed
 - added support for a configuration file with channel nicknames to be displayed instead
   of TV channel number
 - fixed the issue with the 12-hour mode and the remaining/elapsed time display
1.20
 - improved interactions with the FW with respect to flickering (FW output does not
   disturb the TAP output anymore)
 - added displaying messages on stopping the recording in event-driven display mode
 - added the 12-hour time format to be displayed if the language setting is English
   (don't confuse it with the English output in the TAP menu, it is the default language
   for all language settings other than German)
 - changed the firmware version check for TF5100PVRt 04/05/05 (5.11.69 => 5.11.70)
 - fixed the freezing issue for the setting time = "off" and channel = "off"
1.19
 - renamed the TAP file (TF5000Display)
 - renamed the ini file and moved it into ProgramFiles directory
 - added passing the Exit key to next TAP (when OK is pressed in the menu, for Australia only)
 - added an event-triggered mode to display status changes (PLAY, REC, channel change)
 - added support for TF5100PVRc 03/03/05 (5.11.46), experimental support, not yet tested
 - added support for TF5100PVRt 04/05/05 (5.11.69), experimental support, not yet tested
 - added support for TF5100PVRc 04/05/05 (5.11.70)
 - improved system ID recognition (still not perfect)
1.18
 - added two modes to display the elapsed time for playback
 - added displaying channel name for radio channels only
 - added support for TF5000PVRt BP/Aus FW (5.11.64), experimental, not yet tested
 - added support for TF5000PVR BP FW (5.11.56), experimental, not yet tested
 - improved the workaround for the TAP_GetPlayInfo() problem, now the time
   can always be displayed
1.17
 - added support for TSRCommander
 - added support for TF5800PVR FW (5.11.79), experimental, not yet tested
 - added a workaround for the TAP_GetPlayInfo() problem
1.16
 - fixed the problem with (re-)storing configuration values (time duration = 0 and
   display mode)
1.15
 - added displaying LCN instead of channel number for the Australian FW
 - added support for the Australian FW versions 5.11.71 and 5.11.78 (PVRt/Aus)
1.14
 - added displaying playback status along with the remaining time
 - added support for the 5.11.90 FW version (PVRt/Eur)
 - added support for the Australian FW versions 5.11.56 and 5.11.90 (PVRt/Aus)
 - enabled the clock duration to be set to 0 (deactivates the current time display)
 - added an option for menu activation key
 - fixed the problem with short channel names (unused positions were filled with
   random characters)
1.13
 - added compact representation of the record number ("I"/"II") and the remaining
   recording time
 - fixed the problem with erasing the TV/STB LED
 - fixed the problem with a persistent colon in scrolling mode
1.12
 - added compact representation of the record number ("I"/"II") and the channel number
 - added displaying the remaining time for playback
1.11
 - added support for the 5.11.88 FW version (PVR)
 - fixed vertical selection bug in the menu
1.10
 - extended information to be displayed
1.01
 - corrected exit key handling (the key is now passed to other TAPs on exit from
   configuration menu)
 - incorporated support for both the PVR (5.11.55) and the PVRt/Eur (5.11.56) models  
1.00
 - initial version
