Webcam à base de chipset Syntek

Sont regroupées ici, les informations sur les webcams à base de chipset Syntek (rien à voir avec la convention collective des métiers de l'informatique nommée Syntec).

De nombreux portables Asus et Packard Bell intègrent une webcam de ce type. Pour savoir si vous êtes dans ce cas, faites un lsusb et cherchez un périphérique dont l'identifiant commence par 05e1:???? (Syntek Semiconductor Co., Ltd) ou 174f:???? (Syntek Semicon.), comme ci-dessous:

$ sudo update-usbids

$ lsusb
Bus 005 Device 002: ID 05e1:0501 Syntek Semiconductor Co., Ltd
Bus 005 Device 001: ID 0000:0000
...

Vérifiez si l'ID (Vendor:Product) est parmi les suivantes (première colonne du tableau) :

Il y a plusieurs pilotes:

• stk-webcam: inclus au Kernel depuis 2.6.27/Intrepid mais ne supporte que le modèle 174F:A311
• stk11xx: téléchargeable sur http://syntekdriver.sourceforge.net
  • Version 1.4 (et antérieures) pour les Kernel 2.6.20/Feisty à 2.6.28/Jaunty
  • Version 2.0 (et trunk SVN) pour les Kernel 2.6.29 et suivants

Ce qui suit ne s'intéresse qu'au pilote stk11xx.

• Une webcam Syntek !
• Les entêtes du noyau Linux : pour être sûr tapez dans un terminal:

sudo apt-get install linux-headers-`uname -r`

• Les outils classiques pour compiler : Installer le paquet build-essential
• Eventuellement SVN pour récupérer la toute dernière version : Installer le paquet subversion

Tentative d'installation sur Ubuntu 12.04 LTS 64 bits :

• La procédure d'installation pour la version 2 semble ne pas fonctionner : Message d'erreur stk11xx-v4l.c:1737: error: unknown field ‘compat_ioctl’ specified in initializer. Finalement, il a fallu supprimer, à la fin de “stk11xx-v4l.c” afin que la compilation fonctionne (voir http://forum.ubuntu-fr.org/viewtopic.php?id=433068) :

#ifdef CONFIG_COMPAT
  .compat_ioctl = v4l_compat_ioctl32,
#endif

• Certains sites indiquent que le pilote ne fonctionne pas en 64 bits (y compris LaunchPad, depuis 8.04).
• La procédure pour la version 1 compile correctement et met en place le périphérique.
• Pour démarrer la caméra et l'utiliser sous vlc, je dois d'abord lancer gstreamer-properties et faire un test via l'onglet video avant de pouvoir ouvrir le périphérique de capture sous vlc.
• Attention à bien mettre les droits “Peut utiliser des périphériques vidéo” à l'utilisateur (sinon il n'est pas possible d'accéder à la WebCam).

Préalable à l'installation :

1- Vérifiez que le fichier video existe dans dev (raccourcis/poste de travail/système de fichiers/dev)

2- Si ce fichier n'existe pas, le créer en allant dans ce tuto : http://doc.ubuntu-fr.org/webcam?s[]=logiciel&s[]=webcam

Maintenant on peut passer à l'installation de la webcam.

Installation

1. Télécharger et extraire ce fichier.

2. Compiler et installer le pilote

$ make -f Makefile-syntekdriver

$ sudo make -f Makefile-syntekdriver install

3. Blacklister et décharger stk-webcam sur Intrepid et suivants

lsmod | grep stk-webcam
rmmod stk-webcam (si à ce stade il y a "erreur" d'écrit, ne vous en faites pas et continuez votre installation)
lsmod | grep stk-webcam

4. Charger le pilote et vérifier qu'il fonctionne:

$ sudo modprobe stk11xx

$ dmesg |tail
stk11xx: Syntek USB2.0 webcam driver startup
stk11xx: Syntek USB2.0 - STK-1135 based webcam found.
stk11xx: Syntek AVStream USB2.0 1.3M WebCam - Product ID 0xA311.
stk11xx: Release: 0005
stk11xx: Number of interfaces : 1
stk11xx: Initialize USB2.0 Syntek Camera
stk11xx: Syntek USB2.0 Camera is ready
stk11xx: Syntek USB2.0 Camera is now controlling video device /dev/video0
usbcore: registered new interface driver usb_stk11xx_driver
stk11xx: v1.3.0 : Syntek USB Video Camera

$ sudo lsusb -v|grep -A 8 Syntek
Bus 005 Device 002: ID 05e1:0501 Syntek Semiconductor Co., Ltd
Device Descriptor:
  bLength                18
  bDescriptorType         1
  bcdUSB               2.00
  bDeviceClass            0 (Defined at Interface level)
  bDeviceSubClass         0
  bDeviceProtocol         0
  bMaxPacketSize0        64
  idVendor           0x05e1 Syntek Semiconductor Co., Ltd
  idProduct          0x0501
  bcdDevice            0.05
  iManufacturer           1 Syntek Semiconductor
  iProduct                2 USB 2.0 Image Capture Controller
  iSerial                 0
  bNumConfigurations      1
  Configuration Descriptor:
    bLength                 9
    bDescriptorType         2
    wTotalLength          147
    bNumInterfaces          1

Télécharger les dernières sources (actuellement stk11xx-2.1.0.tar.gz)

$ sudo apt-get install exuberant-ctags
$ tar xvf stk11xx-2.1.0.tar.gz
$ cd stk11xx-2.1.0
$ make -f Makefile.standalone
$ sudo insmod stk11xx.ko

Si tout ce passe bien la webcam s'allume, pour la tester sous vlc:

$ vlc v4l2:///dev/video0 --noaudio

Remarque : si ça ne marche pas avec Camorama (a essayer en premier, voir ce qui suit), installer le Paquet Cheese et essayez. En effet, certaines webcam ne fonctionnent pas avec tous les logiciels prévus pour.

Pour Camorama (V4L), il y a 2 méthodes Map (par défaut) et Read (option -R), si les couleurs ne sont pas bonnes, il suffit de cliquer droit sur le panneau « Effects » (faire Ctrl + E si celui-ci n'apparaît pas) et de sélectionner « Add filter » puis « Color correction »:

$ camorama -D --width=640 --height=480 

$ camorama -D -R --width=640 --height=480 

Pour XawTV (V4L2), l'option -nodga est nécessaire:

$ xawtv -nodga

Pour VLC (V4L):

$ vlc v4l://dev/video0 --noaudio

Pour MPlayer/MEncoder (V4L et V4L2):

$ mplayer tv:// -tv driver=v4l:width=640:height=480
$ mplayer tv:// -tv driver=v4l2:width=320:height=240:fps=25:outfmt=rgb24:device=/dev/video0
$ mplayer tv:// -tv driver=v4l2:width=320:height=240:fps=25:outfmt=yuy2:device=/dev/video0
$ mplayer tv:// -tv driver=v4l2:width=320:height=240:fps=25:outfmt=uyvy:device=/dev/video0

$ mencoder tv:// -tv driver=v4l:width=640:height=480:outfmt=rgb24:device=/dev/video0 -nosound -ovc lavc -o out.avi
$ mencoder tv:// -tv driver=v4l2:width=320:height=240:fps=25:outfmt=rgb24:device=/dev/video0 -nosound -ovc lavc -o out.avi

Vous avez la tête à l'envers ou le teint bleuâtre, vous pouvez configurer la webcam.

Soit en passant des options au chargement du pilote :

$ sudo insmod stk11xx.ko vflip=1 brightness=0xBBBB

Ou bien, ce qui revient au même, en ajoutant dans le fichier /etc/modprobe.d/options:

# Syntek Webcam
options stk11xx vflip=1 brightness=0xBBBB

Soit en utilisant les “variables système” qui se trouvent dans /sys/class/video4linux/video0 après le chargement du module:

$ cat /sys/class/video4linux/video0/vflip 

$ echo 1 >/sys/class/video4linux/video0/vflip

La liste des paramètres

• Pour signaler un problème, une découverte: voir dans le forum SourceForge
• Pour aider les développeurs du pilote : Help us
• Le site du constructeur Syntek Semi-conducteurs
• Si vous possédez une webcam montée sur pivot, il est possible de retourner l'image automatiquement; voir Rotational Camera (en anglais).

Contributeurs: Créée par SgtGarcia (a.k.a sgt_garcia), modifié par Fabien26.