Aperçu des erreurs courantes

Cette page permet de localiser rapidement les erreurs courantes de Klipper. Veuillez d'abord trouver le mot-clé complet de l'erreur dans klippy.log, puis accédez à la page de catégorie correspondante pour la traiter.

Index rapide

Type d'erreur	Mots-clés courants	Point d'entrée pour le diagnostic
Problèmes de connexion	Unable to connect, Invalid CAN uuid, Lost communication, MCU Protocol error, /dev/serial/by-id	Problèmes de connexion sur cette page, Configuration de l'ID MCU, Réseau CAN et recherche d'ID
Problèmes de configuration	not valid, not a valid config section, must be specified, Unable to parse, SAVE_CONFIG, Option conflict	Erreurs de configuration
Commandes de macros et de trancheur	Unknown command, Error evaluating 'gcode_macro, jinja2.exceptions.UndefinedError, dict object has no attribute	Erreurs de configuration
Déplacement et origine	Move out of range, Must home axis first, No trigger, Endstop still triggered	Erreurs de mouvement, de fin de course et de nivellement
Analyse G-code	Unable to parse move, Invalid speed, Machine does not support G20, G2/G3	Erreurs de mouvement, de fin de course et de nivellement, Conseils d'ajustement d'arc
Nivellement par sonde	Probe triggered, No trigger on probe, samples_tolerance, bed_mesh, BLTouch failed, Z_TILT, QUAD_GANTRY_LEVEL	Erreurs de mouvement, de fin de course et de nivellement
Chauffage de température	ADC out of range, not heating at expected rate, Verify heater, temperature	Erreurs de température, de chauffage et d'extrusion
Problèmes d'extrusion	Extrude below minimum temp, Extrude only move too long, Move exceeds maximum extrusion, Filament sensor, M600	Erreurs de température, de chauffage et d'extrusion
Délai d'attente de performance	Timer too close, Missed scheduling, Stepper too far in past, Rescheduled timer, restarting too fast, SD busy	Erreurs système, de performance et de service
Pilote TMC	Unable to read tmc uart, Unable to write tmc spi, GSTAT, coil short circuit	Diagnostic des erreurs TMC
Réseau CAN	bytes_invalid, Network is down, No buffer space available, Invalid CAN uuid	Réseau CAN et recherche d'ID
Périphériques capteurs	Invalid adxl345 id, No data, Insufficient axis, Eddy current sensor error, Invalid read data	Test et calibrage de l'accéléromètre, Problèmes EDDY

Référence rapide aux pages de configuration associées

Direction de l'erreur	Référence recommandée
Syntaxe de configuration, indentation, commentaires, broches en double	Instructions de modification de configuration
Direction d'origine, direction d'axe, déplacement forcé	Guide de calibrage de l'origine et de la direction
Fin de course, TAP, fin de course optique, capteur de proximité	Fin de course
Origine sans fin de course, sensibilité de fin de course virtuelle	Utilisation sans fin de course
Chauffage, PID, chauffage lent, protection thermique	Chauffage, Optimisation de verify_heater, Optimisation de M109
Configuration du ventilateur, ventilateur piloté, ventilateur 7040	Configuration de référence du ventilateur
Paramètres de l'extrudeuse, distance de rotation, configuration de l'extrusion	Configuration de référence de l'extrudeuse, Calibrage de la machine
Macro de début/fin, pause/reprise, nivellement et macro de mesh du lit	Introduction aux macros
Commandes de débogage courantes, sonde, compensation de résonance	Instructions de débogage courantes

Problèmes de connexion

Explication de la configuration de l'ID MCU

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

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
MCU hôte	serial:	serial: /tmp/klipper_host_mcu

Règles de remplissage :

1. La carte mère utilise par défaut [mcu], tandis que les cartes d'outillage ou d'extension utilisent des noms personnalisés comme [mcu tool], [mcu toolboard], etc.
2. Pour le firmware USB, remplissez uniquement serial: ; pour le firmware CAN, remplissez uniquement canbus_uuid:. Ne conservez pas les deux éléments dans un même [mcu].
3. Dans une machine multi-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 être cohérente.
5. Les xxxxxxxx dans les exemples de documents ne peuvent pas être utilisés directement. Ils doivent être remplacés par l'ID réellement trouvé.

Erreurs courantes :

• Utiliser l'ID en mode de flashage (comme les ID contenant katapult, canboot) comme ID du firmware Klipper.
• Configurer canbus_uuid: pour un firmware USB, ou conserver l'ancien serial: pour un firmware CAN.
• Configurer la carte d'outillage comme [mcu], ce qui remplace la configuration MCU de la carte mère.
• Incohérence entre le préfixe des broches et le nom du MCU. 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

Configuration de la carte d'outillage : Ajout d'un MCU de carte d'outillage et configuration multi-cartes

mcu 'xxx': Unable to connect

Message d'erreur : L'hôte ne parvient pas à trouver ou à se connecter à la carte mère.

Loading...

Causes courantes :

• L'ID du périphérique USB n'est pas renseigné ou est mal renseigné.
• L'UUID CAN n'est pas renseigné, est mal renseigné ou le périphérique n'est pas en ligne.
• Problème avec UTOC, câble USB, firmware de pont CAN ou alimentation.
• CAN0 non démarré ou configuration réseau CAN anormale.

Méthode de traitement :

1. Ouvrez klippy.log et descendez tout en bas pour confirmer le message d'erreur spécifique.

2. Si [Errno 2] apparaît, cela signifie généralement que l'ID du périphérique USB trouvé n'a pas été ajouté à printer.cfg.

   Loading...

3. Si Serial connection closed apparaît, il est généralement nécessaire de rechercher à nouveau l'ID CAN et de vérifier le réseau CAN.

   Loading...

4. Si Unable to open CAN port: [Errno 19] No such device apparaît, cela signifie généralement qu'il manque un périphérique UTOC, un firmware de pont CAN USB ou un périphérique CAN0.

   Loading...

5. Si [Errno 100] Network is down ou [Errno 105] No buffer space available apparaît, veuillez vérifier à nouveau la configuration CAN0 selon Réseau CAN et recherche d'ID.

mcu 'mcu': Invalid CAN uuid

Message d'erreur : L'UUID CAN est invalide ou non reconnu.

Loading...

Cause de l'erreur : canbus_uuid: mal renseigné, périphérique hors ligne, ou communication réseau CAN anormale.

Solution :

1. Recherchez à nouveau l'UUID CAN selon Réseau CAN et recherche d'ID.
2. Assurez-vous que l'UUID réellement trouvé est renseigné dans printer.cfg.
3. Assurez-vous que serial: et canbus_uuid: ne sont pas activés simultanément dans le même [mcu].
4. Vérifiez CAN-H, CAN-L, la résistance de terminaison, l'alimentation et le débit CAN du firmware.

Option 'serial' in section 'mcu' must be specified

Message d'erreur : serial doit être spécifié dans la section de configuration [mcu].

Loading...

Cause de l'erreur : serial: n'est pas renseigné lors de la connexion du firmware USB, ou la section [mcu] a été accidentellement supprimée.

Solution :

1. Recherchez à nouveau l'ID du périphérique USB.
2. Renseignez dans la section [mcu] de printer.cfg :

[mcu]
serial: /dev/serial/by-id/ID_effectivement_trouvé

3. Sauvegardez et redémarrez Klipper.

Si la carte mère actuelle est flashée avec un firmware CAN, utilisez canbus_uuid: et ne renseignez pas serial:.

ID USB introuvable / Interférence des services système

Message d'erreur : L'exécution de ls /dev/serial/by-id/* n'affiche rien ou indique No such file or directory ; Klipper affiche mcu 'xxx': Unable to open serial port, [Errno 2] No such file or directory, ou la carte mère USB se déconnecte et se reconnecte de manière répétée dans le système.

Causes courantes :

• La carte mère n'est pas en état d'exécution du firmware Klipper, elle est toujours en mode de flashage Katapult / CanBoot / DFU.
• Problème de câble USB, de port USB, d'alimentation de l'hôte ou d'alimentation de la carte mère.
• Certaines versions de udev de Debian 11 Bullseye peuvent ne pas générer le chemin de périphérique /dev/serial/by-id/.
• Les versions de bureau de Linux peuvent avoir installé ModemManager ou BRLtty, ces services peuvent monopoliser le port série, empêchant Klipper de se connecter de manière stable à la carte mère.

Méthode de diagnostic :

Opération hors tension

Avant de rebrancher le câble USB, de vérifier le câble d'alimentation de la carte mère ou de réorganiser le faisceau USB / CAN, éteignez complètement l'imprimante et débranchez l'alimentation. Ne touchez pas aux connecteurs ou aux bornes sous tension.

1. Assurez-vous d'abord que la carte mère a été flashée et exécute le firmware Klipper. L'ID USB doit contenir usb-Klipper. N'écrivez pas l'ID du mode katapult, canboot, Bootloader ou DFU dans printer.cfg.
2. Éteignez, remplacez le câble de données USB et le port USB de l'hôte par des éléments fiables, puis rallumez et réexécutez ls /dev/serial/by-id/*.
3. Si vous utilisez Debian 11 Bullseye, une version ancienne de MainsailOS / FluiddPi / Armbian, exécutez la commande suivante pour vérifier la version de udev :

apt-cache policy udev

4. S'il est confirmé qu'il s'agit d'un problème de udev sur Debian 11, mettez d'abord à jour udev via les sources de mise à jour normales du système, ou remplacez par une image système plus récente.
5. Vérifiez la présence de services pouvant monopoliser le port série :

systemctl list-units --all | grep -Ei 'ModemManager|brltty'

6. Si ces services sont installés et que l'hôte actuel n'a pas besoin de modem ou de terminal braille, remplacez le nom d'unité complet affiché par la commande précédente dans la commande, arrêtez et désactivez-les, puis redémarrez le système :

sudo systemctl disable --now ModemManager.service
sudo systemctl disable --now brltty.service
sudo systemctl disable --now brltty.path

7. Une fois terminé, recherchez à nouveau l'ID USB et assurez-vous que serial: dans [mcu] de printer.cfg correspond à la sortie réelle.

Référence de configuration associée : Configuration de l'ID MCU.

Lost communication with MCU

Message d'erreur : La communication entre Klipper et le MCU est interrompue. Le journal peut contenir Lost communication with MCU, Lost communication with mcu ou des indications similaires.

Scénario courant : Pendant le déplacement ou la recherche d'origine, dès qu'un fin de course est déclenché, la carte mère ou la carte outil se déconnecte ; après une remise sous tension, la connexion est rétablie.

Causes courantes :

• Câblage incorrect du fin de course, provoquant un court-circuit anormal entre la broche de signal et l'alimentation ou la masse lors du déclenchement.
• Lors de l'utilisation d'un fin de course à trois fils, d'un fin de course optique ou d'un fin de course à effet Hall, l'ordre des fils d'alimentation, de masse et de signal est mal branché.
• Le faisceau du fin de course est dénudé, écrasé ou provoque un court-circuit lors des mouvements dans la chaîne porte-câbles.
• Le déclenchement du fin de course provoque une fluctuation de l'alimentation de la carte mère, entraînant un redémarrage du MCU ou une interruption de la communication USB / CAN.
• Le câble de communication USB / CAN entre le MCU et l'hôte passe à proximité d'une source d'interférence forte, ce qui rend les déconnexions plus probables lors du déclenchement du fin de course ou des mouvements.
• La broche du fin de course dans la configuration ne correspond pas au câblage réel, déclenchant une interface incorrecte.

Méthode de diagnostic :

Opération hors tension

Avant de débrancher les fils du fin de course, de vérifier l'ordre des fils, de vérifier le faisceau de la chaîne porte-câbles ou d'utiliser un multimètre pour mesurer la continuité / la résistance, éteignez complètement l'imprimante et débranchez l'alimentation. Les modes résistance / continuité du multimètre ne peuvent être utilisés qu'hors tension. Il est interdit de mesurer la résistance ou de faire des tests de court-circuit sous tension.

1. Hors tension, vérifiez l'ordre des fils du fin de course, en particulier si le VCC, GND et Signal du fin de course à trois fils sont mal branchés.
2. Hors tension, débranchez temporairement le fil du fin de course correspondant, puis remontez-le avant de rallumer et de tester si la carte mère se déconnecte à nouveau.
3. Hors tension, utilisez le mode continuité / résistance d'un multimètre pour vérifier s'il y a un court-circuit avant et après le déclenchement du fin de course, en vous concentrant sur la broche de signal qui pourrait être connectée à l'alimentation.
4. Vérifiez les positions de pliage dans la chaîne porte-câbles, les connecteurs et le faisceau pour confirmer qu'il n'y a pas de court-circuit par écrasement lors du déclenchement ou du mouvement.
5. Vérifiez le câble de communication USB / CAN entre le MCU et l'hôte, en essayant de l'éloigner des câbles moteur, des câbles de chauffage, des câbles du lit chauffant et des câbles d'alimentation.
6. Si le châssis de la machine, l'alimentation ou le blindage ne sont pas correctement mis à la terre, cela peut également rendre les interférences plus probables. Vérifiez uniquement les points de mise à la terre fournis par le fabricant et l'état de la prise, ne démontez pas l'alimentation vous-même et ne modifiez pas le fil de terre secteur.
7. Assurez-vous que la broche du fin de course dans la configuration correspond à la documentation de la carte mère et au câblage réel.
8. Une fois le problème résolu, exécutez QUERY_ENDSTOPS pour confirmer que l'état du fin de course peut passer normalement de open à TRIGGERED.

Références de configuration associées : Fin de course, Instructions de câblage d'alimentation.

MCU Protocol error

Message d'erreur : Erreur de protocole MCU. Le journal peut contenir MCU Protocol error, Unknown command ou Command format mismatch.

Loading...

Causes courantes :

• Klipper a été mis à jour sur l'hôte, mais le firmware de la carte mère ou de la carte outil n'a pas été recompilé et flashé.
• La version du firmware du MCU de la carte mère, de la carte outil, de l'EDDY, de l'ADXL ou d'autres périphériques ne correspond pas à celle de Klipper sur l'hôte.
• Utilisation d'un système personnalisé ou de modules tiers, entraînant une incohérence des commandes prises en charge entre l'hôte Klipper et le MCU.

Solution :

1. Confirmez si Klipper, l'image système ou des modules ont été récemment mis à jour.
2. Recompilez et flashez le firmware Klipper de tous les MCU.
3. S'il s'agit d'une carte outil, d'un EDDY, d'un ADXL ou d'un autre périphérique MCU, mettez à jour le firmware du périphérique correspondant en même temps.
4. Si vous utilisez un système personnalisé, assurez-vous que ce système prend en charge la version actuelle de Klipper.
5. Après le flashage, exécutez FIRMWARE_RESTART, puis testez à nouveau la connexion.

FAQ spécifiques

Sujet spécifique	Point d'entrée
Conflit de configuration, analyse des paramètres, SAVE_CONFIG	Erreurs de configuration
Commande inconnue, modèle de macro, G-code de départ du trancheur	Erreurs de configuration
Mouvement, origine, fin de course, sonde, nivellement du mesh du lit	Erreurs de mouvement, de fin de course et de nivellement
Température, chauffage, extrusion, détection de rupture de filament	Erreurs de température, de chauffage et d'extrusion
Performance, délai d'attente, firmware, service système	Erreurs système, de performance et de service
G2/G3, ajustement d'arc, précision du chemin du trancheur	Conseils d'ajustement d'arc
Communication du pilote TMC, surchauffe, problème de bobine	Diagnostic des erreurs TMC
Réseau CAN, UUID, bytes_invalid	Réseau CAN et recherche d'ID
Accéléromètre et test de résonance	Test et calibrage de l'accéléromètre
Sonde à courants de Foucault EDDY	Problèmes EDDY