Guide d'utilisation de la fonction d'impression via clé USB

FLYOS-FAST monte automatiquement la clé USB ; il est possible de parcourir et d'imprimer les fichiers G-code qu'elle contient depuis le gestionnaire de fichiers web ou sur l'écran de l'appareil. Cet article a été vérifié pour les images v1.3.10 des modèles H3, H5 et H618, ainsi que pour l'image v1.4.0 du modèle H618.

Principe de fonctionnement

La partition de la clé USB sera montée dans le répertoire G-code sous forme de dossier commençant par U_. Au démarrage de l'impression, le système copie d'abord le fichier complet en local :

/usr/share/printer_data/gcodes/.UDISK/tmp.gcode

Une fois la copie terminée, Klipper exécute l'impression à partir de ce fichier temporaire ; la prochaine impression depuis la clé USB l'écrasera.

Attendez la fin de la copie avant de retirer la clé USB

L'affichage « Impression en cours » sur la page web ne signifie pas que le fichier a été entièrement copié. Veuillez attendre que Copy files from removable disk completed apparaisse dans la console, ou que l'imprimante ait commencé à chauffer et à bouger avant de retirer la clé. Retirer la clé pendant la copie empêchera cette impression de démarrer.

Exigences relatives aux fichiers

Élément	Plage de prise en charge	Recommandation
Système de fichiers	FAT32, exFAT, NTFS	Privilégier FAT32 ou exFAT
Format de fichier	.gcode, .g, .gco	Privilégier .gcode
Emplacement du fichier	Répertoire racine ou dossiers multi-niveaux	Classer par modèle
Nom de fichier	Prise en charge de l'UTF-8, des espaces et du chinois	Court de préférence, pour faciliter le transfert entre plateformes

Les fichiers de modèle tels que .stl, .obj ou les fichiers de projet de tranchage ne sont pas pris en charge ; il est nécessaire d'exporter d'abord le G-code à l'aide d'un logiciel de tranchage.

USB 3.0 non pris en charge

Cette fonction ne prend pas en charge l'USB 3.0. Veuillez insérer la clé USB dans un port USB 2.0 et ne pas utiliser de clé USB 3.0 ; avec une clé 3.0, la vitesse de transfert devient très lente et le temps d'attente lors de la copie s'allonge sensiblement.

Extensions masquées sous Windows

Veuillez cocher Extensions de nom de fichier dans l'Explorateur de fichiers afin de vérifier que le suffixe est bien .gcode, .g ou .gco, et éviter ainsi d'obtenir modèle.gcode.txt.

Étapes d'utilisation

1. Copiez le G-code généré par le tranchage sur une clé USB.
2. Insérez la clé USB dans le port USB de l'ordinateur hôte.
3. Ouvrez la liste de fichiers de Fluidd, Mainsail ou de l'écran local, et recherchez le dossier commençant par U_ ; si celui-ci n'apparaît pas immédiatement, actualisez la liste.
4. Entrez dans ce dossier, sélectionnez le fichier G-code, vérifiez les informations d'aperçu, puis cliquez une seule fois sur « Démarrer l'impression ».
5. Attendez que la console indique que la copie est terminée ; le système démarre ensuite automatiquement l'impression.

Pendant la copie, ne cliquez pas plusieurs fois sur « Démarrer l'impression » et ne sélectionnez pas un second fichier de la clé USB : toutes les impressions depuis une clé USB partagent le même tmp.gcode, et des copies simultanées s'écraseraient mutuellement.

Retrait de la clé USB et limitations

• Après avoir confirmé que la copie est terminée, vous pouvez retirer la clé USB ; l'impression continuera de lire les fichiers temporaires locaux ; ne la retirez pas tant que la console affiche encore Copying file.
• Ne retirez pas la clé USB lorsqu'aucune indication de progression de copie n'est affichée : certains boîtiers de disque USB ou SSD peuvent ne pas être reconnus comme périphériques amovibles, et Klipper lira directement les fichiers externes.
• Lorsque la page web effectue un téléversement, une suppression ou un renommage sur la clé USB, attendez la fin de l'opération avant de la retirer.
• Une clé USB sans table de partitions peut ne pas s'afficher ; vous pouvez la repartitionner et la formater ; deux clés USB identiques en fabricant, modèle, capacité et structure de partitions peuvent être montées dans le même répertoire et entrer en conflit.
• La détection automatique ne couvre que les partitions à un seul chiffre courantes (comme /dev/sda1) ; les périphériques spéciaux à partitions multiples peuvent ne pas être entièrement montés.
• Plus le fichier est volumineux, plus l'attente de copie avant le début de l'impression est longue, et cela dépend de l'espace local restant sur l'hôte.

Questions fréquentes

Le fichier est visible mais l'impression ne peut pas démarrer

Vérifiez que l'extension est .gcode, .g ou .gco, et que le fichier peut être prévisualisé normalement dans le logiciel de tranchage ; vérifiez l'espace libre local :

df -h /usr/share/printer_data/gcodes

Consultez ensuite les erreurs de copie ou d'ouverture dans le journal Klipper :

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

Le téléversement web fonctionne, mais pas la clé USB

Certains logiciels de tranchage enregistrent les commentaires en chinois avec GBK ou ANSI, tandis que les fichiers de la clé USB sont d'abord copiés vers .UDISK/tmp.gcode puis lus strictement en UTF-8, ce qui peut provoquer une erreur en présence d'octets non UTF-8 :

UnicodeDecodeError: 'utf-8' codec can't decode byte

Le nom de fichier en chinois n'est généralement pas la cause ; le renommer en anglais ne modifiera pas l'encodage interne du fichier. Procédez de l'une des manières suivantes :

1. Réexportez depuis le logiciel de tranchage en définissant l'encodage sur UTF-8.
2. Utilisez un éditeur prenant en charge la conversion d'encodage pour enregistrer l'intégralité du fichier en UTF-8, sans vous contenter de changer l'extension.
3. Si le choix de l'encodage n'est pas possible, supprimez les commentaires en chinois non UTF-8 en tête de fichier puis enregistrez, sans modifier les instructions de mouvement, de température et d'extrusion.
4. En solution temporaire, vous pouvez d'abord téléverser le fichier via le web vers le répertoire G-code local, puis imprimer.

Après un échec de copie, l'état « impression en cours » persiste

Vérifiez que l'imprimante n'est pas en train d'exécuter un chauffage ou un mouvement, puis redémarrez Klipper :

systemctl restart klipper

Réinsérez la clé USB et réessayez ; si le problème se reproduit, remplacez la clé USB et fournissez les deux journaux suivants au support technique :

/var/log/flyos-auto-mount.log
/usr/share/printer_data/logs/klippy.log