Commit 07ccc1f3 authored by Luca Risolia's avatar Luca Risolia Committed by Greg Kroah-Hartman

[PATCH] USB: W996[87]CF driver updates

Small W996[87]CF documentation updates.
Signed-off-by: default avatarLuca Risolia <luca.risolia@studio.unibo.it>
parent b3abb666
...@@ -9,25 +9,29 @@ ...@@ -9,25 +9,29 @@
Index Index
===== =====
1. Copyright 1. Copyright
2. License 2. Disclaimer
3. Overview 3. License
4. Supported devices 4. Overview
5. Module dependencies 5. Supported devices
6. Module loading 6. Module dependencies
7. Module paramaters 7. Module loading
8. Contact information 8. Module paramaters
9. Credits 9. Contact information
10. Credits
1. Copyright 1. Copyright
============ ============
Copyright (C) 2002-2004 by Luca Risolia <luca.risolia@studio.unibo.it> Copyright (C) 2002-2004 by Luca Risolia <luca.risolia@studio.unibo.it>
2. Disclaimer
=============
Winbond is a trademark of Winbond Electronics Corporation. Winbond is a trademark of Winbond Electronics Corporation.
This driver is not sponsored or developed by Winbond. This software is not sponsored or developed by Winbond.
2. License 3. License
========== ==========
This program is free software; you can redistribute it and/or modify This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by it under the terms of the GNU General Public License as published by
...@@ -44,7 +48,7 @@ along with this program; if not, write to the Free Software ...@@ -44,7 +48,7 @@ along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
3. Overview 4. Overview
=========== ===========
This driver supports the video streaming capabilities of the devices mounting This driver supports the video streaming capabilities of the devices mounting
Winbond W9967CF and Winbond W9968CF JPEG USB Dual Mode Camera Chips. OV681 Winbond W9967CF and Winbond W9968CF JPEG USB Dual Mode Camera Chips. OV681
...@@ -57,7 +61,7 @@ decoding, up-scaling and colour conversions. Once the driver is installed, ...@@ -57,7 +61,7 @@ decoding, up-scaling and colour conversions. Once the driver is installed,
every time an application tries to open a recognized device, "w9968cf" checks every time an application tries to open a recognized device, "w9968cf" checks
the presence of the "w9968cf-vpp" module and loads it automatically by default. the presence of the "w9968cf-vpp" module and loads it automatically by default.
Please keep in mind that official kernels do NOT include the second module for Please keep in mind that official kernels do not include the second module for
performance purposes. However it is always recommended to download and install performance purposes. However it is always recommended to download and install
the latest and complete release of the driver, replacing the existing one, if the latest and complete release of the driver, replacing the existing one, if
present: it will be still even possible not to load the "w9968cf-vpp" module at present: it will be still even possible not to load the "w9968cf-vpp" module at
...@@ -65,7 +69,7 @@ all, if you ever want to. Another important missing feature of the version in ...@@ -65,7 +69,7 @@ all, if you ever want to. Another important missing feature of the version in
the official Linux 2.4 kernels is the writeable /proc filesystem interface. the official Linux 2.4 kernels is the writeable /proc filesystem interface.
The latest and full-featured version of the W996[87]CF driver can be found at: The latest and full-featured version of the W996[87]CF driver can be found at:
http://go.lamarinapunto.com/ . Please refer to the documentation included in http://www.linux-projects.org. Please refer to the documentation included in
that package, if you are going to use it. that package, if you are going to use it.
Up to 32 cameras can be handled at the same time. They can be connected and Up to 32 cameras can be handled at the same time. They can be connected and
...@@ -83,7 +87,7 @@ will be automatically loaded by default (provided that the kernel has been ...@@ -83,7 +87,7 @@ will be automatically loaded by default (provided that the kernel has been
compiled with the automatic module loading option). compiled with the automatic module loading option).
4. Supported devices 5. Supported devices
==================== ====================
At the moment, known W996[87]CF and OV681 based devices are: At the moment, known W996[87]CF and OV681 based devices are:
- Aroma Digi Pen VGA Dual Mode ADG-5000 (unknown image sensor) - Aroma Digi Pen VGA Dual Mode ADG-5000 (unknown image sensor)
...@@ -99,11 +103,9 @@ At the moment, known W996[87]CF and OV681 based devices are: ...@@ -99,11 +103,9 @@ At the moment, known W996[87]CF and OV681 based devices are:
If you know any other W996[87]CF or OV681 based cameras, please contact me. If you know any other W996[87]CF or OV681 based cameras, please contact me.
The list above does NOT imply that all those devices work with this driver: up The list above does not imply that all those devices work with this driver: up
until now only webcams that have an image sensor supported by the "ovcamchip" until now only webcams that have an image sensor supported by the "ovcamchip"
module work. module work. Kernel messages will always tell you whether this is case.
For a list of supported image sensors, please visit the author's homepage on
this module: http://alpha.dyndns.org/ov511/
Possible external microcontrollers of those webcams are not supported: this Possible external microcontrollers of those webcams are not supported: this
means that still images cannot be downloaded from the device memory. means that still images cannot be downloaded from the device memory.
...@@ -113,7 +115,7 @@ Furthermore, it's worth to note that I was only able to run tests on my ...@@ -113,7 +115,7 @@ Furthermore, it's worth to note that I was only able to run tests on my
additional testing and full support, would be much appreciated. additional testing and full support, would be much appreciated.
5. Module dependencies 6. Module dependencies
====================== ======================
For it to work properly, the driver needs kernel support for Video4Linux, USB For it to work properly, the driver needs kernel support for Video4Linux, USB
and I2C, and the "ovcamchip" module for the image sensor. Make sure you are not and I2C, and the "ovcamchip" module for the image sensor. Make sure you are not
...@@ -157,7 +159,7 @@ And finally: ...@@ -157,7 +159,7 @@ And finally:
CONFIG_USB_W9968CF=m CONFIG_USB_W9968CF=m
6. Module loading 7. Module loading
================= =================
To use the driver, it is necessary to load the "w9968cf" module into memory To use the driver, it is necessary to load the "w9968cf" module into memory
after every other module required. after every other module required.
...@@ -166,6 +168,7 @@ Loading can be done this way, from root: ...@@ -166,6 +168,7 @@ Loading can be done this way, from root:
[root@localhost home]# modprobe usbcore [root@localhost home]# modprobe usbcore
[root@localhost home]# modprobe i2c-core [root@localhost home]# modprobe i2c-core
[root@localhost home]# modprobe videodev
[root@localhost home]# modprobe w9968cf [root@localhost home]# modprobe w9968cf
At this point the pertinent devices should be recognized: "dmesg" can be used At this point the pertinent devices should be recognized: "dmesg" can be used
...@@ -181,7 +184,7 @@ explanation about them and which syntax to use, it is recommended to run the ...@@ -181,7 +184,7 @@ explanation about them and which syntax to use, it is recommended to run the
[root@locahost home]# modinfo w9968cf [root@locahost home]# modinfo w9968cf
7. Module parameters 8. Module parameters
==================== ====================
Module parameters are listed below: Module parameters are listed below:
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
...@@ -452,7 +455,7 @@ Default: 0 ...@@ -452,7 +455,7 @@ Default: 0
------------------------------------------------------------------------------- -------------------------------------------------------------------------------
8. Contact information 9. Contact information
====================== ======================
I may be contacted by e-mail at <luca.risolia@studio.unibo.it>. I may be contacted by e-mail at <luca.risolia@studio.unibo.it>.
...@@ -461,7 +464,7 @@ My public 1024-bit key should be available at your keyserver; the fingerprint ...@@ -461,7 +464,7 @@ My public 1024-bit key should be available at your keyserver; the fingerprint
is: '88E8 F32F 7244 68BA 3958 5D40 99DA 5D2A FCE6 35A4'. is: '88E8 F32F 7244 68BA 3958 5D40 99DA 5D2A FCE6 35A4'.
9. Credits 10. Credits
========== ==========
The development would not have proceed much further without having looked at The development would not have proceed much further without having looked at
the source code of other drivers and without the help of several persons; in the source code of other drivers and without the help of several persons; in
......
...@@ -2371,7 +2371,7 @@ USB SN9C10x DRIVER ...@@ -2371,7 +2371,7 @@ USB SN9C10x DRIVER
P: Luca Risolia P: Luca Risolia
M: luca.risolia@studio.unibo.it M: luca.risolia@studio.unibo.it
L: linux-usb-devel@lists.sourceforge.net L: linux-usb-devel@lists.sourceforge.net
W: http://go.lamarinapunto.com W: http://www.linux-projects.org
S: Maintained S: Maintained
USB SUBSYSTEM USB SUBSYSTEM
...@@ -2399,7 +2399,7 @@ USB W996[87]CF DRIVER ...@@ -2399,7 +2399,7 @@ USB W996[87]CF DRIVER
P: Luca Risolia P: Luca Risolia
M: luca.risolia@studio.unibo.it M: luca.risolia@studio.unibo.it
L: linux-usb-devel@lists.sourceforge.net L: linux-usb-devel@lists.sourceforge.net
W: http://go.lamarinapunto.com W: http://www.linux-projects.org
S: Maintained S: Maintained
USER-MODE LINUX USER-MODE LINUX
......
...@@ -135,7 +135,7 @@ static const struct w9968cf_format w9968cf_formatlist[] = { ...@@ -135,7 +135,7 @@ static const struct w9968cf_format w9968cf_formatlist[] = {
#define W9968CF_MODULE_NAME "V4L driver for W996[87]CF JPEG USB " \ #define W9968CF_MODULE_NAME "V4L driver for W996[87]CF JPEG USB " \
"Dual Mode Camera Chip" "Dual Mode Camera Chip"
#define W9968CF_MODULE_VERSION "1:1.32-basic" #define W9968CF_MODULE_VERSION "1:1.33-basic"
#define W9968CF_MODULE_AUTHOR "(C) 2002-2004 Luca Risolia" #define W9968CF_MODULE_AUTHOR "(C) 2002-2004 Luca Risolia"
#define W9968CF_AUTHOR_EMAIL "<luca.risolia@studio.unibo.it>" #define W9968CF_AUTHOR_EMAIL "<luca.risolia@studio.unibo.it>"
#define W9968CF_MODULE_LICENSE "GPL" #define W9968CF_MODULE_LICENSE "GPL"
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment