2. Enabling Support for Your (Webcam) Hardware in Linux

2.1.1. Module or In-Kernel?

As a rule, often the stock kernel, or working part of the operating system, of your initial installation may already have support for what you need. Your Linux distribution vendor has likely enabled the most common options already, including the bus, or connection type, and drivers for common camera models. The driver exists either as a loadable module or within the already running kernel.

An easy way to tell if the driver is enabled is to use the dmesg command piped into less (for easy paging) to look for an acknowledgement that it was loaded when your system started up:

$ dmesg | less

...which may yield something like the following, depending on your hardware:

Dec 18 17:35:18 localhost kernel: hub 5-0:1.0: USB hub found Dec 18 17:35:18 localhost kernel: hub 5-0:1.0: 2 ports detected Dec 18 17:35:18 localhost kernel: Linux video capture interface: v1.00 Dec 18 17:35:18 localhost kernel: quickcam: QuickCam USB camera found (driver version QuickCam USB $Date: 2005/01/07 13:29:53 $) Dec 18 17:35:18 localhost kernel: quickcam: Kernel:2.6.7 bus:1 class:FF subclass:FF vendor:046D product:0840 Dec 18 17:35:18 localhost kernel: quickcam: Sensor HDCS-1000/1100 detected Dec 18 17:35:18 localhost kernel: quickcam: Registered device: /dev/video0 Dec 18 17:35:18 localhost kernel: usbcore: registered new driver quickcam

If you don't see it, the particular driver may exist as a loadable module. If you know what that module is named, try using find; in this example we are looking for the 'ibmcam' module:

$ find /lib/modules -name ibmcam.o

Note that up until the 2.4 series modules had the suffix .o; for 2.6+ series kernels this was replaced with .ko.

You can get a list of all modules available by typing the following at the command line:

$ ls -R /lib/modules/`uname -r`/kernel

Where `uname -r`, surrounded by forward tick marks, is your kernel version number. The following output is an example of what you might find in a USB webcam-ready kernel , where everything is loaded as a module (all but the relevant lines have been edited for brevity):

./usb: usbvideo.o usbcore.o ibmcam.o

Once you know which module your camera needs you can find out if it is already loaded by typing the following at the command line:

# lsmod

As shown by the prompt above, you will need to have root privileges to do this. You should get output similar to the following:

cdrom 29312 0 (autoclean) [sr_mod] usb-ohci 17888 0 (unused) usbcore 56768 0 [scanner ibmcam usbvideo usb-ohci] ibmcam 39680 0

Most stock kernels are compiled with kmod, which enabling automatic loading of necessary modules when the appropriate hardware is detected. It may not always do so, however, so if you don't have the particular module you're seeking loaded and you think the module may be available, try loading it manually with modprobe, as in the following using the ibmcam module as an example:

# modprobe -v ibmcam

Drivers for specific webcam models, or links to project pages hosting code for drivers, are outlined in Section 2.3. The drivers are usually available one of three ways: within the kernel, as a compilable stand alone module, or available as a pre-compiled binary from your Linux distribution.

If the support for your driver is not found either enabled statically within the kernel or as a module, don't despair. Drivers for numerous models are in the Linux kernel source (available directly from kernel.org source code repository), or in code offered separately from the kernel that can be configured to work with your current setup as oulined in Section 2.1.2. If your webcam driver is available in the kernel source but not enabled as a module or otherwise in your default system, you can either recompile the kernel from the source code you have or obtain a new version of the kernel source, either pre-packaged by your Linux distributor or directly from the previous link (as a so-called "vanilla" kernel). If you are unfamiliar with the prerequisites and procedure of compiling your own kernel, I direct you to the Kernel HOWTO for more information.

2.1.2. Patching, Source-Only or Precompiled Binary?

You may find that your webcam is supported by only a kernel patch, by a source-only driver not requiring a kernel recompile, or you may even be lucky enough to have a distribution that makes a pre-compiled and packaged binary driver available for your computer's architecture. The procedure involved in the former is largely beyond the scope of this document and is probably best outlined in the documentation available on the web page of your particular model's driver found in Section 2.3. Some further more general documentation on these processes are, however, addressed in Section 5

2.2.1. USB Webcams

If you have a USB webcam, it is likely a Linux driver has been written for your device. There are two ways of supporting USB devices in Linux. One is the more traditional kernel support, and the other is through libusb. For at least one webcam category, the STV0680-based models, working libusb support is recommended, at least according to the Sourceforge page on the subject.

Unless you know your driver requires libusb support, you should probably stick with the more conventional in-kernel support for USB devices beginning in Section 2.2.1.2.

2.2.2. IEEE 1394 (Firewire™, i.Link™)

IEEE 1394 webcams require an IEEE 1394 PCI card or an IEEE 1394 bus port on your mainboard. The IEEE interface has been supported in Linux since the early 2.4-series kernel. If you are lucky enough to own such a device, generic information on support of the IEEE 1394 bus in Linux can be found at www.linux1394.org. If you have a kernel older than 2.4.2, you will need to patch your kernel with one of the patches found on this page matched to your kernel version. In addition, you will require libraw1394. The previously referenced linux1394.org site has a great installation guide.

The IEEE1394 Digital Camera List, by Damien Douxchamps, offers an outstanding summary of the capabilities of IEEE 1394 cameras as well as the current status of support for individual models.

2.2.3. Generic Parallel Port Support for Parport Webcams

For 2.2 and 2.4 kernel systems, parallel-port support must be enabled statically or as a module (stock kernels usually have this enabled by default). You may want to read more generic info about parallel-port device support under the Linux kernel before starting this process. To find out for sure if the module parport is loaded, you can check the dmesg file or use lsmod as outlined above. Using dmesg | less, you should see (among many other lines) the following:

Mar 3 08:00:25 K7 kernel: parport0: PC-style at 0x378 (0x778) [PCSPP,TRISTATE] Mar 3 08:00:25 K7 kernel: parport0: irq 7 detected

If you are compiling your own kernel, enable 'Parallel Port support'. You should enable 'IEEE 1284 transfer modes', and if you have x86 type architecture, you should also enable 'PC-style hardware'.

If modprobe returns an error when you attempt to load the module, note that you may need to determine and supply the hardware address when invoking modprobe. The most common address is 0x378 for an x86 system; 0x278 and 0x3BC are other possibilities for integrated or ISA parallel ports. Add-in PCI parallel ports may have unusual base addresses. You can also arrange multiple devices with either the parport_pc or parport_arc modules, though that topic is beyond the scope of this document.

WARNING: Be sure you have the correct address before entering this information at the command line or else your machine may become unstable, crash or otherwise implode.

Your parallel port should be set to preferably "EPP" mode, or alternatively ECP/EPP. "Bidirectional" (also known as "BPP" or "PS/2") may work, albeit much more slowly. "Unidirectional" mode is unsuitable for scanning. The above setting can usually be accessed through your BIOS menu, at least on x86 systems.

2.3.1. 3com HomeConnect PC Digital Webcam

This driver is supported with the kernel patch located at the homeconnectusb project web page. It may require a kernel recompile after patching depending on your kernel version.

2.3.2. CPiA based Webcams

Please see the project home page for up-to-date information. This chipset has been used in the manufacture of both USB and parallel port webcams including the following:

• Aiptek HyperVcam Fun USB (non-OV511 based)

• Creative Video Blaster WebCam II USB and parallel-port

• CVideo-Mail Express parallel-port

• Digicom Galileo USB and Digicom Galileo Plus

• Dynalink Digital Camera

• Ezonics EZCam (not Pro or Plus)

• I-View NetView NV200M

• Microtek EyeStar USB

• Pace Color Video Camera USB

• SuperCam WonderEye

• TCE Netcam 310 USB

• Terracam USB (non-OV511 based or Terracam Pro)

• Trust SpaceC@m Lite USB and SpaceC@m 100

• Utopia USB Camera

• ZoomCam USB and parallel-port

2.3.3. SE401, SE402 and EP800 based USB webcams

This project is a work in progress. The drivers and other useful information are available at the project homepage located here. As of writing this, it is necessary to patch and recompile your kernel in order to obtain support for these models. The driver supports the following:

SE401 chipset via the 'se401' driver:

• Aox SE401 camera

• Philips PCVC665 USB VGA webcam 'Vesta Fun'

• Kensington VideoCAM PC Camera (Models 67014-67017)

SE402 and EP 800 chipsets via the 'epcam' driver

• Spypen Actor

• Rimax Slim Multicam

• Concord Eye-Q Easy

• Creative PD1001

• Chicony DC-100

• Endpoints SE402 and EP800

2.3.4. OmniVision based Webcams

This category includes a multitude of webcam and video-capture devices manufactured by Omnivision, including the OV511(+), OV518(+), OV6620, OV6630, OV7610, and OV7620AE. The project homepage is here. Supported models include:

• Aiptek HyperVcam Home and Mobile

• Amitech AWK-300

• I-view NetView NV300M

• TEVion MD9308

• Intel Me2Cam

• Dlink DSB C100, C300

• Hawking Tech. UC-110, UC-300 and UC-310

• Puretek PT-6007

• Alpha Vision Tech AlphaCam SE model AC-520

• Creative Labs WebCam model PD1001 with OV518 chipset

• Creative Labs WebCam 3, WebCam Go, Webcam Go Plus

• Elecom UCAM-C1C20

• Elta WEBCam 8211 PCC

• Ezonics EZPhone Cam

• Philips ToUCam XS (old version with OV518)

• LG Electronics LPC-UM10

• Lifeview various USB Life TV models

• Genius VideoCam Express

• AverMedia Intercam Elite

• Maxxtro Cam22U

• MediaForte MV300, PC Vision 300

• Terratec TerraCam PRO and some TerraCam models

• OmniVision (except those with OV519)

• TRENDNet TV-PC301

• Trust Sp@ceC@m USB

• Lifetec LT9388

• BestBuy EasyCam U

• Maxell Maxcam

• TCE NetCam 310u

• Medion MD9388

• Webeye 2000B

• Suma eON

• Prochips PCA-3100

• Ezonics EZ USB Cam II (the OV511+ models)

• Waytech I-Pac VIC-30

• Zoom Telephonics ZoomCam III USB (model 1598)

2.3.5. Logitech (formerly Connectix) Quickcam Support

The QuickCam VC USB and parallel port model webcams are supported by the driver offered here. A kernel patch and recompile are necessary for support of this model.

The Quickcam driver is represented by two different projects that offer two different flavors of driver for certain Quickcam models, both of which are stand-alone drivers that do not require a kernel patch or recompile. The qce-ga and qc-usb drivers support the following models:

• Logitech (earlier models of) Quickcam Express

• Quickcam Web

• Legocam

• Dexxa Webcam

• Labtec Webcam

The qc-usb driver is more experimental but reportedly works better on some models such as the Quickcam Web. Also, I have recieved correspondence that newer versions of the Logitech Quickcam Express no longer work with the above drivers; instead this page offers an experimental driver that claims to support the newer model.

Note to Redhat users: The qce-ga driver doesn't compile properly using the modified kernel source provided in Redhat 9, but a fix is available here.

Some Logitech camera models are supported by the Philips driver in Section 2.3.8.

2.3.6. ICM532 Based Webcams

One driver for this chipset, homepage here, is now merged into the 2.6 kernel source; the other is (per the developer's own description) experimental and available here. Either or both claim to support the following models:

• IC-Media Corp Pencam

• Newer versions of the Logitech Quickcam Express

• Newer versions of the Labtec Webcam

• Biolux 654 microscope

• Ezonics EZCam USB II (uvt8532)

• Ezonics EZCam USB III

• TerraCam USB

• Stick Webcam

• Mini WebCam

• Tucan PenCam

• Che-ez! Webbie

• SNAKE EYE SI-8480/8481

• PC CAM CP03

• WEB Camera PBC0006

• Clipcam

2.3.7. NW802 Based Webcams

This chipset, manufactured by DIVIO, is supported by the driver found here. The models supported include the following:

• BTC SurfCam CMOS300k

• Mustek WCam 300

• Logitech QuickCam Pro USB (the earlier "dark focus ring" model)

2.3.8. Philips USB Webcams

Because of the expiration of the Non-Disclosure-Agreement between Philips Corporation and the former maintainer of the pwc driver, the previous kernel support for Philips PWC-chip-based webcams has been removed. Luckily a new, still experimental driver that does not require a proprietary module is under development. The old site, with a discussion of the change, can be seen at http://www.smcc.demon.nl/webcam/; the new driver is maintained at saillard.org with more information at the PWC Documentation Project.

Philips models supported by the above include the following.

• PCA645VC

• PCA646VC

• PCVC675K Vesta, Vesta Pro and Vesta Scan

• PCVC720K/40 ToUCam XS, ToUCam Fun, ToUCam Pro and ToUCam Scan

• Askey VC010

• Creative Labs Webcam 5, Pro Ex

• Logitech 3000 and 4000 Pro, Notebook Pro, and Zoom

• Samsung MPC-C10 and MPC-C30

• Sotec Afina Eye

• Visionite VCS UM100 and UC300

2.3.9. SPCA50X USB Camera Linux Driver

Information regarding this chipset can be found here, and is under heavy development and includes partial or complete support for the following models:

• Kodak DVC-325 and EZ200

• Creative PC-CAM 300, 600, 750

• Genius VideoCAM Express V2

• Micro Innovation IC 200/IC 150

• Logitech ClickSmart 310, 420, 510, 820 and Cordless models

• Logitech Pocket750

• Benq DC 1016, 1300, 1500, 3410

• Flexcam 100

• Aiptek MegaCam, [1.3 Megapixel] Mini PenCam and PocketCam 1.3M Smart

• Finet Technology Palmpix DC-85

• Pure DigitalDakota

• 3Com Home Connect lite

• Megapix V4

• Mustek gSmart: Mini, Mini2, Mini3, LCD 2, LCD 3

• Digital Dream Enigma 1.3, Epsilon 1.3

• Maxwell Compact Pc PM3

• Jenoptik models

• Minton S-Cam F5

• D-Link DSC-350

• Trust FamilyC@m 300 Movie

• Aiptek Pocket DV, PocketDVII, DV3100+, mini PenCam 2, PocketCam 3M, Pencam SD 2, Pocket DV3500

• Hama Sightcam 100

• Micro Innovations IC50C, IC400c

• FlyCam USB100

• Arowana USB Camera 300 K

• Intel Easy PC Camera, CS120 (Easy PC Share), PC Camera Pro (CS431), Pocket PC Camera (CS630)

• Grandtec V.cap

• Sigma-Apo Petcam

2.3.10. STV0680 based Models

The USB version of webcams made with this chipset are supported by the 2.4.18 and above kernel with the stv680.o module. Alternatively, you can obtain the source from the project homepage. This driver supports models including the Aiptek Pencam and the Nisis Quickpix 2.

If you have a serial version, the main one of which is the Scan e-Studio, you should go here.

2.3.11. Winbond w9966cf

This is a driver for the parallel-port interface that supports the Philips SAA7111 CCD-control chip as found on the Lifeview Flycam SUPRA webcam. It is included in the late 2.4 kernel series and later under the heading 'video4linux' support. The homepage for this project is here.

2.3.12. Xirlink C-it™ HDCS-1000 based Webcams

This driver is for the USB webcams manufactured by Xirlink, IBM (PC Camera) and Veo Stingray model webcams. Support has been in the Linux kernel USB section since 2.2.12. The homepage is at http://www.linux-usb.org/ibmcam.