Service de caméra GoCam

GoCam est le service de caméra ajouté dans la version bêta FLYOS-FAST v1.4.0. Il est compatible avec les caméras USB sans pilote prenant en charge le protocole UVC. Il fournit un flux vidéo en temps réel, des instantanés mono-image et une page de gestion des paramètres de la caméra.

Limites de la version bêta

GoCam n'est actuellement confirmé que dans l'image bêta FLYOS-FAST v1.4.0. Pour la version stable v1.3.10 et les images de plateformes ne contenant pas GoCam, veuillez utiliser Crowsnest.

Activation de GoCam

GoCam et Crowsnest doivent être utilisés de manière exclusive. Si les deux sont réglés sur 1, le système démarrera Crowsnest en priorité et GoCam ne sera pas actif.

Dans FlyOS-Conf/config.txt, configurez :

crowsnest=0
gocam=1

Après avoir enregistré, redémarrez l'ordinateur hôte. Pour les instructions de modification du fichier de configuration, veuillez vous référer au Guide de configuration système FLYOS-FAST.

Opération hors tension

Avant de connecter ou de remplacer une caméra pour la première fois, éteignez complètement l'imprimante et débranchez l'alimentation. Ne débranchez pas les câbles de la caméra ou ne réorganisez pas les interfaces lorsque l'appareil est sous tension.

Connectez une caméra USB sans pilote prenant en charge UVC au port USB de l'ordinateur hôte, puis remettez l'appareil sous tension.

Ouverture de la page de gestion GoCam

GoCam utilise par défaut le port 8080. Dans le même réseau local que l'ordinateur hôte, accédez à :

http://IP_de_l'appareil:8080

La page de gestion offre les fonctionnalités suivantes :

• Visualisation en temps réel du flux de la caméra.
• Consultation des formats, résolutions et taux d'images pris en charge par la caméra.
• Copie des adresses du flux vidéo et des instantanés.
• Ajustement des paramètres UVC réellement pris en charge par la caméra.

Les paramètres exposés varient selon la caméra ; la page n'affiche que les éléments pris en charge et modifiables de la caméra actuelle, tels que la luminosité, la fréquence du secteur, la mise au point ou l'exposition. Les modifications sont appliquées immédiatement à la caméra ; après avoir confirmé l'effet, cliquez sur Sauvegarder dans la configuration pour conserver le réglage après le redémarrage du service.

Adresses du flux vidéo et des instantanés

Usage	Adresse recommandée
Flux vidéo en temps réel	http://IP_de_l'appareil:8080/?action=stream
Instantané mono-image	http://IP_de_l'appareil:8080/snapshot
Instantané local de l'ordinateur hôte	http://localhost:8080/snapshot

GoCam est également compatible avec les adresses /stream, /?action=snapshot et /webcam/?action=.... Pour les nouvelles configurations, privilégiez les adresses du tableau ci-dessus afin d'éviter les problèmes de compatibilité des plugins liés à l'utilisation des chemins d'autres services de caméra.

Configuration de la photographie en accéléré

En mode GoCam, l'adresse de l'instantané pour la photographie en accéléré dans moonraker.conf doit être définie comme suit :

[timelapse]
output_path: /usr/share/printer_data/timelapse/
snapshoturl: http://localhost:8080/snapshot
frame_path: /tmp/timelapse

Après modification, redémarrez Moonraker. Pour les opérations complètes, veuillez vous référer à la fonction de photographie en accéléré.

Vérification du chemin de l'instantané

Si la photographie en accéléré ne génère pas d'images, vérifiez d'abord snapshoturl. GoCam recommande d'utiliser directement /snapshot ; ne conservez pas l'ancienne adresse d'instantané de Crowsnest sans validation.

Fichier de configuration

La configuration du service GoCam se trouve dans :

/usr/share/printer_data/config/gocam.conf

La configuration de référence par défaut est la suivante :

[cam 1]
port: 8080
device: /dev/video1
resolution: 1920x1080
max_fps: 30
quality: 5
# v4l2ctl: focus_automatic_continuous=0,focus_absolute=70
# ffmpeg_flags: -fflags nobuffer -flags low_delay

Paramètre	Valeur par défaut de l'image v1.4.0	Description
port	8080	Port du service de la caméra actuelle
device	/dev/video1	Nœud de périphérique de la caméra ; privilégier les chemins fixes sous /dev/v4l/by-id/...
resolution	1920x1080	Résolution réellement prise en charge par la caméra
max_fps	30	Taux d'images maximal
quality	5	Qualité MJPEG, plage de valeurs de 1 à 31
v4l2ctl	Non défini	Paramètres UVC optionnels ; les paramètres enregistrés depuis la page de gestion y sont écrits
ffmpeg_flags	Non défini	Paramètres FFmpeg optionnels

Vérification de l'état et dépannage

Exécutez via SSH :

systemctl status gocam --no-pager

Consultez les journaux récents du service :

tail -n 100 /usr/share/printer_data/logs/gocam.log

Problèmes courants :

• Page inaccessible : Vérifiez que gocam=1, crowsnest=0, et vérifiez si le port 8080 est occupé par un autre service.
• Page affiche aucun signal : Vérifiez que device pointe vers la caméra actuelle et confirmez que la résolution et le taux d'images sont pris en charge par la caméra.
• Paramètres perdus après redémarrage : Après un ajustement en temps réel, cliquez également sur Sauvegarder dans la configuration.
• Pas d'images en photographie en accéléré : Modifiez snapshoturl en http://localhost:8080/snapshot, puis redémarrez Moonraker.