Aller au contenu principal

Instructions de compilation du firmware

Avertissement de sécurité important

Pour garantir le bon fonctionnement du système, veuillez impérativement respecter les principes d'utilisation du firmware suivants :

  • Cohérence de la compilation du firmware : Le firmware Klipper doit être compilé par l'ordinateur hôte que vous utilisez actuellement. L'utilisation d'un firmware compilé par un tiers ou dont la version ne correspond pas peut entraîner des pannes système imprévisibles.
  • Conformité de la plateforme matérielle : Il est fortement recommandé d'utiliser un matériel hôte standard. Évitez d'utiliser des appareils modifiés de manière non officielle (comme certains boîtiers TV, clés WiFi ou certains modèles de Redmi), qui peuvent présenter des risques de compatibilité et de stabilité.
  • Limitations de l'environnement virtualisé : Il est déconseillé d'utiliser le système hôte dans une machine virtuelle, cela pourrait introduire des interférences de performance et de temps réel, affectant la qualité d'impression.

Explication des types de firmware​

  • Mode Katapult / HID

    • Fonction : Ces deux modes ont la même fonction, permettant tous deux une mise à jour sans contact (mise à jour directe du firmware via l'ordinateur hôte, sans avoir à insérer/retirer la carte mémoire).
    • Explication : HID est le Bootloader utilisé par l'ordinateur hôte intégré de FLY, son essence est identique à celle de Katapult.
    • Avis important : Lors de l'utilisation de Katapult, si le flashage d'un mauvais firmware rend la carte mère inactive, localisez le bouton de réinitialisation sur la carte mère et double-cliquez rapidement pour revenir en mode Katapult et refaire le flashage.

  • Mode Bootloader

    • Fonction : Méthode de flashage traditionnelle via carte mémoire.
    • Avantage : Cette méthode offre une bonne tolérance aux erreurs. En cas de flashage incorrect, il suffit de refaire le flashage de la carte mémoire pour réessayer, sans risque de "briquer" la carte mère.

Guide de compilation du firmware​

Préparation et conseils pour la compilation
  • Pour maximiser les chances de succès de la compilation, il est recommandé d'utiliser MobaXterm comme client SSH. Certains outils SSH pourraient, d'après les retours d'utilisateurs, causer des erreurs de compilation inconnues.
  • Option de configuration importante : Dans l'interface de configuration de la compilation, veuillez impérativement cocher l'option Enable extra low-level configuration options, sinon certaines options avancées ne seront pas affichées.

Configuration des broches de démarrage (GPIO pins to set at micro-controller startup)​

Avis important
  • Cette option permet de forcer l'état logique de broches GPIO spécifiques au démarrage du microcontrôleur.
  • Il est nécessaire de basculer vers une disposition de clavier en anglais, sinon la compilation du firmware échouera.

  • Syntaxe de configuration :

    • Ajouter ! devant une broche signifie la forcer à l'état bas (niveau logique bas) au démarrage, ne pas ajouter ! signifie la forcer à l'état haut (niveau logique haut).
    • Série STM32 : Les numéros de broches doivent être en majuscules, veuillez les renseigner selon la documentation de votre carte mère actuelle.
    • Série RP2040 : Les numéros de broches doivent être en minuscules, veuillez les renseigner selon la documentation de votre carte mère actuelle.

  • Configuration de plusieurs broches : Pour configurer plusieurs broches, séparez-les par une virgule , en anglais.

    • Exemple : !<pin_a>,!<pin_b>,<pin_c> signifie forcer les deux premières broches à l'état bas et la troisième à l'état haut au démarrage.
Note de sécurité

Les GPIO pins to set at micro-controller startup que vous configurez ne sont actives qu'avant l'établissement de la connexion par Klipper. Une fois que Klipper a terminé la connexion et fonctionne normalement, ce paramètre n'affecte pas les autres opérations des broches, il peut être utilisé en toute sécurité.

Récupération après échec de flashage et protection générale
  • Protection contre un flashage de firmware erroné : Les trois types de firmware Katapult, HID et Bootloader possèdent des mécanismes de protection intégrés. Tant que vous n'entrez pas dans un mode DFU spécial pour le flashage, même si le firmware principal flashé est erroné, ces bootloaders ne seront pas écrasés et la carte mère ne sera pas "briquée".
  • Opération nécessaire après le flashage : Une fois le flashage de tout firmware terminé, veuillez impérativement couper complètement l'alimentation de la carte contrôleur (débrancher le câble d'alimentation), puis la remettre sous tension pour garantir le bon chargement et le fonctionnement stable du nouveau firmware.

Instructions de flashage du firmware​

À savoir avant le flashage
  • Identification du périphérique : Lors du flashage avec Katapult, assurez-vous que l'ordinateur hôte peut identifier le périphérique. Si le périphérique est introuvable, double-cliquez rapidement sur le bouton de réinitialisation de la carte mère pour revenir en mode flashage. Ou alors, refaites le flashage du firmware BL de la carte mère.
  • Suivre les normes : Veuillez suivre strictement la méthode de flashage du tutoriel officiel. L'utilisation d'autres méthodes non vérifiées pourrait endommager l'appareil.
  • Vérification de la compilation : Avant le flashage, assurez-vous impérativement que le firmware ne comporte pas d'erreur de compilation. Un fichier de firmware erroné entraînera un échec du flashage ou un dysfonctionnement de l'appareil.

Récupération après un flashage de firmware Katapult erroné​

  1. Localisez le bouton de réinitialisation physique sur la carte mère et double-cliquez rapidement.
  2. Normalement, une LED témoin sur la carte Fly commencera à clignoter, indiquant que le mode Katapult a été activé avec succès.
  3. Vous pouvez alors entrer en mode Katapult et refaire le flashage du firmware Klipper correct.

Récupération après un flashage de firmware Bootloader erroné​

  1. Réinsérez la carte TF contenant le firmware correct dans la carte mère.
  2. Si le flashage échoue, coupez d'abord complètement l'alimentation, insérez la carte TF, puis remettez sous tension.
  3. Maintenez l'alimentation pendant environ 5 secondes pour terminer le flashage automatique.

Installation des dépendances de flashage pour Katapult​

Important
  • Si vous utilisez un ordinateur hôte non officiel de Fly, veuillez impérativement exécuter la commande suivante pour installer le package de dépendances de flashage du firmware !
  • Un seul des deux dépôts ci-dessous est nécessaire.
  • Dépôt GitHub 
    cd && git clone https://github.com/Arksine/katapult.git
  • Dépôt miroir pour la région Chine 
    cd && git clone https://cnb.cool/3dmellow/public/katapult
Loading...
Loading...