File: README

package info (click to toggle)
nw802 0.0.99-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 244 kB
  • ctags: 375
  • sloc: ansic: 3,058; makefile: 174
file content (77 lines) | stat: -rw-r--r-- 3,347 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
 NW802 kernel module
=====================

This kernel module is a driver for USB webcam based on the DivIO chipsets NW800/NW801/NW802.

This version is an hybrid version. It includes the almost latest code for image decoding ( which is REALLY faster and has a REALLY improved quality of image ) and the old ( almost obsolete ) usb/cam interaction core.

Due to the limitation of this cam control module, support is limited but this version does include some /proc interface that allows tweaking the cam registers 'on-the-fly' which allows to do tests and more important tweak some image register. For this, a handy GTK utils ( nw8xx_regedit ) is now provided.


How to use it ?
---------------

* Edit nw8xx_regedit.c, at the start there is some #define to choose your cam chip ( registers differs and the GTK utils doesn't do any autodetect ).
* Type :
 # make
 # su
 # modprobe videodev
 # insmod usbvideo.o
 # insmod nw802.o
* Launch xawtv ( or any V4L compatible app. Since the driver currently ignores quite a lot of V4L request like videosize, format, ... the app may give warning or refuses to work at all ... xawtv works, newer version of gnomemeeting don't ... )


Something is wrong ...
----------------------

Don't compile ?
* Check that you have kernel sources installed
* Be sure to use CVS version !!!! ALWAYS use CVS. Releases may not contains
  all the correct stuff for the most recent 2.4 kernel
* Try to use the usbvideo.h & usbvideo.c from your kernel tree

Don't work ?
* You may not have a supported camera. Ask the mailing list.

New Driver ?
------------

As I said this version is hybrid. It includes some part of the new driver that is being developed. This version is the last commit to CVS and the last release.

The new one will be called 'nw8xx'. As I said, the new image decoding stuff algorithm is already done ( need some minor tweaks ). The new cam interface is not ready yet. Kjell Claesson and I ( well, for the moment, it mostly Kjell ;) ) are working on reverse enginering of the cam registers and to analyze the logs provided by users.

The new features should includes :
 - 2.4 / 2.6 kernel support
 - Better cam support with automatic chip/cds/ccd detection
 - Image control + Auto white balance + Auto exposure
 - ...
 

FAQ :
----

 * I don't have a 2.4.x kernel !
 
   If you use a 2.0 or 2.2 ... Upgrade ! If you use 2.6 ... Well this current version, it's not supported. I don't intent to add it ( so don't send patches, some people already did it and it's being included in the new driver ).

 * When will the new driver be ready ?

  ... I don't know ;) ...

 * Why is the project called nw802 and not nw8xx ?

  Because at first, I wasn't planning on supporting more than NW802 ;) Then I followed the users demands and since peoples provided me with 'working' init sequence for other chips ...

 * I have other questions, where to ask ?

  Try the mailing list : nw802-main@sourceforge.net


Many tanks to :
---------------

 - Several guys on USB mailling list, kernel newbies chat, for their help ( sorry don't know their names )
 - Robert Peter for it's great help to add support for NW800 based cam.
 - Stefan Jenisch for the first working NW801 init sequence.
 - Kjell Claesson for it's help in supporting NW801 and now being a member of the project. Great job on register/logs analysis !