From e65b69765175aca0a94eba111b13ff75133f404d Mon Sep 17 00:00:00 2001 From: Klaus Schmidinger Date: Mon, 24 Apr 2000 10:40:00 +0200 Subject: [PATCH] Added installation instructions --- BUGS | 7 ---- INSTALL | 96 ++++++++++++++++++++++++++++++++++++++++++++++++ MANUAL | 32 ++++++++++++++++ README | 112 +++----------------------------------------------------- 4 files changed, 134 insertions(+), 113 deletions(-) create mode 100644 INSTALL diff --git a/BUGS b/BUGS index c9c4a311..66755f9f 100644 --- a/BUGS +++ b/BUGS @@ -14,10 +14,3 @@ Video Disk Recorder - Known Bugs Haven't figured out yet how to ensure that it switches back to 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? diff --git a/INSTALL b/INSTALL new file mode 100644 index 00000000..d7acfb6d --- /dev/null +++ b/INSTALL @@ -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. + diff --git a/MANUAL b/MANUAL index a7ed224c..36a62987 100644 --- a/MANUAL +++ b/MANUAL @@ -1,6 +1,32 @@ 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 There are three ways to select a channel: @@ -36,6 +62,8 @@ Video Disk Recorder User's Manual * Replay Control + The following keys have the listed meaning in Replay mode: + - "Begin" Positions to beginning of the recording and starts playback from there. - "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 again to resume normal speed. - "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 diff --git a/README b/README index 0de0d557..cfc10a76 100644 --- a/README +++ b/README @@ -7,6 +7,12 @@ of the LinuxTV project (http://linuxtv.org). For details about the "Video Disk Recorder" project please 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. 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 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? ------------------