Instructions de compilation du firmware

Avertissement de sécurité important

Pour garantir la stabilité du système, veuillez respecter les principes d'utilisation du firmware suivants :

• Cohérence de 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 d'autres ou dont la version est incompatible peut entraîner des pannes imprévisibles.
• Conformité de la plateforme matérielle : Il est fortement recommandé d'utiliser un ordinateur hôte standard. Évitez d'utiliser des appareils modifiés de manière non officielle (par exemple, certains boîtiers TV, sticks WiFi ou certains modèles Redmi), car ces appareils peuvent présenter des risques 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, ce qui pourrait introduire des interférences de performance et de temps réel, affectant la qualité d'impression.

Description des types de firmware

• Mode Katapult / HID

  • Fonction : Ces deux modes ont la même fonction, tous deux permettent un flashage sans contact (pas besoin d'insérer/retirer la carte mémoire, mise à jour directe via l'ordinateur hôte).
  • Explication : HID est le Bootloader utilisé par l'ordinateur hôte intégré FLY, son essence est identique à Katapult.
  • Remarque importante : Lorsque vous utilisez Katapult, si un mauvais firmware est flashé et que la carte mère ne répond plus, veuillez localiser le bouton de réinitialisation sur la carte mère et double-cliquer rapidement pour revenir en mode Katapult et flasher à nouveau.

• Mode Bootloader

  • Fonction : Méthode de flashage traditionnelle via carte mémoire.
  • Avantage : Cette méthode offre une grande tolérance aux erreurs. Si un flashage incorrect est effectué, vous pouvez réessayer en reflashant la carte mémoire, sans craindre de « bricker » la carte mère.

Guide de compilation du firmware

Préparation et conseils pour la compilation

• Pour 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 peuvent provoquer des erreurs de compilation inconnues.
• Option de configuration importante : Sur l'écran de configuration de compilation, veuillez impérativement cocher l'option Enable extra low-level configuration options, sinon certains réglages avancés ne seront pas affichés.

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

Remarque importante

• Cette option permet de forcer le niveau électrique de broches GPIO spécifiques au démarrage du microcontrôleur.
• Il est nécessaire de passer en clavier anglais (saisie), sinon la compilation du firmware échouera.

• Syntaxe de configuration :

  • L'ajout de ! avant une broche signifie que cette broche sera mise à l'état bas (niveau bas) au démarrage ; l'absence de ! signifie qu'elle sera mise à l'état haut (niveau haut).
  • Série STM32 : Le numéro de broche doit être en majuscules, veuillez vous référer à la documentation réelle de la carte mère.
  • Série RP2040 : Le numéro de broche doit être en minuscules, veuillez vous référer à la documentation réelle de la carte mère.

• Configuration de plusieurs broches : Pour configurer plusieurs broches, séparez-les par des virgules anglaises ,.

  • Exemple : !<pin_a>,!<pin_b>,<pin_c> signifie que les deux premières broches seront mises à l'état bas au démarrage, tandis que la troisième sera mise à l'état haut.

Note de sécurité

Les GPIO pins to set at micro-controller startup que vous configurez ne sont actifs qu'avant la connexion de démarrage de Klipper. Une fois que Klipper est connecté et fonctionne normalement, ce réglage n'affectera aucune autre opération sur les broches et peut être utilisé en toute sécurité.

État GPIO global de démarrage

Fonctionnalité FLYOS-Klipper

GPIO state at micro-controller startup est une fonctionnalité étendue fournie par FLYOS-Klipper, cette option peut ne pas être disponible dans la version standard de Klipper. Sauf exigence explicite de la documentation de la carte mère ou de l'outil, veuillez conserver la valeur par défaut Not set.

Cette option permet de définir uniformément un état initial pour la plupart des GPIO physiques pendant la phase de démarrage du microcontrôleur. Elle diffère de l'option GPIO pins to set at micro-controller startup ci-dessus :

Élément de configuration	Portée
GPIO pins to set at micro-controller startup	Définit uniquement les broches explicitement renseignées dans le champ de saisie ; vous pouvez utiliser ! pour spécifier un niveau bas individuellement
GPIO state at micro-controller startup	Définit uniformément un même état de démarrage pour les autres GPIO physiques disponibles

Les broches suivantes ne seront pas couvertes par l'état global :

• Les broches renseignées dans GPIO pins to set at micro-controller startup.
• Les broches réservées par le firmware pour les fonctions de communication actuelles telles que UART, USB, CAN, USB vers CAN.

États disponibles

Option	Comportement en phase de démarrage	Recommandation d'utilisation
Not set	Ne modifie pas uniformément l'état de démarrage des autres GPIO	Option par défaut et recommandée
Input pull-up	Configure les autres GPIO en entrée avec résistance de rappel au niveau haut	À utiliser uniquement si la conception matérielle l'exige explicitement
Input pull-down	Configure les autres GPIO en entrée avec résistance de rappel au niveau bas	À utiliser uniquement si la conception matérielle l'exige explicitement
Output high	Configure les autres GPIO en sortie au niveau haut	Risque élevé, à utiliser uniquement selon la documentation du produit
Output low	Configure les autres GPIO en sortie au niveau bas	Risque élevé, à utiliser uniquement selon la documentation du produit

Ne définissez pas aveuglément un état de sortie global

Output high ou Output low modifiera le niveau d'un grand nombre de GPIO avant l'établissement de la connexion Klipper. Un mauvais choix peut provoquer des actions non prévues sur les ventilateurs, chauffages, activations de drivers ou autres périphériques. Sauf spécification explicite dans la documentation du produit FLY correspondant, vous devez choisir Not set.

Méthode d'utilisation

1. Activez Enable extra low-level configuration options dans make menuconfig.
2. Si nécessaire, renseignez d'abord les broches d'exception à contrôler individuellement dans GPIO pins to set at micro-controller startup, par exemple !gpio18. Séparez plusieurs broches par des virgules anglaises.
3. Accédez à GPIO state at micro-controller startup :
   • Pour un firmware normal, choisissez Not set.
   • Uniquement si la documentation du produit exige explicitement un état global, choisissez l'état d'entrée ou de sortie correspondant.
4. Appuyez sur Q pour quitter, appuyez sur Y lorsque Save configuration apparaît, puis recompilez et mettez à jour le firmware selon le tutoriel de flashage du produit.
5. Après le flashage, mettez complètement hors tension l'ordinateur inférieur, puis remettez-le sous tension.

Not set ne désactive pas les broches de démarrage individuelles

Choisir Not set signifie simplement « ne pas modifier uniformément les autres GPIO ». Les broches renseignées dans GPIO pins to set at micro-controller startup comme !gpio18, !PA15 ou d'autres continueront de prendre effet selon leur propre configuration.

Récupération après un flashage erroné et protections générales

• Protection contre un mauvais flashage : Les trois types de firmware Katapult, HID et Bootloader disposent de mécanismes de protection. Tant que vous n'entrez pas dans un mode DFU spécial pour flasher, même si le firmware principal est mal flashé, il ne sera pas écrasé, la carte mère ne « brickera » pas.
• 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 l'ordinateur inférieur (débrancher le câble d'alimentation), puis le 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 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 de flashage. Ou bien, reflashez le firmware BL de la carte mère.
• Suivre les normes : Veuillez suivre strictement les méthodes de flashage des tutoriels officiels. L'utilisation d'autres méthodes non vérifiées peut endommager l'équipement.
• Vérification de la compilation : Avant le flashage, assurez-vous que le firmware n'a pas d'erreurs de compilation. Un fichier de firmware erroné entraînera un échec du flashage ou un dysfonctionnement du dispositif.

Récupération après une erreur de flashage du firmware Katapult

1. Localisez le bouton de réinitialisation physique sur la carte mère et double-cliquez rapidement.
2. Normalement, un voyant LED sur la carte Fly commence à clignoter, indiquant que le mode Katapult a été activé avec succès.
3. Vous pouvez maintenant entrer en mode Katapult et reflasher le firmware Klipper correct.

Récupération après une erreur de flashage du firmware Bootloader

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

Installation des dépendances de flashage Katapult

Important

• Si vous utilisez un ordinateur hôte non officiel 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 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...

---