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

FLYOS-FAST peut monter automatiquement les clés USB et permet de parcourir et d'imprimer les fichiers G-code qu'elles contiennent via le gestionnaire de fichiers web ou l'écran de la machine. La logique décrite dans ce document a été vérifiée avec les images officielles v1.3.10 des H3, H5, H618 ainsi que l'image de test v1.4.0 du H618.

Principe de fonctionnement

La partition de la clé USB est montée dans le répertoire G-code sous forme d'un dossier commençant par U_. Lorsqu'un fichier est sélectionné pour démarrer 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 local. Lors du démarrage de l'impression suivante depuis la clé USB, le fichier temporaire est écrasé.

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

Au tout début de la copie, la page web peut déjà afficher « Impression en cours », ce statut ne signifie pas que le fichier a été entièrement copié. Attendez que le message suivant apparaisse dans la console avant de retirer la clé USB :

Copy files from removable disk completed

Vous pouvez également attendre que l'imprimante commence à chauffer ou à se déplacer avant de retirer la clé. Retirer la clé USB pendant la copie entraîne l'échec de celle-ci et l'impression ne peut pas démarrer correctement.

Exigences relatives à la clé USB et aux fichiers

Élément	Plage 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	Racine de la clé USB ou dossiers imbriqués	Classer par modèle selon vos besoins
Capacité de la clé USB	Aucune limite minimale fixe	Conserver un espace suffisant et vérifier l'intégrité du fichier
Nom de fichier	UTF-8, espaces et caractères chinois pris en charge	Pour une meilleure compatibilité multiplateforme, utiliser des noms de fichiers courts

Les fichiers de modèles (.stl, .obj, etc.) ou les fichiers de projet de tranchage ne sont pas pris en charge pour l'impression directe ; il est impératif de générer un G-code via un logiciel de tranchage.

Affichage des extensions de fichiers sous Windows

Windows peut masquer l'extension des fichiers connus. Dans l'Explorateur de fichiers, cochez Extensions de noms de fichiers pour vérifier que l'extension finale est bien .gcode, .g ou .gco et éviter les cas comme modèle.gcode.txt.

Étapes d'utilisation

1. Copiez le fichier G-code généré par le tranchage à la racine de la clé USB ou dans un dossier.
2. Insérez la clé USB dans un port USB de l'ordinateur hôte.
3. Ouvrez la liste des fichiers dans Fluidd, Mainsail ou sur l'écran de la machine.
4. Trouvez le dossier commençant par U_ ; s'il n'apparaît pas immédiatement, actualisez la liste des fichiers.
5. Ouvrez le dossier de la clé USB et sélectionnez le fichier G-code à imprimer.
6. Après avoir vérifié le fichier et l'aperçu, cliquez une seule fois sur « Démarrer l'impression ».
7. Attendez que la console affiche la fin de la copie ; le système commencera ensuite automatiquement à exécuter le fichier temporaire local.

Ne lancer qu'une seule copie à la fois

Pendant la copie, ne cliquez pas à nouveau sur « Démarrer l'impression » et ne sélectionnez pas un second fichier de la clé USB. Toutes les impressions depuis une clé USB de la version actuelle partagent le même tmp.gcode ; des copies simultanées peuvent écraser le fichier et provoquer des anomalies d'impression.

Retrait de la clé USB

• Une fois la copie du fichier confirmée, une clé USB ordinaire peut être retirée ; la tâche en cours continuera à lire le fichier temporaire local.
• Si la console affiche encore Copying file, ne retirez pas la clé USB.
• Si aucune progression ni indication de fin de copie n'apparaît, ne retirez pas la clé pendant l'impression. Certains boîtiers de disque dur USB ou SSD USB peuvent ne pas être reconnus comme périphériques amovibles ; dans ce cas, Klipper peut lire directement le fichier externe.
• Si vous avez effectué un téléchargement, une suppression ou un renommage sur la clé USB via la page web, attendez la fin de l'opération avant de la retirer.

Limitations connues

• Le montage automatique ne traite que les périphériques de stockage USB dotés d'une partition standard. Les clés USB sans table de partitions peuvent ne pas être affichées ; il est possible de recréer une partition et de formater sur un ordinateur.
• N'insérez pas simultanément deux clés USB strictement identiques en marque, modèle, capacité et structure de partition ; elles pourraient générer le même répertoire de montage et entrer en conflit.
• Les règles de détection automatique actuelles ne couvrent que les partitions numériques simples courantes, par exemple /dev/sda1. Les périphériques de stockage spéciaux multi-partitions peuvent ne pas être montés automatiquement dans leur intégralité.
• L'impression depuis une clé USB dépend de l'espace libre local. Plus le fichier G-code est volumineux, plus l'attente de copie avant de commencer l'impression est longue.

Le fichier s'affiche mais l'impression ne démarre pas

1. Vérifiez que l'extension est .gcode, .g ou .gco.

2. Vérifiez que le fichier G-code s'affiche correctement dans le logiciel de tranchage.

3. Vérifiez l'espace libre local de l'ordinateur hôte :

   df -h /usr/share/printer_data/gcodes

4. Consultez les erreurs de copie ou d'ouverture de fichier dans les journaux Klipper :

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

Le téléchargement local fonctionne, mais l'impression depuis la clé USB ne démarre pas

Certains logiciels de tranchage enregistrent les commentaires en chinois avec des encodages non UTF-8 tels que GBK ou ANSI :

• Après un téléchargement via la page web vers le répertoire G-code local, Klipper ignore les caractères indécodables ; le fichier peut donc s'imprimer normalement.
• Lors de la sélection d'un fichier depuis la clé USB, le système le copie d'abord dans .UDISK/tmp.gcode, puis le lit strictement en UTF-8 ; en présence d'octets non UTF-8, l'impression peut ne pas démarrer.

Une erreur similaire peut apparaître dans les journaux Klipper :

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

Les noms de fichiers en chinois ne sont généralement pas la cause

Les caractères chinois, les tirets bas et les traits d'union peuvent être utilisés normalement dans les noms de fichiers. Renommer uniquement le fichier en anglais ne modifie pas l'encodage interne du fichier et ne résout pas ce problème.

Veuillez utiliser l'une des méthodes suivantes :

1. Réexportez de préférence depuis le logiciel de tranchage en définissant l'encodage du texte G-code sur UTF-8.
2. Utilisez un éditeur de texte prenant en charge la conversion d'encodage pour convertir et enregistrer l'intégralité du fichier G-code en UTF-8 ; ne modifiez pas uniquement l'extension.
3. Si le logiciel de tranchage ne permet pas de choisir l'encodage, supprimez les commentaires chinois non UTF-8 en tête de fichier puis réenregistrez. Ne modifiez pas les instructions réelles de mouvement, de température ou d'extrusion.
4. En solution temporaire, téléchargez le fichier via la page web vers le répertoire G-code local avant d'imprimer.

Pour les fichiers G-code volumineux, il est recommandé de retrancher ou d'utiliser un outil textuel dédié à la conversion plutôt que de modifier le fichier entier directement dans le navigateur.

Après un échec de copie, « Impression en cours » reste affiché

Vérifiez d'abord que l'imprimante n'exécute pas de chauffage, de mouvement ou autre opération d'impression, puis redémarrez Klipper :

systemctl restart klipper

Réinsérez la clé USB et réessayez l'impression. Si le problème se reproduit, changez de clé USB et fournissez au support technique les deux journaux suivants :

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