Spca5xx

Differences between revisions 4 and 6 (spanning 2 versions)
Revision 4 as of 2005-09-23 16:37:36
Size: 11090
Editor: gw
Comment: spca5xx breezy problem
Revision 6 as of 2005-12-17 01:03:57
Size: 15713
Editor: p50875E9E
Comment: alternative How-to
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
'''Content:'''
[[TableOfContents()]]
Line 5: Line 8:
The spca5xx is not (yet) in the ubuntu kernel. You can however compile it yourselves using the following steps: The spca5xx driver is in the ubuntu kernel 2.6.9-12 (type <code>uname -a</code> in a terminal to see your kernel version number). However it does not work (Oct. 22nd - ubuntu bugzilla: [http://bugzilla.ubuntu.com/show_bug.cgi?id=15809 15809] [http://bugzilla.ubuntu.com/show_bug.cgi?id=14566 14566] [https://bugzilla.ubuntu.com/show_bug.cgi?id=16727 16727]).

You can however compile it yourselves using the following steps:
Line 212: Line 217:
----
= Installing spca5xx - alternative How-to =

If you want to replace the spca5xx driver delivered with Ubuntu, this text shows you how. A compilation of the kernel is not necessary.

/!\ The spca5xx module delivered with Ubuntu Breezy is buggy and needs to be replaced, if you want to use it. This bug manifests itself by crashing the system when the camera is activated.

This howto is partially based on information found in arnieboy's posting: [http://www.ubuntuforums.org/showthread.php?t=70657&page=3]

== Step 1: Get the spca5xx source code ==

First download the current spca5xx source from Michel Xhaard's homepage and store it in your home directory. At the time of writing 20051212 is the latest version.

{{{
cd ~
wget http://mxhaard.free.fr/spca50x/Download/spca5xx-20051212.tar.gz
}}}

But check out his site for a newer version at [http://mxhaard.free.fr/download.html] [[BR]]
Change any occurance of ''spca5xx-20051212'' in this how-to to the version you have downloaded.

== Step 2: Become root ==

For administrative task Ubuntu uses the '''sudo''' command. This will not work here. (We have to change an environment variable (see below). If we use sudo this change will be discarded when the execution of the sudo commands ends, i.e. immediately.)

So, we use this method: [[BR]]
Open a terminal window and enter:

{{{sudo -s
}}}

When prompted for your password, enter your user password.

The prompt should change to:
{{{root@yourmachine:
}}}

== Step 3: Download the necessary packages ==
In order to compile and integrate the drivers, the following packages are needed from the Ubuntu repositories:

 1. {{{linux-headers-`uname -r`}}}
 1. {{{linux-restricted-modules-`uname -r`}}}
 1. {{{build-essential}}}
 1. {{{gcc-3.4}}}

'''linux-...''' - The construct {{{`uname -r`}}} will evaluate to the version of the running kernel, e.g. 2.6.12.10-k7 (may vary on your system). The "linux" packages will download the headers of your kernel and the restricted modules from the repositories.

'''build-essential''' - contains utilities for compiling source code.

'''gcc-3.4''' - The GNU C compiler. By default Breezy installs gcc-4.0 on your system. But the current kernel is compiled with gcc-3.4. Kernel modules MUST be compiled with the same compiler version as the kernel itself, so we need the older version. [[BR]]
/!\ This information is valid for Breezy and may change in later versions of Ubuntu.

The command to install these packages is:

{{{apt-get install linux-headers-`uname -r` linux-restricted-modules-`uname -r` build-essential gcc-3.4
}}}

== Step 4: Compiling the spca5xx source code ==

The linux stuff is installed under '''/usr/src'''. So I suggest, you go there:

{{{cd /usr/src
}}}

and move the spca5xx source from your home directory to this location:
{{{mv ~/spca5xx-20051212.tar.gz .
}}}

Unpack it
{{{tar xfvz spca5xx-20051212.tar.gz
}}}

Enter the spca5xx directory
{{{cd spca5xx-20051212
}}}

=== Workaround to make the Makefile use gcc-3.4 ===
The Makefile which controls the compiling process for this driver has to be told to use gcc-3.4 instead of the default version 4.0:

{{{CC=gcc-3.4
export CC
}}}

This sets the environment variable CC, which is used in the spac5xx Makefile to select the compiler.

=== Setting a link back to the source code (headers) ===

Furthermore the spca5xx Makefile expect a pointer to the kernel source at a specific location. Let's create it:
{{{ln -s /usr/src/linux-headers-`uname -r` /lib/modules/`uname -r`/build
}}}
(Note: If you compile a kernel, this link is usually there. But as we use a pre-compiled kernel, we have to cheat.)

=== Compiling the spca5xx source code ===
{{{make
}}}

There should be no errors.

=== Removing the old driver from memory ===
{{{modprobe -r spca5xx
}}}

=== Removing the old driver from the hard drive ===
{{{rm -rf /lib/modules/`uname -r`/kernel/drivers/usb/media/spca5xx*
}}}

=== Install the new driver ===
{{{make install
}}}


=== Load the new driver ===
{{{modprobe spca5xx
}}}

There should be no errors.


/!\ Remember: This process has to be repeated if a new kernel version is being installed.

----

Content: TableOfContents()

Installing spca5xx Mini-Howto

Newer Logitech Quick Cam Express Webcams and a lot of other Webcams are supported by the [http://mxhaard.free.fr/download.html spca5xx] driver, a branch of the [http://spca50x.sourceforge.net spca50x] driver. The spca5xx driver supports a wider range of cameras, but classifies itselves as experimental. (This means it might crash your kernel in the worst case.)

The spca5xx driver is in the ubuntu kernel 2.6.9-12 (type <code>uname -a</code> in a terminal to see your kernel version number). However it does not work (Oct. 22nd - ubuntu bugzilla: [http://bugzilla.ubuntu.com/show_bug.cgi?id=15809 15809] [http://bugzilla.ubuntu.com/show_bug.cgi?id=14566 14566] [https://bugzilla.ubuntu.com/show_bug.cgi?id=16727 16727]).

You can however compile it yourselves using the following steps:

Step 1: Get a compiled Kernel

See KernelBuildpackageHowto

Note: You might not need to install the kernel, but you need to compile it so the spca5xx module can be compiled. If your currently installed kernel has been compiled with the same version of gcc as you are using now, you won't need to install your kernel package. Best is to not install it now and try insmod spca5xx.o after the last step. If you get some error about the module being invalid, try installing the kernel package.

Step 2: Get spca5xx sources

Download the spca5xx driver from http://mxhaard.free.fr/download.html Unpack it into any directory:

tar -zxvf spca5xx-<version>.tar.gz

Step 3: Preparing to compile spca5xx

Link the kernel source directory from first step into the /lib/modules/ directory for that kernel (replace <arch> with your selected architecture, e.g. 386, 686 or k7):

ln -s /usr/src/linux-source-`uname -r`/debian/build/build-<arch> /lib/modules/`uname -r`/build

Step 4: Build and install spca5xx

cd spca5xx-<version>; make;

Now try if the module can be loaded:

insmod spca5xx.ko

If you see no errors, your camera should work. You can try to launch xawtv for example. To make the module load at startup, use

make install
modprobe spca5xx

dmesg could give you something like

spca5xx-20050419/drivers/usb/spca5xx.c: USB SPCA5xx camera found. Type QC Express (unknown CCD)
spca5xx-20050419/drivers/usb/spca5xx.c: [spca5xx_probe:8174] Camera type GBGR
usbcore: registered new driver spca5xx
spca5xx-20050419/drivers/usb/spca5xx.c: spca5xx driver 00.56.01 registered

Problems

If the kernel was compiled using an other version of gcc, you will get an error message complaining

FATAL: Error inserting spca5xx (spca5xx.ko): Invalid module format

Try installing the kernel you built in Step 1. (And this is the one place even linux needs a reboot)

If this does not help or you get other errors, get the last log entries typing

dmesg

To use your spca5xx-supported webcam with GnomeMeeting will require libpt-plugins-v4l. This can be installed by running:

sudo apt-get install libpt-plugins-v4l

Once installed set up GnomeMeeting with v4l (not v4l2). The video controls (brightness, contrast etc. in GnomeMeeting) do not seem to work.

The above HowTo is based on the blog entry [http://dvlinux.blogspot.com/2005_03_13_dvlinux_archive.html#111101610927602822]

spca5xx supports the following cameras (as of version spca5xx-20050419)

  {USB_DEVICE (0x0733, 0x0430)},  /* Intel PC Camera Pro */
  {USB_DEVICE (0x0733, 0x0401)},        /* Intel Create and Share */
  {USB_DEVICE (0x99FA, 0x8988)},        /* Grandtec V.cap */
  {USB_DEVICE (0x0733, 0x0402)},        /* ViewQuest M318B */
  {USB_DEVICE (0x0733, 0x0110)},        /* ViewQuest VQ110 */
  {USB_DEVICE (0x040A, 0x0002)},        /* Kodak DVC-325 */
  {USB_DEVICE (0x055f, 0xc420)},        /* Mustek gSmart Mini 2 */
  {USB_DEVICE (0x055f, 0xc520)},        /* Mustek gSmart Mini 3 */
  {USB_DEVICE (0x041E, 0x400A)},        /* Creative PC-CAM 300 */
  {USB_DEVICE (0x084D, 0x0003)},        /* D-Link DSC-350 */
  {USB_DEVICE (0x041E, 0x400B)},        /* Creative PC-CAM 600 */
  {USB_DEVICE (0x8086, 0x0630)},        /* Intel Pocket PC Camera */
  {USB_DEVICE (0x8086, 0x0110)},        /* Intel Easy PC Camera */
  {USB_DEVICE (0x0506, 0x00df)},        /* 3Com HomeConnect Lite */
  {USB_DEVICE (0x040a, 0x0300)},        /* Kodak EZ200 */
  {USB_DEVICE (0x04fc, 0x504b)},        /* Maxell MaxPocket LE 1.3 */
  {USB_DEVICE (0x08ca, 0x2008)},        /* Aiptek Mini PenCam 2 M */
  {USB_DEVICE (0x08ca, 0x0104)},        /* Aiptek PocketDVII 1.3 */
  {USB_DEVICE (0x08ca, 0x2018)},        /* Aiptek Pencam SD 2M */
  {USB_DEVICE (0x04fc, 0x504a)},        /* Aiptek Mini PenCam 1.3 */
  {USB_DEVICE (0x055f, 0xc530)},        /* Mustek Gsmart LCD 3 */
  {USB_DEVICE (0x055f, 0xc650)},        /* Mustek MDC5500Z */
  {USB_DEVICE (0x052b, 0x1513)},        /* Megapix V4 */
  {USB_DEVICE (0x08ca, 0x0103)},        /* Aiptek PocketDV */
  {USB_DEVICE (0x0af9, 0x0010)},        /* Hama USB Sightcam 100 */
  {USB_DEVICE (0x1776, 0x501c)},        /* Arowana 300K CMOS Camera */
  {USB_DEVICE (0x08ca, 0x0106)},        /* Aiptek Pocket DV3100+ */
  {USB_DEVICE (0x08ca, 0x2010)},        /* Aiptek PocketCam 3M */
  {USB_DEVICE (0x0458, 0x7004)},        /* Genius VideoCAM Express V2 */
  {USB_DEVICE (0x04fc, 0x0561)},        /* Flexcam 100 */
  {USB_DEVICE (0x055f, 0xc430)},        /* Mustek Gsmart LCD 2 */
  {USB_DEVICE (0x04fc, 0xffff)},        /* Pure DigitalDakota */
  {USB_DEVICE (0xabcd, 0xcdee)},        /* Petcam */
  {USB_DEVICE (0x04a5, 0x3008)},        /* Benq DC 1500 */
  {USB_DEVICE (0x046d, 0x0960)},        /* Logitech Inc. ClickSmart 420 */
  {USB_DEVICE (0x046d, 0x0901)},        /* Logitech Inc. ClickSmart 510 */
  {USB_DEVICE (0x04a5, 0x3003)},        /* Benq DC 1300 */
  {USB_DEVICE (0x0af9, 0x0011)},        /* Hama USB Sightcam 100 */
  {USB_DEVICE (0x055f, 0xc440)},        /* Mustek DV 3000 */
  {USB_DEVICE (0x041e, 0x4013)},        /* Creative Pccam750 */
  {USB_DEVICE (0x060b, 0xa001)},        /* Maxell Compact Pc PM3 */
  {USB_DEVICE (0x04a5, 0x300a)},        /* Benq DC3410 */
  {USB_DEVICE (0x04a5, 0x300c)},        /* Benq DC1016 */
  {USB_DEVICE (0x0461, 0x0815)},        /* Micro Innovation IC200 */
  {USB_DEVICE (0x046d, 0x0890)},        /* Logitech QuickCam traveler */
  {USB_DEVICE (0x10fd, 0x7e50)},        /* FlyCam Usb 100 */
  {USB_DEVICE (0x06e1, 0xa190)},        /* ADS Instant VCD */
  {USB_DEVICE (0x055f, 0xc220)},        /* Gsmart Mini */
  {USB_DEVICE (0x0733, 0x2211)},        /* Jenoptik jdc 21 LCD */
  {USB_DEVICE (0x046d, 0x0900)},        /* Logitech Inc. ClickSmart 310 */
  {USB_DEVICE (0x055f, 0xc360)},        /* Mustek DV4000 Mpeg4  */
 {USB_DEVICE (0x08ca, 0x2024)},        /* Aiptek DV3500 Mpeg4  */
  {USB_DEVICE (0x046d, 0x0905)},        /* Logitech ClickSmart820  */
  {USB_DEVICE (0x05da, 0x1018)},        /* Digital Dream Enigma 1.3 */
  {USB_DEVICE (0x0c45, 0x6025)},        /* Xcam Shanga */
  {USB_DEVICE (0x0733, 0x1311)},        /* Digital Dream Epsilon 1.3 */
  {USB_DEVICE (0x041e, 0x401d)},        /* Creative Webcam NX ULTRA */
  {USB_DEVICE (0x08ca, 0x2016)},        /* Aiptek PocketCam 2 Mega */
  {USB_DEVICE (0x0734, 0x043b)},        /* 3DeMon USB Capture aka */
  {USB_DEVICE (0x041E, 0x4018)},        /* Creative Webcam Vista (PD1100) */
  {USB_DEVICE (0x0546, 0x3273)},        /* Polaroid PDC2030 */
  {USB_DEVICE (0x041e, 0x401f)},        /* Creative Webcam Notebook PD1171 */
  {USB_DEVICE (0x041e, 0x4017)},        /* Creative Webcam Mobile PD1090 */
  {USB_DEVICE (0x046d, 0x08a2)},        /* Labtec Webcam Pro */
  {USB_DEVICE (0x055f, 0xd003)},        /* Mustek WCam300A */
  {USB_DEVICE (0x0458, 0x7007)},        /* Genius VideoCam V2 */
  {USB_DEVICE (0x0458, 0x700c)},        /* Genius VideoCam V3 */
  {USB_DEVICE (0x0458, 0x700f)},        /* Genius VideoCam Web V2 */
  {USB_DEVICE (0x041e, 0x401e)},        /* Creative Nx Pro */
  {USB_DEVICE (0x0c45, 0x6029)},        /* spcaCam@150 */
  {USB_DEVICE (0x0c45, 0x6009)},        /* spcaCam@120 */
  {USB_DEVICE (0x0c45, 0x600d)},        /* spcaCam@120 */
  {USB_DEVICE (0x04fc, 0x5330)},        /* Digitrex 2110 */
  {USB_DEVICE (0x055f, 0xc540)},        /* Gsmart D30 */
  {USB_DEVICE (0x0ac8, 0x301b)},        /* Asam Vimicro */
  {USB_DEVICE (0x041e, 0x403a)},        /* Creative Nx Pro 2 */
  {USB_DEVICE (0x055f, 0xc211)},        /* Kowa Bs888e Microcamera */
  {USB_DEVICE (0x0ac8, 0x0302)},        /* Z-star Vimicro zc0302 */
  {USB_DEVICE (0x0572, 0x0041)},        /* Creative Notebook cx11646 */
  {USB_DEVICE (0x08ca, 0x2022)},        /* Aiptek Slim 3200 */
  {USB_DEVICE (0x046d, 0x0921)},        /* Labtec Webcam */
  {USB_DEVICE (0x046d, 0x0920)},        /* QC Express */
  {USB_DEVICE (0x0923, 0x010f)},        /* ICM532 cams */
  {USB_DEVICE (0x055f, 0xc200)},        /* Mustek Gsmart 300 */
  {USB_DEVICE (0x0733, 0x2221)},        /* Mercury Digital Pro 3.1p */
  {USB_DEVICE (0x041e, 0x4036)},        /* Creative Live ! */
  {USB_DEVICE (0x055f, 0xc005)},        /* Mustek Wcam300A */
  {USB_DEVICE (0x041E, 0x403b)},        /* Creative Webcam Vista (VF0010) */
  {USB_DEVICE (0x0545, 0x8333)},        /* Veo Stingray */
  {USB_DEVICE (0x0545, 0x808b)},        /* Veo Stingray */
  {USB_DEVICE (0x10fd, 0x8050)},        /* Typhoon Webshot II USB 300k */
  {USB_DEVICE (0x0546, 0x3155)},        /* Polaroid PDC3070 */
  {USB_DEVICE (0x046d, 0x0928)},        /* Logitech QC Express Etch2 */
  {USB_DEVICE (0x046d, 0x092a)},        /* Logitech QC for Notebook */
  {USB_DEVICE (0x046d, 0x08a0)},        /* Logitech QC IM */
  {USB_DEVICE (0x0461, 0x0a00)},        /* MicroInnovation WebCam320 */
  {USB_DEVICE (0x08ca, 0x2028)},        /* Aiptek PocketCam4M */
  {USB_DEVICE (0x08ca, 0x2042)},        /* Aiptek PocketDV5100 */
  {USB_DEVICE (0x08ca, 0x2060)},        /* Aiptek PocketDV5300 */
  {USB_DEVICE (0x04fc, 0x5360)},        /* Sunplus Generic */
  {USB_DEVICE (0x046d, 0x08a1)},        /* Logitech QC IM 0x08A1 +sound*/
  {USB_DEVICE (0x046d, 0x08a3)},        /* Logitech QC Chat */
  {USB_DEVICE (0x046d, 0x08b9)},        /* Logitech QC IM ??? */
  {USB_DEVICE (0x046d, 0x0929)},        /* Labtec Webcam Elch2*/
  {USB_DEVICE (0x10fd, 0x0128)},        /* Typhoon Webshot II USB 300k 0x0128 */
  {USB_DEVICE (0x102c, 0x6151)},        /* Qcam Sangha CIF */
  {USB_DEVICE (0x102c, 0x6251)},        /* Qcam xxxxxx VGA */
  {USB_DEVICE (0x04fc, 0x7333)},        /* PalmPixDC85*/
  {USB_DEVICE (0x06be, 0x0800)},        /* Optimedia*/
  {USB_DEVICE (0x2899, 0x012c)},        /* Toptro Industrial*/
  {USB_DEVICE (0x06bd, 0x0404)},        /* Agfa CL20*/
  {USB_DEVICE (0x0000, 0x0000)},        /* MystFromOri Unknow Camera */

(Copied here to be found by searches for camera names...)

From ChuckShort Mon May 30 14:15:10 +0100 2005 From: Chuck Short Date: Mon, 30 May 2005 14:15:10 +0100 Subject: Spca5xx Message-ID: <20050530141510+0100@https://www.ubuntulinux.org>

Spca5xx can now be found in breezy's 2.6.12. (sudo modprobe spca5xx did work, but the cam is still not available. gqcam tells me /dev/video: No such device, maybe someone has achieved to make it work under breezy)


Installing spca5xx - alternative How-to

If you want to replace the spca5xx driver delivered with Ubuntu, this text shows you how. A compilation of the kernel is not necessary.

Warning /!\ The spca5xx module delivered with Ubuntu Breezy is buggy and needs to be replaced, if you want to use it. This bug manifests itself by crashing the system when the camera is activated.

This howto is partially based on information found in arnieboy's posting: [http://www.ubuntuforums.org/showthread.php?t=70657&page=3]

Step 1: Get the spca5xx source code

First download the current spca5xx source from Michel Xhaard's homepage and store it in your home directory. At the time of writing 20051212 is the latest version.

cd ~
wget http://mxhaard.free.fr/spca50x/Download/spca5xx-20051212.tar.gz

But check out his site for a newer version at [http://mxhaard.free.fr/download.html] BR Change any occurance of spca5xx-20051212 in this how-to to the version you have downloaded.

Step 2: Become root

For administrative task Ubuntu uses the sudo command. This will not work here. (We have to change an environment variable (see below). If we use sudo this change will be discarded when the execution of the sudo commands ends, i.e. immediately.)

So, we use this method: BR Open a terminal window and enter:

{{{sudo -s }}}

When prompted for your password, enter your user password.

The prompt should change to: {{{root@yourmachine: }}}

Step 3: Download the necessary packages

In order to compile and integrate the drivers, the following packages are needed from the Ubuntu repositories:

  1. linux-headers-`uname -r`

  2. linux-restricted-modules-`uname -r`

  3. build-essential

  4. gcc-3.4

linux-... - The construct `uname -r` will evaluate to the version of the running kernel, e.g. 2.6.12.10-k7 (may vary on your system). The "linux" packages will download the headers of your kernel and the restricted modules from the repositories.

build-essential - contains utilities for compiling source code.

gcc-3.4 - The GNU C compiler. By default Breezy installs gcc-4.0 on your system. But the current kernel is compiled with gcc-3.4. Kernel modules MUST be compiled with the same compiler version as the kernel itself, so we need the older version. BR Warning /!\ This information is valid for Breezy and may change in later versions of Ubuntu.

The command to install these packages is:

{{{apt-get install linux-headers-uname -r linux-restricted-modules-uname -r build-essential gcc-3.4 }}}

Step 4: Compiling the spca5xx source code

The linux stuff is installed under /usr/src. So I suggest, you go there:

{{{cd /usr/src }}}

and move the spca5xx source from your home directory to this location: {{{mv ~/spca5xx-20051212.tar.gz . }}}

Unpack it {{{tar xfvz spca5xx-20051212.tar.gz }}}

Enter the spca5xx directory {{{cd spca5xx-20051212 }}}

Workaround to make the Makefile use gcc-3.4

The Makefile which controls the compiling process for this driver has to be told to use gcc-3.4 instead of the default version 4.0:

{{{CC=gcc-3.4 export CC }}}

This sets the environment variable CC, which is used in the spac5xx Makefile to select the compiler.

Furthermore the spca5xx Makefile expect a pointer to the kernel source at a specific location. Let's create it: {{{ln -s /usr/src/linux-headers-uname -r /lib/modules/uname -r/build }}} (Note: If you compile a kernel, this link is usually there. But as we use a pre-compiled kernel, we have to cheat.)

Compiling the spca5xx source code

Spca5xx (last edited 2008-08-06 16:34:39 by localhost)