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

Domaine d'application

Ce processus est utilisé pour flasher le firmware Klipper qui vient d'être compilé via USB Katapult. Il suffit d'utiliser le type de firmware sélectionné sur la page actuelle.

1. Rechercher l'ID USB Katapult

Les hôtes non officiels FLY doivent d'abord installer Katapult :

Voir la méthode d'installation de Katapult

Exécutez la commande suivante :

ls /dev/serial/by-id/*

Résultat de la recherche

Le résultat de la recherche doit contenir un chemin complet incluant usb-katapult_, par exemple :

/dev/serial/by-id/usb-katapult_<modèle de puce>_<ID de l'appareil>-if00

L'ID de chaque carte est différent. Veuillez copier le chemin complet affiché pour votre propre appareil.

2. Flasher le firmware Klipper

Remplacer l'ID de l'appareil

Veuillez remplacer <Katapult USB ID> dans la commande par le chemin complet trouvé à l'étape précédente, sans conserver les chevrons.

• Hôte Linux standard
• FLYOS / Hôte FLY

~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d <Katapult USB ID>

python3 ~/katapult/scripts/flashtool.py -d <Katapult USB ID>

3. Confirmer le résultat du flashage

Si la commande s'exécute sans erreur, cela signifie que le firmware a été écrit. Une fois le flashage terminé, l'ID USB Katapult disparaîtra ; veuillez suivre les étapes suivantes de la page du produit actuel pour remettre sous tension et rechercher l'ID Klipper correspondant.

Loading...

Reflasher le firmware

Lorsque vous aurez besoin de mettre à jour le firmware Klipper déjà flashé à l'avenir, il ne sera pas nécessaire de reflasher Katapult. Veuillez d'abord recompiler le firmware cible sur la page actuelle, puis choisir une méthode en fonction de l'état actuel de l'appareil.

Méthode 1 : Utiliser une commande pour entrer automatiquement dans Katapult

Si vous pouvez actuellement rechercher un ID usb-Klipper_, vous pouvez demander à Klipper de faire passer automatiquement la carte en mode Katapult et de terminer le reflashage :

cd ~/klipper && make flash FLASH_DEVICE=<usb-Klipper ID>

Veuillez remplacer <usb-Klipper ID> par le chemin complet trouvé via ls /dev/serial/by-id/*. La commande utilise par défaut ~/klipper/out/klipper.bin.

Méthode 2 : Double-cliquer sur RST puis flasher manuellement

Si aucun ID usb-Klipper_ n'est actuellement disponible, ou si la méthode 1 échoue, veuillez utiliser la méthode suivante :

Opération hors tension

Avant de commencer, veuillez éteindre complètement l'imprimante et couper l'alimentation. Ne pas brancher ou débrancher le câble USB ni toucher les bornes sous tension.

1. Après avoir coupé l'alimentation, reconnectez le câble de données Type-C.

2. Double-cliquez rapidement sur le bouton RST de la carte et attendez que le voyant d'état clignote, indiquant que le mode Katapult est activé.

3. Recherchez l'ID USB Katapult :

   ls /dev/serial/by-id/*

4. Utilisez l'ID usb-katapult_ trouvé pour exécuter le flashage :

   Hôte Linux standard :

   ~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d <Katapult USB ID> -f ~/klipper/out/klipper.bin

   FLYOS / Hôte FLY :

   python3 ~/katapult/scripts/flashtool.py -d <Katapult USB ID> -f ~/klipper/out/klipper.bin

Attention

Lors du reflashage, vous devez utiliser le firmware correspondant au mode de connexion actuel. Bien que le firmware USB pont CAN fonctionne finalement via CAN, le reflashage Katapult utilise toujours l'ID USB et les commandes de flashage USB.

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