Connexion à Klipper

Informations importantes

• Ce tutoriel concerne l'écriture du firmware KLIPPER sur la carte Fly-Buffer-Plus.
• L'écriture du firmware effacera les paramètres associés aux broches du firmware de pression.
• Pour retrouver les fonctionnalités antérieures, vous devrez soit écrire vos propres macros, soit recharger l'ancien firmware.
• Toute configuration et utilisation devra être effectuée via des macros que vous devrez écrire vous-même.

Écriture du BL

Entrer en mode d'écriture

• Il existe deux méthodes pour entrer en mode d'écriture :
• Première méthode : avec la carte complètement débranchée, appuyez sur le bouton BOOT, puis connectez un câble TYPE-C (capable de transfert de données) entre la carte mère et votre appareil.
• Deuxième méthode : après avoir connecté un câble TYPE-C (capable de transfert de données) entre la carte mère et votre appareil, appuyez sur le bouton BOOT, puis sur le bouton RST, relâchez ensuite le bouton RST, puis enfin le bouton BOOT.
  

Écrire le firmware

Tutoriel d'écriture sous Windows

• Le firmware BL de la carte
  • Cliquez sur le lien de téléchargement ci-dessous
• Loading...

À savoir

• Le flashage peut échouer avec USB3.0, veuillez utiliser autant que possible le USB2.0 de votre ordinateur pour le flashage
• Si le flashage ne fonctionne toujours pas, veuillez utiliser un logiciel de contrôle hôte pour le flashage
• Si l'erreur suivante apparaît, veuillez utiliser un hub USB
  

1. Outil de flashage Lien de téléchargement
2. Vous devez télécharger SetupSTM32CubeProgrammer et le pilote STM32 DFU
3. Téléchargez le firmware dans n'importe quel répertoire sur votre ordinateur
4. Connectez la carte mère à l'ordinateur à l'aide d'un câble Type-C, assurez-vous d'être déjà en mode de flashage dfu
5. Dans STM32CubeProgrammer, sélectionnez le mode USB, puis actualisez et connectez
   
6. Si aucune fenêtre d'erreur n'apparaît, la connexion est réussie.
   Attention

   Si le contenu illustré dans l'image ci-dessous apparaît, cela indique un problème avec l'ordinateur ou le logiciel. Veuillez utiliser un logiciel de contrôle hôte pour le flashage :Tutoriel de flashage avec logiciel de contrôle hôte

   
7. Cliquez sur l'icône de téléchargement à gauche et sélectionnez les options ci-dessous
   
8. Cliquez sur le bouton Browse indiqué par la flèche, puis sélectionnez le firmware que vous souhaitez flasher
   
9. Sélectionnez Start address et entrez 0x08000000
   • Veuillez noter que si le firmware est au format HEX, veuillez ignorer cette étape !
   
10. Cliquez sur Start automatic mode en bas pour commencer à flasher le firmware
    
11. L'indication ci-dessous signifie que le firmware a été flashé avec succès
    

Tutoriel d'écriture sur la carte hôte

1. Installation de l'outil de gravure

• L'interface supérieure FLY n'a pas besoin d'exécuter l'installation de l'outil de gravure
• Si vous devez installer, veuillez noter : l'interface supérieure doit être en mesure de se connecter à 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

2. Exécutez la commande suivante pour vérifier si la connexion a réussi.

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 est possible que d'autres noms soient affichés, si 0483:df11 est affiché, cela signifie que le mode de gravage a été entré

3. Téléchargez les fichiers de firmware précompilés

• Cela contient tous les fichiers de firmware précompilés
• Veuillez noter que l'interface supérieure doit être en mesure de se connecter à Internet pour installer
• L'interface supérieure doit exécuter la commande ci-dessous pour télécharger le paquet de fichiers de firmware (si le téléchargement ne peut pas être effectué en raison de problèmes de réseau sur l'interface supérieure, veuillez contacter l'administrateur du groupe de support après-vente)

cd && git clone https://github.com/FengHua741/FLY_Katapult.git

• Si vous avez déjà téléchargé le paquet de fichiers de firmware, il est recommandé de mettre à jour le paquet de fichiers de firmware avant de poursuivre les autres opérations

cd ~/FLY_Katapult && git pull

4. Écrire le firmware

prompt

Il suffit d'écrire un seul des firmware proposés.

• Voici la commande d'écriture du firmware :

  sudo dfu-util -a 0 -d 0483:df11 --dfuse-address 0x08000000 -D ~/FLY_Katapult/BL/buffer/FLY_BUFFER.bin

5. Si vous voyez un texte similaire à File downloaded successfully comme indiqué dans l'image ci-dessous, cela signifie que l'écriture a réussi.

   

prompt

Après l'écriture, veuillez débrancher complètement la carte mère.

Compilation du firmware USB

Démarrer la compilation

• Il faut utiliser un ordinateur hôte ayant installé le service klipper Se connecter en SSH via le réseau
• Et connecter l'appareil à l'ordinateur hôte
• Remarque : veuillez utiliser un ordinateur hôte normal, comme Raspberry Pi FLY, etc. Si c'est un ordinateur hôte modifié (comme une baguette WiFi, Xiaomi Mi, etc.), cet ordinateur hôte présente trop de problèmes et ne pourra pas être soutenu.

Remarques sur le système FlyOS-Armbian et les systèmes normaux

note

• Remarques sur le système FlyOS-Armbian et les systèmes normaux
  • Les systèmes d'ordinateurs hôtes normaux tels que Raspberry Pi, FLY, etc., appartiennent à cette catégorie
  • Ces ordinateurs hôtes ne doivent pas utiliser l'utilisateur ROOT pour effectuer tout type d'opération
  • Veuillez utiliser un utilisateur normal
  • Méthode de changement d'utilisateur : pour le système FlyOS-Armbian, utilisez la commande su fly pour basculer vers l'utilisateur normal
  • Pour les autres systèmes, utilisez la commande su <votre nom d'utilisateur de l'ordinateur hôte> pour basculer vers l'utilisateur normal

  su <votre nom d'utilisateur de l'ordinateur hôte>

Remarques sur le système FlyOS-FAST

note

• Remarques sur le système FlyOS-FAST
  • Le nom d'utilisateur par défaut du système FAST est root, le mot de passe est mellow
  • La compilation des microprogrammes ne peut être effectuée qu'avec l'utilisateur root
  • De plus, le système FAST n'a qu'un seul utilisateur ROOT, vous n'avez pas besoin de changer d'utilisateur !!!

prompt

• 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

prompt

Assurez-vous que le mode de saisie du clavier est en mode demi-largeur, c'est-à-dire en mode anglais

1. 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
2. La touche Entrée ou la touche Espace est utilisée pour cocher une option de menu ou entrer dans un sous-menu
3. La touche Échap est utilisée pour revenir au menu précédent
4. La touche Q permet de quitter la page de configuration du firmware Klipper
5. La touche Y, lorsqu'on quitte la page de configuration du firmware Klipper et qu'une invite apparaît, appuyez sur Y pour enregistrer le fichier de configuration

note

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 comment compiler le firmware :

• Connectez-vous à SSH puis entrez 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 firmware make menuconfig est la compilation du firmware, après l'exécution, une interface similaire à celle ci-dessous devrait apparaître

  

• Sélectionnez Enable extra low-level configuration options et appuyez sur Entrée

  

• Accédez au menu Micro-controller Architecture puis sélectionnez STMicroelectronics STM32 et appuyez sur Entrée

  

• Accédez au menu Processor model, sélectionnez STM32F072 et appuyez sur Entrée

  

• Sélectionnez Bootloader offset, choisissez : 8KiB bootloader

  

• Communication interface, choisissez : USB (on PA11/PA12) et appuyez sur Entrée

  

• Veuillez vérifier avec l'image ci-dessous pour vous assurer qu'elle correspond, avant de passer à l'étape suivante

  

• Appuyez sur la touche Q, une option Save configuration apparaîtra, appuyez ensuite sur Y
  
• La configuration est maintenant sauvegardée et vous êtes revenu à l'interface en ligne de commande.
• Entrez la commande suivante pour commencer la compilation (cela peut prendre un certain temps) :

make -j4

• Une fois la compilation réussie, les lignes suivantes apparaîtront :

  Linking out/klipper.elf
  Creating hex file out/klipper.bin

• Voici un enregistrement du processus de compilation du firmware :

Asciinema cast

Entrer en mode d'écriture

Attention

• Appuyez deux fois sur le bouton RST pour entrer en mode d'écriture.

Vérifier si le mode d'écriture est activé

• Assurez-vous que la machine supérieure peut se connecter normalement à Internet et que le câble de données du périphérique inférieur connecté à la machine supérieure a une fonction de transmission de données.
• Après avoir établi une connexion SSH avec la machine supérieure, entrez la commande lsusb et appuyez sur Entrée. Si l'information entourée dans l'image ci-dessous est affichée, vous pouvez passer à l'étape suivante.
  • Si aucune information n'est retournée, il s'agit d'un problème système de la machine supérieure, nous ne pouvons rien faire. Vous devez remplacer un système confirmé comme fonctionnel ou changer la machine supérieure.
  • Si la commande lsusb ne fonctionne pas, vous pouvez exécuter la commande suivante pour l'installer :

    sudo apt-get install usbutils

    
• 1d50:6177 appartient à l'appareil que vous utiliserez cette fois.
  • Certaines machines supérieures peuvent ne pas afficher correctement ou ne pas afficher du tout en raison de problèmes système.
  • Si vous pouvez voir l'appareil après avoir entré la commande lsusb, mais que 1d50:6177 n'est pas affiché, essayez de changer de câble de données et connectez le contrôleur mère à un autre port USB de la machine supérieure.
• Si vous avez effectué les étapes mentionnées précédemment et que la mise à jour du firmware Klipper a réussi, et que le contrôleur mère fonctionne normalement, mais que vous souhaitez uniquement mettre à jour le firmware Klipper, veuillez consulter la section Mise à jour du firmware du menu latéral droit de cette page.

Remarque importante

Il est obligatoire de trouver le périphérique 1d50:6177 avant de poursuivre.

Écrire le firmware

prompt

• Une connexion Internet est nécessaire lors de l'installation du plugin de flashage. Veuillez vous assurer que votre ordinateur hôte est correctement connecté à Internet.
• Si l'installation a déjà été effectuée, il n'est pas nécessaire de l'installer à nouveau.

Commencer le flashage

Avertissement

• Pour les ordinateurs hôtes autres que Fly, veuillez exécuter impérativement la commande ci-dessous afin d'installer les paquets nécessaires au flashage du firmware ! Sinon, le firmware ne pourra pas être flashé !

  Dépôt par défaut

  cd && git clone https://github.com/Arksine/katapult.git

  Dépôt chinois

  cd && git clone https://gitee.com/MrCakeFuck/katapult.git

  

• Utilisez la commande suivante pour rechercher l'ID de votre appareil, l'ID indiqué dans l'image ci-dessous devrait apparaître (Remarque : l'ID indiqué dans l'image est à titre indicatif uniquement, chaque carte mère a un ID différent)

  ls /dev/serial/by-id/*

  

• Utilisez le code ci-dessous pour flasher le firmware. Veuillez vous assurer que le firmware a été compilé à l'avance. Veuillez remplacer <votre ID carte mère> par l'ID obtenu à l'étape précédente.

Méthode de flashage pour Fly-Armbian et ordinateurs hôtes standards

~/klippy-env/bin/python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<votre ID carte mère>

Méthode de flashage pour Fly-FAST

python ~/katapult/scripts/flashtool.py -d /dev/serial/by-id/<votre ID carte mère>

• Ci-dessous un exemple :

  

• Exemple après le flashage :

  

Mise à jour du firmware

Mise à jour du firmware USB

• Utilisez la commande suivante pour rechercher l'ID de votre carte mère. L'ID indiqué dans l'image ci-dessous devrait apparaître (Remarque : l'ID indiqué dans l'image est à titre indicatif uniquement, chaque carte mère a un ID différent)

  ls /dev/serial/by-id/*

Remarque

Dans l'image ci-dessous, /dev/serial/by-id/usb-katapult_rp2040_E662549553642032-if00 est l'ID de la carte mère.

• La mise à jour du firmware USB nécessite, après la compilation du dernier firmware, d'entrer la commande suivante pour effectuer la mise à jour. Veuillez remplacer <votre ID carte mère> par l'ID obtenu à l'étape précédente.

  cd ~/klipper/ && make flash FLASH_DEVICE=<votre ID carte mère>

  

Mise à jour du firmware CAN bridge

• Pour mettre à jour le firmware CAN bridge USB, après avoir compilé le dernier firmware, entrez la commande suivante pour réinitialiser dans Katapult. (Comme indiqué dans l'image ci-dessous, l'ID affiché est à titre indicatif uniquement, veuillez vous référer à l'ID dans votre fichier de configuration.)

Remarque

• <CANBUS UUID> est l'UUID CANBUS de la carte mère dans votre fichier de configuration printer.cfg

Méthode de réinitialisation pour Fly-Armbian et ordinateurs hôtes standards

• Veuillez remplacer <votre ID carte mère> par l'ID obtenu à l'étape précédente

  ~/klippy-env/bin/python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <CANBUS UUID>

Méthode de réinitialisation pour Fly-FAST

• Veuillez remplacer <votre ID carte mère> par l'ID obtenu à l'étape précédente

  python3 ~/katapult/scripts/flashtool.py -i can0 -r -u <CANBUS UUID>

Remarque

• Dans l'image ci-dessous, f95cee90e1f9 est l'UUID CANBUS de la carte mère.

• Après avoir réinitialisé dans Katapult, utilisez la commande suivante pour rechercher l'ID de votre carte mère. L'ID indiqué dans l'image ci-dessous devrait apparaître (Remarque : l'ID indiqué dans l'image est à titre indicatif uniquement, chaque carte mère a un ID différent)

  ls /dev/serial/by-id/*

Remarque

Dans l'image ci-dessous, /dev/serial/by-id/usb-Klipper_stm32f072xb_43002C000951324757373520-if00 est l'ID de la carte mère.

• Veuillez vous assurer que le nouveau firmware a été compilé avant d'effectuer le flashage. Veuillez remplacer <votre ID carte mère> par l'ID obtenu à l'étape précédente.

  cd ~/klipper/ && make flash FLASH_DEVICE=<votre ID carte mère>

  

Méthode de récupération en cas de mauvais firmware

• Débranchez la carte mère, puis la rebrancher, et appuyez rapidement deux fois sur le bouton de réinitialisation pour revenir au mode de flashage.
• Ou utilisez un ordinateur sous Windows/ordinateur hôte pour reflasher le firmware Katapult Flasher le firmware Katapult

Recherche de l'ID CAN

1. Ouvrez le navigateur et saisissez l'adresse IP de l'ordinateur hôte dans la barre d'adresse. Par exemple, si l'IP de mon ordinateur hôte est 192.168.101.179, entrez-la directement puis appuyez sur Entrée.

2. Ouvrez l'interface WEB de l'ordinateur hôte, trouvez l'option suivante dans le menu de configuration de la barre latérale gauche :

Pour fluidd : {…}, cliquez dessus pour trouver printer.cfg

Pour mainsail : Machine, cliquez dessus pour trouver printer.cfg

3. Cliquez sur printer.cfg, puis cliquez sur DEVICES en haut à droite :

4. Cliquez sur CAN, puis actualisez :

   Actualisation sous fluidd

   Actualisation sous mainsail

5. Copiez l'ID, cliquez sur la flèche indiquée pour copier :

   Sous fluidd, vérifiez que la première flèche pointe sur Klipper, si c'est le cas, cliquez sur la flèche de droite pour copier

   Sous mainsail, vérifiez que la première flèche pointe sur Klipper, si c'est le cas, cliquez sur la flèche de droite pour copier

Saisie de l'ID CAN

1. Fermez DEVICES et saisissez l'ID

À savoir

• Veuillez modifier dans le fichier de configuration :

[mcu] 
serial: /tmp/klipper_host_mcu

en

[mcu host] 
serial: /tmp/klipper_host_mcu

• Ajoutez :

[mcu]
canbus_uuid: <Remplacez ici par l'ID que vous venez de trouver>

Dans fluidd, trouvez [MCU]

Dans mainsail, trouvez [MCU]

2. Saisissez l'ID dans la configuration

prompt

• Après avoir saisi l'ID, cliquez sur SAVE & RESTART en haut à droite

3. Si Klipper affiche ADC out of range, c'est un phénomène normal. Connectez le lit chauffant et la thermistance à la carte mère, configurez correctement les broches thermiques de l'extrudeur et du lit chauffé, puis sauvegardez et redémarrez.

dangereux

Attention : Tous les ID présents dans ce document sont des exemples. Chaque carte mère a un ID différent. Veuillez saisir l'ID réellement obtenu.

---