This is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  Sascha Volkenandt <sascha@akv-soft.de>
				  Reiner Rosin <rosinr@web.de>

Project's homepage:          www.arghgra.de

Latest version available at: www.arghgra.de

See the file COPYING for license information.

Description:
--
em84xx is an output-plugin for all em84xx-based decoder-cards
and onboard-decoders.

Prerequisites:
--
You need the NS2000-driver from the sigma designs website 
(http://www.sigmadesigns.com/support/downloads.htm).
The driver currently runs only with 2.4 kernels
(in the meantine Kron has developed a port for 2.6 kernels - see
[4] for detailed infomations).

Build and install the driver with the loaddriver-script
from the package.
If you use another chip than the em8400 add you chip-id
to loaddriver, e.g. "./loaddriver 0x8475".
After this source the env-File created by loaddriver:
"source ./Netstream.env".
Compile and run vdr from the same shell where you sourced
the env-File, otherwise the Sigma-Libs cannot be found.

Installation:
--
Install it like any other _normal_ VDR-plugin. Right now it
should run with VDR >= 1.3.21.
-
Then compile the plugins from the vdr-source-dir with make plugins.

If you want mplayer support, compile with EMMPLAYER=1.
If you want extended debug information, compile with EMDEBUG=1 (not at the moment!).

Start vdr with -Pem84xx. If you have a chip with 4mb ram, start
with the commandline-parameter -o (-P'em84xx -o')

DVD/disc player:
--
The disc-player main menu option (and also the settings) are only visible if a dvd 
drive was detected at plugin startup. This is done via the environment setting
USE_DRIVE (which is also used by the Sigma library) - a valid USE_DRIVE setting is
the dvd device name, e.g. "USE_DRIVE=/dev/hdc".

Using the DVD/Disc player (this is the default key assignment!)
--
|----------------------------------------------------------------------------------------------------|
| Key       | DVD                      | CDDA                | SVCD             | VCD                |
|----------------------------------------------------------------------------------------------------|
| Up        | In DVD menu navi-up,     | Play                                                        |
|           | otherwise Play           |                                                             |
|----------------------------------------------------------------------------------------------------|
| Down      | In DVD menu navi-down,   | Pause                                                       |
|           | otherwise Pause          |                                                             |
|----------------------------------------------------------------------------------------------------|
| Left      | In DVD menu navi-left,   | Fast rewind                                                 |
|           | otherwise fast rewind    |                                                             |
|----------------------------------------------------------------------------------------------------|
| Right     | In DVD menu navi-right,  | Fast forward                                                |
|           | otherwise fast forward   |                                                             |
|----------------------------------------------------------------------------------------------------|
| Ok        | In DVD menu navi-select, | Show/hide progessbar                                        |
|           | otherwise show/hide      |                                                             |
|           | progressbar              |                                                             |
|----------------------------------------------------------------------------------------------------|
| Play      | Play                                                                                   |
|----------------------------------------------------------------------------------------------------|
| Pause     | Pause                                                                                  |
|----------------------------------------------------------------------------------------------------|
| FastFor   | Fast forward                                                                           |
|----------------------------------------------------------------------------------------------------|
| FastRew   | Fast rewind                                                                            |
|----------------------------------------------------------------------------------------------------|
| Red       | -                                                                                      |
|----------------------------------------------------------------------------------------------------|
| Green     | jump -1min.                                                       | -                  |
|----------------------------------------------------------------------------------------------------|
| Yellow    | jump +1min                                                        | -                  |
|----------------------------------------------------------------------------------------------------|
| Blue      | go to DVD menu           | -                                                           |
|----------------------------------------------------------------------------------------------------|
| 1         | Next audio stream        |  Toggle audio streams                  | -                  |
|----------------------------------------------------------------------------------------------------|
| 2         | Next subpic stream       | -                                                           |
|----------------------------------------------------------------------------------------------------|
| 3         | Next angle               | -                                                           |
|----------------------------------------------------------------------------------------------------|
| 4         | Previous chapter         | -                                                           |
|----------------------------------------------------------------------------------------------------|
| 6         | Next chapter             | -                                                           |
|----------------------------------------------------------------------------------------------------|
| 7         | Previous track                                                                         |
| ChanDn    |                                                                                        |
|----------------------------------------------------------------------------------------------------|
| 9         | Next track                                                                             |
| ChanUp    |                                                                                        |
|----------------------------------------------------------------------------------------------------|
| 0         | Resume bookmark          | -                                                           |
|----------------------------------------------------------------------------------------------------|
| Stop      | Stop disc replay                                                                       |
| Back      |                                                                                        |
|----------------------------------------------------------------------------------------------------|


Disc ejection and the em84xx
--
If you want to open/close your dvd devices, start vdr with
the eject plugin '-Pem84xx-eject' and use the new main menu entry
"Open/close disc tray".

Note: Don't do this while a dvd is playing ;).

Spdif support
--
Spdif output on Netstream cards is supported in both audio-output modes.
If you want real AC3/DTS (and not the sigma chip doing a downmix), select
in the plugin settings "AC3/DTS: Passthrough".
Note: Having AC3/DTS data (passthrough), you are not able to change the volume
via VDR.
Note: Uwe has discovered, how to get AC3 working on the newer Activy models
(320, 350, 370) - http://www.vdr-portal.de/board/thread.php?threadid=38401
Note2: There's a hack for the Activy 300 to connect a digital output directly
to the em84xx - see vdrportal.de. Unfortunately detailed information is
missing - but should come soon.

Mplayer support
--
If you want to use the em84xx plugin with the mplayer-plugin and mplayer compile
with EMMPLAYER=1 - if enabled switching to and from DVD will now cause some
flicker on the tv: this is no error! ;)

Setup options
--
The em84xx plugin has got the following setup options (Menu->Setup->Plugins->em84xx):
(*) "TV is": select the format of your Televesion - "4:3" or "16:9"
(*) "Handle 16:9 on 4:3 TV": select how to handle 16:9 transmissions on a 4:3 tv-set -
        "Letterbox" or "Pan & scan"
(*) "Handle 4:3 on 16:9 TV", select how to handle 4:3 transmissions on a 16:9 tv-set -
         "Zoom on", "Zoom of", or "Nothing";
(*) "Audio output": surround sound mode - "Stereo downmix" or "Passthrough"
(*) "DVD speed control": slow down speed of dvd-drive during replay of a dvd -
         "Off" or "On
(*) "DVD menu on disc start": if enabled, directly starts a dvd with the main menu
         (if possible)
(*) "DVD audio language": sets language for DVD audio
(*) "DVD subpicture language": sets language for DVD subpicture
(*) "DVD menu language": sets language for DVD menus
(*) "DVD subpicture": enables/disables DVD subpictures

Debugging
--
Compile the plugin with EMDEBUG=1. When running extended debug-infos
will be written to em84xx.log (not at the moment!).

Acknowledges
--
Thanks to Uwe for his tests and patches and suggestions
Thanks to helau for providing the RLE-osd-code and patches
Thanks to sdu+Ulf for testing the plugin
Thanks to boonkerz for providing webspace for this plugin
Thanks to SvenF for his nice skin - although it's obsolete now

And finally thanks to LordJaxom who did the base work for this
plugin :).

Additional Infos / Links
[1] http://free.pages.at/vinomna/vdr/slackware/index.htm
    vdr-portal user sdu has made a fine german website on how to install
    the plugin and all the stuff you need for it.
[2] http://www.sigmadesigns.com/support/downloads.htm
    Sigma Designs Download Page
[3] http://www.vdr-portal.de/board/thread.php?threadid=38401
    AC3 on Activy 320, 350, 370
[4] http://sourceforge.net/projects/em84xx/ &&
    http://www.vdr-portal.de/board/thread.php?threadid=46304
    2.6 port of the Netstream driver
[5] http://www.vdr-portal.de/board/thread.php?threadid=57726
    packetcommand driver for 2.6 kernels to enable DVD playback
