Aller au contenu principal

Aperçu des erreurs courantes

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

Index rapide​

Type d'erreurMots-clés courantsPoint d'entrée
Problème de connexionUnable to connect、Invalid CAN uuid、Lost communication、MCU Protocol error、/dev/serial/by-idProblème de connexion sur cette page, Configuration de l'ID MCU, Réseau CAN et recherche d'ID
Problème de configurationnot valid、not a valid config section、must be specified、Unable to parse、SAVE_CONFIG、Option conflict、virtual_sdcard、pause_resume、display_statusErreurs de configuration
Commandes de macro et de trancheuseUnknown command、Error evaluating 'gcode_macro、jinja2.exceptions.UndefinedError、dict object has no attributeErreurs de configuration
Mouvement d'origineMove out of range、Must home axis first、No trigger、Endstop still triggeredErreurs de mouvement, de fin de course et de nivellement
Analyse G-codeUnable to parse move、Invalid speed、Machine does not support G20、G2/G3Erreurs de mouvement, de fin de course et de nivellement, Conseils d'adaptation des arcs
Nivellement par palpeurProbe triggered、No trigger on probe、samples_tolerance、bed_mesh、BLTouch failed、Z_TILT、QUAD_GANTRY_LEVEL、no samples between time、SVD did not convergeErreurs de mouvement, de fin de course et de nivellement, Configuration et dépannage BLTouch
Chauffage de températureADC out of range、not heating at expected rate、Verify heater、temperature、Thermocouple reader faultErreurs de température, de chauffage et d'extrusion
Problème d'extrusionExtrude below minimum temp、Extrude only move too long、Move exceeds maximum extrusion、Filament sensor、M600Erreurs de température, de chauffage et d'extrusion
Délai d'attente de performanceTimer too close、Missed scheduling、Stepper too far in past、Move queue overflow、stepcompress、Rescheduled timer、restarting too fast、SD busy、Unhandled exception during run、hard pwm eventErreurs système, de performance et de service
Pilote TMCUnable to read tmc uart、Unable to write tmc spi、GSTAT、coil short circuit、tmcuart_responseDépannage des erreurs TMC
Réseau CANbytes_invalid、Network is down、No buffer space available、Invalid CAN uuid、USB CANBUS bridge、BUS-OFFRéseau CAN et recherche d'ID, Dépannage des erreurs CAN
Périphérique capteurInvalid adxl345 id、No data、Insufficient axis、Eddy current sensor error、Invalid read data、load_cell_probe、START_READ_NACK、I2C、BUS_TIMEOUTTest et calibrage de l'accéléromètre, Problèmes EDDY, Dépannage de la sonde Load Cell, Erreur de communication I2C sur cette page
Compensation de résonance et avance de pressionshaper_freq、input_shaper、pressure_advance、smooth_time、accel_chip、TEST_RESONANCES、SHAPER_CALIBRATECompensation de résonance et avance de pression

Référence rapide des pages de configuration associées​

Direction d'erreurRéférence recommandée
Syntaxe de configuration, indentation, commentaire, broche en doubleInstructions de modification de configuration
Direction d'origine, direction d'axe, déplacement forcéGuide de calibrage d'origine et de direction
Fin de course, TAP, fin de course photoélectrique, interrupteur de proximitéFin de course
Origine sans fin de course, sensibilité de fin de course virtuelleUtilisation sans fin de course
Chauffage, PID, chauffage lent, protection de températureChauffage, Optimisation verify_heater, Optimisation M109
Configuration du ventilateur, ventilateur de conduite, ventilateur 7040Configuration de référence du ventilateur
Paramètres de l'extrudeur, distance de rotation, configuration d'extrusionConfiguration de référence de l'extrudeur, Calibrage de la machine
Macro de début/fin, pause reprise, macro de nivellement et de lit en mailleIntroduction aux macros
Commandes de débogage courantes, palpeur, compensation de résonanceInstructions 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 configurationExemple
Firmware USBserial:serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx
Firmware CANcanbus_uuid:canbus_uuid: xxxxxxxxxxxx
MCU hôteserial: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'ordinateur 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.
  • Anomalie de l'UTOC, du câble USB, du pont CAN ou de l'alimentation.
  • CAN0 non démarré ou configuration réseau CAN anormale.

Méthode de traitement :

  1. Ouvrez klippy.log et allez 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 pilote 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 : UUID CAN invalide ou non reconnaissable.

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 de configuration [mcu] a été supprimée par erreur.

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_réellement_trouvé
  1. Enregistrez et redémarrez Klipper.

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

ID USB introuvable / Interférence du service système​

Message d'erreur : L'exécution de ls /dev/serial/by-id/* ne produit aucune sortie ou signale No such file or directory ; Klipper signale mcu 'xxx': Unable to open serial port, [Errno 2] No such file or directory lors de la connexion, 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 entrée en état d'exécution du firmware Klipper, elle est toujours en mode de flashage Katapult / CanBoot / DFU.
  • Anomalie du câble USB, du port USB, de l'alimentation de l'ordinateur hôte ou de l'alimentation de la carte mère.
  • Certaines versions de udev sous Debian 11 Bullseye ont des problèmes et peuvent ne pas générer le chemin de périphérique /dev/serial/by-id/.
  • La version de bureau de Linux peut avoir installé ModemManager ou BRLtty, ces services peuvent occuper le port série, empêchant Klipper de se connecter de manière stable à la carte mère.

Méthode de dépannage :

Opération hors tension

Avant de reconnecter 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 réorganisez pas l'ordre des câbles d'interface ou ne touchez pas aux bornes sous tension.

  1. Confirmez 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 de mode katapult, canboot, Bootloader ou DFU dans printer.cfg.
  2. Après avoir coupé l'alimentation, remplacez par un câble de données USB fiable et un port USB de l'ordinateur hôte, puis réexécutez ls /dev/serial/by-id/* après la remise sous tension.
  3. Si vous utilisez Debian 11 Bullseye, une ancienne version de MainsailOS / FluiddPi / Armbian, exécutez la commande suivante pour vérifier la version de udev :
apt-cache policy udev
  1. Si vous confirmez qu'il s'agit d'un problème de udev sur Debian 11, mettez à jour udev de préférence via la source de mise à jour normale du système, ou remplacez par une image système plus récente.
  2. Vérifiez s'il existe des services pouvant occuper le port série :
systemctl list-units --all | grep -Ei 'ModemManager|brltty'
  1. Si vous confirmez que ces services sont installés et que l'ordinateur hôte actuel n'a pas besoin de fonctions 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, puis redémarrez le système :
sudo systemctl disable --now ModemManager.service
sudo systemctl disable --now brltty.service
sudo systemctl disable --now brltty.path
  1. Après cela, interrogez à nouveau l'ID USB et assurez-vous que serial: de [mcu] dans printer.cfg correspond à la sortie réelle.

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

Serial connection closed​

Message d'erreur : mcu 'xxx': Serial connection closed, la connexion série entre Klipper et le MCU s'est fermée de manière inattendue.

Causes courantes :

  • Mauvais contact ou mauvaise qualité du câble USB.
  • Alimentation instable ou firmware anormal du périphérique de pont CAN (UTOC, etc.).
  • Fluctuation de l'alimentation de la carte mère entraînant un redémarrage du MCU.
  • Communication réseau CAN anormale, périphérique hors ligne.

Solution :

  1. Après avoir coupé l'alimentation, rebranchez le câble USB / CAN et remplacez-le par un câble fiable.
  2. Vérifiez l'alimentation et l'état du firmware du périphérique de pont CAN, recherchez à nouveau l'ID CAN si nécessaire.
  3. Assurez-vous que l'alimentation de la carte mère est stable et évitez de partager le circuit d'alimentation avec des appareils de grande puissance.
  4. Si le problème se reproduit, consultez Dépannage des erreurs CAN et Lost communication with MCU pour continuer le dépannage.

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 mouvement d'origine ou le déplacement, dès que le fin de course se déclenche, la carte mère ou la carte outil se déconnecte ; après une remise sous tension, elle peut se reconnecter.

Causes courantes :

  • Erreur de câblage de l'interrupteur de 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 photoélectrique ou d'un fin de course à effet Hall, l'ordre de l'alimentation, de la masse et de la ligne de signal est mal branché.
  • Le faisceau de câbles du fin de course est dénudé, écrasé ou provoque un court-circuit lors du mouvement de la chaîne porte-câbles.
  • Le déclenchement instantané du fin de course provoque une fluctuation de l'alimentation de la carte mère, 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 à proximité d'une source de fortes interférences, ce qui rend la déconnexion plus probable lors du déclenchement du fin de course ou du mouvement.
  • La broche du fin de course dans la configuration ne correspond pas au câblage réel, déclenchant une interface erronée.

Méthode de dépannage :

Opération hors tension

Avant de débrancher le câble du fin de course, de vérifier l'ordre des câbles, 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. Le mode résistance/continuité du multimètre ne peut être utilisé qu'à l'état hors tension. Il est interdit de mesurer la résistance ou de tester un court-circuit sous tension.

  1. Après avoir coupé l'alimentation, vérifiez l'ordre des câbles de l'interrupteur de fin de course, en particulier si VCC, GND, Signal du fin de course à trois fils sont mal branchés.
  2. Après avoir coupé l'alimentation, débranchez temporairement le câble du fin de course correspondant, puis remontez-le et testez si la carte mère se déconnecte toujours.
  3. Après avoir coupé l'alimentation, utilisez le mode continuité/résistance du multimètre pour vérifier s'il y a un court-circuit avant et après le déclenchement du fin de course, en vérifiant particulièrement si la broche de signal est connectée à l'alimentation.
  4. Vérifiez la chaîne porte-câbles, les connecteurs et les points de pliage du faisceau pour vous assurer qu'il n'y a pas de court-circuit dû à l'écrasement du câble 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, essayez 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 boîtier, l'alimentation ou le blindage de la machine n'est pas correctement mis à la terre, cela peut également être plus sensible aux interférences ; vérifiez uniquement les points de mise à la terre et l'état de la prise fournis par le fabricant, ne démontez pas vous-même l'alimentation 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. Après la résolution du problème, exécutez QUERY_ENDSTOPS pour confirmer que l'état du fin de course peut passer normalement de open à TRIGGERED.

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

Timeout on wait for 'xxx' response​

Message d'erreur : Timeout on wait for 'neopixel_result' response, Timeout on wait for 'trsync_state' response, etc.

Causes courantes :

  • Liaison de communication CAN / USB instable, le MCU n'a pas répondu à la demande de l'ordinateur hôte en temps opportun.
  • Charge trop élevée du MCU (par exemple, impression à grande vitesse + mouvement multi-axe + requête d'accéléromètre simultanées).
  • Nombre excessif de LED Neopixel ou mauvaise qualité du câble de données, entraînant un délai d'attente de neopixel_result.
  • Incompatibilité entre la version du firmware MCU et l'ordinateur hôte.

Solution :

  1. Vérifiez que la connexion du câble de communication USB / CAN est sécurisée, éloignez-la des sources d'interférences telles que les câbles moteur et les câbles de chauffage.
  2. S'il s'agit d'un délai d'attente Neopixel, réduisez le nombre de LED ou remplacez par un câble de données de haute qualité, assurez-vous que la configuration data_pin est correcte.
  3. Assurez-vous que les versions du firmware de tous les MCU sont cohérentes, recompilez et flashez si nécessaire.
  4. Réduisez la vitesse d'impression et l'accélération, observez si le problème se reproduit.

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 des périphériques (carte mère, carte outil, EDDY, ADXL, etc.) ne correspond pas à Klipper sur l'ordinateur hôte.
  • Utilisation d'un système personnalisé ou d'un plugin tiers, entraînant une discordance entre les commandes prises en charge par l'hôte Klipper et le MCU.

Solution :

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

Erreur de communication I2C (START_READ_NACK / BUS_TIMEOUT)​

Message d'erreur : MCU 'xxx' I2C request to addr 42 reports error START_READ_NACK, I2C request to addr 104 reports error START_READ_NACK ou I2C ... BUS_TIMEOUT.

Causes courantes :

  • Adresse du périphérique I2C mal configurée, ou aucun périphérique avec l'adresse correspondante sur le bus.
  • Connexion I2C desserrée, cassée ou SDA/SCL inversée.
  • Résistance de tirage manquante, ou bus trop long entraînant une atténuation du signal.
  • Le capteur est lu avant d'être prêt (par exemple, requête immédiate lors de la mise sous tension).
  • Conflit d'adresses entre plusieurs périphériques I2C.

Solution :

Opération hors tension

Avant de vérifier le câblage I2C, le module capteur ou la résistance de tirage, éteignez complètement l'imprimante et débranchez l'alimentation.

  1. Après avoir coupé l'alimentation, vérifiez que le câblage I2C (SDA, SCL, VCC, GND) est sécurisé et qu'il n'est pas inversé.
  2. Assurez-vous que l'adresse I2C dans la configuration correspond au périphérique réel. Adresses courantes : ADXL345 est 0x53 (83) ou 0x1D (29), MPU6050 est 0x68 (104).
  3. Vérifiez s'il y a une résistance de tirage sur le bus I2C (généralement 4,7 kΩ) ; si le module a sa propre résistance de tirage, il n'est pas nécessaire d'en ajouter.
  4. Si le bus est long (plus de 30 cm), essayez de raccourcir le câblage ou de réduire le débit I2C.
  5. Si l'erreur ne se produit qu'une fois au démarrage, cela peut être dû à un délai d'initialisation du capteur, observez si le fonctionnement ultérieur est stable.
  6. Assurez-vous qu'il n'y a pas deux périphériques utilisant la même adresse sur le même bus I2C.

Erreur I2C de la sonde EDDY : Si vous utilisez une sonde à courants de Foucault EDDY et que BUS_TIMEOUT apparaît, veuillez consulter Problèmes EDDY.

FAQ spécialisées​

SpécialitéEntrée
Conflit de configuration, analyse des paramètres, SAVE_CONFIGErreurs de configuration
Commande inconnue, modèle de macro, G-code de début de trancheuseErreurs de configuration
Mouvement, origine, fin de course, palpeur, nivellement du lit en mailleErreurs de mouvement, de fin de course et de nivellement
Température, chauffage, extrusion, détection de rupture de filamentErreurs de température, de chauffage et d'extrusion
Performance, délai d'attente, firmware, service systèmeErreurs système, de performance et de service
G2/G3, adaptation d'arc, précision du chemin de la trancheuseConseils d'adaptation des arcs
Communication du pilote TMC, surchauffe, problème de bobineDépannage des erreurs TMC
Réseau CAN, UUID, bytes_invalidRéseau CAN et recherche d'ID
Test d'accéléromètre et de résonanceTest et calibrage de l'accéléromètre
Sonde à courants de Foucault EDDYProblèmes EDDY
Load Cell, sonde de pressionDépannage de la sonde Load Cell
Loading...