Readme for utils directory, ivtv project.

Currently supported utils:
* ivtvfwextract (see below)
* ptune-ui.pl (see README.ptune) for changing channels
* ptune.pl (see README.ptune) for changing channels (no GUI)
* test_ioctl.c for setting various options. Run with -h to see usage.
* record-v4l2.pl for recording for a set length of time then stopping (ie 1 hr)

Available only via the SourceForge File Release System:
  http://sourceforge.net/project/showfiles.php?group_id=73219

* Updated Video::Frequencies (perl module, see section "Perl Modules")
* ivtv-specific Video::ivtv (perl module, see section "Perl Modules")

Unsupported utils:
* chann.c (can be used to change channels. Only useful for NTSC,
  recommend ptune-ui.pl.)

Other files:
* "videodev2.h"
	is the v4l2 header. Copy this to driver/ if you don't have 
	v4l2 compiled into your kernel and don't want to patch.
* "lircd.conf"
	sample LIRC config file for the black pvr 250/350 IR port/remote
* "lircd-g.conf"
	sample LIRC config file for the grey pvr 250/350 remote,
	rename it to lircd.conf to use
* "lircrc"
	sample ~/.lircrc config file for the Hauppauge remote

Firmware stuff
========================================
(first, read the firmware section on the website: http://ivtv.sourceforge.net/ )

Step-by-step

1) Extract the firmware from your Hauppauge WinTV-PVR-x50 CD or from an
   updated driver file using the program ivtvfwextract.  Make sure you
   have the CD mounted (assumed at /mnt/cdrom by default) or that you have
   an updated driver file accessible (named similar to "pvr48_1620352.exe").

   Use plain "ivtvfwextract" (no options) to extract the firmware from CD
   into /lib/modules/ivtv-fw-dec.bin and ivtv-fw-enc.bin.
   If you want to use other filenames or the CD isn't at /mnt/cdrom,
   use "ivtvfwextract --help" for a list of options.

2) (Only if you for some reason do not use the default names at step 1:)
   Update the source to point at your firmware files.  Edit ivtv.h to
   reflect the location of your firmware files.  The values to edit are
   IVTV_FIRM_ENC_FILENAME and IVTV_FIRM_DEC_FILENAME.  

3) Compile the driver. You should be good to go.
   (Note: If your kernel is not in /usr/src/linux then you'll have
          to run "make KERNELDIR=/path/to/kernel/source" )


Perl Modules
===========================
The included perl modules can be installed as follows:

1) Unpack the modules
   tar -zxvf filename.tar.gz

2) Compile the module
   cd <directory>
   perl Makefile.PL
   ...
   make
   ...
   make test
   ...

3) Install the modules, as root, if everything is OK up until now.
   make install

