Guide de connexion de MCU

Remarque d'application

Ce guide sert à diagnostiquer et résoudre les problèmes de connexion entre le MCU et Klipper.

Préparation et précautions

• Équipements non recommandés : Évitez d'utiliser des appareils comme les téléphones Redmi, les clés WiFi, les décodeurs, etc. Ces appareils utilisent souvent des systèmes personnalisés ou modifiés, ce qui peut empêcher la reconnaissance correcte du MCU.
• Vérifier le nombre de microcontrôleurs : Vérifiez à l'avance le nombre de microcontrôleurs (comme les cartes d'outils) que vous utilisez, car plusieurs MCU peuvent affecter la connexion.
• Simplifier les câblages : Il est recommandé de retirer temporairement tous les câbles autres que les câbles de données sur la carte mère et la carte d'outil, afin d'éliminer les interférences.
• Interface recommandée : L'interface Fluidd est recommandée, car elle affiche de manière plus intuitive l'état de connexion du MCU.

Étape 1 : Sauvegarder et réinitialiser la configuration

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

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

2. Localiser le fichier de configuration

Une fois dans 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, sélectionnez Duplicate, puis renommez la copie en :

printer_Backup.cfg

Exemple d'opération avec Fluidd :

Exemple d'opération avec Mainsail :

4. Réinitialiser le fichier de configuration

Ouvrez à nouveau printer.cfg, supprimez tout son contenu, puis collez-y la configuration de base 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 microcontrôleurs).
• Important : Assurez-vous d'un arrêt complet, sinon les étapes suivantes ne pourront pas être effectuées.

---

Étape 2 : Vérifier les appareils et identifier le type de firmware

Conditions préalables

• Ordre des appareils 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.

Étapes à suivre

1. Effectuer la détection des appareils

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

     lsusb

   • Le système affichera tous les appareils 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 appareil n'est affiché après l'exécution, changez d'équipement hôte.

3. Identifier les informations des appareils Selon l'illustration ci-dessous, identifiez votre appareil dans la sortie de lsusb :

   
   

4. Vérifier le type de firmware

   • Selon le firmware que vous avez gravé, vérifiez les informations clés suivantes dans les résultats 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 si vous utilisez une carte G2T)

---

Étape 3 : Rechercher l'ID de l'appareil

Remarque importante

• Recherche d'ID USB : S'applique uniquement au firmware USB, ne fonctionne pas avec CAN ou RS232.
• Recherche d'ID CAN : S'applique uniquement aux appareils CAN, ne fonctionne pas avec USB ou RS232.
• Recherche d'ID RS232 : S'applique uniquement au firmware RS232, ne fonctionne pas avec 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 selon le type de firmware

Appareils avec firmware USB Exécutez la commande suivante pour rechercher l'ID de l'appareil USB :

ls /dev/serial/by-id/*

Appareils avec firmware USB pont CAN Selon votre système, sélectionnez 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

Appareils avec firmware RS232 Exécutez la commande suivante pour rechercher le chemin de l'appareil RS232 :

ls /dev/serial/by-path/*

Interprétation et traitement des résultats

Résultats de la recherche d'ID USB

Après avoir exécuté la commande, le terminal affichera un ID d'appareil similaire à l'exemple suivant :

• ✅ Utilisable directement : Si l'ID indique Klipper après le champ usb-
• ⚠️ Nécessite la mise à jour du firmware : Si l'ID indique katapult après le champ usb-

Résultats de la recherche d'ID CAN

Après l'exécution de la commande, jugez selon les cas :

• ✅ Utilisable directement : Si l'ID affiche Klipper dans le champ Application: à la fin.
• ⚠️ Nécessite la mise à jour du firmware : Si l'ID affiche CANBOOT ou Katapult dans le champ Application: à la fin.
• ❌ Aucun appareil trouvé : Si l'affichage est Total 0 uuids found, les causes possibles sont :
  • Configuration réseau CAN incorrecte
  • Taux de communication CAN non synchronisé (vérifiez que le taux est identique pour l'équipement hôte, la carte mère et les cartes d'outils)
  • Cet ID est déjà utilisé (vous devez le désactiver dans la configuration, puis éteindre, débrancher et redémarrer)

Résultats de la recherche d'ID RS232

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

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

Configuration spécifique pour RS232

Lors de la configuration d'un appareil RS232, il faut absolument spécifier le débit en bauds 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 débranchée, afin d'éviter les conflits d'identification des appareils.

Ouvrez à nouveau le fichier printer.cfg, trouvez la ligne de configuration serial: /tmp/klipper_host_mcu dans la section [mcu].

Selon votre méthode de connexion, suivez la méthode correspondante ci-dessous :

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 insérez l'ID CAN trouvé.

Exemple de configuration :

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

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

Enregistrez 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 du microcontrôleur sous Mcu Information
3. Vérifiez le modèle du contrôleur : Assurez-vous que le modèle affiché correspond bien au modèle 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 H723
• Si l'affichage est incorrect ou non reconnu, vérifiez les étapes précédentes

---

Étape 6 : Ajouter la carte d'outil MCU

Une fois la connexion du MCU principal confirmée, 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. Modifiez 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

Nom des MCU

Les noms comme mcu1, mcu2 dans la configuration sont uniquement utilisés pour distinguer temporairement les différents appareils. Vous pouvez personnaliser ces noms, tant qu'ils sont 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 appareils.
• Les noms des MCU peuvent être entièrement personnalisés (par exemple toolboard, extruder_mcu, etc.), tant qu'ils restent uniques dans la configuration.
• Utilisez uniquement des ID de carte d'outil valides trouvés précédemment.
• Les appareils RS232 doivent configurer les paramètres baud: 250000 et restart_method: command
• Lorsque vous configurez plusieurs cartes d'outils, attribuez des noms différents à chaque appareil pour les distinguer.

Une fois la configuration terminée, enregistrez 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 : Confirmez que tous les MCU sont correctement identifiés sous Mcu Information
3. Vérifiez l'état de chaque MCU : Assurez-vous que le MCU principal et la carte d'outil affichent tous deux un état connecté

Points clés de vérification

• Le MCU principal et toutes les cartes d'outil doivent apparaître dans la liste
• L'état de connexion de chaque MCU doit être "Connecté"
• Si un MCU n'apparaît pas ou échoue à se connecter, 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 : Trouvez le champ Version sous Mcu Information
3. Vérifiez la cohérence des versions : Confirmez 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 préconfigurés, tous les firmwares 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 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 s'afficher 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 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 MCU

   • Ouvrez le fichier printer.cfg restauré
   • Trouvez la section [mcu] existante et mettez à jour l'ID selon les étapes précédentes :

   Configuration USB :

   [mcu]
   serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00
   # Remplacez par l'ID 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)

   • Dans le fichier de configuration, trouvez la section [mcu] correspondant à la carte d'outil
   • Mettez à jour l'ID de la carte d'outil selon 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. Enregistrez et redémarrez

   • Après avoir mis à jour toutes les configurations MCU, cliquez sur SAVE & RESTART pour enregistrer et redémarrer Klipper
   • Retournez à la page System et confirmez que l'état 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 l'ID de chaque section [mcu] une par une
• Les cartes d'outil RS232 doivent inclure les paramètres baud: 250000 et restart_method: command
• Après la restauration de la configuration, les paramètres originaux de l'imprimante (comme les moteurs pas à pas, les interrupteurs de fin de course, etc.) resteront inchangés

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