Aller au contenu principal

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

Caractéristiques et conception du système​

1. Spécifications des utilisateurs du système​

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

2. Gestion des paquets logiciels​

  • Pour rester minimaliste et démarrer rapidement, le système FAST n'intègre pas de gestionnaire de paquets traditionnel comme apt. Par conséquent, les commandes telles que apt update ne peuvent pas être exécutées.
  • Logiciels préinstallés : Le système inclut déjà l'écosystème Klipper et les outils couramment nécessaires pour la maintenance quotidienne.
  • Besoins logiciels : Si vous avez besoin de paquets logiciels supplémentaires, n'hésitez pas à nous en faire part. 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 n'autorise la modification des fichiers que 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 sauvegardé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 les mises à jour OTA.
  • Point d'entrée de la mise à jour : Vous pouvez accéder à la page de mise à jour OTA du système en visitant le port adresse IP:9998 de l'ordinateur hôte.
  • Rappel important :
    • Avant de lancer une mise à jour du système, assurez-vous d'avoir mis en pause toutes les tâches d'impression.
    • Les services système redémarreront pendant la mise à jour. Ne procédez à aucune opération d'impression, sinon cela pourrait entraîner un échec d'impression ou une perte de contrôle du matériel.

Mise à jour par flashage (re-flashing)​

  • Cas d'utilisation : Lorsque le système ne peut pas démarrer normalement.
  • Avertissement important :
    • Sauvegarde obligatoire avant flashage : Le processus de flashage effacera toutes les données utilisateur. Il est impératif de sauvegarder au préalable la configuration de votre système d'imprimante.
    • Après le flashage, vous devrez restaurer manuellement les fichiers de configuration sauvegardés.
  • Méthode de flashage : Veuillez vous référer au tutoriel et aux outils de flashage fournis officiellement.

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 généré se trouve dans :
/data/klipper/out/

Emplacement des fichiers de configuration​

  • Dans le système FAST
Version du firmwareChemin de configuration KlipperChemin de configuration RRF
Chemin de configuration du firmware
Loading...
Loading...

Différences d'environnement Python​

Le système FAST n'utilise pas l'environnement virtuel Python venv recommandé officiellement par Klipper, mais plutôt l'environnement Python global. Cela nécessite d'adapter toutes les commandes de script Python qui doivent s'exécuter dans l'environnement Klipper.

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

Description du scénarioCommande système standardCommande système FAST
Interroger l'UUID CANBUS
Loading...
Loading...

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

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

Solution : Comme indiqué dans le tableau ci-dessus, remplacez simplement le chemin de l'interpréteur Python dans la commande.

Guide d'installation des composants​

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

Étapes d'installation générales​

La plupart des extensions Klipper peuvent être installées via ces étapes simples :

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

    cd /data
    git clone [URL du dépôt de l'extension]

  2. Copier les fichiers Python nécessaires vers le répertoire des extensions Klipper

    cp /data/[répertoire_extension]/[fichier_principal_extension].py /data/klipper/klippy/extras/

  3. Redémarrer le service Klipper pour prendre effet

    systemctl restart klipper

Indications importantes​

  • Sélection des fichiers : Veuillez vérifier dans la documentation de l'extension quels fichiers Python spécifiques doivent être copiés. Ne copiez pas aveuglément tous les fichiers .py.
  • Vérification des dépendances : Avant l'installation, assurez-vous que l'extension n'a pas d'exigences de dépendances particulières.
  • Compatibilité des versions : Assurez-vous que la version de l'extension est compatible avec votre version de Klipper.

Explication des dépendances​

Remarque : Si vous utilisez FlyOS_FAST-V1.3.0 ou une version plus récente, le système inclut déjà les dépendances courantes ; aucune installation supplémentaire n'est généralement 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/

Points à noter​

  1. Emplacement d'installation : Installez tous les composants personnalisés dans le répertoire /data.
  2. Vérification des fichiers : Avant de copier, vérifiez l'utilité des fichiers pour éviter d'écraser des fichiers importants.
  3. Redémarrage du service : Après l'installation, le service Klipper doit être redémarré pour prendre effet.
  4. Dépannage : Si des anomalies surviennent après l'installation, vérifiez que les fichiers copiés sont corrects.

Questions fréquemment posées​

1. Que faire si je ne peux pas accéder à fly-tools (port 9999) via le navigateur ?​

  • Le système FAST est un environnement d'exécution central hautement intégré. L'outil web fly-tools n'est pas préinstallé par défaut, donc le port 9999 ne répond pas. Ceci est une conception normale.

2. ⚠️ Important : Explication concernant la mise à jour des composants système​

  • Klipper, Moonraker, etc., dans le système FAST, sont des versions personnalisées qui diffèrent des versions officielles de la communauté.
  • 【Principe fondamental】 Ne mettez jamais à jour manuellement via la ligne de commande ou d'autres canaux non officiels, car cela compromettrait les optimisations 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 :
    • Utiliser la fonctionnalité de mise à jour OTA en ligne intégrée au système.
    • Ou re-flasher l'image système complète la plus récente.

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

1. Sécurité des fichiers de configuration

  • La mise à jour OTA est conçue de manière spéciale pour ne pas écraser ou modifier vos fichiers de configuration personnels.

2. Points d'attention pendant le processus de mise à jour

  • Assurez-vous que l'alimentation électrique de l'appareil est stable pendant la mise à jour.
  • Une coupure de courant inattendue entraînera l'échec de la mise à jour et, dans les cas graves, nécessitera un re-flashage du système.

3. Gestion du code personnalisé

  • Si vous avez modifié des fichiers de configuration Klipper ou installé des extensions personnalisées,
  • La mise à jour OTA ignorera automatiquement les fichiers concernés, préservant ainsi vos modifications.

4. Rappel important : Mise à jour du firmware

  • Après chaque mise à jour OTA terminée, veillez à compiler manuellement le firmware Klipper et à re-flasher le firmware du contrôleur (firmware de la carte électronique).
Loading...