Aller au contenu principal

Instructions de compilation du firmware

Avis de sécurité important

Pour garantir un fonctionnement stable du système, veuillez respecter les principes suivants concernant l'utilisation du firmware :

  • 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 dysfonctionnements imprévisibles du système.
  • 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), car ces appareils peuvent présenter des risques de compatibilité et de stabilité.
  • Limitations des environnements virtualisés : Il est déconseillé d'utiliser un système hôte dans une machine virtuelle, car cela peut introduire des interférences de performance et de temps réel, affectant la qualité d'impression.

Explication des types de firmware​

  • Mode Katapult / HID

    • Fonctionnalité : Ces deux modes ont la même fonction, permettant une mise à jour sans contact (mise à jour du firmware directement via l'ordinateur hôte, sans avoir à insérer/retirer une carte mémoire).
    • Explication : HID est le bootloader utilisé par l'ordinateur hôte intégré de FLY, son essence est la même que celle de Katapult.
    • Remarque importante : Lors de l'utilisation de Katapult, si la carte mère ne répond pas après avoir flashé un mauvais firmware, veuillez trouver le bouton de réinitialisation sur la carte mère et double-cliquer rapidement pour revenir en mode Katapult et flasher à nouveau.

  • Mode Bootloader

    • Fonctionnalité : Méthode de flashage traditionnelle via une carte mémoire.
    • Avantage : Cette méthode offre une grande tolérance aux erreurs. Si vous flashez par erreur un mauvais firmware, vous pouvez réessayer en reformatant la carte mémoire, sans risque de "bricker" la carte mère.

Guide de compilation du firmware​

Préparation et recommandations pour la compilation
  • Pour garantir au maximum le succès de la compilation, il est recommandé d'utiliser MobaXterm comme client SSH. Selon les retours des utilisateurs, certains outils SSH peuvent provoquer 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 certains paramètres avancés ne s'afficheront pas.

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

Remarque importante
  • Cette option permet de forcer l'état logique de broches GPIO spécifiques au démarrage du microcontrôleur.
  • Il est nécessaire de passer en méthode de saisie anglaise, sinon le firmware ne pourra pas être compilé.

  • Syntaxe de configuration :

    • Ajouter ! devant une broche pour la mettre à l'état bas (niveau logique bas) au démarrage, omettre ! pour la mettre à l'état haut (niveau logique haut).
    • Série STM32 : Les numéros de broches doivent être en MAJUSCULES (ex : !PF8 ou PF8).
    • Série RP2040 : Les numéros de broches doivent être en minuscules (ex : !gpio5 ou gpio5).

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

    • Exemple : !gpio5,!gpio19,gpio24 signifie mettre gpio5 et gpio19 à l'état bas, et gpio24 à l'état haut au démarrage.
Note de sécurité

Les GPIO pins to set at micro-controller startup que vous configurez ne sont effectifs qu'avant que Klipper n'établisse la connexion. Une fois que Klipper est connecté et fonctionne normalement, ce paramètre n'affecte pas les autres opérations de la broche. Son utilisation est sûre.

Récupération après un échec de flashage et protection générale
  • Protection contre le mauvais firmware : Les firmwares de type Katapult, HID et Bootloader ont un mécanisme de protection intégré. Tant que vous n'entrez pas dans un mode DFU spécial pour flasher, même si vous flashez un mauvais firmware principal, ces derniers ne seront pas écrasés, et la carte mère ne "briquera" pas.
  • Opération nécessaire après le flashage : Après avoir flashé un firmware, veuillez impérativement mettre la carte esclave hors tension complètement (débrancher le câble d'alimentation), puis la remettre sous tension pour garantir que le nouveau firmware est correctement chargé et fonctionne de manière stable.

Instructions de flashage du firmware​

À savoir avant le flashage
  • Identification du périphérique : Lors du flashage via Katapult, assurez-vous que l'ordinateur hôte peut reconnaître 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 de flashage.
  • Respect des normes : Suivez strictement la méthode de flashage du tutoriel officiel. L'utilisation d'autres méthodes non vérifiées peut endommager l'appareil.
  • Vérification de la compilation : Avant de flasher, assurez-vous que le firmware ne contient pas d'erreur de compilation. Un fichier firmware erroné entraînera un échec du flashage ou un dysfonctionnement de l'appareil.

Récupération après un mauvais flashage du firmware Katapult​

  1. Trouvez le bouton de réinitialisation physique sur la carte mère et double-cliquez rapidement.
  2. Normalement, une LED sur la carte Fly commencera à clignoter, indiquant que le mode Katapult a été activé avec succès.
  3. Vous pouvez alors effacer le mauvais firmware de la carte mère et flasher à nouveau le firmware Klipper correct.

Récupération après un mauvais flashage du firmware Bootloader​

  1. Réinsérez la carte TF contenant le firmware correct dans la carte mère.
  2. Si le flashage ne fonctionne pas, mettez d'abord complètement hors tension, 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 paquet de dépendances de flashage du firmware !
  • Choisissez l'un des deux dépôts ci-dessous.
  • Dépôt git 
    cd && git clone https://github.com/Arksine/katapult.git
  • Dépôt gitee 
    cd && git clone https://gitee.com/MrCakeFuck/katapult.git
Loading...
Loading...