Guide de connexion du MCU

Note d'application

Ce guide est utilisé pour dépanner les problèmes où le MCU principal ne parvient pas à se connecter correctement à Klipper. Si l'appareil se connecte normalement et que vous devez uniquement remplacer ou compléter l'ID du MCU, consultez directement la Configuration de l'ID MCU, sans avoir besoin d'effacer la configuration existante.

Processus de dépannage

1. Sauvegardez le printer.cfg actuel.
2. Activez une configuration de test minimale uniquement si vous ne pouvez pas accéder à Klipper.
3. Confirmez le type de firmware actuellement exécuté sur la carte mère.
4. Recherchez le véritable ID du MCU et écrivez-le dans une configuration temporaire pour vérifier la connexion.
5. Restaurez la configuration complète en ne mettant à jour que les éléments de connexion du MCU.

Ne vérifiez qu'un seul appareil à la fois

Lorsque plusieurs périphériques USB/CAN sont connectés, il est facile de confondre l'ID de la carte d'outillage avec celui de la carte mère dans [mcu]. Pendant la phase de dépannage, il est recommandé de ne vérifier que la carte mère, puis d'ajouter les cartes d'outillage une par une après confirmation du succès.

Première étape : Sauvegarder la configuration actuelle

1. Accédez à la gestion des fichiers de configuration

Saisissez l'adresse IP de l'hôte dans le navigateur. Les utilisateurs de Fluidd cliquent sur ... à gauche, les utilisateurs de Mainsail cliquent sur Machine, puis trouvent printer.cfg.

Loading...

Loading...

Loading...

2. Créez une sauvegarde

Cliquez avec le bouton droit sur printer.cfg, sélectionnez Duplicate, puis renommez la copie :

printer_Backup.cfg

Exemple avec Fluidd :

Loading...

Exemple avec Mainsail :

Loading...

Ne sautez pas la sauvegarde

La configuration minimale suivante est uniquement destinée aux tests de connexion et ne peut pas remplacer la configuration officielle de l'imprimante. Assurez-vous que printer_Backup.cfg existe et que son contenu est complet avant de continuer.

Vérifiez l'include avec caractères génériques

Si la configuration officielle utilise [include *.cfg], le printer_Backup.cfg dans le même répertoire pourrait également être chargé. Déplacez la sauvegarde vers un sous-répertoire qui ne correspond pas à cette règle, ou changez son extension en .txt pour éviter les sections de configuration dupliquées.

Deuxième étape : Activez la configuration de test minimale si nécessaire

Cas où cette étape peut être ignorée

Si Klipper démarre et se connecte actuellement normalement et que vous devez uniquement modifier l'ID du MCU, conservez la configuration complète et passez directement à la troisième étape.

Lorsqu'une configuration erronée ou plusieurs périphériques empêchent Klipper de démarrer, vous pouvez temporairement remplacer le contenu de printer.cfg par la configuration minimale suivante :

[mcu]
serial: /tmp/klipper_host_mcu

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

Cliquez sur SAVE & RESTART pour enregistrer. /tmp/klipper_host_mcu ici est l'adresse de connexion temporaire du MCU hôte de la machine supérieure ; elle sert uniquement à permettre le démarrage de la configuration minimale et n'est pas le véritable ID USB de la carte mère.

Opération hors tension

Avant de commencer, éteignez complètement l'imprimante et débranchez l'alimentation électrique. Ne branchez ou ne débranchez pas les câbles, ne réorganisez pas les fils des connecteurs et ne touchez pas les bornes lorsque l'appareil est sous tension.

Après la mise hors tension, débranchez les câbles de données des cartes d'outillage qui ne participent pas au test, en ne conservant que les connexions de données nécessaires entre l'hôte et la carte mère. Ne démontez pas l'alimentation, ne modifiez pas le câblage secteur et ne touchez pas aux bornes exposées. Une fois les connexions confirmées, remettez sous tension.

Troisième étape : Confirmez le firmware et le mode de communication

Commencez par accéder à l'hôte en suivant le Tutoriel de connexion SSH, puis exécutez :

lsusb

Identifiez le mode actuel de l'appareil en fonction de la sortie :

VID:PID	État de l'appareil	Étape suivante
1d50:614e	Firmware USB Klipper	Rechercher l'ID USB
1d50:606f	Firmware de pont USB vers CAN	Rechercher l'UUID CAN
1d50:6177	Mode de flashage Katapult	Flasher ou démarrer d'abord le firmware Klipper
1a86:7523	Adaptateur série USB	Rechercher le chemin RS232

Loading...

Loading...

Si le message lsusb: command not found s'affiche, installez usbutils :

sudo apt-get update
sudo apt-get install usbutils

lsusb ne montre pas l'appareil cible

Vérifiez d'abord que la carte mère est correctement alimentée, que le câble de données prend en charge la communication et que le mode du firmware est correct. Ne devinez pas l'ID uniquement à partir du nom de l'appareil et n'écrivez pas l'ID du mode Katapult/Bootloader dans printer.cfg.

Quatrième étape : Recherchez et saisissez l'ID du MCU

Carte mère USB

ls /dev/serial/by-id/*

La sortie doit contenir usb-Klipper_.... Les appareils contenant katapult ou Bootloader sont encore en mode de flashage et ne peuvent pas être utilisés comme ID d'exécution de Klipper.

Carte mère CAN

• Hôte Linux standard
• Hôte FlyOS-FAST / FLY

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

python3 ~/klipper/scripts/canbus_query.py can0

Seul l'UUID correspondant à Application: Klipper peut être écrit dans la configuration. Si Total 0 uuids found s'affiche, consultez Réseau CAN et recherche d'UUID pour poursuivre le dépannage.

Appareil RS232

ls -l /dev/serial/by-path/

Les règles suivantes partagent le même contenu avec la FAQ :

Explication de la configuration de l'ID MCU

Dans Klipper, l'ID MCU fait référence aux informations d'identification utilisées pour se connecter à la carte de contrôle dans la section de configuration [mcu] ou [mcu xxx]. Les différentes méthodes de communication s'écrivent différemment :

Méthode de connexion	Élément de configuration	Exemple
Firmware USB	serial:	serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx
Firmware CAN	canbus_uuid:	canbus_uuid: xxxxxxxxxxxx
Périphérique RS232	serial:	serial: /dev/serial/by-path/xxxxxxxxxxxx
MCU de l'hôte	serial:	serial: /tmp/klipper_host_mcu

Règles de remplissage :

1. La carte mère utilise par défaut [mcu], la carte d'outillage ou la carte d'extension utilise des noms personnalisés tels que [mcu tool], [mcu toolboard], etc.
2. Le firmware USB ne remplit que serial:, le firmware CAN ne remplit que canbus_uuid:, ne conservez pas les deux éléments dans le même [mcu].
3. Dans une machine à plusieurs MCU, chaque [mcu xxx] doit utiliser son propre ID réel, ne copiez pas le même ID USB ou UUID CAN.
4. Le nom de [mcu xxx] affecte le préfixe des broches, par exemple les broches de [mcu tool] doivent être écrites comme tool:gpio13 ; la casse du nom doit rester cohérente.
5. Le xxxxxxxx dans les exemples de documentation ne peut pas être utilisé directement, il doit être remplacé par l'ID réellement trouvé.
6. Pour les périphériques RS232, en plus de serial:, il est généralement nécessaire de remplir baud: 250000 et restart_method: command ; se référer à la documentation du produit correspondant.

Erreurs courantes :

• Utiliser l'ID du mode de flashage (comme un ID contenant katapult, canboot) comme ID du firmware Klipper.
• Le firmware USB est configuré avec canbus_uuid:, ou le firmware CAN conserve encore l'ancien serial:.
• Pour les périphériques RS232, seule la voie est remplie, en omettant les baud: ou restart_method: requis.
• La carte d'outillage est configurée comme [mcu], ce qui écrase la configuration MCU de la carte mère.
• Le préfixe des broches et le nom du MCU ne correspondent pas, par exemple la configuration est [mcu toolboard], mais les broches sont écrites tool:gpio13.

Recherche d'ID USB : Pour le firmware USB, exécutez ls /dev/serial/by-id/* pour obtenir l'ID.

Recherche d'ID CAN : Réseau CAN et recherche d'ID

Recherche de voie RS232 : Exécutez ls -l /dev/serial/by-path/ pour obtenir la voie de périphérique stable.

Configuration de la carte d'outillage : Ajout de MCU pour carte d'outillage et configuration inter-cartes

Instructions complètes de recherche et exemples de plusieurs MCU : Configuration de l'ID MCU

Cinquième étape : Vérifiez le MCU principal

Mettez à jour l'adresse de connexion dans [mcu] avec l'ID réel que vous venez d'obtenir. Si la configuration minimale a été activée à la deuxième étape, remplacez /tmp/klipper_host_mcu ; si la configuration officielle a été conservée, modifiez uniquement serial: ou canbus_uuid: dans [mcu] existant, sans modifier les autres paramètres.

• Carte mère USB
• Carte mère CAN

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

[mcu]
canbus_uuid: 688e89f0e401

Cliquez sur SAVE & RESTART. Après une connexion réussie :

1. Ouvrez la page System de Fluidd.
2. Trouvez le MCU principal dans Mcu Information.
3. Vérifiez que le Micro-Controller correspond au modèle de contrôleur principal réel de la carte mère.

Points clés de la vérification

• [mcu] doit correspondre à la carte mère et ne doit pas afficher le modèle de la carte d'outillage.
• Les versions du firmware de tous les MCU doivent être compatibles avec le système Klipper actuel.
• Si la connexion échoue toujours, consultez Dépannage des problèmes de connexion en fonction du message d'erreur original.

Loading...

Sixième étape : Restaurez la configuration complète de l'imprimante

La configuration officielle doit être restaurée

Si la configuration minimale a été activée à la deuxième étape, vous devez restaurer la configuration officielle après avoir terminé la vérification de la connexion. N'utilisez pas une configuration de test contenant uniquement [mcu] et kinematics: none à long terme.

Utilisation de la configuration minimale

Après avoir confirmé que le MCU principal peut se connecter :

1. Renommez le fichier printer.cfg temporaire actuel en printer_MCU_Test.txt pour le conserver à des fins de vérification, tout en évitant qu'il ne soit chargé par le caractère générique *.cfg.
2. Copiez le printer_Backup.cfg précédent et nommez la copie printer.cfg.
3. Ouvrez le printer.cfg restauré et localisez la section de configuration [mcu] d'origine.
4. Mettez uniquement à jour serial: ou canbus_uuid: sans écraser les paramètres des moteurs pas à pas, des chauffages, des fins de course ou d'autres paramètres de l'imprimante.
5. Cliquez sur SAVE & RESTART, puis accédez à nouveau à Mcu Information pour confirmer la connexion.

Si la sauvegarde n'existe pas ou si son contenu est incomplet, restaurez d'abord la configuration complète depuis l'historique de configuration, ne continuez pas à écraser le fichier actuel.

Configuration minimale ignorée

Le printer.cfg actuel est déjà la configuration officielle, aucune renomination ou restauration de fichier n'est nécessaire. Confirmez que la connexion MCU est réussie et conservez la sauvegarde créée à la première étape.

Étape 7 : Ajout de la carte d'outils

Une fois que le MCU principal est validé avec succès, connectez et ajoutez les cartes d'outils une par une :

Carte d'outils et configuration multi-MCU : Ajout du MCU de la carte d'outils et configuration inter-cartes