Manuel, 2008.0, 2008.1, logitech quickcam web et autres, installation

Un article de Wiki de la communauté Mandriva.

Jump to: navigation, search


Cette page est une ébauche. Elle mérite des améliorations.
Si vous voulez contribuer, cliquez simplement sur l'onglet modifier. Consultez également les autres pages dont le contenu est à réviser.

Sommaire

[modifier] Préambule

Ce document est valable pour d’autres caméra sauf les chapitres

  • « Le pilote qce-ga est connu pour fonctionner avec les caméras suivantes »
  • « Installation semi-automatique : technologie dkms »

Il vous suffit d’adapter les désignations à votre caméra.

En appendice vous trouverez des adresses de sites concernant d’autres caméras et un exemple d'adaptation à un autre pilote

Attention !

Il faut installer un pilote comme expliqué dans ce document que si il n’est pas intégré au noyau ou pas disponible en paquet rpm dans les sources MDV. C’est le cas pour le pilote de la Quickcam depuis le noyau 2.6.22 utilisé par la MDV 2008.0.

Il existe désormais (le 28 Avril 2008) un rpm réalisé par Guillaume Bedot inspiré de mon travail, disponible dans le dépôt de paquets "contrib/backports" pour MDV 2008.0 et 2008.1

dkms-qc-usb-0.6.6-2mdv2008.0

dkms-qc-usb-0.6.6-2mdv2008.1

à utiliser sans modération pour installer le pilote

cet article n'est utile que :

- pour vérifier que votre caméra est supportée 
- connaître les conditions requises pour installer un pilote dkms
- si un jour une version plus récente du pilote est fournie par le projet qce-ga et que le rpm n'est pas à jour

REMERCIEMENT

- Pacho Ramos qui a trouvé les patchs à appliquer au pilote pour qu'il fonctionne avec la 2008.0 et 2008.1

- Pascal Terjan qui a réalisé un patch pour que le pilote fonctionne avec la 2008.1

[modifier] Liste des caméras supportées

[modifier] Liste

Le pilote qce-ga est connu pour fonctionner avec les caméras suivantes :

  • Dexxa Webcam
  • Labtec Webcam (vieux modèle)
  • LegoCam
  • Logitech QuickCam Express (vieux modèle)
  • Logitech QuickCam Notebook (quelques modèles) Logitech QuickCam Web

Généralement toute caméra avec un ID(identifiant) de vendeur pour la catégorie de matériel USB égale à 0x46d et un ID de produit USB égale à 0x840, 0x850, ou 0x870 (comme 0x46d:0x840, par exemple), devrait fonctionner. Vous pouvez obtenir L’ID USB en utilisant la commande système lsusb dans Linux.

Attention :

  • le projet de pilote à l’origine est qce-ga et est la référence, le pilote à installer car petit à petit il intègre les améliorations des autres
  • quelque soit le pilote dans ses variations il est appelé avec la désignation générique « qc-usb »
  • le nom du module lancé sous linux suivant les projets peut être différent : quickcam, mod_quickam etc.
  • Il y a plusieurs projets quickcam qui se recouvrent ou non suivant les modèles de caméra voir l’APPENDICE
  • dans le projet qce-ga :
    • « qc-usb » reste employé et prête à confusion
    • il faut l’interpréter dans son contexte « qc-usb » signifie version « qce-ga » de « qc-usb »

[modifier] Identification d’une caméra

  • Marque et modèle du vendeur

se trouve dans la documentation de la caméra et sur la caméra

  • Marque et modèle du constructeur

Identifiant de la marque et du modèle du constructeur, résultat de la commande lsusb en tant qu'utilisateur root.

Exemple : ma souris

  • Vendeur
    • marque : Gateway
    • modèle : usb standard
  • Constructeur
    • marque : Primax Electronics, Ltd Kensington
    • modèle : mouse-in-a-box
  • ID de la marque et du modèle du constructeur : 0461:4d03
    • marque : 0461
    • modèle : 4d03

Remarque :

  • lsusb voit votre caméra qu’il y ait un pilote ou non
  • cause possible de non détection :
    • pas assez de courant sur le port usb de la caméra sous linux vous n’êtes pas prévenu comme sous Windows .Remède : essayez un autre port, débrancher un autre périphérique usb

[modifier] Installation d’un environnement de développement

[modifier] Installation des outils de compilation

Installer avec le gestionnaire de logiciel les outils de développements :

Image:Konsole.png
[root@ordi ~]# urpmi gcc make

[modifier] Installation des sources du kernel

Il n’est pas nécessaire d’installer toutes les sources du kernel (~200 Mo), on installe juste le nécessaire nécessaires pour compiler un pilote (~20 Mo).

Assurez-vous d’installer avec le gestionnaire de logiciels (Image:drakrpm-icon.png drakrpm) le paquet kernel-<variante du kernel>-devel-latest

avec <variante du kernel> = desktop, laptop ou desktop586 :

  • si Mandriva Free et PC, alors « desktop »
  • si Mandriva Free et laptop, alors « laptop »
  • si Mandriva One, alors « desktop586 »

Si vous avez un doute, entrez la commande suivante :

Image:Konsole.png
[utilisateur@ordi ~]$ uname -r

[modifier] Installation manuelle du pilote

[modifier] Installation des sources du pilote

Télécharger la dernière version des sources du pilote qc-usb

  • cliquer sur la version proposée (colonne « release ») (aujourd’hui samedi 13 octobre 2007 : version 0.6.6).

Extraire les sources

  • cliquer 2 fois sur l’archive.
  • vous êtes maintenant dans l’archive.
  • copier-coller le contenu dans un dossier.

Génération de la version binaire du pilote

  • aller dans le dossier qc-usb-<version>, dans un terminal (comme Konsole), avec la commande cd).
  • taper la commande :
Image:Konsole.png
[utilisateur@ordi ~]$ make all
  • Ceci génère des messages. A la fin de tous les messages, vérifier qu’il n’y a pas un compte-rendu d’erreur.
  • aller dans le dossier qc-usb-<version>
  • il doit y avoir un fichier quickcam.ko : c’est la version binaire du pilote appelé aussi module

Installation du pilote dans le noyau

L’installation se fait avec les outils de développement en mode root, dans le terminal :

  • aller dans le dossier qc-usb-<version>

pour cela taper la commande

Image:Konsole.png
[root@ordi ~]# cd /home/<votre nom d’utilisateur>/<chemin vers « qc-usb-<version> »>/qc-usb-<version>

puis

Image:Konsole.png
[root@ordi ~]# make install

[modifier] Vérifier l’installation

On vérifie le lancement des modules dont dépend quickcam :

  • taper la commande
Image:Konsole.png
[root@ordi ~]# modprobe quickcam

si vous avez un message d’erreur (invalid module format) et un refus d’installer vous pouvez tenter :

Image:Konsole.png
[root@ordi ~]# modprobe -f quickcam

si vous avez un message d’erreur (Module quickcam not found), il est possible que le module porte un autre nom, par exemple quickcam-messenger, vous pouvez alors tenter :

Image:Konsole.png
[root@ordi ~]# modprobe quickcam-messenger

Les modules suivants doivent être en route :

  • quickcam
  • usbcore
  • videodev
  • v4l1-compat (ce peut être un nom voisin)
  • v4l2-common (ce peut être un nom voisin)

car

  • quickam provoque le lancement de usbcore et videodev
  • videodev provoque le lancement de v4l1-compat et v4l2-common

taper la commande lsmod pour vérifier.

si ce n’est pas le cas taper la commande suivante pour installer le module manquant :

Image:Konsole.png
[root@ordi ~]# modprobe <nom du module>

Vérification avec une application

Par exemple lancer Kopete, puis

  • aller dans configuration -> configurer -> périphériques
  • sauter de joie :)

Installation pour un démarrage automatique du module

Il n’y a rien à faire, le système se débrouille pour détecter la caméra et charger le module « quickcam ».

Désinstallation du pilote

  • En tant que root :
Image:Konsole.png
[root@ordi ~]# rmmod quickcam
  • En tant que root supprimer le fichier /lib/modules/<votre kernel>/misc/quickcam.ko

Changement de noyau

Avec la méthode ci-dessus, il faut tout recommencer :(

[modifier] Installation semi-automatique : technologie dkms

[modifier] 3.2.1. Avantage

Cette technologie permet la génération automatique au démarrage avec un nouveau noyau et de basculer d’un noyau à l’autre.

[modifier] 3.2.2. Méthode

3.2.2.1. En tant que root

Extraire l’archive qc-usb-0.6.6-3mdv.tar.gz dans /usr/src

vous la trouvez ici https://qa.mandriva.com/show_bug.cgi?id=33478

en bas de la page web dans le cadre « attachements »

l’extraction crée un dossier « qc-usb-0.6.6-3mdv » dans /usr/src

3.2.2.2. En tant que root ouvrir une console en mode texte dans /usr/src

  • Ajouter dans l’environment dkms le module en tapant
Image:Konsole.png
[root@ordi ~]# dkms add -m qc-usb -v 0.6.6-3mdv

Vérifier bien qu’il n’y a pas de message d’erreur

  • Construire la version binaire du pilote
Image:Konsole.png
[root@ordi ~]# dkms build -m qc-usb -v 0.6.6-3mdv

Vérifier bien qu’il n’y a pas de message d’erreur

  • Installer la version binaire du pilote dans le noyau
Image:Konsole.png
[root@ordi ~]# dkms install -m qc-usb -v 0.6.6-3mdv

Vérifier bien qu’il n’y a pas de message d’erreur

3.2.2.3. Redémarrer le pc

Le système va lancer le pilote s’il détecte la caméra.

remarque :

  • il peut être nécessaire de redémarrer une seconde fois le PC pour que le système lance le pilote
  • il peut-être nécessaire(2008.1) de mettre l'utilisateur courant dans le groupe "video"
  • si vous basculez vers un nouveau noyau
    • durant le démarrage la version binaire du module(pilote) est construite puis installée puis lancée.
    • il peut être nécessaire de lancer une deuxième fois le PC pour que le système lance le pilote

3.2.2.4. Vérifier l’installation

Voir au chapitre « Installation manuelle » le chapitre « Vérifier l’installation »

[modifier] 3.2.3. Désinstaller le pilote selon la technologie dkms

En tant que root

  • soit pour désinstaller le pilote dans tous les noyaux
Image:Konsole.png
[root@ordi ~]# dkms remove -m qc-usb -v 0.6.6-3mdv --all
  • soit pour désinstaller le pilote dans un noyau

taper la commande

Image:Konsole.png
[root@ordi ~]# dkms remove -m qc-usb -v 0.6.6-3mdv -k <nom du kernel>

<nom du kernel> est le résultat de la commande uname -r en tant que root

  • soit pour désinstaller le pilote dans le noyau courant taper la commande
Image:Konsole.png
[root@ordi ~]# dkms remove -m qc-usb -v 0.6.6-3mdv

puis supprimer le dossier /usr/src/qc-usb-0.6.6-3mdv

[modifier] Le micro de la camera

Pour la Logitech Quickcam Web 046b 0850

il n’y a rien à faire :

  • il est détecté et mis en oeuvre par le pilote snd_usb_audio
  • il fonctionne

[modifier] Exemples d'adaptation de la méthode à un autre pilote

adaptation au pilote ov51x-jpeg

[modifier] Exemple 1

*********************************************************

3.1.1.1 Télécharger la dernière version des sources du pilote qc-usb

aller à

http://sourceforge.net/project/showfiles.php?group_id=12924

cliquer sur la version proposée (colonne « release »)

aujourd’hui samedi 13 octobre 2007 : version 0.6.6

***********************************************************


donne

*************************************************************

3.1.1.1 Télécharger la dernière version des sources du pilote ov51x-jpeg

aller à

http://www.rastageeks.org/downloads/ov51x-jpeg/ov51x-jpeg-1.5.7.tar.gz

****************************************************************


[modifier] Exemple 2

***********************************

aller dans le dossier « qc-usb-<version> »

****************************************


donne

*****************************************

aller dans le dossier « ov51x-jpeg-<version> »

*******************************************


la version peut varier dans le temps aujourd'hui

<version> ::= 1.5.7


[modifier] Exemple 3

*************************************************************

cd /home/<votre nom d’utilisateur>/<chemin vers « qc-usb-<version> »>/qc-usb-<version>

**************************************************************


donne


*************************************************************

cd /home/<votre nom d’utilisateur>/<chemin vers « ov51x-jpeg-<version> »>/ov51x-jpeg-<version>

*************************************************************


la version peut varier dans le temps aujourd'hui

<version> ::= 1.5.7


dans ce cas et aujourd'hui

si l'identifiant qui vous a servi à ouvrir votre session kde

(<=> nom d'utilisateur) est "toto" et vous avez téléchargé l'archive du pilote et vous l'avez décompressé dans "Téléchargement"


cd /home/toto/Téléchargement/ov51x-jpeg-1.5.7


[modifier] Exemple 4

***************************************************

modprobe quickcam

***************************************************


donne

****************************************************

modprobe ov51x-jpeg

**************************************************


[modifier] Liens utiles

Le site logitech à propos des webcams sous linux (à lire absolument !).

Un site généraliste qui répertorie le matériel incompatible avec Linux(attention contient des infos qui peuvent-être obsolètes).

Documentation générale sur les webcams

Projets Quickcam(et cameras utilisant le même circuit)

Projet uvc (enfin une norme pour les caméras !)

  • pilote intégré au noyau
  • http://linux-uvc.berlios.de/
  • supporte certaines logitech dont des quickcam !
  • documentation logitech à propos de problèmes avec les quickcam et uvc

http://www.quickcamteam.net/documentation/faq/logitech-webcam-linux-usb-incompatibilities

Projet Omnivision ov511 ov51x

  • pilote intégré au noyau

Projet Omnivision ov51x-jpeg avec fonction image jpeg

Projet sqcam

Projet Syntek

Des pilotes tout prêts :

n’hésitez pas à fouiller