Quick HOWTO, better one coming soon, hopefully. 

Be sure to check http://ivtv.sf.net/ for the latest updates/news.
The preferred method for asking questions is the devel mailing list.

The old-style chardev support has been removed. v4l2 (at least the headers) is
now required. Not a problem for most people.

Also there are now options to set the number of buffers desired:
insmod ivtv.o mpg_buffers=xx yuv_buffers=yy

On average a frame of full-res mpg data takes 2 or 3 buffers and a frame of YUV takes 17. (each buffer is 32k)

##########
# How to get mpeg from the card:
#########

You have 2 choices for v4l:
A) Get your kernel patched and compiled with the v4l2 stuff
   from http://bytesex.org/v4l/ (this is the reccommended option)
B) Copy videodev2.h from the v4l2 sources into the same dir as ivtv.h 
   This doesn't require kernel recompile, but may not be fully featured.
   Only option one is actively supported by the developers :)

Once you've done that,

1) Make sure you have /dev/video0

mknod /dev/video0 c 81 0

2) Load the drivers (and supporting modules):

insmod i2c-core
insmod i2c-algo-bit
insmod msp3400.o
insmod saa7115.o
# you may need to specify tuner type, i.e.:
#  "insmod tuner type=2" for most NTSC tuners
insmod tuner
insmod videodev
#lots of debugging
# insmod ivtv.o
#less debugging
insmod ivtv.o debug=1

3) Copy mpg
Check your logs. it will say which minor # got registered as the iTVC card

cat /dev/video0 > file.mpg

ctrl-c when you've had enough

4) See the utils/ directory for tools that let you change channels and set card
options. "test_ioctl" is a good place to start.

##########
# How to get YUV (aka raw video) from the card:
#########

1) Make sure you have /dev/yuv0

mknod /dev/video0 c 81 32

2) load the drivers (same as before)
2a) If you want the card to automatically convert the hauppauge "proprietary"
     YUV format to NV12, load the driver as "insmod ivtv.o yuv_fixup=1"
     (note: this is a very new feature, and probably very buggy also)

3) cat /dev/yuv0 -> file.yuv

Note that the YUV is in a non-standard format. You'll need to fix it up or
wait until we can fix it up for you.

-tmk (nufan_wfk at yahoo.com)
