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ù se trouvent les fichiers couramment utilisés ?

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

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

Chemins de configuration RRF et erreurs courantes : Voir le dépannage en mode RRF

Quels répertoires sont conservés de manière persistante ?

Le système enregistre /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, vous devez toujours sauvegarder séparément la configuration de l'imprimante avant d'effectuer une OTA ou une réécriture du firmware.

Comment modifier la configuration système FLYOS-FAST ?

Le modèle du système, le réseau, l'écran et les commutateurs de services sont gérés de manière centralisée dans FlyOS-Conf/config.txt. Après le démarrage du système, vous pouvez également modifier via .flyos-config/sys-config.conf dans la page web.

Méthodes de configuration et portée des effets : Voir le guide de configuration système FLYOS-FAST

Pourquoi les modifications de configuration ne prennent-elles pas effet ?

Différentes configurations nécessitent différentes opérations pour prendre effet :

Contenu modifié	Opération pour prendre effet
printer.cfg et fragments de configuration Klipper	Exécuter Enregistrer et redémarrer dans la page web
moonraker.conf	Redémarrer Moonraker
config.txt ou sys-config.conf	Redémarrer l'ensemble de l'ordinateur hôte
Code source de plugin ou liens symboliques	Redémarrer le service correspondant selon le tutoriel du plugin

Si les modifications ne prennent toujours pas effet après le redémarrage, veuillez confirmer que les fichiers sont bien enregistrés, que les éléments de configuration ne sont pas définis en double, et vérifier les journaux du service correspondant.

Mode RRF

En mode RRF, la DCS se déconnecte de manière répétée et affiche l'erreur M550 de non-correspondance du nom de machine, que faire ?

En mode RRF, les symptômes suivants apparaissent :

• La page web DWC affiche de manière répétée Connection interrupted, DCS has been stopped.
• Le journal de démarrage contient Error in start-up file config.g line 3: M550: Machine name must consist of the same letters and digits as configured by the Linux hostname.
• La DCS (Duet Control Server) ne démarre pas correctement et la page web reste inaccessible.

Cause

RRF exige que le nom de machine défini par M550 P"..." dans config.g soit exactement identique au hostname du système Linux (contenant uniquement les mêmes lettres et chiffres). En cas de non-correspondance, la DCS refuse de démarrer et subit des boucles de plantage et de reconnexion.

printer_name n'est utilisé qu'au premier démarrage pour initialiser le hostname. Si le hostname a été modifié manuellement ultérieurement sans synchroniser config.g, ou si un config.g provenant d'un autre appareil a été copié, cette erreur se produit.

Étapes de diagnostic et de correction :

1. Connectez-vous à la machine hôte via SSH et vérifiez le hostname Linux actuel :

   hostname

2. Consultez la valeur actuelle de M550 dans le fichier de configuration RRF :

   cat /opt/dsf/sd/sys/config.g | grep M550

3. Modifiez M550 pour qu'il corresponde au hostname. Par exemple, si le hostname est fly-c5, modifiez-le comme suit :

   M550 P"fly-c5"

4. Après avoir enregistré le fichier, redémarrez la DCS depuis la page web DWC, ou redémarrez directement la machine hôte.

Limitation des caractères du nom

Le nom de machine dans M550 ne peut contenir que des lettres et des chiffres, sans espaces, tirets bas, caractères chinois ou autres caractères spéciaux. Si vous devez modifier le hostname, synchronisez également la valeur de M550 dans config.g pour garantir leur correspondance.

Où se trouvent les fichiers de configuration du mode RRF ?

Tous les fichiers de configuration RRF se trouvent dans le répertoire /opt/dsf/sd/sys/. Les principaux fichiers incluent :

Fichier	Fonction
config.g	Fichier de configuration principal de démarrage, contenant les paramètres essentiels tels que M550 (nom de machine)
board.txt	Configuration au niveau de la carte (réseau, SPI, etc.)
deploy.d	Répertoire des scripts de déploiement

Les fichiers G-code sont stockés dans /opt/dsf/sd/gcodes/. Les fichiers imprimés depuis une clé USB y sont également montés. Ne mélangez pas le chemin de configuration de Klipper (/usr/share/printer_data/) avec celui de RRF.

Mises à jour système et micrologiciel

Comment mettre à jour le système ?

FLYOS-FAST doit être mis à jour via l'OTA du système ou en regravant l'image officielle correspondant au périphérique. N'utilisez pas de scripts de mise à jour tiers pour remplacer les fichiers clés.

Mise à jour en ligne et par clé USB : Consulter le guide de mise à jour OTA

Regraver le système : Consulter le tutoriel de gravure de l'image système

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

Une OTA normale conserve /data et le répertoire de données de l'imprimante, mais les situations suivantes peuvent tout de même provoquer des anomalies de configuration :

• L'utilisateur a remplacé lui-même Klipper, Moonraker ou d'autres composants préinstallés.
• Des fichiers personnalisés ont masqué les nouveaux fichiers fournis par l'OTA.
• L'alimentation a été interrompue pendant la mise à jour.
• L'espace disque était insuffisant ou le système de fichiers était 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 n'effectuez aucune opération d'impression.

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

Déconseillé. Dans le système, Klipper, Moonraker, l'interface web et le service d'écran sont adaptés comme un ensemble cohérent ; remplacer un seul composant séparément peut casser les chemins, les interfaces d'extension ou le mécanisme de mise à jour. Veuillez utiliser la méthode de mise à jour globale fournie par le système.

Que faire si les versions MCU ne correspondent pas après l'OTA ?

L'OTA ne prend en charge la mise à jour automatique que du micrologiciel USB des cartes mères FLY-C8, FLY-C5, FLY-C8P et FLY-GEMINI V3. Les autres cartes mères, le micrologiciel CAN, les cartes outils et les autres MCU externes ne prennent pas en charge la mise à jour automatique et doivent être gravés manuellement selon le tutoriel du produit correspondant.

Portée de la mise à jour automatique et méthode de vérification : Consulter les notes sur la mise à jour du micrologiciel MCU après OTA

Où trouver les fichiers après la compilation du micrologiciel ?

Les produits compilés se trouvent dans :

/data/klipper/out/

Le fichier réel peut être klipper.bin ou klipper.uf2, déterminé par l'architecture du MCU et la configuration du chargeur de démarrage.

Notes de compilation du micrologiciel : Consulter le tutoriel de compilation du micrologiciel Klipper

Limitations de compilation FLYOS-FAST : Consulter les notes de compilation du micrologiciel FLYOS-FAST

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.