Compilation du firmware CAN

Astuce

• L'ERCF est livré en usine avec le firmware Katapult pré-flashé pour la connexion CAN
• Si vous utilisez le flashage du firmware USB, vous devez flasher le firmware Katapult USB
• Après un flashage, aucun nouveau flashage n'est nécessaire
• Flashage du firmware Katapult

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

   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'

   (gpio17) GPIO pins to set at micro-controller startup

   GPIO state at micro-controller startup (Not set) --->

   [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) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   Communication Interface (USBSERIAL) --->

   USB ids --->

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

   (gpio17) GPIO pins to set at micro-controller startup

   GPIO state at micro-controller startup (Not set) --->

   [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) --->

   Bootloader offset (16KiB bootloader) --->

   Communication Interface (USBSERIAL) --->

   USB ids --->

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

   (gpio17) GPIO pins to set at micro-controller startup

   GPIO state at micro-controller startup (Not set) --->

   [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) --->

   Communication Interface (USBSERIAL) --->

   USB ids --->

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

   (gpio17) GPIO pins to set at micro-controller startup

   GPIO state at micro-controller startup (Not set) --->

   [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) --->

   USB ids --->

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

   (gpio17) GPIO pins to set at micro-controller startup

   GPIO state at micro-controller startup (Not set) --->

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

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

   6USB ids 保持默认，无需进入

   (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'

   (gpio17) GPIO pins to set at micro-controller startup

   GPIO state at micro-controller startup (Not set) --->

   [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 (Raspberry Pi RP2040/RP235x) --->

   Processor model (rp2040) --->

   Bootloader offset (16KiB bootloader) --->

   Communication Interface (USBSERIAL) --->

   USB ids --->

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

   (gpio17) GPIO pins to set at micro-controller startup

   GPIO state at micro-controller startup (Not set) --->

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

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

   8GPIO pins to set at micro-controller startup 设置为 gpio17

   (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'

   (gpio17) GPIO pins to set at micro-controller startup

   GPIO state at micro-controller startup (Not set) --->

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

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

   9GPIO state at micro-controller startup 选择 Not set

   此项是 FLYOS-Klipper 功能。通常保持 Not set；如需设置全部 GPIO 的启动状态，请先阅读 GPIO 启动状态使用说明。

   (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'

   (gpio17) GPIO pins to set at micro-controller startup

   GPIO state at micro-controller startup (Not set) --->

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

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

   10按 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'

   (gpio17) GPIO pins to set at micro-controller startup

   GPIO state at micro-controller startup (Not set) --->

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

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

   11出现 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 与系统版本变化。

Câblage

• Utilisez un câble USB pour connecter la carte d'outillage à l'ordinateur hôte ; la LED sur la carte principale clignotera alors.

Avertissement

• Si la LED ne clignote pas, veuillez re-flasher le firmware Katapult :Flasher le firmware Katapult
• Si la LED ne clignote pas, veuillez exécuter l'étape suivante après avoir flashé le firmware Katapult

Flashage du firmware

Début de la gravure

• Les hôtes non officiels de Fly doivent installer Katapult
• Installer Katapult

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 ci-dessous devrait s’afficher (Attention : l’ID de chaque carte mère est différent) :

ls /dev/serial/by-id/*

Si l’ID trouvé contient usb-katapult_stm32xxxxxxxx, cela signifie que vous pouvez passer à l’étape suivante

Loading...

---

Graver le firmware

⚠️ Préparation

• Assurez-vous que le fichier du firmware est déjà compilé
• Remplacez <ID_DE_VOTRE_CARTE_MÈRE> dans la commande ci-dessous par l’ID réel obtenu à l’étape précédente

• Pour un hôte ordinaire, utilisez le code suivant

  ~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d <ID_DE_VOTRE_CARTE_MÈRE>

• Pour un hôte FLY, utilisez le code suivant

  python3 ~/katapult/scripts/flashtool.py -d <ID_DE_VOTRE_CARTE_MÈRE>

Référence du processus de gravure :

Loading...

Référence d’une gravure réussie :

Loading...

---

Mise à jour du firmware

• Mise à jour du firmware USB
• Mise à jour du firmware CAN ponté

Étapes de mise à jour du firmware USB

1. Rechercher l’ID de la carte mère

ls /dev/serial/by-id/*

Points clés pour l’identification

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

Loading...

2. Mettre à jour le firmware

cd ~/klipper/ && make flash FLASH_DEVICE=<ID_DE_VOTRE_CARTE_MÈRE>

Attention

• Remplacez <ID_DE_VOTRE_CARTE_MÈRE> par l’ID réellement obtenu

Loading...

Étapes de mise à jour du firmware CAN ponté

1. Réinitialiser pour entrer en mode de gravure

Remarque importante

<ID_DE_VOTRE_CARTE_MÈRE> est l’UUID CANBUS de la carte mère dans le fichier de configuration printer.cfg

• Pour un hôte ordinaire, utilisez le code suivant

  ~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <ID_DE_VOTRE_CARTE_MÈRE>

• Pour un hôte FLY, utilisez le code suivant

  python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <ID_DE_VOTRE_CARTE_MÈRE>

Exemple

f95cee90e1f9 dans l’image ci-dessous est l’UUID CANBUS de la carte mère (à titre d’exemple uniquement)

Loading...

2. Rechercher le nouvel ID de l’appareil

ls /dev/serial/by-id/*

Points clés pour l’identification

• Ceci est juste une référence !
• /dev/serial/by-id/usb-Klipper_stm32f072xb_38001B000551324752333720-if00 dans l’image ci-dessous est le nouvel ID de la carte mère

Loading...

3. Graver le nouveau firmware

cd ~/klipper/ && make flash FLASH_DEVICE=<ID_DE_VOTRE_CARTE_MÈRE>

Loading...

---

Solutions en cas de gravure erronée

Méthode 1 : Entrer rapidement en mode de gravure

1. Coupez l’alimentation de la carte mère
2. Après avoir remis sous tension, appuyez deux fois rapidement sur le bouton RESET
3. Réentrez en mode de gravure

Méthode 2 : Re-gravure du firmware Katapult

Cliquez pour voir le guide de gravure du firmware Katapult

Vérifier si le firmware a démarré

• Si le firmware démarre correctement, la LED s'allumera
  Loading...