Aller au contenu principal

Instructions de compilation du firmware

Avertissement de sécurité important

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

  • Cohérence de compilation du firmware : Le firmware Klipper doit être compilé par l'hôte que vous utilisez actuellement. L'utilisation d'un firmware compilé par un tiers ou d'une version incompatible peut entraîner des dysfonctionnements système imprévisibles.
  • Normes de la plateforme matérielle : Il est fortement recommandé d'utiliser un matériel hôte standard. Évitez les appareils modifiés de manière non officielle (comme certains décodeurs TV, clés WiFi ou modèles spécifiques d'appareils Redmi), car ils peuvent présenter des risques de compatibilité et de stabilité.
  • Limites des environnements virtualisés : Il n'est pas recommandé d'exécuter le système hôte dans une machine virtuelle, car 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 offrent la même fonctionnalité : permettre la programmation sans contact (mise à jour du firmware directement via l'hôte, sans retirer la carte SD).
    • Explication : HID est le Bootloader utilisé par les cartes hôtes FLY, il est fondamentalement identique à Katapult.
    • Note importante : Lors de l'utilisation de Katapult, si un mauvais firmware est flashé et rend la carte mère non réactive, localisez le bouton de réinitialisation sur la carte mère et appuyez rapidement deux fois dessus. Cela permettra de réentrer en mode Katapult pour re-flasher.

  • Mode Bootloader

    • Fonction : Méthode traditionnelle de programmation via la carte SD.
    • Avantage : Cette méthode est tolérante aux erreurs. En cas de flash incorrect, il suffit de re-flasher la carte SD pour réessayer, sans craindre de "brique" la carte mère.

Guide de compilation du firmware​

Préparation et recommandations pour la compilation
  • Pour maximiser les chances de compilation réussie, il est recommandé d'utiliser MobaXterm comme client SSH. Selon les retours utilisateurs, certains outils SSH peuvent provoquer des erreurs de compilation inconnues.
  • Option de configuration importante : Dans l'interface de configuration de compilation, assurez-vous de 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)​

Note importante
  • Cette option permet de forcer l'état logique (niveau) de broches GPIO spécifiques au démarrage du microcontrôleur.
  • Il est nécessaire de passer en mode de saisie en anglais, sinon la compilation du firmware échouera.

  • Syntaxe de configuration :

    • Ajouter ! devant le nom de la broche signifie la forcer à l'état bas (low) au démarrage. Ne pas ajouter ! signifie la forcer à l'état haut (high).
    • Série STM32 : Le numéro de broche doit être en majuscules (ex : !PF8 ou PF8).
    • Série RP2040 : Le numéro de broche doit être en minuscules (ex : !gpio5 ou gpio5).

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

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

La configuration GPIO pins to set at micro-controller startup n'est active que avant que Klipper ne se connecte et démarre. Une fois Klipper connecté et fonctionnant normalement, ce paramètre n'affecte en rien les autres opérations des broches et peut être utilisé en toute sécurité.

Récupération après échec de flash et protection générale
  • Protection contre un mauvais flash : Les firmwares Katapult, HID et Bootloader possèdent un mécanisme de protection intégré. Tant que vous n'effectuez pas de flash dans le mode spécial DFU, même si le firmware principal est incorrectement flashé, ces bootloaders ne seront pas écrasés et la carte mère ne deviendra pas une "brique".
  • Action nécessaire après le flash : Après tout flash de firmware, il est impératif de couper complètement l'alimentation de l'esclave (débrancher le câble d'alimentation) une fois, puis de le rallumer. Cela garantit que le nouveau firmware est correctement chargé et fonctionne de manière stable.

Instructions de programmation du firmware​

À savoir avant le flash
  • Identification du périphérique : Lors de l'utilisation de Katapult pour flasher, assurez-vous que l'hôte reconnaît le périphérique. Si l'appareil n'est pas trouvé, appuyez rapidement deux fois sur le bouton de réinitialisation de la carte mère pour réentrer en mode programmation.
  • Respecter les procédures : Suivez strictement la méthode de flash du tutoriel officiel. L'utilisation d'autres méthodes non vérifiées peut endommager l'appareil.
  • Vérification de la compilation : Avant le flash, assurez-vous qu'il n'y a aucune erreur de compilation dans le firmware. Un fichier de firmware erroné entraînera un échec du flash ou un dysfonctionnement de l'appareil.

Récupération après un mauvais flash de firmware Katapult​

  1. Localisez le bouton de réinitialisation physique sur la carte mère et appuyez rapidement deux fois dessus.
  2. Normalement, une LED indicatrice sur la carte mère FLY commencera à clignoter, indiquant que le mode Katapult a été activé avec succès.
  3. Vous pouvez alors effacer le firmware incorrect sur la carte mère et re-flasher le firmware Klipper correct.

Récupération après un mauvais flash de firmware Bootloader​

  1. Réinsérez la carte TF contenant le firmware correct dans la carte mère.
  2. Si le flash échoue, coupez complètement l'alimentation, insérez la carte TF, puis rallumez.
  3. Maintenez l'alimentation pendant environ 5 secondes pour que le flash automatique se termine.

Installation des dépendances de flash pour Katapult​

⚠️ Important
  • Si vous utilisez un hôte non officiel FLY, vous devez absolument exécuter la commande suivante pour installer les paquets de dépendances nécessaires au flash du firmware !
  • Choisissez un seul des 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...