*This is the Pixel View Combo Plus Video For Linux Driver (V4L1) README.

*Introduction

Hello There!!!
If you're interested in trying out this device driver, you're either
really very brave, or very desperate or both. This is the first
release of this driver, which I intend to Maintain and support
because, and only because the only other platform on which this card
is supported, is Windows 98. That smacks hard on my ego.........

*Disclaimer

This device driver is based on highly experimental and untested
code. If you're trying it out, you should be either of:

- Kernel Hacker.
- Alpha Tester.
- Desperate(ly) Poor Linux fanatic. (Uh, I can't afford a new card...)
- Reckless Daredevil.

Please - no email asking me to replace your burnt out combo tv card.

*Features

- Works with xawtv version 3.72 (at least that's all I've tested it on.)
with the XFree4 Xserver release in the following graphics modes:
800x600, 640x480 @ 24bpp, 16bpp in all combinations.

Note: Please do not try 8-bit depth at any resolution. The driver does not
object, but the result is not very pleasant (to your opinion about my
programming skills ;-) ).

- Support for PAL (B,G,H,I) (50Hz) broadcasts. 
Note: Only Framebuffer Overlay is supported at present. ie; you can
just watch tv. No video capture.

- Modular code - can be easily extended to other cards of this family.

- Patch available against kernel version 2.5.47 and 2.4.18.
  See: http://cherry.freeshell.org/downloads/


*Bugs

- Freezes, I repeat, FREEZES the machine if you switch consoles while
xawtv is running. It's ok to switch consoles even if the driver is
loaded if xawtv is not running.

- At 800x600 resolution, the graphics buffer gets written over. The
result is more of an eyesore rather than any serious harm. Fullscreen video
works fine in all the supported (see above) video modes.


*TODO
- Fix the console switch bug.
- Implement Dynamic Capture buffer resizing, to prevent messing up the screen
  at higher resolutions.
- Implement Chromakeying.
- Implement Brightness, Contrast, Hue and Colour controls.
- Implement Audio IOCTLs.
- Implement Video grabbing etc.
- Implement V4L2.

*File List
All paths are w.r.t the linux source tree root.
drivers/media/video/pvcl.c
drivers/media/video/pvcl.h
drivers/media/video/pvcard.h
drivers/media/video/pvproc.h
drivers/media/video/vpx322xd.c
Documentation/video4linux/pvclnotes.txt

Configuration entry in drivers/media/video/Kconfig
Configuration entry in drivers/media/video/Makefile

*Configuration

-Patch the kernel as described in the kernel README file or the
Kernel-HOWTO document.
-While configuring the kernel, Enable the following options:
 1. "Prompt for development and/or incomplete code/drivers"
 2. "I2C Support" in the Character Devices Section.
 3. "I2C bit-banging interfaces" in the I2C Support Section.
 4. "Video For Linux" in the Multimedia Devices Section.
 5. "Pixel View Combo Tv Plus (V4L1 Driver) (EXPERIMENTAL)"


*Installation

-compile the driver using 'make modules' and 'make modules_install'.

-do 'modprobe vpx322xd'
    You should see something like:

    i2c-core.o: i2c core module version 2.6.4 (20020719)
    vpx version 0.1 (November, 2002)

-do 'modprobe pvcl'
    You should see something like:

    Linux video capture interface: v1.00
    i2c-algo-bit.o: i2c bit algorithm module version 2.6.4 (20020719)
    pvcl: registered device video
    pvcl: Found Cirrus Logic GD 5446
    pvcl: Detected 2MB video ram.
    vpx: probing i2c adapter clgd54xx ... 
    vpx: Found: vpx 3225d chip @ 0x86 

-do 'modprobe tuner type=24'
    You should see something like:

    tuner: probing clgd54xx i2c adapter [id=0x10005]
    tuner: chip found @ 0xc6

-Now switch back to the xserver and run xawtv.

Happy Hacking!!

Cherry.

"Cherry George Mathew" <cherry@freeshell.org>
http://cherry.freeshell.org/

PS: Please send your comments/patches to video4linux-list@redhat.com
and send me a cc: