Compilation du firmware USB

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 选择 Raspberry Pi RP2040/RP235x

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

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

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

   3Processor model 选择 rp2040

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

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

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

   4Bootloader offset 选择 16KiB bootloader

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

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

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

   5Communication Interface 选择 USBSERIAL

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   Communication Interface (USBSERIAL) --->

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

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

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

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   Communication Interface (USBSERIAL) --->

   USB ids --->

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

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

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

   7按 Q 键退出配置界面

   (Top)

   Klipper Firmware Configuration

   [*] Enable extra low-level configuration options

   Micro-controller Architecture (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   Communication Interface (USBSERIAL) --->

   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 启动状态使用说明。

   8出现 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/rp2040/bootrom.o

   Compiling out/src/rp2040/usbserial.o

   Compiling out/src/generic/usb_cdc.o

   Compiling out/src/rp2040/chipid.o

   Compiling out/src/rp2040/hard_pwm.o

   Compiling out/src/rp2040/spi.o

   Compiling out/src/rp2040/i2c.o

   Preprocessing out/src/rp2040/rpxxxx_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 与系统版本变化。

Vérifier le mode de brûlage

Opération d’arrêt

Avant de commencer, veuillez éteindre complètement l’imprimante et déconnecter l’alimentation électrique. Ne connectez ni ne déconnectez pas les câbles, ne réorganisez pas les connexions ni n’approchez pas les bornes tant que l’appareil est allumé.

• Après avoir connecté la carte mère à l’ordinateur hôte à l’aide d’un câble USB Type-C, faites un double-clic sur le bouton reset ; une LED sur la carte mère se mettra alors à clignoter.

Avertissement

• Si la LED ne clignote pas, veuillez ré-exécuter le brûlage du firmware Katapult : Brûler le firmware Katapult
• Si la LED ne clignote pas, veuillez effectuer l’étape suivante après avoir terminé le brûlage du firmware Katapult

Brûler le firmware

Commencer la gravure

Sélectionnez la méthode de gravure en fonction de l'état actuel de l'appareil :

您的下位机现在是什么状态

Causes courantes d'échec

Phénomène	Cause possible	Traitement
usb-katapult_ introuvable	Katapult non démarré, câble de données en charge seule ou port USB défectueux	Double-cliquer sur RST ; vérifier 1d50:6177 avec lsusb ; changer de câble de données et de port USB
Invalid firmware path '...'	Le chemin -f n'existe pas, ou le firmware n'a pas encore été compilé	Revenir à l'étape de compilation et vérifier que ~/klipper/out/klipper.bin existe
Unable to open serial port	Le service Klipper occupe le port série	Exécuter sudo systemctl stop klipper puis réessayer
Device is not Katapult, exiting...	L'appareil n'est pas en mode Katapult	Double-cliquer sur RST pour y revenir ; si cela ne fonctionne toujours pas, consulter la documentation de restauration du Bootloader du produit concerné
Flash Tool Error accompagné d'une Traceback	Câble, alimentation ou type de firmware incompatible	Conserver la sortie complète et vérifier si un firmware USB / USB vers CAN erroné a été flashé
Flashage réussi mais Klipper ne se connecte pas	Type de firmware incohérent avec le câblage, ou [mcu] non mis à jour	Confirmer si usb-Klipper_ ou canbus_uuid doit apparaître, et modifier [mcu]
Double-clic sur RST sans voyant, 1d50:6177 toujours absent	Katapult est probablement corrompu	Consulter la documentation de restauration du Bootloader (Katapult) du produit concerné

Rechercher l’ID USB après le brûlage

Une fois le brûlage du firmware terminé et que la carte mère a été redémarrée, continuez à rechercher l’ID USB.

Voir comment obtenir l’ID USB