Guide d'utilisation et remarques importantes sur le système FAST

Caractéristiques et Conception du Système

1. Description des Utilisateurs du Système

• Le système FAST, conçu pour être extrêmement léger et sécurisé, utilise un mode mono-utilisateur.
• Utilisateur unique : root
• Restriction : Le système ne permet pas de créer ou de basculer vers d'autres comptes utilisateurs.

2. Gestion des Paquets

• Afin de rester léger et rapide au démarrage, le système FAST n'intègre pas de gestionnaire 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 inclut déjà Klipper et les outils couramment utilisés pour la maintenance.
• Demande de logiciels : Si vous avez besoin de paquets supplémentaires, veuillez nous faire part de votre demande. Nous évaluerons leur utilité générale et envisagerons de les inclure dans les versions futures.

3. Système de Fichiers et Persistance

• Chemins modifiables : Pour garantir l'intégrité du système, seul le contenu des répertoires /etc et /data peut être modifié dans le système FAST.
• Restrictions : Les autres répertoires du système sont en lecture seule, toute modification ne sera pas conservée. Veuillez stocker vos configurations personnalisées et données dans les deux répertoires mentionné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é)

• À partir de la version V1.3.0, le système FAST prend en charge les mises à jour OTA.
• Point d'accès : Vous pouvez accéder à la page de mise à jour OTA via le port 9998 de l'adresse IP de l'hôte.
• Important :
  • Avant de lancer la mise à jour, veuillez vous assurer que toutes les tâches d'impression sont en pause.
  • Pendant le processus de mise à jour, les services système redémarreront. Veuillez ne pas effectuer d'impression, cela pourrait entraîner des échecs d'impression ou un dysfonnement du matériel.

Mise à jour par reflashage

• Cas d'utilisation : Lorsque le système ne démarre pas correctement
• Avertissement important :
  • Sauvegardez vos paramètres avant le reflashage : Le processus de reflashage effacera toutes les données utilisateur. Veuillez sauvegarder vos paramètres de l'imprimante à l'avance.
  • Après le reflashage, vous devrez restaurer manuellement les paramètres sauvegardés.
• Méthode de reflashage : Veuillez consulter le tutoriel et les outils officiels fournis.

Chemins et Différences d'Environnement

Emplacement de Génération du Firmware

• Après une compilation réussie du firmware Klipper dans le système FAST, le fichier firmware généré se trouve à l'emplacement suivant :

/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érences d'Environnement Python

Le système FAST n'utilise pas l'environnement virtuel Python venv recommandé par Klipper, mais utilise un environnement Python global. Cela implique que toutes les commandes exécutant des scripts Python dans l'environnement Klipper doivent être ajustées.

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

Scénario	Commande système standard	Commande système FAST
Recherche d'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 : 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érale pour installer des plugins Klipper dans le système FAST.

Étapes Générales d'Installation

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

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

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

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

   cp /data/[répertoire du plugin]/[fichier principal du plugin].py /data/klipper/klippy/extras/

3. Redémarrer le service Klipper pour que les changements prennent effet

   systemctl restart klipper

Remarques Importantes

• Sélection des fichiers : Vérifiez dans la documentation du plugin quels fichiers Python doivent être copiés. Ne copiez pas aveuglément tous les fichiers .py
• Vérification des dépendances : Assurez-vous que le plugin ne nécessite pas de dépendances spécifiques avant l'installation
• Compatibilité des versions : Vérifiez que la version du plugin est compatible avec votre version de Klipper

Informations sur les Dépendances

Remarque : Si vous utilisez la version FlyOS_FAST-V1.3.0 ou ultérieure, les dépendances courantes sont déjà intégrées au système, il n'est généralement pas nécessaire d'installer des dépendances supplémentaires.

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/

Remarques

1. Emplacement d'installation : Tous les composants personnalisés doivent être installés dans le répertoire /data
2. Vérification des fichiers : Vérifiez toujours l'utilisation des fichiers avant de les copier pour éviter d'écraser des fichiers importants
3. Redémarrage du service : Le service Klipper doit être redémarré après l'installation pour que les changements prennent effet
4. Dépannage : En cas de problème après l'installation, vérifiez que les fichiers copiés sont corrects

FAQ

1. Pourquoi ne puis-je pas accéder à l'outil web fly-tools sur le port 9999 ?

Le système FAST, en tant qu'environnement central de fonctionnement, ne contient pas par défaut l'outil web fly-tools.

2. Pourquoi le système ne propose-t-il pas de mise à jour automatique via l'interface web des composants tels que Klipper ?

• Raison : Les composants principaux préinstallés dans le système FAST, tels que Klipper et Moonraker, sont des versions personnalisées ayant fait l'objet d'optimisations et de développements secondaires poussés, différentes des versions officielles upstream.
• Recommandation :
  • Nous vous déconseillons fortement de mettre à jour manuellement ces composants via la ligne de commande, cela pourrait entraîner une instabilité du système, des dysfonctionnements ou une perte d'optimisation.
  • Toutes les mises à jour fonctionnelles et correctifs de sécurité des composants principaux doivent être effectuées uniquement via une mise à jour OTA ou en réinstallant l'image la plus récente.