Guide d'utilisation et précautions du système FAST

Caractéristiques du système et description de la conception

1. Description des utilisateurs du système

• Le système FAST adopte un mode mono-utilisateur pour une légèreté et une sécurité maximales.
• Utilisateur unique : root
• Restriction : Le système ne prend pas en charge la création ou le changement vers d'autres comptes utilisateur.

2. Gestion des paquets logiciels

• Le système FAST, pour rester léger et démarrer rapidement, n'intègre pas de gestionnaires de paquets traditionnels comme apt, il est donc impossible d'exécuter des commandes telles que apt update.
• Logiciels préinstallés : Le système intègre déjà l'écosystème Klipper et les outils courants nécessaires à la maintenance quotidienne.
• Besoins logiciels : Si vous avez des besoins supplémentaires en matière de paquets, n'hésitez pas à nous les signaler. Nous évaluerons leur utilité générale et envisagerons de les préinstaller dans les versions futures.

3. Système de fichiers et persistance

• Chemins modifiables : Pour garantir l'intégrité du noyau du système, le système FAST autorise uniquement la modification des fichiers dans les répertoires /etc et /data.
• Explication des restrictions : Tous les autres répertoires du système sont en lecture seule, toute modification ne sera pas enregistrée. Veuillez stocker vos configurations personnalisées et vos données dans les deux répertoires spécifiés ci-dessus.

4. Stratégie de mise à jour du système

Le système FAST prend en charge deux méthodes de mise à jour :

Mise à jour OTA en ligne (recommandée)

• À partir de la version V1.3.0, le système FAST prend en charge la mise à niveau OTA
• Accès à la mise à jour : Vous pouvez accéder à la page de mise à jour OTA du système via le port adresse_IP:9998 de l'ordinateur hôte.
• Rappels importants :
  • Avant de lancer une mise à jour système, assurez-vous d'avoir mis en pause toutes les tâches d'impression.
  • Pendant la mise à jour, les services système redémarreront, n'effectuez aucune opération d'impression, car cela pourrait entraîner un échec de l'impression ou une perte de contrôle du matériel.

Mise à jour par flashage

• Scénario d'application : Lorsque le système ne peut pas démarrer normalement
• Avertissement important :
  • Sauvegardez la configuration avant de flasher : Le processus de flashage effacera toutes les données utilisateur, assurez-vous de sauvegarder au préalable la configuration de votre système d'imprimante
  • Après le flashage, vous devez restaurer manuellement le fichier de configuration sauvegardé
• Méthode de flashage : Veuillez vous référer au tutoriel et aux outils de flashage officiels fournis.

Différences de chemins et d'environnement

Emplacement de génération du firmware

• Dans le système FAST, après une compilation réussie du firmware Klipper, le fichier firmware généré se trouve dans :

/data/klipper/out/

Emplacement des fichiers de configuration

• Dans le système FAST

Version du firmware	Chemin de configuration Klipper	Chemin de configuration RRF
Chemin de configuration du firmware	Loading...	Loading...

Différence d'environnement Python

Le système FAST n'utilise pas l'environnement virtuel Python venv recommandé par Klipper, mais un environnement Python global. Cela entraîne une adaptation nécessaire de toutes les commandes de scripts Python qui appellent l'environnement Klipper.

Modification principale : Remplacez ~/klippy-env/bin/python dans les commandes par python.

Description du scénario	Commande système standard	Commande système FAST
Interroger l'UUID CANBUS	Loading...	Loading...

Problème courant : Lors de l'exécution d'une commande, vous pouvez rencontrer l'erreur suivante :

-bash: ~/klippy-env/bin/python: No such file or directory

Solution : Remplacez le chemin de l'interpréteur Python dans la commande comme indiqué dans le tableau ci-dessus.

Guide d'installation des composants

Ce document décrit la méthode générique pour installer des plugins Klipper dans le système FAST.

Étapes d'installation génériques

La plupart des plugins Klipper peuvent être installés en suivant ces étapes simples :

1. Téléchargez le composant dans le répertoire /data

   cd /data
   git clone [adresse du dépôt du plugin]

2. Copiez les fichiers Python nécessaires dans le répertoire d'extension de Klipper

   cp /data/[répertoire_plugin]/[fichier_principal_plugin].py /data/klipper/klippy/extras/

3. Redémarrez le service Klipper pour appliquer les modifications

   systemctl restart klipper

Conseils importants

• Sélection des fichiers : Veuillez confirmer les fichiers Python spécifiques à copier en fonction de la documentation du plugin, ne copiez pas aveuglément tous les fichiers .py
• Vérification des dépendances : Avant l'installation, vérifiez si le plugin a des exigences de dépendances particulières
• Compatibilité de version : Assurez-vous que la version du plugin est compatible avec votre version de Klipper

Explication des dépendances

Remarque : Si vous utilisez FlyOS_FAST-V1.3.0 ou une version ultérieure, le système intègre déjà les dépendances courantes, une installation supplémentaire n'est généralement pas nécessaire.

Exemples d'installation de composants courants

Sonde Beacon 3D

cd /data && git clone https://github.com/beacon3d/beacon_klipper.git
cp /data/beacon_klipper/beacon.py /data/klipper/klippy/extras/

IDM ou Scanner

cd /data && git clone https://gitee.com/NBTP/IDM.git
cp /data/IDM/idm.py /data/klipper/klippy/extras/
cp /data/IDM/scanner.py /data/klipper/klippy/extras/

Cartographer 3D

cd /data && git clone https://github.com/Cartographer3D/cartographer-klipper.git
cp /data/cartographer-klipper/idm.py /data/klipper/klippy/extras/
cp /data/cartographer-klipper/scanner.py /data/klipper/klippy/extras/
cp /data/cartographer-klipper/cartographer.py /data/klipper/klippy/extras/

Précautions

1. Emplacement d'installation : Veuillez installer tous les composants personnalisés de manière unifiée dans le répertoire /data
2. Confirmation des fichiers : Avant de copier, vérifiez l'utilité du fichier pour éviter d'écraser des fichiers importants
3. Redémarrage du service : Après l'installation, vous devez redémarrer le service Klipper pour que les modifications prennent effet
4. Dépannage : Si des anomalies surviennent après l'installation, vérifiez si les fichiers copiés sont corrects

Foire aux questions

1. Que faire si je n'arrive pas à accéder à fly-tools (port 9999) via le navigateur ?

• Le système FAST est un environnement d'exécution centralisé hautement intégré. L'outil web fly-tools n'est pas préinstallé par défaut. Par conséquent, le port 9999 ne répond à aucun service. C'est une conception normale.

2. ⚠️ Important : Note sur la mise à jour des composants système

• Klipper, Moonraker et autres composants du système FAST sont des versions personnalisées, différentes des versions officielles de la communauté.

• 【Principe fondamental】Veuillez ne pas les mettre à jour manuellement via la ligne de commande ou d'autres canaux non officiels, car cela détruirait l'optimisation du système, entraînant des problèmes de compatibilité et des dysfonctionnements.
• 【Méthode correcte】Toutes les mises à jour de composants doivent être effectuées via les canaux officiels suivants :
  • Utilisez la fonction de mise à jour OTA en ligne intégrée au système.
  • Ou flashez à nouveau l'image système complète de la dernière version.

3. À quoi faut-il faire attention lors d'une mise à jour OTA ?

1. Sécurité des fichiers de configuration

• La mise à jour OTA est spécialement conçue pour ne pas écraser ou modifier vos fichiers de configuration personnels

2. Précautions pendant le processus de mise à jour

• Assurez-vous que l'alimentation de l'appareil est stable pendant la mise à jour
• Une coupure de courant accidentelle entraînera un échec de la mise à jour, nécessitant parfois de reflasher le système

3. Gestion du code personnalisé

• Si vous avez modifié des fichiers de configuration Klipper ou installé des plugins personnalisés
• La mise à jour OTA ignorera automatiquement ces fichiers, garantissant que vos modifications sont conservées

4. Rappel important : Mise à jour du firmware

• Après chaque mise à jour OTA, veuillez impérativement compiler manuellement le firmware Klipper, puis reflasher le firmware de la carte contrôleur