Instructions de compilation du firmware

Avertissement important sur la sécurité

Afin de garantir un fonctionnement stable du système, veuillez respecter les principes suivants lors de l'utilisation du firmware :

• Cohérence de la compilation du firmware : le firmware Klipper doit être compilé par l'hôte que vous utilisez actuellement. L'utilisation d'un firmware compilé par une autre personne ou d'une version incompatible pourrait entraîner des pannes système imprévisibles.
• Normes de la plateforme matérielle : il est fortement recommandé d'utiliser du matériel hôte standard. Évitez d'utiliser des appareils modifiés non officiellement (par exemple certains boîtiers TV, clés WiFi ou certains modèles spécifiques de téléphones Redmi), car ils pourraient présenter des problèmes de compatibilité et de stabilité.
• Limitations de l'environnement virtualisé : il n'est pas recommandé d'exécuter le système hôte dans une machine virtuelle, car cela pourrait introduire des interférences en termes de performance et de temps réel, affectant ainsi la qualité d'impression.

Explication des types de firmware

• Mode Katapult / HID

  • Fonctionnalité : Ces deux modes ont des fonctionnalités identiques, et permettent tous deux le flashage sans contact (pas besoin d'insérer ou retirer une carte mémoire, la mise à jour du firmware s'effectue directement depuis l'hôte).
  • Explication : HID est le Bootloader utilisé par l'hôte intégré sur les cartes FLY. En réalité, il est identique à Katapult.
  • Avertissement important : lors de l'utilisation de Katapult, si un firmware incorrect a été flashé et que la carte mère ne répond plus, trouvez le bouton de réinitialisation sur la carte mère et double-cliquez rapidement, vous pourrez ainsi ré-entrer en mode Katapult et reflasher le firmware.

• Mode Bootloader

  • Fonctionnalité : Méthode traditionnelle de flashage via une carte mémoire.
  • Avantage : Cette méthode est plus tolérante aux erreurs. Si jamais vous flashiez un firmware incorrect, il suffit de reflasher la carte mémoire pour réessayer, sans craindre que la carte mère ne devienne inutilisable.

Guide de compilation du firmware

Préparation et recommandations pour la compilation

• Afin de maximiser les chances de réussite de la compilation, il est recommandé d'utiliser MobaXterm comme client SSH. Selon les retours utilisateurs, certains outils SSH pourraient provoquer des erreurs de compilation inconnues.
• Paramètre important : Dans l'interface de configuration de la compilation, veuillez cocher l'option Enable extra low-level configuration options, sans quoi certaines options avancées ne seront pas visibles.

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

Avertissement important

• Cette option permet de forcer l'état électrique de certains GPIO spécifiques au démarrage du microcontrôleur.
• Il est nécessaire de passer en clavier anglais pour pouvoir compiler le firmware, sinon la compilation échouera.

• Syntaxe de configuration :

  • Ajouter ! devant le nom de la broche signifie que celle-ci sera mise à un niveau bas (état bas) au démarrage ; sans !, elle sera mise à un niveau haut (état haut).
  • Série STM32 : le numéro de la broche doit être en majuscules (ex. !PF8 ou PF8).
  • Série RP2040 : le numéro de la broche doit être en minuscules (ex. !gpio5 ou gpio5).

• Configuration de plusieurs broches : si plusieurs broches doivent être configurées, séparez-les par une virgule anglaise ,.

  • Exemple : !gpio5,!gpio19,gpio24 signifie que gpio5 et gpio19 sont mises à un niveau bas, tandis que gpio24 est mise à un niveau haut au démarrage.

Remarque sur la sécurité

La configuration GPIO pins to set at micro-controller startup n'est active qu'avant que Klipper ne se connecte et ne démarre. Une fois Klipper connecté et fonctionnel, ce paramètre n'affecte plus les opérations effectuées sur ces broches, son utilisation est donc sûre.

Récupération après un flashage raté et protection générale

• Protection en cas de mauvais firmware : les firmwares Katapult, HID et Bootloader disposent chacun d'un mécanisme de protection. Tant que vous ne passez pas en mode DFU spécial pour le flashage, même si le firmware principal est incorrect, ces firmwares ne seront pas écrasés et la carte mère ne sera pas « cassée ».
• Opération nécessaire après le flashage : après tout flashage de firmware, veuillez couper complètement l'alimentation de l'appareil (débranchez le câble d'alimentation), puis rallumez-le, afin de vous assurer que le nouveau firmware est correctement chargé et fonctionne de manière stable.

Instructions pour le flashage du firmware

Informations avant le flashage

• Reconnaissance de l'appareil : lors de l'utilisation de Katapult pour le flashage, assurez-vous que l'hôte reconnaît l'appareil. Si l'appareil n'est pas trouvé, veuillez double-cliquer rapidement sur le bouton de réinitialisation de la carte mère pour réentrer en mode flashage.
• Respect des normes : veuillez suivre strictement la méthode de flashage décrite dans le tutoriel officiel. L'utilisation d'autres méthodes non validées pourrait endommager l'appareil.
• Vérification de la compilation : avant de flasher, assurez-vous impérativement que le firmware ne contient aucune erreur de compilation. Un fichier firmware incorrect pourrait entraîner un échec du flashage ou un fonctionnement anormal de l'appareil.

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

1. Trouvez le bouton de réinitialisation physique sur la carte mère et double-cliquez rapidement dessus.
2. Normalement, sur la carte FLY, une LED commence à clignoter, ce qui indique que le mode Katapult a été correctement activé.
3. Vous pouvez alors effacer le firmware incorrect de la carte mère et reflasher le firmware Klipper correct.

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

1. Réinsérez la carte TF contenant le firmware correct dans la carte mère.
2. Si le flashage échoue, veuillez d'abord couper complètement l'alimentation, insérez la carte TF, puis rallumez.
3. Laissez l'appareil sous tension pendant environ 5 secondes, le flashage automatique sera alors terminé.

---