Questions fréquentes et dépannage FLYOS-FAST

Cette page regroupe les limitations du système, chemins de configuration, méthodes de mise à jour et pannes courantes de FLYOS-FAST. Les procédures complètes pour chaque fonction sont accessibles via des liens vers les documents correspondants, afin d'éviter la duplication dans cette FAQ.

Ordre de dépannage recommandé

1. Enregistrez le message d'erreur complet affiché sur la page web ou le terminal, ne vous contentez pas de la dernière ligne.
2. Identifiez les modifications de configuration, plugins ou options système effectuées avant l'apparition du problème.
3. Vérifiez l'espace disque, l'état des services et les journaux correspondants.
4. Si un redémarrage du service ou de l'unité de contrôle est nécessaire, assurez-vous d'abord qu'aucune impression, mise en chauffe ou mouvement n'est en cours sur l'imprimante.

Système et comptes

Pourquoi ne puis-je utiliser que l'utilisateur root ?

FLYOS-FAST est un système allégé conçu pour les dispositifs de contrôle d'impression, géré en mode mono-utilisateur. root est le seul compte administratif interactif. Le système ne prend pas en charge la création de comptes ou le changement d'utilisateur.

Pourquoi ne puis-je pas utiliser apt ou dpkg ?

FLYOS-FAST ne fournit pas d'environnement de gestion de paquets comme les distributions Linux traditionnelles. Par conséquent, les commandes suivantes ne peuvent pas être utilisées pour installer ou mettre à jour des logiciels :

apt update
apt install
dpkg -i

Ne copiez pas de paquets ou de bibliothèques système depuis d'autres systèmes Linux. Les dépendances supplémentaires doivent être fournies explicitement par les tutoriels d'installation des plugins ; si une dépendance générique manque, veuillez contacter le support technique.

Pourquoi le répertoire système est-il en lecture seule ?

Le système principal utilise un système de fichiers en lecture seule, mis à jour de manière unifiée via une image complète ou une OTA. Ne tentez pas de remonter la racine et de modifier directement les fichiers système, cela pourrait provoquer des échecs de mise à jour ou une perte des modifications après redémarrage.

Les configurations utilisateur, plugins et données d'impression doivent être conservés dans les répertoires persistants.

Fichiers et configuration

Où sont enregistrés les fichiers courants ?

Contenu	Chemin en mode Klipper	Description
Configuration de l'imprimante	/usr/share/printer_data/config/	Contient printer.cfg, la configuration Moonraker et caméra
Fichiers G-code	/usr/share/printer_data/gcodes/	Point d'entrée des fichiers téléversés via le web ou imprimés depuis une clé USB
Journaux d'exécution	/usr/share/printer_data/logs/	Journaux Klipper, Moonraker, écran et caméra
Plugins et sources	/data/	Les plugins personnalisés doivent être placés ici
Source Klipper	/data/klipper/	Répertoire Klipper préinstallé
Fichiers compilés	/data/klipper/out/	Répertoire de sortie après compilation du firmware

Le répertoire de données en mode RRF est /opt/dsf/. Ne mélangez pas les chemins de configuration de Klipper et de RRF.

Quels répertoires sont persistants ?

Le système conserve /etc, /data, /root, ainsi que le répertoire de données du mode d'impression actuel. Même si ces répertoires sont conservés, il est toujours recommandé de sauvegarder séparément la configuration de l'imprimante avant une OTA ou une nouvelle gravure.

Comment modifier la configuration système de FLYOS-FAST ?

Le modèle système, le réseau, l'écran et les interrupteurs de services sont gérés dans FlyOS-Conf/config.txt. Après le démarrage, ils peuvent également être modifiés via sys-config.conf dans .flyos-config sur la page web.

Méthode de configuration et champ d'application : Consultez le guide de configuration système FLYOS-FAST

Pourquoi les modifications de configuration ne sont-elles pas appliquées ?

Différentes configurations nécessitent différentes opérations pour être appliquées :

Modification	Opération pour appliquer
printer.cfg et extraits de configuration Klipper	Cliquez sur Enregistrer et redémarrer dans la page web
moonraker.conf	Redémarrez Moonraker
config.txt ou sys-config.conf	Redémarrez toute l'unité de contrôle
Sources de plugins ou liens symboliques	Redémarrez le service correspondant selon le tutoriel du plugin

Si la modification n'est toujours pas appliquée après redémarrage, vérifiez que le fichier a été enregistré, que l'option n'est pas définie en double, et consultez les journaux du service correspondant.

Mises à jour système et firmware

Comment mettre à jour le système ?

FLYOS-FAST doit être mis à jour via l'OTA système ou en re-gravant l'image officielle correspondant à l'appareil. N'utilisez pas de scripts de mise à jour tiers pour remplacer les fichiers principaux.

Mise à jour en ligne et via clé USB : Consultez le guide de mise à jour OTA

Re-gravure du système : Consultez le tutoriel de gravure d'image système

L'OTA supprime-t-elle la configuration de l'imprimante ?

Une OTA normale conserve /data et les répertoires de données d'impression, mais les situations suivantes peuvent encore entraîner des anomalies de configuration :

• L'utilisateur a remplacé Klipper, Moonraker ou d'autres composants préinstallés.
• Des fichiers personnalisés masquent les nouveaux fichiers fournis par l'OTA.
• Coupure d'alimentation pendant la mise à jour.
• Espace disque insuffisant ou système de fichiers déjà corrompu avant la mise à jour.

Avant la mise à jour, téléchargez ou copiez une sauvegarde de printer_data/config. Maintenez une alimentation stable pendant la mise à jour et le redémarrage, et ne lancez pas d'impression.

Puis-je mettre à jour Klipper ou Moonraker séparément ?

Ce n'est pas recommandé. Klipper, Moonraker, l'interface web et les services d'écran du système ont été adaptés ensemble. Remplacer un seul composant peut casser les chemins, interfaces d'extension ou mécanismes de mise à jour. Utilisez la méthode de mise à jour globale fournie par le système.

Que faire en cas d'incompatibilité de version MCU après l'OTA ?

L'OTA ne prend en charge que la mise à jour automatique du firmware USB des cartes mères FLY-C8, FLY-C5, FLY-C8P et FLY-GEMINI V3. Les autres cartes mères, firmwares CAN, cartes d'outillage et autres MCU externes ne prennent pas en charge la mise à jour automatique ; une gravure manuelle est nécessaire selon le tutoriel du produit correspondant.

Portée de la mise à jour automatique et méthode de vérification : Consultez les instructions de mise à jour du firmware MCU après OTA

Où trouver les fichiers après compilation du firmware ?

Les fichiers compilés se trouvent dans :

/data/klipper/out/

Le fichier réel peut être klipper.bin ou klipper.uf2, selon l'architecture du MCU et la configuration du bootloader.

Instructions de compilation du firmware : Consultez le tutoriel de compilation du firmware Klipper

Plugins et environnement Python

Pourquoi ne trouve-t-on pas ~/klippy-env/bin/python ?

FLYOS-FAST utilise le Python système, pas l'environnement virtuel klippy-env courant. Remplacez l'interpréteur Python et le chemin Klipper par les chemins système réels. Par exemple, pour interroger le CAN UUID :

python /data/klipper/scripts/canbus_query.py can0

Ne remplacez pas seulement la commande Python tout en conservant le chemin ~/klipper/ incorrect.

Où installer les plugins ?

Les dépôts de plugins sont placés dans /data/. Pour ajouter des fichiers d'extension à Klipper, privilégiez les liens symboliques, et vérifiez d'abord les noms de fichiers et dépendances requis par le tutoriel du plugin. Ne copiez pas en masse tout le répertoire du plugin dans Klipper.

Règles d'installation et tutoriels de plugins existants : Consultez les instructions d'installation des plugins

Que faire si un plugin n'est pas effectif après installation ?

Vérifiez dans l'ordre :

1. Si l'étape de téléchargement réseau s'est déroulée complètement.

2. Si le fichier du plugin existe réellement dans /data/.

3. Si le lien symbolique pointe vers le bon fichier :

   readlink -f /data/klipper/klippy/extras/fichier_plugin.py

4. Si printer.cfg charge bien la configuration du plugin.

5. Si le journal Klipper contient des erreurs de modules, dépendances ou options manquants.

Ne supprimez pas les configurations de sécurité ni ne désactivez les protections de température, de fin de course ou de chauffe de Klipper pour contourner les erreurs.

Web et réseau

Quelles sont les différentes entrées web ?

Fonction	Adresse	Conditions d'utilisation
Fluidd ou Mainsail	http://IP_appareil/	Mode Klipper démarré correctement
Page de gestion OTA	http://IP_appareil:9998/	Réseau de l'unité de contrôle normal
Page de gestion GoCam	http://IP_appareil:8080/	GoCam activé

Pourquoi ne puis-je pas accéder à IP_appareil:9999 ?

FLYOS-FAST ne fournit pas le service web fly-tools par défaut, donc l'absence de réponse sur le port 9999 est normale. Les opérations de configuration système et de firmware doivent être effectuées via la documentation FLYOS-FAST et les commandes SSH correspondantes.

Comment vérifier si la page web principale est inaccessible ?

1. Vérifiez que l'ordinateur et l'unité de contrôle sont sur le même réseau local.

2. Vérifiez l'adresse de l'appareil dans le routeur pour éviter de continuer à utiliser une ancienne IP modifiée.

3. Vérifiez l'adresse réseau actuelle via SSH :

   ip -br addr

4. Vérifiez les services ayant échoué au démarrage :

   systemctl --failed --no-pager

5. Si SSH est également inaccessible, vérifiez d'abord que le système a terminé le démarrage, puis examinez le câble réseau, le Wi-Fi et l'alimentation.

Méthode de connexion SSH : Consultez le tutoriel de connexion SSH à l'unité de contrôle

Impression, clé USB et caméra

La clé USB est détectée mais l'impression ne démarre pas ?

Vérifiez le système de fichiers, l'extension G-code, l'espace local restant et l'encodage du fichier. Certains G-code non UTF-8 peuvent provoquer une situation où "le téléversement local fonctionne mais l'impression depuis la clé USB ne démarre pas".

Impression USB et vérification de l'encodage : Consultez le guide d'utilisation de l'impression USB

Que faire si la caméra n'affiche aucune image ?

Vérifiez d'abord que la caméra prend en charge le protocole UVC, puis vérifiez que le service caméra est activé, que le nœud de périphérique est correct et que la résolution est prise en charge par la caméra. Ne démarrez pas deux services utilisant la même caméra simultanément.

Connexion et configuration de la caméra : Voir la connexion et l'utilisation de la caméra

Que faire si la photographie en accéléré ne génère aucune image ?

Accédez d'abord directement à l'adresse de la capture d'écran dans le navigateur pour confirmer qu'une seule image est bien renvoyée. Si le service de caméra change, il faut modifier en conséquence le snapshoturl dans moonraker.conf.

Adresse de capture et dépannage des journaux : Voir la fonction de photographie en accéléré

Par où commencer le dépannage en cas d'erreur Klipper ?

Notez en priorité le message d'erreur brut affiché sur la page web et examinez la première anomalie apparaissant dans klippy.log. Les messages de déconnexion ou de redémarrage en fin de journal ne sont souvent que des symptômes consécutifs, pas nécessairement la cause racine.

Index des erreurs Klipper : Voir les erreurs courantes de Klipper

Journaux et support technique

Où se trouvent les journaux courants ?

Journal	Chemin
Klipper	/usr/share/printer_data/logs/klippy.log
Moonraker	/usr/share/printer_data/logs/moonraker.log
KlipperScreen	/usr/share/printer_data/logs/klipperscreen.log
Crowsnest	/usr/share/printer_data/logs/crowsnest.log
GoCam	/usr/share/printer_data/logs/gocam.log
Montage automatique de clé USB	/var/log/flyos-auto-mount.log

Pour ne consulter que le contenu récent, vous pouvez utiliser :

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

Vérifier l'état des principaux services :

systemctl status klipper moonraker --no-pager

Vérifier les ressources système :

uptime
free -h
df -h

Que fournir lors de la prise de contact avec le support technique ?

Veuillez, si possible, fournir en une seule fois :

• Les modèles précis de l'ordinateur hôte et de la carte mère.
• Le numéro de version de FLYOS-FAST.
• Les opérations effectuées ou les modifications appliquées avant l'apparition du problème.
• Une capture d'écran complète de l'erreur sur la page web.
• Les journaux complets de klippy.log, moonraker.log ou du service correspondant.
• Si le problème peut être reproduit de manière stable, et s'il persiste après un redémarrage.

Ne fournissez pas uniquement les dernières lignes tronquées du journal, sinon le premier message d'erreur réel pourrait ne pas être visible. Avant d'envoyer les configurations et les journaux, veuillez supprimer les informations sensibles telles que les mots de passe Wi-Fi, les identifiants de services cloud, les jetons, etc.