Aller au contenu principal

Compilation du firmware USB

Connexion à l'ordinateur hôte​

Limitation de la connexion principale

La carte mère Fly-D5 ne peut communiquer avec Klipper sur l'ordinateur hôte que via le port USB Type-C.

Loading...

Notes et guide d'opération pour la compilation du firmware​

Notes importantes​

📌 Prérequis essentiels
  1. Connexion réseau : Assurez-vous que l'ordinateur hôte (Raspberry Pi, etc.) est connecté au réseau.
  2. Méthode d'accès : Vous devez vous connecter à l'ordinateur hôte via SSH en utilisant le réseau. L'utilisation d'outils de communication série est interdite.
  3. Permissions utilisateur : Utilisez le compte utilisateur approprié en fonction du type de système de l'ordinateur hôte.
  4. Méthode de saisie : Assurez-vous que la méthode de saisie du clavier est en mode demi-largeur (mode anglais).

Connexion SSH et changement d'utilisateur​

Connexion SSH à l'ordinateur hôte​

Utilisez un outil SSH (comme MobaXterm, PuTTY, etc.) pour vous connecter à l'ordinateur hôte via le réseau : Voir le tutoriel détaillé pour la connexion SSH

Changer d'utilisateur selon le type de système​

Systèmes applicables :

  • Système officiel Raspberry Pi
  • Autres systèmes avec Klipper déjà installé

Exigences de permissions utilisateur :

  • Il est interdit d'utiliser l'utilisateur root pour toute opération.
  • Vous devez passer à un utilisateur standard pour effectuer les opérations.

Commande de changement :

  • Autres systèmes (remplacez <username> par votre nom d'utilisateur)

    su <username>
💡 Astuce

L'utilisateur standard dispose généralement des permissions de compilation nécessaires. L'utilisation de l'utilisateur root peut entraîner des problèmes de permissions.

Explications sur la compilation du firmware​

1. Guide d'utilisation du clavier​

  • Dans la page de configuration du firmware Klipper, vous ne pouvez utiliser que les raccourcis clavier suivants :
  • Il est impossible d'utiliser directement la souris !
ToucheFonction
Flèches ↑ ↓Déplacer le curseur vers le haut/le bas pour sélectionner les éléments du menu
Entrée ou EspaceConfirmer la sélection/cocher l'élément du menu ou entrer dans un sous-menu
ÉchapRetourner au menu précédent
QQuitter la page de configuration du firmware Klipper
YSi une confirmation apparaît à la sortie, appuyez sur Y pour sauvegarder la configuration

Afficher les options cachées​

⚠️ Afficher les options cachées

Si la page de configuration présente peu d'options, veuillez d'abord cocher :

[ ] Enable extra low-level configuration options

Cette option permet d'afficher certaines options de configuration cachées.

Commencer la compilation du firmware​

Voici comment compiler le firmware :

  • Après la connexion SSH, saisissez la commande suivante et appuyez sur Entrée :

    cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig

  • Ici, rm -rf ~/klipper/.config && rm -rf ~/klipper/out supprime les données de compilation et le firmware précédents.

  • make menuconfig compile le firmware. Après exécution, l'interface suivante devrait apparaître :

    Loading...

  • Sélectionnez Enable extra low-level configuration options et appuyez sur Entrée.

    Loading...

  • Accédez au menu Micro-controller Architecture, puis sélectionnez STMicroelectronics STM32 et appuyez sur Entrée.

    Loading...

  • Accédez au menu Processor model, sélectionnez STM32F072 et appuyez sur Entrée.

    Loading...

  • Sélectionnez Bootloader offset, puis choisissez : 8KiB bootloader.

    Loading...

  • Communication interface, sélectionnez : USB (on PA11/PA12) et appuyez sur Entrée.

    Loading...

  • Veuillez vérifier en comparant avec l'image ci-dessous, assurez-vous qu'elle correspond avant de passer à l'étape suivante.

    Loading...
  • Appuyez sur la touche Q, l'option Save configuration apparaît, puis appuyez sur la touche Y.
    Loading...
  • La configuration devrait maintenant être sauvegardée et vous devriez être revenu à l'interface de ligne de commande.
  • Saisissez la commande ci-dessous pour commencer la compilation, cela prendra un certain temps.
make -j4
Loading...
  • La compilation est réussie si la sortie finale correspond au contenu ci-dessous.
  • En raison de la version de Klipper, l'apparition de out/klipper.bin indique le succès. 
    Linking out/klipper.elf
    Creating bin file out/klipper.bin

Entrer en mode programmation​

  • Après avoir connecté la carte mère à l'ordinateur hôte avec un câble de données Type-C, double-cliquez sur le bouton RST. À ce moment, une LED clignotera sur la carte mère.
Avertissement
  • Si aucune LED ne clignote, veuillez reprogrammer le firmware katapult : Programmer le firmware katapult
  • Si aucune LED ne clignote, après avoir programmé le firmware katapult, passez à l'étape suivante.
Loading...
  • Assurez-vous que la machine supérieure peut se connecter normalement à Internet et que le câble de données du périphérique inférieur connecté à la machine supérieure a une fonction de transmission de données.
  • Après avoir établi une connexion SSH avec la machine supérieure, entrez la commande lsusb et appuyez sur Entrée. Si l'information entourée dans l'image ci-dessous est affichée, vous pouvez passer à l'étape suivante.
    • Si aucune information n'est retournée, il s'agit d'un problème système de la machine supérieure, nous ne pouvons rien faire. Vous devez remplacer un système confirmé comme fonctionnel ou changer la machine supérieure.
    • Si la commande lsusb ne fonctionne pas, vous pouvez exécuter la commande suivante pour l'installer : 
      sudo apt-get install usbutils
      Loading...
  • 1d50:6177 appartient à l'appareil que vous utiliserez cette fois.
    • Certaines machines supérieures peuvent ne pas afficher correctement ou ne pas afficher du tout en raison de problèmes système.
    • Si vous pouvez voir l'appareil après avoir entré la commande lsusb, mais que 1d50:6177 n'est pas affiché, essayez de changer de câble de données et connectez le contrôleur mère à un autre port USB de la machine supérieure.
  • Si vous avez effectué les étapes mentionnées précédemment et que la mise à jour du firmware Klipper a réussi, et que le contrôleur mère fonctionne normalement, mais que vous souhaitez uniquement mettre à jour le firmware Klipper, veuillez consulter la section Mise à jour du firmware du menu latéral droit de cette page.
Remarque importante

Il est obligatoire de trouver le périphérique 1d50:6177 avant de poursuivre.

Programmer le firmware​

Début de la programmation​

📌 Prérequis
  • Une connexion Internet est nécessaire pour installer le plugin de programmation, assurez-vous que votre ordinateur hôte est connecté à Internet
  • Si le plugin de programmation est déjà installé, il n'est pas nécessaire de le réinstaller

Installation des dépendances de programmation​

⚠️ Important

Si vous utilisez un ordinateur hôte non officiel de Fly, veuillez absolument exécuter la commande suivante pour installer le package de dépendances de programmation du firmware !

cd && git clone https://github.com/Arksine/katapult.git
Loading...

Obtenir l'ID de la carte mère​

Exécutez la commande suivante pour rechercher l'ID de l'appareil. Normalement, un ID similaire à celui de l'image ci-dessous devrait s'afficher (Remarque : chaque carte mère a un ID différent) :

ls /dev/serial/by-id/*
Loading...

Programmer le firmware​

⚠️ Préparation
  • Assurez-vous que le fichier du firmware a été compilé
  • Remplacez <Votre ID de carte mère> dans la commande ci-dessous par l'ID réel obtenu à l'étape précédente
python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<Votre ID de carte mère>

Référence du processus de programmation :

Loading...

Référence de programmation réussie :

Loading...

Mise à jour du firmware​

Étapes de mise à jour du firmware via USB​

  1. Rechercher l'ID de la carte mère
ls /dev/serial/by-id/*
Point clé d'identification

Dans l'image ci-dessous, /dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00 est l'ID de la carte mère

Loading...
  1. Mettre à jour le firmware
cd ~/klipper/ && make flash FLASH_DEVICE=<Votre ID de carte mère>
Remarque
  • Veuillez remplacer <Votre ID de carte mère> par l'ID réellement obtenu
Loading...

Solution en cas de programmation incorrecte du firmware​

Méthode 1 : Entrer rapidement en mode programmation​

  1. Mettre la carte mère hors tension
  2. Après la remise sous tension, appuyer rapidement deux fois sur le bouton RESET
  3. Revenir en mode programmation

Méthode 2 : Reprogrammer le firmware Katapult​

Cliquez pour voir le guide de programmation du firmware Katapult
Loading...