Configuration de Klipper via une connexion filaire
- Il faut flasher le firmware sur le STM32F072 avant de le connecter à Klipper, sinon les opérations de connexion filaire ne sont pas prises en charge
Démarrage de la compilation
- Vous devez utiliser une station supérieure avec le service
klipper
installé Connexion via SSH par réseau - Assurez-vous que l'appareil est bien connecté à la station supérieure
- Attention : Veuillez utiliser une station supérieure ordinaire, comme un Raspberry Pi ou un FLY Pi. Si vous utilisez une station supérieure modifiée (par exemple, une clé WiFi, Redmi, etc.), ces stations présentent trop de problèmes et nous ne pouvons pas vous fournir de support technique
- Pour passer de l'utilisateur
ROOT
à un utilisateur normal, vous pouvez entrer la commande ci-dessous - N'utilisez pas l'utilisateur
ROOT
- L'utilisateur fly peut simplement entrer :
su fly
, si vous n'êtes pas l'utilisateur fly, veuillez remplacer<Votre nom d'utilisateur sur la station supérieure>
par votre nom d'utilisateur sur la station supérieure !
su <Votre nom d'utilisateur sur la station supérieure>
- Assurez-vous que l'hôte peut se connecter normalement à Internet
- Avant de compiler le firmware, vous devez utiliser SSH pour vous connecter à distance via le réseau à l'hôte
- Veuillez ne pas utiliser d'outil de terminal série pour vous connecter à l'hôte
Instructions d'utilisation pour la compilation et la configuration du firmware Klipper
Assurez-vous que le mode de saisie du clavier est en mode demi-largeur, c'est-à-dire en mode anglais
- La touche
↑
(haut) et la touche↓
(bas) du clavier sont utilisées pour déplacer le curseur verticalement afin de sélectionner les éléments du menu - La touche
Entrée
ou la toucheEspace
est utilisée pour cocher une option de menu ou entrer dans un sous-menu - La touche
Échap
est utilisée pour revenir au menu précédent - La touche
Q
permet de quitter la page de configuration du firmware Klipper - La touche
Y
, lorsqu'on quitte la page de configuration du firmware Klipper et qu'une invite apparaît, appuyez surY
pour enregistrer le fichier de configuration
Si le nombre d'options de la page de configuration est limité, activez d'abord [ ] Activer les options de configuration de niveau inférieur supplémentaires
pour afficher certaines options masquées
Voici la traduction en français :
Voici comment compiler le firmware :
-
Connectez-vous à SSH puis tapez la commande suivante et appuyez sur Entrée :
cd ~/klipper && rm -rf ~/klipper/.config && rm -rf ~/klipper/out && make menuconfig
-
Où
rm -rf ~/klipper/.config && rm -rf ~/klipper/out
est la suppression des données de compilation précédentes et du firmwaremake menuconfig
est la compilation du firmware, après quoi l'interface suivante devrait apparaître -
Sélectionnez Activer les options de configuration de bas niveau supplémentaires et appuyez sur Entrée
-
Allez dans le menu Microcontrôleur Architecture puis sélectionnez STMicroelectronics STM32 et appuyez sur Entrée
-
Allez dans le menu Modèle de processeur, sélectionnez STM32F072 et appuyez sur Entrée
-
Sélectionnez Décalage du bootloader, sélectionnez : (Pas de bootloader)
-
Interface de communication, sélectionnez : USB (sur PA11/PA12)
-
Appuyez sur la touche
Q
, vous verrez Save configuration, appuyez ensuite surY
-
Vous devriez maintenant avoir sauvegardé la configuration et être retourné à l'interface de ligne de commande
-
Tapez
make -j4
pour commencer la compilation, cela prendra un certain temps -
Si vous obtenez le message suivant, la compilation a réussi
Linking out/klipper.elf
Creating hex file out/klipper.bin
Entrer en mode de programmation
- Lorsque AirClick est débranché, maintenez le BOOT du STM32 et connectez le port de programmation du STM32 au PC à l'aide d'un câble Typec
Vérifier si l'on est entré en mode de programmation
-
Assurez-vous que l'ordinateur hôte peut accéder à Internet normalement
-
Assurez-vous que le câble de données du périphérique inférieur est capable de transférer des données avec l'ordinateur hôte
-
Après la connexion SSH à l'ordinateur hôte, tapez
lsusb
et appuyez sur Entrée. Il peut y avoir trois cas possibles- Affiche les appareils USB déjà reconnus
- Indique qu'il n'y a pas de commande
ls
, vous pouvez exécuter cette commande pour l'installersudo apt-get install usbutils
- Aucune erreur, aucune autre information (problème système nécessitant un changement de système)
-
Après avoir entré
lsusb
, il ne se passe rien, c'est un problème système, nous ne pouvons rien faire, vous devez changer de système fonctionnel -
Si l'information encadrée sur l'image ci-dessous apparaît, vous pouvez passer à l'étape suivante
-
0843:df11
est l'appareil que vous devrez utiliser cette fois-ci. Les prochaines indications ne sont pas nécessaires, car des problèmes de système peuvent entraîner une affichage incomplet ou même aucun affichage -
Si ce n'est pas le cas, vérifiez vous-même si le câble de données est correctement branché ou si la carte mère est entrée en mode DFU
Passez à l'étape suivante uniquement s'il y a 0483:df11
Programmer le firmware
- Installation de l'outil de gravure
- Le logiciel supérieur FLY n'a pas besoin d'exécuter l'installation de l'outil de gravure
- Si vous devez installer, veuillez noter : le logiciel supérieur doit être connecté à Internet pour installer correctement
- Si vous avez déjà installé, vous n'avez pas besoin d'installer
sudo apt update
sudo apt install dfu-util -y
- Exécutez la commande suivante pour vérifier si la connexion est réussie.
lsusb
- Si aucun périphérique DFU n'est détecté, essayez de réentrez en mode de gravage
- En raison des problèmes de version du système, il peut afficher un autre nom, si vous voyez
0483:df11
, cela signifie que vous êtes en mode de gravage

- Gravure du firmware
- Exécutez le code ci-dessous pour commencer la gravure
sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/klipper/out/klipper.bin
- Si vous voyez le contenu indiqué à l'endroit de la flèche dans l'image ci-dessous
File downloaded successfully
, alors la gravure a réussi

Après la gravure, vous devez déconnecter complètement l'alimentation de la carte mère une fois.
Rechercher le USBID
- Connectez le port de programmation d'AirClick au port USB du PC, ne tenez pas le bouton BOOT, sinon l'ID ne sera pas trouvé
Recherche de tutoriels USB
Précautions avant la recherche du périphérique
- Avant de rechercher l'ID USB, connectez-vous d'abord à SSH [/docs/DebugDoc/BasicTutorial/index.mdx "cliquez pour accéder"]
- Veuillez vous assurer que vous êtes connecté via le réseau à SSH et non via un port série
- Assurez-vous d'avoir correctement branché la carte mère flashée avec le firmware USB et que le câble de connexion vers l'ordinateur dispose des fonctionnalités de transmission de données
Recherche du périphérique
- Assurez-vous que l'ordinateur principal peut se connecter normalement à Internet et que le périphérique inférieur est connecté à l'ordinateur principal avec un câble de données ayant une fonction de transmission de données.
- Après avoir établi une connexion SSH avec l'ordinateur principal, entrez
lsusb
puis appuyez sur Entrée. Si des informations entourées dans l'image ci-dessous apparaissent, vous pouvez passer à l'étape suivante.- Si aucune information n'est renvoyée, il s'agit d'un problème du système de l'ordinateur principal. Nous ne pouvons rien faire. Vous devez remplacer un système confirmé comme fonctionnel ou changer l'ordinateur principal.
- Si la commande
lsusb
n'existe pas, vous pouvez installer cette commande en exécutant :sudo apt-get install usbutils
1d50:614e
appartient au périphérique que vous utiliserez cette fois-ci.- Certains ordinateurs principaux peuvent afficher incomplètement ou ne pas afficher du tout en raison de problèmes système.
- Si la commande
lsusb
affiche correctement le périphérique mais sans1d50:614e
, essayez de changer le câble de données et connectez le contrôleur carte mère à un autre port USB de l'ordinateur principal.
- Si vous avez effectué les étapes ci-dessus auparavant et que vous avez réussi à graver le firmware Klipper, que la carte mère fonctionne normalement, mais que vous souhaitez simplement mettre à jour le firmware Klipper, consultez la section
Mise à jour du firmware
du menu latéral droit de cette page.
Il est obligatoire de trouver l'une des cartes 1d50:614e
avant de passer à l'étape suivante.
Recherche de l'ID USB
ls /dev/serial/by-id/*
- Entrez la commande ci-dessous et appuyez sur Entrée. Si tout se passe bien, une ligne bleue contenant l'ID apparaîtra (l'exemple ci-dessous est indicatif).

- Si aucune ID n'apparaît après l'entrée de la commande ci-dessous, mais que
lsusb
affiche des appareils, veuillez changer l'ordinateur ou le système d'exploitation de l'ordinateur
Si plusieurs IDs apparaissent, choisissez celui correspondant au modèle de MCU de votre carte mère.
Remplissez l'ID USB dans la configuration
![]() |
![]() |
Remarque : Tous les IDs mentionnés dans le document sont indicatifs, chaque carte mère a un ID unique, veuillez remplacer par l'ID réellement obtenu.
Remplir l'ID USB
- Trouvez
[mcu]
, puis remplacez
- Remplacez dans le fichier de configuration :
[mcu]
serial: <remplacez par l'ID que vous avez trouvé>
- Référence
![]() |
![]() |
- Cliquez sur le bouton en haut à droite
SAVE & RESTART
. Le fichier sera automatiquement sauvegardé et klipper redémarrera automatiquement.