Guide de Connexion MCU
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 box 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 (comme les cartes outils) que vous utilisez. 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 de manière plus intuitive l'état de connexion du MCU.
Étape 1 : Sauvegarder et réinitialiser la configuration
1. Accéder à l'interface hôte
Accédez-y en entrant l'adresse IP de l'hôte (par exemple : 192.168.101.179) dans votre navigateur.
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 Loading... | Utilisateurs Mainsail : Cliquez sur 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, videz 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, veuillez mettre hors tension tous les appareils (y compris l'hôte et tous les esclaves).
- Important : Assurez-vous d'une mise hors tension complète, sinon les étapes suivantes ne pourront pas être effectuées.
Étape 2 : Détecter les appareils et confirmer le type de firmware
Conditions préalables
- Ordre des appareils principaux : Le premier
MCUdoit ê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 un réseau.
Procédure
-
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 périphériques USB reconnus.
- Après une connexion SSH réussie, exécutez la commande suivante :
-
Gérer les exceptions de commande
- Si la commande
lsusbn'est pas trouvée, installez-la d'abord :sudo apt-get install usbutils - Si rien n'est affiché après exécution, envisagez de changer d'hôte.
- Si la commande
-
Identifier les informations de l'appareil Sur la base des illustrations ci-dessous, identifiez votre appareil dans la sortie de
lsusb:Loading...Loading... -
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 : Devrait afficher
1d50:614e - Firmware USB ponté CAN : Devrait afficher
1d50:606f - Firmware USB Katapult : Devrait afficher
1d50:6177 - Adaptateur RS232 (utilisé avec UTOR ou les cartes mères D8 et D8PRO) : Devrait afficher
1a86:7523(non requis avec G2T)
- Firmware USB : Devrait afficher
- En fonction du firmware que vous avez flashé, vérifiez les informations clés suivantes dans les résultats de
Étape 3 : Rechercher l'ID de l'appareil
Informations importantes
- Recherche d'ID USB : Applicable uniquement au firmware USB, pas au CAN ou RS232.
- Recherche d'ID CAN : Applicable uniquement aux appareils bus CAN, pas à l'USB ou RS232.
- Recherche d'ID RS232 : Applicable uniquement au firmware RS232, pas à l'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 selon le 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 :
- Hôte standard
- Système Fly_FAST
~/klippy-env/bin/python ~/klipper/scripts/canbus_query.py can0
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
Klipperaprès le champusb- -
⚠️ Nécessite un flash de firmware : Si l'ID est annoté comme
katapultaprès le champusb-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
Klipperdans le champApplication:à la fin. - ⚠️ Nécessite un flash de firmware : Si l'ID affiché est annoté comme
CANBOOTouKatapultdans le champApplication:à la fin. - ❌ Appareil non trouvé : Si
Total 0 uuids foundest affiché, les causes possibles incluent :- Configuration réseau CAN incorrecte
- 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, débrancher et redémarrer)
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
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
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, reportez-vous à la méthode correspondante ci-dessous pour configurer :
- Configuration de connexion USB
- Configuration de connexion CAN
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
# Modifier la configuration en :
[mcu]
serial: /dev/serial/by-id/usb-Klipper_stm32h723xx_12345-if00
Remplacez l'entrée de configuration serial: /tmp/klipper_host_mcu par canbus_uuid:, et entrez l'ID CAN trouvé.
Exemple de configuration :
# L'ID CAN trouvé est :
# 688e89f0e401
# Modifier la configuration en :
[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, il faut vérifier si la connexion est réussie :
- Ouvrez l'interface Fluidd, cliquez sur
Systemdans le menu de gauche - Consultez les informations MCU : Trouvez les informations
Micro-ControllersousMcu Information - 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
- Si votre contrôleur est un STM32H723, alors
Micro-Controllerdoit afficher un modèle lié au H723 - Si l'affichage est incorrect ou non reconnu, vérifiez les étapes de configuration précédentes
É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 :
- Reconnectez la carte outil : Rebranchez le câble de données de la carte outil à l'hôte ou à la carte mère
- Modifiez le fichier de configuration : Ajoutez la configuration de la carte outil tout en bas du fichier
printer.cfg - Configurez l'ID de la carte outil : Ajoutez l'ID correspondant dans la nouvelle section de configuration, selon le type de firmware de la carte outil
Les noms mcu1, mcu2, etc., dans la configuration sont uniquement utilisés pour distinguer temporairement les 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
Exemple de configuration :
- Carte outil USB
- Carte outil CAN
- Carte outil RS232
[mcu mcu1]
serial: /dev/serial/by-id/usb-Klipper_stm32f446xx_54321-if00
[mcu mcu1]
canbus_uuid: 688e89f0e402
[mcu mcu1]
serial: /dev/serial/by-path/platform-3f980000.usb-usb-0:1.2:1.0-port0
baud: 250000
restart_method: command
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 configurer les paramètres
baud: 250000etrestart_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 faut revérifier l'état de connexion de tous les MCU :
- Ouvrez l'interface Fluidd, cliquez sur
Systemdans le menu de gauche - Consultez les informations MCU : Sous
Mcu Information, confirmez que tous les MCU sont correctement identifiés - Vérifiez l'état de chaque MCU : Assurez-vous que le MCU principal et la carte outil affichent tous deux un état connecté
- 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
Étape 8 : Vérifier la version du firmware
Après avoir établi toutes les connexions MCU, il faut vérifier la compatibilité des versions du firmware :
1