Aller au contenu principal

Guide de connexion MCU

Note d'application

Ce guide est utilisé pour diagnostiquer et résoudre les problèmes de connexion entre le MCU et Klipper.

Préparation et précautions​

  • Appareils hôtes non recommandés : Évitez d'utiliser des téléphones Redmi, des clés WiFi, des décodeurs TV, etc. Ils utilisent généralement des systèmes personnalisés ou modifiés, ce qui peut empêcher une identification correcte du MCU.
  • Confirmer le nombre d'appareils esclaves : Veuillez confirmer à l'avance le nombre d'appareils esclaves (par exemple, cartes outils) que vous utilisez, car plusieurs appareils esclaves peuvent affecter la connexion.
  • Simplifier le câblage : Il est recommandé de retirer temporairement tous les câbles autres que les câbles de données de la carte mère et des cartes outils, ne conservant que les connexions de données nécessaires pour éliminer les interférences.
  • Interface recommandée : Il est recommandé d'utiliser l'interface Fluidd, qui 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'adresse IP de l'appareil hôte (par exemple : 192.168.101.179) dans votre navigateur.

Loading...

2. Localiser le fichier de configuration​

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

Utilisateurs Fluidd : Cliquez sur ..., puis trouvez printer.cfg.

Loading...

Utilisateurs Mainsail : Cliquez sur 机器, puis trouvez printer.cfg.

Loading...

3. Sauvegarder le fichier de configuration​

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

printer_Backup.cfg

Exemple d'opération Fluidd :

Loading...

Exemple d'opération Mainsail :

Loading...

4. Réinitialiser le fichier de configuration​

Rouvrez printer.cfg, effacez tout le contenu, et collez la configuration de base suivante :

[mcu]
serial: /tmp/klipper_host_mcu

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

5. Sauvegarder 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'hôte et tous les esclaves).
  • Important : Assurez-vous d'un arrêt complet, sinon les étapes suivantes ne pourront pas être effectuées.

Étape 2 : Détecter les appareils et confirmer le type de firmware​

Prérequis​

  • Ordre des appareils principaux : Le premier MCU doit être la carte mère, pas une carte outil.
  • Type de firmware : Confirmez que le firmware de votre carte mère FLY est un firmware USB ou un firmware USB ponté CAN. Ce guide ne s'applique pas aux autres types.
  • Méthode de connexion : Veuillez d'abord vous connecter en SSH, cette opération nécessite une connexion réseau.

Procédure​

  1. Exécuter la détection d'appareil

    • Après une connexion SSH réussie, exécutez la commande suivante : 
      lsusb
    • Le système listera tous les appareils USB reconnus.

  2. Gérer les exceptions de commande

    • Si la commande lsusb n'est pas trouvée, installez-la d'abord : 
      sudo apt-get install usbutils
    • Si l'exécution n'affiche aucun appareil, il est recommandé de changer d'appareil hôte.

  3. Identifier les informations de l'appareil Sur la base des images ci-dessous, identifiez votre appareil dans la sortie de lsusb :

    Loading...
    Loading...

  4. Vérifier le type de firmware

    • En fonction du firmware que vous avez flashé, 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 avec les cartes mères D8 et D8PRO) : Doit afficher 1a86:7523 (non requis avec G2T)

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

Notes importantes​

  • Recherche d'ID USB : Applicable uniquement au firmware USB, ne fonctionne pas pour CAN ou RS232.
  • Recherche d'ID CAN : Applicable uniquement aux appareils bus CAN, ne fonctionne pas pour USB ou RS232.
  • Recherche d'ID RS232 : Applicable uniquement au firmware RS232, ne fonctionne pas pour USB ou CAN.
  • Spécificité RS232 : Le firmware RS232 est généralement utilisé uniquement pour les cartes outils, pas pour le MCU principal.

Choisir la méthode en fonction du type de firmware​

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

ls /dev/serial/by-id/*

Appareils USB pontés CAN Selon votre type de système, choisissez la commande correspondante pour rechercher l'ID CAN :

~/klippy-env/bin/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 recherche d'ID USB​

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

  • ✅ Utilisable directement : Si l'ID est annoté comme Klipper après le champ usb-

  • ⚠️ Nécessite un flash de firmware : Si l'ID est annoté comme katapult après le champ usb-

    Loading...

Résultats de recherche d'ID CAN​

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

  • ✅ Utilisable directement : Si l'ID affiché est annoté comme Klipper dans le champ Application: à la fin.
  • ⚠️ Nécessite un flash de firmware : Si l'ID affiché est annoté comme CANBOOT ou Katapult dans le champ Application: à la fin.
  • ❌ Appareil non trouvé : Si Total 0 uuids found est affiché, les causes possibles sont :
    • Configuration incorrecte du réseau CAN
    • Débit CAN incompatible (assurez-vous que les débits de l'hôte, de la carte mère et de la carte outil sont identiques)
    • Cet ID est déjà utilisé (doit être masqué dans la configuration, puis éteindre, couper l'alimentation et redémarrer)
Loading...

Résultats de recherche d'ID RS232​

Après 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
Exigences spéciales de configuration RS232

Les appareils RS232 doivent spécifier le débit binaire et la méthode de redémarrage dans la configuration :

[mcu toolboard]
serial: <Remplacer ici par le chemin de l'appareil 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 outil et l'hôte ou la carte mère est déconnectée pour éviter les conflits d'identification d'appareils.

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

Selon votre méthode de connexion, référez-vous à la méthode correspondante ci-dessous pour configurer :

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 en :
[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00

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, il est nécessaire de vérifier si la connexion est réussie :

  1. Ouvrez l'interface Fluidd, cliquez sur System dans le menu de gauche
  2. Consultez les informations MCU : Trouvez les informations Micro-Controller sous Mcu Information
  3. Vérifiez le modèle du contrôleur : Confirmez que le modèle affiché correspond au modèle réel du contrôleur de votre carte mère
Points de vérification
  • Si votre contrôleur est un STM32H723, alors Micro-Controller doit afficher un modèle lié au H723
  • Si l'affichage est incorrect ou non reconnu, vérifiez les étapes de configuration précédentes
Loading...

Étape 6 : Ajouter le MCU de la carte outil​

Une fois le MCU principal vérifié avec succès, vous pouvez ajouter la carte outil :

  1. Reconnectez la carte outil : Rebranchez le câble de données de la carte outil à l'hôte ou à la carte mère
  2. Modifiez le fichier de configuration : Ajoutez la configuration de la carte outil tout en bas du fichier printer.cfg
  3. Configurez l'ID de la carte outil : Selon le type de firmware de la carte outil, ajoutez l'ID correspondant dans la nouvelle section de configuration
Explication des noms MCU

Les noms mcu1, mcu2, etc., dans la configuration sont utilisés uniquement pour distinguer temporairement différents appareils. Vous pouvez personnaliser complètement ces noms, assurez-vous simplement qu'ils restent uniques dans le fichier de configuration.

Format de configuration :

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

Exemples de configuration :

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

Précautions :

  • Chaque MCU doit utiliser un ID unique, assurez-vous que l'ID de la carte outil est différent de celui du MCU principal et des autres appareils
  • Le nom du MCU peut être entièrement personnalisé (par exemple toolboard, extruder_mcu, etc.), assurez-vous simplement qu'il reste unique dans la configuration
  • Veuillez absolument utiliser l'ID de carte outil validé comme efficace via les étapes précédentes
  • Les appareils RS232 doivent inclure les paramètres baud: 250000 et restart_method: command
  • Lors de la configuration de plusieurs cartes outils, attribuez un nom différent à chaque appareil pour les distinguer

Après avoir terminé la configuration, sauvegardez et redémarrez le service Klipper.

Étape 7 : Vérifier toutes les connexions MCU​

Après avoir ajouté la carte outil et redémarré Klipper, il est nécessaire de revérifier l'état de connexion de tous les MCU :

  1. Ouvrez l'interface Fluidd, cliquez sur System dans le menu de gauche
  2. Consultez les informations MCU : Sous Mcu Information, confirmez que tous les MCU sont correctement identifiés
  3. Vérifiez l'état de chaque MCU : Assurez-vous que le MCU principal et la carte outil affichent tous deux un état connecté
Points de vérification
  • Le MCU principal et toutes les cartes outils 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
Loading...

Étape 8 : Vérifier la version du firmware​

Après avoir établi toutes les connexions MCU, il est nécessaire de vérifier la compatibilité des versions du firmware :

  1. Ouvrez l'interface Fluidd, cliquez sur System dans le menu de gauche
  2. Consultez 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 à la version Klipper de l'hôte
Note sur la compatibilité des versions
  • Firmware compilé personnalisé : À l'exception des appareils personnalisés préconfigurés, tous les firmwares compilés indépendamment doivent correspondre à la version Klipper de l'hôte
  • Système Fly-FAST : La version du firmware du système FAST correspond à la version du système, le firmware Klipper compilé correspond à la version du système
  • Conséquences d'une incompatibilité de version : Des versions de firmware différentes peuvent entraîner des dysfonctionnements, des échecs de communication ou une instabilité du système

Points de vérification :

  • Les informations Version du MCU principal et de toutes les cartes outils doivent être affichées et les versions doivent correspondre
  • Si les versions ne correspondent pas, il est nécessaire de reflasher le firmware correspondant

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

Après avoir confirmé que toutes les connexions MCU sont normales, il est nécessaire de restaurer le fichier de configuration d'origine et de mettre à jour la configuration MCU :

  1. Supprimer le fichier de configuration actuel

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

  2. Restaurer la configuration de sauvegarde

    • Renommez le fichier de sauvegarde précédent printer_Backup.cfg en printer.cfg

  3. Mettre à jour la configuration MCU

    • Ouvrez le fichier printer.cfg restauré
    • Trouvez la section de configuration [mcu] d'origine, et mettez-la à jour en fonction des ID obtenus lors des étapes précédentes :

    Configuration de connexion USB :

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

    Configuration de connexion CAN :

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

  4. Mettre à jour la configuration de la carte outil (le cas échéant)

    • Dans le fichier de configuration, trouvez la section [mcu] correspondant à la carte outil
    • Mettez-la à jour avec l'ID réel de la carte outil trouvé, selon la méthode de connexion :

    Carte outil USB :

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

    Carte outil CAN :

    [mcu toolboard]
    canbus_uuid: 688e89f0e402

    Carte 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. Sauvegarder et redémarrer

    • Après avoir mis à jour toutes les configurations MCU, cliquez sur SAVE & RESTART pour sauvegarder et redémarrer Klipper
    • Revenez à la page System et confirmez que l'état de connexion de tous les MCU est normal
Rappel important
  • Assurez-vous d'utiliser les ID corrects réellement trouvés lors de ce test de connexion
  • Si plusieurs cartes outils sont configurées, mettez à jour l'ID de chaque section [mcu] une par une
  • Les cartes outils RS232 doivent inclure les paramètres baud: 250000 et restart_method: command
  • Après la restauration de la configuration, les paramètres d'origine de l'imprimante (comme les moteurs pas à pas, les fin de course, etc.) resteront inchangés

À ce stade, le dépannage des connexions MCU et la restauration de la configuration sont entièrement terminés.

Loading...