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

De Wiki de la communauté Mandriva.

[Manuel]2008.[0|1] logitech quickcam web+autres installation

0. Préambule

0.1. 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.

0.2. 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 .

1. Liste des caméras supportées

1.1. 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 »

1.2. 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

résultat de la commande « lsusb » en tant qu’administrateur (=superutilisateur = root) Identifiant de la marque et du modèle du constructeur résultat de la commande « lsusb » en tant qu’administrateur (=superutilisateur = 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

2. Installation d’un environnement de développement

2. 1 Installation des outils de compilation

2.1.1. Soit à l’installation de Mandriva

choisir l’option « ...détaillé... »

puis

sélectionner « ....développement... »

Vous avez ainsi un environnement de développement complet du point de vue des outils vous avez le nécessaire pour installer des logiciels à partir de leur sources.

Je recommande d’installer systématiquement l’environnement de développement car tôt ou tard vous aurez besoin d’installer un logiciel à partir de ses sources.

2.1.2. Soit après l'installation de Mandriva

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

  • gcc
  • make

2.2. Installation des sources du kernel juste nécessaires pour compiler un pilote (~20 Mo)

Il n’est pas nécessaire d’installer toutes les sources du kernel(~200 Mo).

Assurez-vous d’installer kernel-<variante du kernel>-devel-latest<suffixe>

<variante du kernel> ::= [desktop|laptop|desktop586]

si MDV Free et PC alors « desktop »

si MDV Free et laptop alors « laptop »

si MDV One alors « desktop586 »

3. Installation du pilote

3.1. Installation manuelle

3.1.1. Installation des sources du pilote

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

3.1.1.2 Extraire les sources

cliquer 2 fois sur l’archive

vous êtes dans l’archive

copier-coller le contenu dans un dossier

3.1.1.3. Génération de la version binaire du pilote

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

cliquer avec le bouton droit dans une zone vide

puis

« actions »

puis

« ouvrir un terminal ici »

puis

dans le terminal

taper la commande

make all

Ceci génères 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

3.1.1.4. Installation du pilote dans le noyau

L’installation se fait avec les outils de développement

L’installation se fait avec les droits de l’administrateur(=superutilisateur=root)

dans le terminal

dans le menu « session »

sélectionner « nouveau shell superutilisateur »

donner le mot de passe (attention quand vous le tapez rien ne se passe, c’est normal) puis

touche « entrée »

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

pour cela taper la commande

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

puis

taper la commande

make install

3.1.1.5 Vérifier l’installation

3.1.1.5.1 Vérifier le lancement des modules dont dépend quickcam

taper la commande

modprobe quickcam

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

modprobe -f quickcam

3.1.1.5.2 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 suivante pour vérifier

lsmod

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

modprobe <nom du module>

3.1.1.5.3. Vérification avec une application

Par exemple lancer kopete

puis

aller dans le menu « configuration »

puis

le menu « configurer »

puis

« périphériques »

puis

sauter de joie :)

3.1.1.6. 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 »

3.1.1.7. Désinstallation du pilote

3.1.1.7.1. En tant que root

dans une console texte

taper la commande

rmmod quickcam

3.1.1.7.2. En tant que root supprimer le fichier /lib/modules/<votre kernel>/misc/quickcam.ko

3.1.1.8. Changement de noyau

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

3.2. 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-2mdv.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-2mdv » 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

dkms add -m qc-usb -v 0.6.6-2mdv

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

  • construire la version binaire du pilote

dkms build -m qc-usb -v 0.6.6-2mdv

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

  • installer la version binaire du pilote dans le noyau

dkms install -m qc-usb -v 0.6.6-2mdv

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
  • 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

ouvrir une console texte

puis

  • soit pour désinstaller le pilote dans tous les noyaux

taper la commande

dksm remove -m qc-usb -v 0.6.6-2mdv --all

  • soit pour désinstaller le pilote dans un noyau

taper la commande

dksm remove -m qc-usb -v 0.6.6-2mdv -k <nom du kernel>

<nom du kernel> ::= résultat de la commande « uname -r » en tant que root

  • soit pour désinstaller le pilote dans le noyau courant taper la commande

dksm remove -m qc-usb -v 0.6.6-2mdv

puis

supprimer le dossier /usr/src/qc-usb-0.6.6-2mdv

4. 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


APPENDICE

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