Manuel, 2008.0, 2008.1, logitech quickcam web et autres, installation
De Wiki de la communauté Mandriva.
Sommaire |
Préambule
Ce document est valable pour d’autres caméras 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
Il ne faut installer un pilote comme expliqué dans ce document que s'il n’est pas intégré au noyau ou pas disponible en paquet rpm dans les sources MDV.
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
Liste des caméras supportées
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 »
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
Installation d’un environnement de développement
Installation des outils de compilation
Installer avec le gestionnaire de logiciel les outils de développements :
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 (
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 :
Installation manuelle du pilote
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 :
- 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
puis
Vérifier l’installation
On vérifie le lancement des modules dont dépend quickcam :
- taper la commande
si vous avez un message d’erreur (invalid module format) et un refus d’installer vous pouvez tenter :
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 :
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 :
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 :
- 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 :(
Installation semi-automatique : technologie dkms
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.
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
Vérifier bien qu’il n’y a pas de message d’erreur
- Construire la version binaire du pilote
Vérifier bien qu’il n’y a pas de message d’erreur
- Installer la version binaire du pilote dans le noyau
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 »
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
- soit pour désinstaller le pilote dans un noyau
taper la commande
<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
puis supprimer le dossier /usr/src/qc-usb-0.6.6-3mdv
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
Exemples d'adaptation de la méthode à un autre pilote
adaptation au pilote ov51x-jpeg
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
****************************************************************
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
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
Exemple 4
***************************************************
modprobe quickcam
***************************************************
donne
****************************************************
modprobe ov51x-jpeg
**************************************************
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)
- http://qce-ga.sourceforge.net/
- http://tuukkat.awardspace.com/quickcam/quickcam.html
- http://home.mag.cx/messenger/
- http://www.informatik.uni-oldenburg.de/~delwi/quickcam/
- http://www.cs.cornell.edu/~reynolds/quickcam/
- http://mxhaard.free.fr/spca5xx.html
- http://linuxtv.org/hg/~mchehab/gspca/
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
- pour les caméra à base de chipset sq905
- http://sqcam.sourceforge.net/
Projet Syntek
- Syntek DC-1125 Camera Driver Project
- Our target 174f:a311 (and 174f:a821 and 05E1:0501) – Syntek semicon USB 2.0 Video
- pilote dkms ici http://www.mde.djura.org/2008.0/RPMS/
Des pilotes tout prêts :
n’hésitez pas à fouiller
