mirror of
https://github.com/VDR4Arch/vdr.git
synced 2023-10-10 13:36:52 +02:00
Added installation instructions
This commit is contained in:
Klaus Schmidinger
parent
1cb2f0209c
commit
e65b697651
7
BUGS
7
BUGS
@ -14,10 +14,3 @@ Video Disk Recorder - Known Bugs
|
|||||||
Haven't figured out yet how to ensure that it switches back to
|
Haven't figured out yet how to ensure that it switches back to
|
||||||
the current channel.
|
the current channel.
|
||||||
|
|
||||||
* Every now and then the on-screen display shows nothing but
|
|
||||||
"noise". If that occurs, I have to stop the 'vdr' program
|
|
||||||
and do a 'make reload' for the card driver. After that it
|
|
||||||
works fine again.
|
|
||||||
Presumably this is a problem in the card driver or firmware?
|
|
||||||
Or could it be a problem with the hardware?
|
|
||||||
Does anybody else observe this?
|
|
||||||
|
|||||||
96
INSTALL
Normal file
96
INSTALL
Normal file
@ -0,0 +1,96 @@
|
|||||||
|
Installation of the Video Disk Recorder
|
||||||
|
---------------------------------------
|
||||||
|
|
||||||
|
Compiling and running the program:
|
||||||
|
----------------------------------
|
||||||
|
|
||||||
|
Make sure the files from this package are located in a
|
||||||
|
directory that is "parallel" to the DVB directory of the
|
||||||
|
driver source for the Siemens DVB-S PCI card (refer to
|
||||||
|
http://linuxtv.org/dvb/siemens_dvb.html for more information
|
||||||
|
about that driver). For example, if the DVB driver was
|
||||||
|
extracted into the directory /home/kls/vdr/DVB, then this
|
||||||
|
package should be extracted into /home/kls/vdr/VDR.
|
||||||
|
|
||||||
|
This program requires the card driver version 0.04 or higher
|
||||||
|
to work properly.
|
||||||
|
|
||||||
|
After extracting the package, change into the VDR directory
|
||||||
|
and type 'make'. This should produce an executable file
|
||||||
|
named 'vdr', which can be run after the DVB driver has been
|
||||||
|
installed.
|
||||||
|
|
||||||
|
There are two macros you can use to customize the 'vdr' program
|
||||||
|
at compile time. Adding "DEBUG_REMOTE=1" to the 'make' call
|
||||||
|
will use the PC's keyboard as input device instead of the "Remote
|
||||||
|
Control Unit" (see http://www.cadsoft.de/people/kls/vdr/remote.htm).
|
||||||
|
Adding "DEBUG_OSD=1" will use the PC screen (or current window)
|
||||||
|
to display texts instead of the DVB card's on-screen display
|
||||||
|
interface. These modes are useful when testing new menus if you
|
||||||
|
only have a remote connection to the VDR (which, in my case, is
|
||||||
|
located in the living room and has neither a monitor nor a keyboard).
|
||||||
|
|
||||||
|
The video data directory:
|
||||||
|
-------------------------
|
||||||
|
|
||||||
|
All recordings are written into directories below "/video". Please
|
||||||
|
make sure this directory exists, and that the user who runs the 'vdr'
|
||||||
|
program has read and write access to that directory.
|
||||||
|
If you prefer a different location for your video files, you can change
|
||||||
|
the value of 'BaseDir' in recording.c.
|
||||||
|
|
||||||
|
Note that the file system need not be 64-bit proof, since the 'vdr'
|
||||||
|
program splits video files into chunks of about 1GB. You should use
|
||||||
|
a disk with several gigabytes of free space. One GB can store roughly
|
||||||
|
half an hour of video data.
|
||||||
|
|
||||||
|
Configuration files:
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
There are three configuration files that hold information about
|
||||||
|
channels, remote control keys and timers. These files are currrently
|
||||||
|
assumed to be located in the directory from which the 'vdr' program
|
||||||
|
was started (this will become configurable later). The configuration
|
||||||
|
files can be edited with any text editor, or will be written by the
|
||||||
|
'vdr' program if any changes are made inside the on-screen menus.
|
||||||
|
The meaning of the data entries may still vary in future releases,
|
||||||
|
so for the moment please look at the source code (config.c) to see
|
||||||
|
the meaning of the various fields.
|
||||||
|
|
||||||
|
Learning the remote control keys:
|
||||||
|
---------------------------------
|
||||||
|
|
||||||
|
There is no default 'keys.conf' file, so if you compile the program
|
||||||
|
without 'DEBUG_REMOTE=1' you will have to go through a "teach-in"
|
||||||
|
session that allows the program to learn your remote control codes.
|
||||||
|
It will first attempt to determine the basic data transfer mode and
|
||||||
|
timing of your remote control unit, and then will ask you to press one
|
||||||
|
key after the other so that it can learn the various key codes. You will
|
||||||
|
at least need to provide an "Up" and a "Down" key, so that you can switch
|
||||||
|
channels. The rest of the key definitions is optional, but the more keys
|
||||||
|
you define, the more you will be able to navigate through the menus and
|
||||||
|
control recording/replaying.
|
||||||
|
If the program has been built with "DEBUG_REMOTE=1", it will use the
|
||||||
|
key configuration file 'keys-pc.conf', so that you won't loose data
|
||||||
|
when switching between normal and debug mode.
|
||||||
|
|
||||||
|
The default PC key assignments are:
|
||||||
|
|
||||||
|
Up, Down, Left, Right Crsr keys in numeric block
|
||||||
|
Menu '5' in numeric block
|
||||||
|
Ok Enter
|
||||||
|
Back Backspace
|
||||||
|
0..9 '0'..'9' in top row
|
||||||
|
Red, Green, Yellow, Blue 'F1'..'F4'
|
||||||
|
Record 'r'
|
||||||
|
Pause 'p'
|
||||||
|
Stop 's'
|
||||||
|
Begin 'B'
|
||||||
|
SearchForward 'f'
|
||||||
|
SearchBack 'b'
|
||||||
|
SkipForward 'PgDn' in numeric block
|
||||||
|
SkipBack 'PgUp' in numeric block
|
||||||
|
|
||||||
|
If you prefer different key assignments, simply delete the file
|
||||||
|
'keys-pc.conf' and restart 'vdr' to get into learning mode.
|
||||||
|
|
||||||
32
MANUAL
32
MANUAL
@ -1,6 +1,32 @@
|
|||||||
Video Disk Recorder User's Manual
|
Video Disk Recorder User's Manual
|
||||||
---------------------------------
|
---------------------------------
|
||||||
|
|
||||||
|
* Navigating through the On Screen Menus
|
||||||
|
|
||||||
|
The "Main" menu can be called up with the "Menu" key of your remote
|
||||||
|
control unit. The "Up" and "Down" keys are used to select a specific
|
||||||
|
item. The "Left" and "Right" keys can be used to change options, and
|
||||||
|
the numeric keys allow direct input of numeric data. The "Ok" key
|
||||||
|
confirms any changes (or switches to a channel in the "Channels" menu).
|
||||||
|
The "Back" key goes back one level in the menu structure, discarding
|
||||||
|
any changes that might have been made in the current menu.
|
||||||
|
|
||||||
|
In the "Timers" menu, the current timer can be enabled or disabled with
|
||||||
|
the "Right" or "Left" key, respectively (enabled timers are marked with ">").
|
||||||
|
"Ok" here opens the "Edit timer" menu.
|
||||||
|
|
||||||
|
Textual options, like channel names or recording file names, can be edited
|
||||||
|
by pressing the "Right" button (which puts brackets around the current
|
||||||
|
character as in "[R]TL"), selecting the desired character position with
|
||||||
|
"Left" and "Right", and changing the character with the "Up" and "Down"
|
||||||
|
keys. "Ok" then confirms the changes.
|
||||||
|
|
||||||
|
The "Red", "Green", "Yellow" and "Blue" buttons have special meanings
|
||||||
|
in the various menus and are listed at the bottom of the on-screen-display.
|
||||||
|
|
||||||
|
At any point in the menu system, pressing the "Menu" key again will
|
||||||
|
immediately leave the menu system.
|
||||||
|
|
||||||
* Selecting a Channel
|
* Selecting a Channel
|
||||||
|
|
||||||
There are three ways to select a channel:
|
There are three ways to select a channel:
|
||||||
@ -36,6 +62,8 @@ Video Disk Recorder User's Manual
|
|||||||
|
|
||||||
* Replay Control
|
* Replay Control
|
||||||
|
|
||||||
|
The following keys have the listed meaning in Replay mode:
|
||||||
|
|
||||||
- "Begin" Positions to beginning of the recording and starts playback
|
- "Begin" Positions to beginning of the recording and starts playback
|
||||||
from there.
|
from there.
|
||||||
- "Pause" Halts playback at the current frame. Press again to continue
|
- "Pause" Halts playback at the current frame. Press again to continue
|
||||||
@ -45,6 +73,10 @@ Video Disk Recorder User's Manual
|
|||||||
- "Search" Runs playback forward or backward at a higher speed. Press
|
- "Search" Runs playback forward or backward at a higher speed. Press
|
||||||
again to resume normal speed.
|
again to resume normal speed.
|
||||||
- "Skip" Skips about 60 seconds forward or backward.
|
- "Skip" Skips about 60 seconds forward or backward.
|
||||||
|
- "Ok" Brings up the replay progress display, which shows the date,
|
||||||
|
time and title of the recording, a progress bar and the
|
||||||
|
current and total time of the recording.
|
||||||
|
Press "Ok" again to turn off the progress display.
|
||||||
|
|
||||||
* Programming the Timer
|
* Programming the Timer
|
||||||
|
|
||||||
|
|||||||
112
README
112
README
@ -7,6 +7,12 @@ of the LinuxTV project (http://linuxtv.org).
|
|||||||
For details about the "Video Disk Recorder" project please
|
For details about the "Video Disk Recorder" project please
|
||||||
refer to http://www.cadsoft.de/people/kls/vdr.
|
refer to http://www.cadsoft.de/people/kls/vdr.
|
||||||
|
|
||||||
|
There is also a remote control unit described on those
|
||||||
|
Web pages, which can be used within this program.
|
||||||
|
|
||||||
|
Please see the INSTALL file for details on how to install
|
||||||
|
this program on your computer.
|
||||||
|
|
||||||
The author can be contacted at kls@cadsoft.de.
|
The author can be contacted at kls@cadsoft.de.
|
||||||
|
|
||||||
Yet another "set-top-box"?
|
Yet another "set-top-box"?
|
||||||
@ -25,112 +31,6 @@ of commercial set-top-boxes usually are a lot more fancy than
|
|||||||
the ones in this system, but here we have the full source code
|
the ones in this system, but here we have the full source code
|
||||||
and can modify the menus in whatever way desired.
|
and can modify the menus in whatever way desired.
|
||||||
|
|
||||||
Compiling and running the program:
|
|
||||||
----------------------------------
|
|
||||||
|
|
||||||
Make sure the files from this package are located in a
|
|
||||||
directory that is "parallel" to the DVB directory of the
|
|
||||||
driver source for the Siemens DVB-S PCI card (refer to
|
|
||||||
http://linuxtv.org/dvb/siemens_dvb.html for more information
|
|
||||||
about that driver). For example, if the DVB driver was
|
|
||||||
extracted into the directory /home/kls/vdr/DVB, then this
|
|
||||||
package should be extracted into /home/kls/vdr/VDR.
|
|
||||||
|
|
||||||
This program requires the card driver version 0.04 or higher
|
|
||||||
to work properly.
|
|
||||||
|
|
||||||
After extracting the package, change into the VDR directory
|
|
||||||
and type 'make'. This should produce an executable file
|
|
||||||
named 'vdr', which can be run after the DVB driver has been
|
|
||||||
installed.
|
|
||||||
|
|
||||||
There are two macros you can use to customize the 'vdr' program
|
|
||||||
at compile time. Adding "DEBUG_REMOTE=1" to the 'make' call
|
|
||||||
will use the PC's keyboard as input device instead of the "Remote
|
|
||||||
Control Unit" (see http://www.cadsoft.de/people/kls/vdr/remote.htm).
|
|
||||||
Adding "DEBUG_OSD=1" will use the PC screen (or current window)
|
|
||||||
to display texts instead of the DVB card's on-screen display
|
|
||||||
interface. These modes are useful when testing new menus if you
|
|
||||||
only have a remote connection to the VDR (which, in my case, is
|
|
||||||
located in the living room and has neither a monitor nor a keyboard).
|
|
||||||
|
|
||||||
Configuration files:
|
|
||||||
--------------------
|
|
||||||
|
|
||||||
There are three configuration files that hold information about
|
|
||||||
channels, remote control keys and timers. These files are currrently
|
|
||||||
assumed to be located in the directory from which the 'vdr' program
|
|
||||||
was started (this will become configurable later). The configuration
|
|
||||||
files can be edited with any text editor, or will be written by the
|
|
||||||
'vdr' program if any changes are made inside the on-screen menus.
|
|
||||||
The meaning of the data entries may still vary in future releases,
|
|
||||||
so for the moment please look at the source code (config.c) to see
|
|
||||||
the meaning of the various fields.
|
|
||||||
|
|
||||||
Learning the remote control keys:
|
|
||||||
---------------------------------
|
|
||||||
|
|
||||||
There is no default 'keys.conf' file, so if you compile the program
|
|
||||||
without 'DEBUG_REMOTE=1' you will have to go through a "teach-in"
|
|
||||||
session that allows the program to learn your remote control codes.
|
|
||||||
It will first attempt to determine the basic data transfer mode and
|
|
||||||
timing of your remote control unit, and then will ask you to press one
|
|
||||||
key after the other so that it can learn the various key codes. You will
|
|
||||||
at least need to provide an "Up" and a "Down" key, so that you can switch
|
|
||||||
channels. The rest of the key definitions is optional, but the more keys
|
|
||||||
you define, the more you will be able to navigate through the menus and
|
|
||||||
control recording/replaying.
|
|
||||||
If the program has been built with "DEBUG_REMOTE=1", it will use the
|
|
||||||
key configuration file 'keys-pc.conf', so that you won't loose data
|
|
||||||
when switching between normal and debug mode.
|
|
||||||
|
|
||||||
The default PC key assignments are:
|
|
||||||
|
|
||||||
Up, Down, Left, Right Crsr keys in numeric block
|
|
||||||
Menu '5' in numeric block
|
|
||||||
Ok Enter
|
|
||||||
Back Backspace
|
|
||||||
0..9 '0'..'9' in top row
|
|
||||||
Red, Green, Yellow, Blue 'F1'..'F4'
|
|
||||||
Record 'r'
|
|
||||||
Pause 'p'
|
|
||||||
Stop 's'
|
|
||||||
Begin 'B'
|
|
||||||
SearchForward 'f'
|
|
||||||
SearchBack 'b'
|
|
||||||
SkipForward 'PgDn' in numeric block
|
|
||||||
SkipBack 'PgUp' in numeric block
|
|
||||||
|
|
||||||
If you prefer different key assignments, simply delete the file
|
|
||||||
'keys-pc.conf' and restart 'vdr' to get into learning mode.
|
|
||||||
|
|
||||||
Navigating through the On Screen Menus:
|
|
||||||
---------------------------------------
|
|
||||||
|
|
||||||
The "Main" menu can be called up with the "Menu" key of your remote
|
|
||||||
control unit. The "Up" and "Down" keys are used to select a specific
|
|
||||||
item. The "Left" and "Right" keys can be used to change options, and
|
|
||||||
the numeric keys allow direct input of numeric data. The "Ok" key
|
|
||||||
confirms any changes (or switches to a channel in the "Channels" menu).
|
|
||||||
The "Back" key goes back one level in the menu structure, discarding
|
|
||||||
any changes that might have been made in the current menu.
|
|
||||||
|
|
||||||
In the "Timers" menu, the current timer can be enabled or disabled with
|
|
||||||
the "Right" or "Left" key, respectively (enabled timers are marked with ">").
|
|
||||||
"Ok" here opens the "Edit timer" menu.
|
|
||||||
|
|
||||||
Textual options, like channel names or recording file names, can be edited
|
|
||||||
by pressing the "Right" button (which puts brackets around the current
|
|
||||||
character as in "[R]TL"), selecting the desired character position with
|
|
||||||
"Left" and "Right", and changing the character with the "Up" and "Down"
|
|
||||||
keys. "Ok" then confirms the changes.
|
|
||||||
|
|
||||||
The "Red", "Green", "Yellow" and "Blue" buttons have special meanings
|
|
||||||
in the various menus and are listed at the bottom of the on-screen-display.
|
|
||||||
|
|
||||||
At any point in the menu system, pressing the "Menu" key again will
|
|
||||||
immediately leave the menu system.
|
|
||||||
|
|
||||||
What do you think?
|
What do you think?
|
||||||
------------------
|
------------------
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user