Guide de connexion MCU

Remarque sur l'applicabilité

Ce guide permet d'identifier et de résoudre les problèmes empêchant la connexion normale entre le MCU et Klipper.

Préparation et précautions

• Équipements hôte non recommandés : Évitez d'utiliser des équipements tels que les téléphones Redmi, clés WiFi, boîtiers de décodeur, etc. Ces appareils utilisent souvent des systèmes personnalisés ou modifiés qui pourraient empêcher la reconnaissance correcte du MCU.
• Nombre de périphériques à confirmer : Vérifiez à l'avance combien de périphériques (comme les cartes d'outils) vous utilisez. Plusieurs périphériques peuvent affecter la connexion.
• Simplifier les câblages : Il est recommandé de retirer temporairement tous les câbles des cartes mères et des cartes d'outils, sauf les câbles de données, afin d'éliminer les interférences.
• Interface recommandée : L'interface Fluidd est recommandée, car elle affiche plus clairement l'état de connexion du MCU.

Étape 1 : Sauvegarder et réinitialiser la configuration

1. Accéder à l'interface hôte

Accédez à l'interface via le navigateur en saisissant l'adresse IP de l'équipement hôte (par exemple : 192.168.101.179).

2. Localiser le fichier de configuration

Depuis l'interface WEB, trouvez l'option de configuration dans la barre latérale gauche :

Pour les utilisateurs de Fluidd : Cliquez sur ..., puis trouvez printer.cfg.

Pour les utilisateurs de Mainsail : Cliquez sur Machine, puis trouvez printer.cfg.

3. Sauvegarder le fichier de configuration

Faites un clic droit sur le fichier printer.cfg et sélectionnez Duplicate pour le copier, puis renommez la copie en :

printer_Backup.cfg

Exemple d'opération sur Fluidd :

Exemple d'opération sur Mainsail :

4. Réinitialiser le fichier de configuration

Réouvrez printer.cfg, supprimez tout son contenu, puis collez la configuration basique suivante :

[mcu]
serial: /tmp/klipper_host_mcu

[printer]
kinematics: none
max_velocity: 200
max_accel: 1000

5. Enregistrer et redémarrer

• Cliquez sur SAVE & RESTART en haut à droite. Klipper sauvegardera la configuration et redémarrera le service.
• En cas d'erreur, ignorez-la temporairement.
• Ensuite, éteignez complètement tous les appareils (y compris l'équipement hôte et tous les périphériques).
• Important : Assurez-vous d'un arrêt complet, sans quoi les étapes suivantes ne pourront pas être exécutées.

---

Étape 2 : Vérifier les périphériques et identifier le type de firmware

Conditions préalables

• Ordre des périphériques principaux : Le premier MCU doit être la carte mère, pas une carte d'outil.
• Type de firmware : Vérifiez que le firmware de la carte FLY est un firmware USB ou un firmware USB pont CAN, ce guide ne s'applique pas aux autres types.
• Méthode de connexion : Connectez-vous d'abord via SSH. Cette opération nécessite une connexion réseau.

Procédure opérationnelle

1. Détecter les périphériques

   • Une fois connecté via SSH, exécutez la commande suivante :

     lsusb

   • Le système affichera la liste de tous les périphériques USB reconnus.

2. Gérer les erreurs de commande

   • Si la commande lsusb n'est pas trouvée, installez-la d'abord :

     sudo apt-get install usbutils

   • Si aucun périphérique n'est affiché après l'exécution, envisagez de changer d'équipement hôte.

3. Identifier les informations des périphériques Selon l'illustration ci-dessous, identifiez vos périphériques dans la sortie de lsusb :

   
   

4. Vérifier le type de firmware

   • En fonction du firmware que vous avez flashé, vérifiez les informations clés suivantes dans la sortie de lsusb :
     • Firmware USB : Doit afficher 1d50:614e
     • Firmware USB pont CAN : Doit afficher 1d50:606f
     • Firmware USB Katapult : Doit afficher 1d50:6177
     • Adaptateur RS232 (utilisé avec UTOR ou les cartes D8 et D8PRO) : Doit afficher 1a86:7523 (cette étape n'est pas nécessaire avec la carte G2T)

---

Étape 3 : Rechercher l'ID du périphérique

Remarque importante

• Recherche d'ID USB : Valable uniquement pour les firmwares USB, non applicable aux CAN ou RS232.
• Recherche d'ID CAN : Valable uniquement pour les périphériques CAN, non applicable aux USB ou RS232.
• Recherche d'ID RS232 : Valable uniquement pour les firmwares RS232, non applicable aux USB ou CAN.
• Spécificité de RS232 : Le firmware RS232 est généralement utilisé uniquement pour les cartes d'outils, pas pour le MCU principal.

Choisir la méthode en fonction du type de firmware

Périphériques à firmware USB Exécutez la commande suivante pour rechercher l'ID USB :

ls /dev/serial/by-id/*

Périphériques USB pont CAN En fonction de votre système, choisissez la commande appropriée pour rechercher l'ID CAN :

Fly_Armbian ou équipement hôte standard

~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0

Système Fly_FAST

python ~/klipper/scripts/canbus_query.py can0

Périphériques à firmware RS232 Exécutez la commande suivante pour rechercher le chemin du périphérique RS232 :

ls /dev/serial/by-path/*

Interprétation et traitement des résultats

Résultats de recherche d'ID USB

Après l'exécution de la commande, le terminal affichera un ID de périphérique similaire à l'exemple ci-dessous :

• ✅ Utilisable directement : Si l'ID indique Klipper après le champ usb-
• ⚠️ Nécessite une réécriture du firmware : Si l'ID indique katapult après le champ usb-

Résultats de recherche d'ID CAN

Après l'exécution de la commande, jugez en fonction de la situation réelle :

• ✅ Utilisable directement : Si l'ID affiche Klipper dans le champ Application:.
• ⚠️ Nécessite une réécriture du firmware : Si l'ID affiche CANBOOT ou Katapult dans le champ Application:.
• ❌ Périphérique non trouvé : Si l'affichage est Total 0 uuids found, cela peut être dû à :
  • Une mauvaise configuration du réseau CAN
  • Un débit CAN incompatible (assurez-vous que le débit est identique sur l'équipement hôte, la carte mère et les cartes d'outils)
  • Un ID déjà utilisé (vous devez le désactiver dans la configuration, puis éteindre et redémarrer)

Résultats de recherche d'ID RS232

Après l'exécution de la commande, le terminal affichera le chemin du périphérique RS232 (exemple) :

• /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0

Exigences spécifiques pour la configuration RS232

Lors de la configuration d'un périphérique RS232, vous devez spécifier le débit et la méthode de redémarrage :

[mcu toolboard]
serial: <Remplacez ici par le chemin RS232 trouvé>
baud: 250000
restart_method: command

---

Étape 4 : Configurer l'ID du MCU principal

Préparation

Avant de commencer la configuration, assurez-vous que la connexion entre la carte d'outil et l'équipement hôte ou la carte mère est coupée pour éviter les conflits d'identification des périphériques.

Réouvrez le fichier printer.cfg, trouvez la ligne de configuration serial: /tmp/klipper_host_mcu dans la section [mcu].

En fonction de votre méthode de connexion, référez-vous à la méthode correspondante ci-dessous pour la configuration :

Configuration USB

Remplacez /tmp/klipper_host_mcu après serial: par l'ID USB trouvé.

Exemple de configuration :

# L'ID USB trouvé est :
# /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

# Modifiez la configuration comme suit :
[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

Configuration CAN

Remplacez la configuration serial: /tmp/klipper_host_mcu par canbus_uuid: et entrez l'ID CAN trouvé.

Exemple de configuration :

# L'ID CAN trouvé est :
# 688e89f0e401

# Modifiez la configuration comme suit :
[mcu]
canbus_uuid: 688e89f0e401

Sauvegardez la configuration et redémarrez le service Klipper.

---

Étape 5 : Vérifier la connexion du MCU principal

Après avoir configuré le MCU principal, vérifiez si la connexion est réussie :

1. Ouvrez l'interface Fluidd, cliquez sur System dans le menu de gauche
2. Vérifiez les informations du MCU : Trouvez les informations de Micro-Controller sous Mcu Information
3. Vérifiez le modèle du contrôleur : Assurez-vous que le modèle affiché correspond bien au contrôleur réel de votre carte mère

Points clés de vérification

• Si votre contrôleur est un STM32H723, Micro-Controller doit afficher un modèle lié à H723
• Si l'affichage est incorrect ou si le périphérique n'est pas reconnu, vérifiez les étapes de configuration précédentes

---

Étape 6 : Ajouter le MCU de la carte d'outil

Après avoir vérifié avec succès le MCU principal, vous pouvez ajouter la carte d'outil :

1. Reconnectez la carte d'outil : Rebranchez le câble de données de la carte d'outil à l'équipement hôte ou à la carte mère
2. Éditez le fichier de configuration : Ajoutez la configuration de la carte d'outil à la fin du fichier printer.cfg
3. Configurez l'ID de la carte d'outil : Selon le type de firmware de la carte d'outil, ajoutez l'ID correspondant dans la nouvelle section de configuration

Remarque sur le nom du MCU

Les noms comme mcu1, mcu2, etc., servent uniquement à distinguer temporairement les différents périphériques. Vous pouvez entièrement personnaliser ces noms, à condition qu'ils soient uniques dans le fichier de configuration.

Format de configuration :

[mcu mcu1]
# Ajoutez ici la configuration de l'ID de la carte d'outil

Exemple de configuration :

Carte d'outil USB

[mcu mcu1]
serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00

Carte d'outil CAN

[mcu mcu1]
canbus_uuid: 688e89f0e402

Carte d'outil RS232

[mcu mcu1]
serial: /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
baud: 250000
restart_method: command

Remarques :

• Chaque MCU doit utiliser un ID unique. Assurez-vous que l'ID de la carte d'outil est différent de celui du MCU principal et des autres périphériques
• Les noms des MCU peuvent être entièrement personnalisés (par exemple toolboard, extruder_mcu, etc.), à condition qu'ils soient uniques dans la configuration
• Utilisez impérativement les ID de carte d'outil validés à l'étape précédente
• Pour les périphériques RS232, configurez obligatoirement les paramètres baud: 250000 et restart_method: command
• Lorsque vous configurez plusieurs cartes d'outil, attribuez des noms différents à chaque périphérique pour les distinguer

Une fois la configuration terminée, sauvegardez et redémarrez le service Klipper.

---

Étape 7 : Vérifier toutes les connexions MCU

Après avoir ajouté la carte d'outil et redémarré Klipper, vérifiez à nouveau l'état de connexion de tous les MCU :

1. Ouvrez l'interface Fluidd, cliquez sur System dans le menu de gauche
2. Vérifiez les informations des MCU : Sous Mcu Information, assurez-vous que tous les MCU sont correctement reconnus
3. Vérifiez l'état de chaque MCU : Confirmez que le MCU principal et la carte d'outil sont affichés comme connectés

Points clés de vérification

• Le MCU principal et toutes les cartes d'outil doivent être affichés dans la liste
• L'état de connexion de chaque MCU devrait indiquer "Connecté"
• Si un MCU n'apparaît pas ou ne se connecte pas, vérifiez sa configuration et sa connexion physique

---

Étape 8 : Vérifier la version du firmware

Après avoir connecté tous les MCU, vérifiez la compatibilité des versions de firmware :

1. Ouvrez l'interface Fluidd, cliquez sur System dans le menu de gauche
2. Vérifiez les informations de version : Sous Mcu Information, trouvez le champ Version
3. Vérifiez la cohérence des versions : Assurez-vous que la version du firmware de tous les MCU correspond à celle de Klipper sur l'équipement hôte

Remarque sur la compatibilité des versions

• Firmware compilé manuellement : Sauf pour les appareils personnalisés préconfigurés, tous les firmware compilés manuellement doivent correspondre à la version de Klipper sur l'équipement hôte
• Système Fly-FAST : La version du firmware du système FAST est synchronisée avec la version du système. Le firmware Klipper compilé correspond à la version du système
• Conséquences d'une incompatibilité de version : Des versions différentes de firmware peuvent entraîner des dysfonctionnements, des échecs de communication ou une instabilité du système

Points clés de vérification :

• Les informations Version du MCU principal et de toutes les cartes d'outil doivent être affichées et les versions doivent correspondre
• Si les versions ne correspondent pas, vous devez reflasher le firmware concerné

---

Étape 9 : Restaurer et mettre à jour le fichier de configuration

Une fois la connexion de tous les MCU confirmée, restaurez le fichier de configuration d'origine et mettez à jour la configuration des MCU :

1. Supprimez le fichier de configuration actuel

   • Dans l'interface de gestion des fichiers de configuration, trouvez et supprimez le fichier printer.cfg actuel

2. Restaurez la sauvegarde

   • Renommez le fichier printer_Backup.cfg sauvegardé précédemment en printer.cfg

3. Mettez à jour la configuration du MCU

   • Ouvrez le fichier printer.cfg restauré
   • Trouvez la section [mcu] existante et mettez à jour l'ID en fonction de celui obtenu aux étapes précédentes :

   Configuration USB :

   [mcu]
   serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00
   # Remplacez par l'ID USB réel du MCU principal trouvé

   Configuration CAN :

   [mcu]
   canbus_uuid: 688e89f0e401
   # Remplacez par l'UUID CAN réel du MCU principal trouvé

4. Mettez à jour la configuration de la carte d'outil (si applicable)

   • Trouvez la section [mcu] correspondant à la carte d'outil dans le fichier de configuration
   • Mettez à jour avec l'ID réel de la carte d'outil trouvé, en fonction de la méthode de connexion :

   Carte d'outil USB :

   [mcu toolboard]
   serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00

   Carte d'outil CAN :

   [mcu toolboard]
   canbus_uuid: 688e89f0e402

   Carte d'outil RS232 :

   [mcu toolboard]
   serial: /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
   baud: 250000
   restart_method: command

5. Sauvegardez et redémarrez

   • Une fois toutes les configurations des MCU mises à jour, cliquez sur SAVE & RESTART pour sauvegarder et redémarrer Klipper
   • Retournez sur la page System et confirmez que l'état de connexion de tous les MCU est normal

Remarque importante

• Assurez-vous d'utiliser les ID réels trouvés lors des tests de connexion
• Si vous configurez plusieurs cartes d'outil, mettez à jour chaque section [mcu] individuellement
• Pour les cartes d'outil RS232, incluez impérativement les paramètres baud: 250000 et restart_method: command
• Après la restauration de la configuration, les paramètres originaux de votre imprimante (comme les moteurs pas à pas, les fins de course, etc.) resteront inchangés

À ce stade, le dépannage et la restauration de la configuration du MCU sont terminés.