Messages d'erreur courants

Cette page permet de localiser rapidement les erreurs courantes de Klipper. Veuillez d'abord trouver l'erreur complète dans klippy.log, puis consulter les explications correspondantes.

Problèmes de connexion

mcu 'xxx': Unable to connect

Message d'erreur : L'ordinateur hôte ne peut 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.
• UTOC, câble USB, firmware de pontage CAN ou alimentation défectueux.
• CAN0 non démarré, ou configuration réseau CAN anormale.

Méthodes 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 pontage 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 revérifier la configuration CAN0 selon Réseau CAN et recherche d'ID.

mcu 'mcu': Invalid CAN uuid

Message d'erreur : UUID CAN invalide ou non reconnaissable.

Loading...

Cause de l'erreur : canbus_uuid: mal renseigné, périphérique hors ligne, ou réseau CAN ne communiquant pas correctement.

Méthode de résolution :

1. Recherchez à nouveau l'UUID CAN selon Réseau CAN et recherche d'ID.
2. Confirmez que l'UUID réellement trouvé est renseigné dans printer.cfg.
3. Confirmez 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 : L'option serial doit être spécifiée dans la section de configuration [mcu].

Loading...

Cause de l'erreur : serial: n'est pas renseigné pour une connexion par firmware USB, ou la section de configuration [mcu] a été supprimée par erreur.

Méthode de résolution :

1. Recherchez à nouveau l'ID du périphérique USB.
2. Renseignez-le dans la section de configuration [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, veuillez utiliser canbus_uuid: et ne pas continuer à renseigner serial:.

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énarios courants : Pendant le référencement ou le déplacement, dès qu'une butée est déclenchée, la carte mère ou la carte outil se déconnecte ; après une remise sous tension, la connexion est rétablie.

Causes courantes :

• Mauvais câblage de l'interrupteur de butée, provoquant un court-circuit anormal entre la broche de signal et l'alimentation ou la masse lors du déclenchement.
• Lors de l'utilisation de butées à trois fils, de butées optiques ou de butées à effet Hall, l'ordre de l'alimentation, de la masse et du signal est mal branché.
• La gaine du câble de butée est abîmée, le câble est pincé ou un court-circuit se produit lors du mouvement dans le porte-câble.
• Le déclenchement de la butée 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'ordinateur hôte passe près d'une source de fortes interférences, rendant les déconnexions plus probables lors du déclenchement d'une butée ou du déplacement.
• La broche de butée configurée ne correspond pas au câblage réel, ce qui déclenche une mauvaise interface.

Méthodes de diagnostic :

1. Coupez l'alimentation et vérifiez le câblage de l'interrupteur de butée, en particulier si VCC, GND et Signal des butées à trois fils sont inversés.
2. Débranchez temporairement le câble de butée correspondant, puis remettez sous tension pour tester si la carte mère se déconnecte toujours.
3. Utilisez un multimètre pour vérifier s'il y a un court-circuit avant et après le déclenchement de la butée, en vous concentrant sur la broche de signal qui pourrait être connectée à l'alimentation.
4. Vérifiez le porte-câble, les connecteurs et les zones de pliage du faisceau pour vous assurer qu'il n'y a pas de court-circuit dû à un pincement lors du déclenchement ou du mouvement.
5. Vérifiez le câble de communication USB/CAN entre le MCU et l'ordinateur hôte, en essayant de l'éloigner des câbles moteur, des câbles de chauffage, des câbles de lit chauffant et des câbles d'alimentation.
6. Si le boîtier de la machine, l'alimentation électrique ou le blindage n'est pas correctement mis à la terre, cela peut également le rendre plus sensible aux interférences. Veuillez vérifier la mise à la terre conformément aux exigences de sécurité électrique de l'équipement.
7. Confirmez que la broche de butée configurée 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 de la butée peut passer normalement de open à TRIGGERED.

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 sur l'ordinateur hôte a été mis à jour, 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, d'EDDY, d'ADXL, etc., ne correspond pas à celle de Klipper sur l'ordinateur hôte.
• Utilisation d'un système personnalisé ou d'un plugin tiers, entraînant une incohérence entre les commandes prises en charge par l'hôte Klipper et le MCU.

Méthode de résolution :

1. Confirmez si Klipper, l'image système ou le plugin ont été récemment mis à jour.
2. Recompilez et flashez le firmware Klipper pour le MCU correspondant.
3. Pour les MCU périphériques comme la carte outil, EDDY, ADXL, veuillez mettre à jour le firmware périphérique correspondant de manière synchronisée.
4. Si vous utilisez un système personnalisé, confirmez qu'il prend en charge la version actuelle de Klipper.
5. Après le flashage, exécutez FIRMWARE_RESTART, puis testez à nouveau la connexion.

Problèmes de conflit de configuration

homing override method always homes X and Y before homing Z. The safe_z_home

Message d'erreur : Conflit entre la configuration de référencement Z sécurisé et le remplacement de référencement.

Loading...

Cause de l'erreur : [safe_z_home] et [homing_override] sont configurés simultanément, ce qui empêche Klipper de déterminer quelle logique de référencement utiliser.

Méthode de résolution :

1. Recherchez [safe_z_home] et [homing_override] dans le fichier de configuration.
2. Ne conservez qu'un seul d'entre eux en fonction de la logique de référencement réelle de la machine.
3. Sauvegardez et redémarrez Klipper.

Problèmes de mouvement et de référencement

Move out of range

Message d'erreur : Coordonnée cible hors de la plage de mouvement autorisée par Klipper. Le journal affiche généralement quelque chose comme Move out of range: X Y Z [E].

Loading...

Causes courantes :

• La taille de la machine dans le slicer ne correspond pas à position_min / position_max dans la configuration Klipper.
• Le G-code de début, le G-code de fin, la macro de changement de filament ou la macro de pause se déplacent en dehors de la plage de la machine.
• Les positions de stationnement des macros M600, PAUSE, CANCEL_PRINT, etc., sont trop proches des limites.
• Après avoir utilisé la correction d'inclinaison, le décalage de la sonde ou la configuration du maillage du lit, les coordonnées calculées deviennent négatives ou dépassent la course maximale.
• La hauteur du modèle dépasse la course maximale de l'axe Z.

Méthode de résolution :

1. Identifiez l'axe qui dépasse la plage en fonction de la coordonnée dans l'erreur.
2. Vérifiez position_min, position_max pour l'axe correspondant et la taille de la machine dans le slicer.
3. Vérifiez les coordonnées de stationnement dans les macros de début, de fin, de pause, de changement de filament, etc., en évitant de vous arrêter à 0,0 ou à la limite maximale.
4. Si l'erreur se produit lors du balayage du lit, vérifiez mesh_min, mesh_max et le décalage de la sonde dans [bed_mesh].
5. Sauvegardez la configuration, redémarrez Klipper et testez à nouveau.

Must home axis first

Message d'erreur : L'axe n'a pas encore été référencé, la commande de mouvement actuelle ne peut pas être exécutée.

Causes courantes :

• G28 n'a pas été exécuté après le démarrage ou FIRMWARE_RESTART.
• La macro exécute d'abord une commande de mouvement, puis une commande de référencement.
• L'état de la machine est réinitialisé après une pause, une reprise ou une annulation d'impression.
• Une configuration anormale de la macro de référencement, de la macro de sonde ou du référencement sans butée empêche Klipper d'enregistrer correctement l'état de référencement.

Méthode de résolution :

1. Exécutez manuellement G28 avant de déplacer l'axe correspondant.
2. Vérifiez le G-code de début et la macro, en confirmant que le référencement est terminé avant la commande de mouvement.
3. Si vous venez de mettre à jour Klipper ou le firmware, vérifiez si les macros liées au référencement sont toujours compatibles avec la version actuelle.
4. Si vous utilisez un référencement sans butée, vérifiez le courant moteur, la sensibilité et homing_retract_dist.

Endstop still triggered after retract

Message d'erreur : Après la fin de la distance de retrait suite au déclenchement de la butée lors du référencement, la butée est toujours déclenchée.

Causes courantes :

• La logique normalement ouvert/normalement fermé de l'interrupteur de butée est configurée à l'envers.
• L'interrupteur de butée est bloqué, endommagé ou le câblage est incorrect.
• homing_retract_dist est trop petit, la butée est toujours enfoncée après le retrait.
• La sensibilité du référencement sans butée est trop élevée, il est toujours considéré comme déclenché après le retrait.
• La configuration de enable_pin, la direction du moteur ou la broche de butée sont incorrectes, ce qui entraîne un mouvement de référencement anormal.

Méthode de résolution :

1. Exécutez QUERY_ENDSTOPS pour confirmer que l'état est open lorsqu'il n'est pas déclenché et TRIGGERED après un déclenchement manuel.
2. Si l'état est inversé, ajustez le ! devant la broche de butée.
3. Vérifiez l'état mécanique de l'interrupteur de butée, le câblage et le connecteur.
4. Augmentez homing_retract_dist de manière appropriée et testez à nouveau.
5. Si vous utilisez un référencement sans butée, réduisez la sensibilité et confirmez que le courant de référencement est approprié.

No trigger on probe after full movement

Message d'erreur : La sonde ne s'est pas déclenchée pendant toute la course de descente.

Causes courantes :

• Mauvais câblage, alimentation ou configuration de la broche de la sonde.
• Hauteur d'installation de la sonde inappropriée, ne pouvant pas se déclencher dans la course de descente.
• Mauvais sens de l'axe Z, décalage de la sonde ou configuration de la zone de mise à niveau.
• Défaut de la sonde elle-même, ou mauvais contact du faisceau lors du mouvement.
• La position du lit chauffant, de la buse ou de la sonde dépasse la plage de détection.

Méthode de résolution :

1. Exécutez QUERY_PROBE, déclenchez manuellement la sonde et confirmez que l'état change normalement.
2. Vérifiez l'alimentation de la sonde, le câble de signal et la broche configurée.
3. Vérifiez la hauteur d'installation de la sonde, en confirmant que la sonde se trouve dans la plage de déclenchement avant la descente.
4. Vérifiez si les points de détection dans [probe], [bed_mesh], [z_tilt] ou [quad_gantry_level] dépassent le lit chauffant.
5. Si le problème ne se produit qu'à certaines positions, concentrez-vous sur la vérification du faisceau traînant et du décalage de la sonde.

Problèmes de détection de température

Error 'XXX mcu' shutdown: ADC out of range

Message d'erreur : ADC hors de la plage de mesure, détection de température anormale.

Loading...

Cause de l'erreur : Klipper détecte une température en dehors de la plage autorisée par la configuration. Cela est souvent dû à une thermistance en circuit ouvert, en court-circuit, à une erreur de câblage, à une configuration incorrecte du modèle de thermistance ou à une erreur de broche.

Attention

Assouplir temporairement min_temp et max_temp n'est autorisé que pour le diagnostic et ne doit pas être une configuration à long terme. Après avoir identifié le problème, il doit être rétabli dans une plage de sécurité pour éviter la désactivation de la protection thermique.

Ordre de diagnostic :

1. Vérifiez si la thermistance est bien branchée et si le fil n'est pas cassé ou en court-circuit.
2. Vérifiez si le modèle de thermistance et la configuration de la broche correspondent au matériel réel.
3. Si nécessaire, assouplissez temporairement la plage de température pour confirmer le changement de lecture, par exemple en abaissant min_temp ou en augmentant max_temp.
4. Après avoir trouvé et résolu le problème de câblage ou de configuration, rétablissez immédiatement la limite de température de sécurité d'origine.
5. Sauvegardez et redémarrez Klipper.

Heater not heating at expected rate

Message d'erreur : Le chauffage ne chauffe pas à la vitesse attendue. Le journal peut contenir Heater extruder not heating at expected rate ou Heater heater_bed not heating at expected rate.

Loading...

Causes courantes :

• Sortie anormale de la cartouche chauffante, du lit chauffant ou du SSR/transistor MOS.
• Mauvais contact de la thermistance, fil semi-sectionné ou lecture fluctuante.
• Ventilateur soufflant directement sur la partie chaude, le lit chauffant ou la zone de chauffe, ce qui ralentit la montée en température.
• Puissance insuffisante du lit chauffant, ou limitation trop basse de max_power.
• Paramètres PID inappropriés, entraînant une trop grande fluctuation de la température près de la cible.

Méthode de résolution :

1. Vérifiez si les connexions du chauffage et de la thermistance sont solides.
2. Observez la courbe de température pour confirmer si la montée en température est continue et s'il y a des fluctuations anormales.
3. Vérifiez si un ventilateur souffle directement sur la partie chaude ou le lit chauffant.
4. Vérifiez la puissance du chauffage, l'alimentation, le fusible, le SSR/transistor MOS et le réglage de max_power.
5. Après avoir confirmé le bon fonctionnement du matériel, réexécutez l'étalonnage PID.
6. Si vous confirmez qu'il s'agit simplement d'un lit chauffant de grande taille ou d'une structure spéciale entraînant une montée lente en température, veuillez vous référer à optimisation de verify_heater.

Problèmes d'extrusion

Extrude below minimum temp

Message d'erreur : La température de la buse est inférieure à la température minimale autorisée pour l'extrusion. Le journal peut contenir Extrude below minimum temp ou Extruder not hot enough.

Causes courantes :

• Exécution d'une commande d'extrusion sans avoir chauffé la buse.
• Absence de commande d'attente de température dans le G-code de début, la macro de changement de filament ou la macro de reprise après pause.
• La température cible n'est pas encore atteinte, la macro a exécuté l'extrusion ou la rétraction prématurément.
• Lecture anormale du capteur de température, amenant Klipper à juger que la buse n'a pas atteint la température d'extrusion.

Méthode de résolution :

1. Avant d'extruder, confirmez que la buse a atteint la température requise pour le filament.
2. Vérifiez si le G-code de début, M600, PAUSE, RESUME, etc., contiennent une logique d'attente de température.
3. Utilisez M109 ou une commande d'attente équivalente de Klipper aux endroits où l'attente de température est nécessaire.
4. Vérifiez la thermistance et la courbe de température pour confirmer que la lecture de la température est stable.
5. Il n'est pas recommandé de réduire min_extrude_temp de manière permanente pour contourner l'erreur.

Problèmes de performance et de dépassement de temps

Problème de dépassement de temps de référencement

En cas de dépassement du temps de communication, de déconnexion du MCU ou d'anomalie de référencement multi-MCU lors du référencement, veuillez vous référer à Problème de dépassement de temps de référencement.

MCU 'mcu' shutdown: Stepper too far in past

Message d'erreur : Un événement pas à pas dépasse la plage de temps que le MCU peut traiter, l'imprimante entre en état d'arrêt.

Loading...

Scénarios de référence : Cette erreur n'est pas nécessairement causée par la configuration du maillage du lit. La cause réelle doit être déterminée en combinant klippy.log et l'opération en cours. Si, lors d'un balayage multipoint du lit, probe_count dans [bed_mesh] est défini sur une valeur trop élevée, par exemple 20,20, et qu'un mesh_pps élevé est également configuré, par exemple mesh_pps: 4,4, cela peut générer des données de maillage trop denses, augmentant la charge de calcul et de planification de mouvement de l'ordinateur hôte, ce qui peut déclencher une erreur similaire.

Méthode de résolution :

1. Si l'erreur se produit lors d'un balayage multipoint du lit, vous pouvez d'abord réduire probe_count dans [bed_mesh], par exemple en le définissant sur 7,7 ou 9,9 pour tester.
2. Si un mesh_pps élevé est configuré, vous pouvez le réduire ou le supprimer, par exemple en le définissant sur mesh_pps: 2,2 ; si l'interpolation n'est pas nécessaire, vous pouvez le définir sur 0,0 en fonction des besoins réels.
3. Sauvegardez la configuration, redémarrez Klipper, puis réexécutez l'opération qui a déclenché l'erreur.
4. Si l'erreur persiste, continuez à vérifier la charge de l'ordinateur hôte, la vitesse d'impression, l'accélération, la qualité de la communication et la macro ou le G-code en cours d'exécution.

MCU 'mcu' shutdown: Timer too close

Message d'erreur : La minuterie du MCU est trop proche, ce qui entraîne un dépassement de temps système.

Loading...

Cause de l'erreur : Une charge de traitement trop élevée sur l'ordinateur inférieur, un dépassement du temps de réponse de l'ordinateur hôte, une vitesse d'impression trop élevée, un micro-pas trop élevé, une interférence avec la synchronisation temporelle du système ou une interférence sur le câble de communication du MCU peuvent tous déclencher ce problème.

Méthode de résolution :

1. Réduisez le micro-pas du moteur pas à pas pour diminuer la charge de traitement d'impulsions du MCU.
2. Réduisez la vitesse d'impression et l'accélération pour observer si le problème disparaît.
3. Vérifiez la charge de l'ordinateur hôte, l'alimentation et la qualité de la communication USB/CAN.
4. Vérifiez si le câble de communication entre le MCU et l'ordinateur hôte est proche des câbles moteur, des câbles de chauffage, des câbles de lit chauffant ou des câbles d'alimentation. Si nécessaire, repassez le câble ou remplacez-le par un câble de communication blindé.
5. Vérifiez la mise à la terre de la machine. Les machines non correctement mises à la terre peuvent être plus sujettes aux interférences de communication.
6. Si le problème se produit pendant la phase de référencement, veuillez vous référer à Problème de dépassement de temps de référencement.
7. Si le problème persiste, envisagez de reflasher le système de l'ordinateur hôte ou le firmware.

Les utilisateurs de Raspberry Pi peuvent vérifier l'état de synchronisation NTP :

sudo timedatectl status | grep "NTP service"

Pour désactiver temporairement la synchronisation NTP, exécutez :

sudo timedatectl set-ntp false

Après avoir confirmé que le problème n'est pas lié à NTP, vous pouvez le réactiver selon vos besoins :

sudo timedatectl set-ntp true