Configuration de Klipper pour connexion filaire

Avertissement important

• Il est nécessaire d’installer le firmware sur le STM32F072 avant de le connecter à Klipper ; sinon, la connexion filaire ne sera pas possible.

Commencer la compilation

Guide concis de compilation du firmware

Notes importantes

• Réseau : Assurez-vous que l'ordinateur maître (Raspberry Pi, etc.) est connecté au réseau.
• Méthode de connexion : Utilisez obligatoirement SSH via le réseau pour vous connecter, désactivez la liaison série.
• Méthode de saisie : Gardez le clavier en mode anglais demi-chasse.

---

Connexion SSH et changement d'utilisateur

Connectez-vous à l'ordinateur maître via SSH avec des outils comme MobaXterm, PuTTY, etc.

Changer d'utilisateur :

• Système standard (système officiel Raspberry Pi, etc.)
  Interdiction d'utiliser root, basculez vers un utilisateur standard :

  su <nom_utilisateur>

• FLY ordinateur maître (système FlyOS-FAST)
  Seul l'utilisateur root est autorisé à se connecter (mot de passe : mellow).

---

Guide d'opération de compilation du firmware

Dans l'interface de configuration du firmware Klipper, seul le clavier est pris en charge, la souris est inutilisable.

Touche	Fonction
↑ / ↓	Déplacer le curseur vers le haut/bas, sélectionner une option de menu
Entrée / Espace	Confirmer la sélection, cocher une option ou entrer dans un sous-menu
Échap	Revenir au menu précédent
Q	Quitter l'interface de configuration
Y	En quittant, appuyer sur Y pour sauvegarder la configuration si demandé

Commencer la compilation du firmware

Voici comment compiler le firmware :

1. Connectez-vous en 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 permet de supprimer la configuration et le firmware précédents ; make menuconfig permet d'ouvrir l'interface de configuration du firmware Klipper.

2. Configurez chaque option dans l'ordre ci-dessous, en terminant chaque étape avant de passer à la suivante.

   1启用 Enable extra low-level configuration options

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   2Micro-controller Architecture 选择 STMicroelectronics STM32

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (STMicroelectronics STM32) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   3Processor model 选择 STM32F072

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (STMicroelectronics STM32) --->

   Processor model (STM32F072) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   4Bootloader offset 选择 No bootloader

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (STMicroelectronics STM32) --->

   Processor model (STM32F072) --->

   Bootloader offset (No bootloader) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   5Clock Reference 选择 8 MHz crystal

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (STMicroelectronics STM32) --->

   Processor model (STM32F072) --->

   Bootloader offset (No bootloader) --->

   Clock Reference (8 MHz crystal) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   6Communication interface 选择 USB (on PA11/PA12)

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (STMicroelectronics STM32) --->

   Processor model (STM32F072) --->

   Bootloader offset (No bootloader) --->

   Clock Reference (8 MHz crystal) --->

   Communication interface (USB (on PA11/PA12)) --->

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   7启用 Optimize stepper code for 'step on both edges'

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (STMicroelectronics STM32) --->

   Processor model (STM32F072) --->

   Bootloader offset (No bootloader) --->

   Clock Reference (8 MHz crystal) --->

   Communication interface (USB (on PA11/PA12)) --->

   USB ids --->

   [*] Optimize stepper code for 'step on both edges'

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   8按 Q 键退出配置界面

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (STMicroelectronics STM32) --->

   Processor model (STM32F072) --->

   Bootloader offset (No bootloader) --->

   Clock Reference (8 MHz crystal) --->

   Communication interface (USB (on PA11/PA12)) --->

   USB ids --->

   [*] Optimize stepper code for 'step on both edges'

   () GPIO pins to set at micro-controller startup

   [Space/Enter] Toggle/enter[?] Help[/] Search

   [Q] Quit (prompts for save)[Esc] Leave menu

   GPIO 状态说明：GPIO state at micro-controller startup 是 FLYOS-Klipper 的扩展功能，本页面仅作说明。普通固件编译请保持 Not set，无需进入或修改；如需了解全部 GPIO 启动状态，请查看 GPIO 启动状态使用说明。

   9出现 Save configuration 时按 Y 保存配置

   Quit

   Save configuration?

   (Y)es(N)o(C)ancel

3. Une fois les deux dernières étapes ci-dessus terminées, appuyez sur Q pour quitter l'interface de configuration, puis sur Y pour enregistrer la configuration.

4. Revenez à la ligne de commande, saisissez la commande suivante et appuyez sur Entrée pour commencer la compilation :

   make -j4

   root@flyos-11e5f8 ~/klipper # make -j4

   Compiling out/src/stm32/stm32f0_adc.o

   Compiling out/src/stm32/spi.o

   Compiling out/src/stm32/stm32f0_i2c.o

   Compiling out/src/stm32/usbfs.o

   Compiling out/src/stm32/chipid.o

   Compiling out/src/generic/usb_cdc.o

   Compiling out/src/stm32/hard_pwm.o

   Preprocessing out/src/generic/armcm_link.ld

   Building out/compile_time_request.o

   Version: XXXX

   Linking out/klipper.elf

   Creating bin file out/klipper.bin

   终端末尾出现 Linking out/klipper.elf 和 Creating bin file out/klipper.bin，即表示编译成功。 实际编译时，部分 Compiling 行和 Version 会随 Klipper 与系统版本变化。

Entrer en mode de gravure

• Tandis que l’AirClick est déconnecté de l’électricité, maintenez enfoncé le bouton BOOT du STM32 afin de relier la porte de gravure via Type-C au ordinateur principal
  Loading...

Graver le firmware

1. Installation de l'outil de flashage

• L'ordinateur hôte FLY n'a pas besoin d'installer d'outil de flashage.
• Si une installation est nécessaire, l'ordinateur hôte doit pouvoir se connecter normalement à Internet.
• Si l'installation a déjà été effectuée, il n'est pas nécessaire de la répéter.

sudo apt update
sudo apt install dfu-util -y

2. Vérifier que l'appareil est en mode DFU

lsusb

• Si aucun appareil DFU n'apparaît, veuillez repasser en mode flashage.
• Selon la version du système, le nom de l'appareil peut varier ; tant que 0483:df11 est visible, cela signifie que l'appareil est en mode DFU.

Loading...

3. (Facultatif) Effacement complet

L'effacement complet supprime le Bootloader

mass-erase efface l'intégralité de la Flash du MCU, y compris Katapult / Bootloader. Il ne doit être utilisé que lorsque l'appareil ne peut pas être flashé normalement et nécessite une restauration complète. Ne l'exécutez pas lors d'une mise à jour normale du firmware ; après l'effacement, vous devez reflasher le Bootloader, puis flasher le firmware applicatif.

Lorsqu'il est confirmé qu'un effacement complet est nécessaire, exécutez :

sudo dfu-util -a 0 -d 0483:df11 -s 0x08000000:mass-erase:force

Cette commande efface uniquement sans écrire de firmware ; une fois terminée, passez à l'étape suivante.

4. Flashage du firmware

Exécutez la commande ci-dessous pour démarrer le flashage. Veuillez remplacer <chemin complet du fichier firmware> par le chemin réel du fichier firmware :

sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D <chemin complet du fichier firmware>

5. Vérification du résultat du flashage

L'apparition de File downloaded successfully indique que le flashage a réussi :

Loading...

Astuce

Une fois le flashage terminé, il est nécessaire de couper complètement l'alimentation de la carte mère une fois.

Rechercher le USBID

• Il est nécessaire de relier la porte de gravure de l’AirClick à un port USB de l’ordinateur principal. Ne maintenez pas enfoncé le bouton BOOT, sinon l’ID ne pourra pas être recherché
  Loading...

Obtention de l'ID USB de la carte mère

Précautions

Opération hors tension

Lorsque vous devez connecter ou rebrancher le câble USB de la carte mère, veuillez d'abord éteindre complètement l'imprimante et débrancher l'alimentation électrique. Ne branchez pas ou ne débranchez pas le faisceau de câbles lorsque l'appareil est sous tension.

Portée d'utilisation

• Vous devez vous connecter à l'hôte via SSH pour exécuter les commandes de recherche.
• Avant toute opération, assurez-vous que la carte mère a été flashée avec le firmware USB et qu'elle est connectée au port USB de l'hôte via un câble Type-C.
• Ce tutoriel sert uniquement à rechercher l'ID USB de la carte mère et ne s'applique pas à la recherche de l'ID des cartes d'outillage.
• Pour les cartes d'outillage, veuillez utiliser le tutoriel d'obtention de l'ID USB ou CAN dans la documentation du produit correspondante.

Étapes d'opération

Recherche de l'ID du périphérique USB

Connectez-vous à l'hôte via SSH, puis exécutez la commande suivante pour lister tous les ID des périphériques USB série :

ls /dev/serial/by-id/*

ID non utilisables

Après avoir exécuté la commande, évitez d'utiliser les deux catégories d'ID suivantes :

Caractéristique de l'ID	Raison de l'explication	Exemple
usb-1a86_USB_Serial-if00-port0	Le nom par défaut des puces série génériques comme CH340, ne peut pas servir d'adresse de connexion pour la carte mère Klipper	/dev/serial/by-id/usb-1a86_USB_Serial-if00-port0
Contient katapult	Le périphérique est en mode de flashage Katapult, vous devez d'abord flasher le firmware Klipper	/dev/serial/by-id/usb-katapult_xxxxxxxxxxxx

Résultats de la recherche

Dans des conditions normales, le terminal affichera un chemin de périphérique similaire à l'image ci-dessous. L'ID dans l'image est uniquement fourni à titre d'exemple de format.

Loading...

Aucun ID disponible trouvé : Consultez le dépannage du firmware et des connexions du périphérique

Plusieurs ID apparaissent

Si la commande renvoie plusieurs ID utilisables, veuillez identifier le chemin complet du périphérique correspondant à la carte mère en fonction du modèle de MCU de la carte ainsi que des changements dans la liste des périphériques avant et après le branchement/débranchement.

Remplir l'ID USB dans la configuration

Ouvrez printer.cfg dans Fluidd ou Mainsail :

Fluidd : Cliquez sur l'icône {…} à gauche, puis ouvrez printer.cfg. Loading...

Mainsail : Cliquez sur « Machine » à gauche, puis ouvrez printer.cfg. Loading...

L'ID doit correspondre à un résultat réel de la recherche

Les chemins de périphériques dans la documentation sont des exemples. L'ID USB de chaque carte mère peut différer. Veuillez copier intégralement le chemin réel renvoyé par la commande SSH.

Trouvez la section de configuration [mcu] et modifiez serial pour indiquer le chemin complet du périphérique obtenu :

[mcu]
serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx

Lorsque vous utilisez le firmware USB, vous devez configurer serial. Ne remplissez pas canbus_uuid dans la même section de configuration [mcu].

L'emplacement de configuration peut être consulté dans l'image ci-dessous :

Exemple de configuration Fluidd Loading...

Exemple de configuration Mainsail Loading...

Après avoir effectué les modifications, cliquez sur SAVE & RESTART en haut à droite pour enregistrer la configuration et redémarrer Klipper.