Aller au contenu principal

Aperçu des erreurs courantes

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

Index rapide​

Type d'erreurMots-clés courantsEntrée de dépannage
Problèmes de connexionUnable to connect、Timeout on connect、Wait for identify_response、Serial connection closed、Invalid CAN uuid、Lost communication、MCU Protocol error、/dev/serial/by-id、Unable to issue reset command、Got EOF when reading from deviceProblèmes de connexion sur cette page、Configuration de l'ID MCU、Réseau CAN et recherche d'ID
Problèmes 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 trancheurUnknown command、Error evaluating 'gcode_macro、jinja2.exceptions.UndefinedError、dict object has no attributeErreurs de configuration
Mouvement et homingMove out of range、Must home axis first、No trigger、Endstop still triggered、virtual_endstop、Unknown pin chip name、Homing failed due to printer shutdownErreurs de mouvement, de fin de course et de nivellement、Dépannage du homing sans fin de course
Analyse G-codeUnable to parse move、Invalid speed、Machine does not support G20、G2/G3Erreurs de mouvement, de fin de course et de nivellement、Recommandations pour l'ajustement des arcs
Nivellement par sondeProbe 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
Température et chauffageADC out of range、not heating at expected rate、Verify heater、temperature、Thermocouple reader faultErreurs de température, de chauffage et d'extrusion
Problèmes 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épassement 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 event、Can't reset time when stepper activeErreurs système, de performance et de service
Pilotes 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
Capteurs et périphériquesInvalid adxl345 id、No data、Insufficient axis、Eddy current sensor error、Invalid read data、load_cell_probe、START_READ_NACK、I2C、BUS_TIMEOUTTest et calibration de l'accéléromètre、Problèmes EDDY、Dépannage de la sonde Load Cell、Erreurs 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 de l'erreurRéférence recommandée
Syntaxe de configuration, indentation, commentaires, broches dupliquéesInstructions de modification de configuration
Direction de homing, direction des axes, mouvement forcéGuide de calibration du homing et des directions
Fins de course, TAP, fins de course optiques, capteurs de proximitéFins de course
Homing sans fin de course, sensibilité des fins de course virtuellesUtilisation sans fins de course
Chauffage, PID, montée en température lente, protection thermiqueChauffage、Optimisation de verify_heater、Optimisation de M109
Configuration des ventilateurs, ventilateurs pilotés, ventilateurs 7040Configuration de référence des ventilateurs
Paramètres de l'extrudeuse, distance de rotation, configuration de l'extrusionConfiguration de référence de l'extrudeuse、Calibration de la machine
Macros de début/fin, pause/reprise, nivellement et macros de maillageIntroduction aux macros
Commandes de débogage courantes, sonde, 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 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 configurationExemple
Firmware USBserial:serial: /dev/serial/by-id/usb-Klipper_xxxxxxxxxxxx
Firmware CANcanbus_uuid:canbus_uuid: xxxxxxxxxxxx
Périphérique RS232serial:serial: /dev/serial/by-path/xxxxxxxxxxxx
MCU de l'hôteserial: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

mcu 'xxx' : Impossible de se connecter​

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 incorrect.
  • L'UUID CAN n'est pas renseigné, est incorrect ou le périphérique est hors ligne.
  • UTOC, câble USB, firmware de pont CAN ou alimentation défectueux.
  • CAN0 n'est pas démarré ou la configuration du réseau CAN est anormale.

Méthode de résolution :

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

  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 Timeout on connect, Wait for identify_response ou Serial connection closed apparaissent, suivez la section Délai d'attente de la poignée de main de connexion MCU pour continuer le dépannage ; cela peut se produire aussi bien avec une connexion USB qu'avec une connexion par pont série.

    Loading...

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

    Loading...

  5. Si [Errno 100] Network is down ou [Errno 105] No buffer space available apparaissent, vérifiez à nouveau la configuration CAN0 en suivant la section Réseau CAN et recherche d'ID.

mcu 'xxx' : UUID CAN invalide​

Message d'erreur : L'UUID CAN est invalide ou ne peut pas être reconnu.

Loading...

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

Méthode de résolution :

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

L'option 'serial' dans la section 'mcu' doit être spécifiée​

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

Loading...

Cause de l'erreur : serial: n'est pas renseigné pour une connexion avec un 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 la section de configuration [mcu] dans 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: 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/* ne produit aucun résultat 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 sur le système.

Causes courantes :

  • La carte mère n'exécute pas le firmware Klipper et se trouve encore dans un mode de flashage tel que Katapult / CanBoot / DFU.
  • Câble USB, port USB, alimentation de l'hôte ou alimentation de la carte mère défectueux.
  • Certaines versions de udev sous Debian 11 Bullseye peuvent présenter des problèmes et ne pas générer les chemins de périphériques /dev/serial/by-id/.
  • Les distributions Linux de bureau peuvent avoir installé ModemManager ou BRLtty, qui peuvent accaparer les ports série et empêcher Klipper de se connecter de manière stable à la carte mère.

Méthode de diagnostic :

Opération nécessitant une mise 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 les faisceaux USB / CAN, éteignez complètement l'imprimante et débranchez l'alimentation. Ne réorganisez pas les fils ou ne touchez pas aux borniers lorsque l'appareil est 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 dans printer.cfg les ID de mode katapult, canboot, Bootloader ou DFU.
  2. Après avoir coupé l'alimentation, remplacez le câble de données USB par un câble fiable et changez de port USB sur l'hôte, puis exécutez à nouveau ls /dev/serial/by-id/* après la remise sous tension.
  3. Si vous utilisez Debian 11 Bullseye, d'anciennes versions de MainsailOS / FluiddPi / Armbian, exécutez la commande suivante pour vérifier la version de udev :
apt-cache policy udev
  1. Si le problème est confirmé comme étant lié à udev sous Debian 11, privilégiez une mise à niveau de udev via les sources de mise à jour normales du système, ou remplacez l'image système par une version plus récente.
  2. Vérifiez si des services susceptibles d'accaparer le port série sont présents :
systemctl list-units --all | grep -Ei 'ModemManager|brltty'
  1. Si ces services sont installés et que l'hôte n'a pas besoin des fonctions de modem ou de terminal braille, remplacez le nom d'unité complet affiché par la commande précédente dans les commandes ci-dessous, puis arrêtez, désactivez et 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, recherchez à nouveau l'ID USB et vérifiez que serial: dans [mcu] de printer.cfg correspond bien à la sortie réelle.

Configuration associée : Configuration de l'ID MCU.

Serial connection closed / Timeout on connect / Wait for identify_response​

Message d'erreur : Au démarrage de Klipper ou lors de l'exécution de FIRMWARE_RESTART, les messages suivants apparaissent dans le journal de manière séquentielle ou répétée :

mcu 'xxx': Timeout on connect
mcu 'xxx': Wait for identify_response
serialhdl.error: mcu 'xxx': Serial connection closed

Nature de l'erreur : Ce groupe d'erreurs indique que l'hôte a tenté d'établir une connexion avec le MCU, mais que le MCU n'a pas renvoyé les informations d'identification du firmware dans le délai imparti. Il décrit un échec de la poignée de main de connexion, sans indiquer directement si la cause provient des paramètres du firmware, du chemin du périphérique, du câblage ou du matériel lui-même.

Causes courantes :

  • Interface de communication, broches, horloge, adresse de démarrage ou décalage du Bootloader du firmware MCU mal sélectionnés.
  • Le firmware n'a pas été flashé correctement, ou la carte mère est restée dans un mode de flashage tel que DFU, Bootloader, Katapult / CanBoot.
  • serial: utilise un chemin de périphérique erroné, obsolète ou incomplet.
  • Câble de données USB, port USB, puce de pont série ou alimentation de la carte mère défectueux.
  • Lors de l'utilisation d'une carte d'outillage CAN, le dispositif de pont, le réseau CAN ou la configuration canbus_uuid: est anormale.

Méthode de résolution :

  1. Consultez l'intégralité du fichier klippy.log pour déterminer si ce groupe d'erreurs se produit lors de la phase de connexion initiale au démarrage ou lors d'une reconnexion après une déconnexion du MCU pendant l'impression.
  2. Exécutez les commandes suivantes pour confirmer que le système identifie correctement le MCU de manière stable, et comparez la sortie avec serial: dans [mcu] :
ls -l /dev/serial/by-id/
dmesg --ctime | tail -n 80
  1. Si l'ID USB existe et est stable, mais que Wait for identify_response persiste, vérifiez à nouveau les paramètres de compilation du firmware et la méthode de flashage conformément à la documentation du produit FLY correspondant, en accordant une attention particulière à l'interface de communication, au décalage du Bootloader et à la configuration de l'horloge ; n'écrivez pas l'ID du périphérique en mode flashage dans printer.cfg.
  2. Si l'ID USB n'existe pas ou se déconnecte de manière répétée dans dmesg, consultez la section ID USB introuvable / Interférence des services système de cette page pour vérifier le système et la connexion.
Opération nécessitant une mise hors tension

Avant de rebrancher ou de remplacer les faisceaux USB / CAN ou de vérifier le connecteur d'alimentation de la carte mère, éteignez complètement l'imprimante et débranchez l'alimentation. Ne réorganisez pas les fils ou ne touchez pas aux borniers lorsque l'appareil est sous tension.

  1. Après une coupure de courant, remplacez par un câble de données fiable et vérifiez l'interface de l'ordinateur hôte, puis remettez sous tension pour tester ; ne démontez pas l'alimentation ni ne modifiez le câblage secteur.
  2. Pour les appareils CAN, veuillez continuer à vous référer au dépannage des erreurs CAN et revérifier l'appareil de pontage, l'état CAN et l'UUID.
  3. Si la première connexion est normale et que Serial connection closed apparaît uniquement pendant l'impression, privilégiez le dépannage de la déconnexion en cours d'exécution selon Lost communication with MCU ; ne repeignez pas le firmware à plusieurs reprises pour masquer le problème.

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 homing ou le déplacement, dès que la butée se déclenche, la carte mère ou la carte outil se déconnecte ; après une remise sous tension, la connexion redevient possible.

Causes courantes :

  • Câblage incorrect de la butée, provoquant un court-circuit anormal entre la broche de signal et l'alimentation ou la masse lors du déclenchement.
  • Pour les butées à trois fils, les butées optiques ou les butées à effet Hall, un ordre incorrect de connexion des fils d'alimentation, de masse et de signal.
  • Le faisceau de câbles de la butée est abîmé, pincé ou provoque un court-circuit lors des mouvements dans la chaîne porte-câbles.
  • Le déclenchement de la butée provoque une fluctuation de l'alimentation de la carte mère, un redémarrage du MCU ou une interruption de la communication USB / CAN.
  • Les câbles de communication USB / CAN entre le MCU et l'ordinateur hôte passent près d'une source d'interférences puissante, rendant la déconnexion plus probable lors du déclenchement de la butée ou des mouvements.
  • La broche de butée configurée ne correspond pas au câblage réel, déclenchant une interface incorrecte.

Méthode de dépannage :

Opération hors tension

Avant de débrancher ou de brancher les câbles de butée, de vérifier l'ordre des fils, d'inspecter 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 coupez l'alimentation électrique. Le mode résistance / continuité du multimètre ne doit être utilisé qu'hors tension ; il est interdit de mesurer la résistance ou d'effectuer des tests de court-circuit sous tension.

  1. Après une coupure de courant, vérifiez l'ordre des fils de la butée, en particulier si VCC, GND et Signal des butées à trois fils sont correctement câblés.
  2. Après une coupure de courant, débranchez temporairement le câble de la butée concernée, puis remettez tout en place et testez à nouveau si la carte mère se déconnecte.
  3. Après une coupure de courant, utilisez le mode continuité / résistance du multimètre pour vérifier la présence d'un court-circuit avant et après le déclenchement de la butée, en particulier si la broche de signal est connectée à l'alimentation.
  4. Inspectez la chaîne porte-câbles, les connecteurs et les zones de pliage du faisceau pour vous assurer qu'aucun court-circuit ne se produit lors du déclenchement ou des mouvements.
  5. Vérifiez les câbles de communication USB / CAN entre le MCU et l'ordinateur hôte, en les tenant éloignés 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 de la machine, l'alimentation ou le blindage n'est pas correctement mis à la terre, des interférences peuvent être plus probables ; vérifiez uniquement le point de mise à la terre fourni par le fabricant et l'état de la prise, sans démonter l'alimentation ni modifier la terre secteur.
  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 passe correctement de open à TRIGGERED.

Référence de configuration associée : Butées, Instructions de câblage de l'alimentation.

Unable to issue reset command on MCU​

Message d'erreur : Unable to issue reset command on MCU 'xxx', généralement accompagné dans le journal de webhooks client ...: Disconnected et Restarting printer.

Nature de l'erreur : Cette erreur n'est généralement pas la première erreur, mais un message secondaire après que le MCU s'est déconnecté, a perdu l'alimentation ou a subi une interruption de communication, lorsque Klipper tente d'envoyer une commande de réinitialisation au MCU sans succès. Lors du dépannage, remontez dans le journal pour trouver la première erreur réelle (comme Lost communication with MCU, Timer too close, Verify heater, erreurs TMC, etc.).

Causes courantes :

  • Déconnexion préalable du MCU, interruption de la communication USB / CAN ou crash du firmware, empêchant l'envoi de la commande de réinitialisation.
  • Alimentation insuffisante de la carte mère, de la carte outil ou des MCU externes, entraînant une coupure de courant pendant la réinitialisation.
  • Mauvais contact du câble USB ou CAN, ou câble endommagé.
  • Le MCU exécute des tâches à forte charge (comme le chauffage ou le nivellement multipoint) lorsqu'il est forcé à réinitialiser.
  • Fortes interférences sur le signal entre l'ordinateur hôte et le MCU (câbles moteur ou de chauffage proches des câbles de communication).

Méthode de résolution :

Opération hors tension

Avant de rebrancher ou de débrancher les câbles USB / CAN, de vérifier les câbles ou de réorganiser le câblage, éteignez complètement l'imprimante et coupez l'alimentation électrique. Ne branchez ni ne débranchez pas les faisceaux ou ne touchez pas aux bornes sous tension.

  1. Ouvrez klippy.log, trouvez la première erreur réelle avant Unable to issue reset command et traitez-la selon la catégorie correspondante.
  2. Après une coupure de courant, rebranchez les câbles USB / CAN, remplacez par un câble fiable et vérifiez que la connexion est ferme.
  3. Vérifiez la stabilité de l'alimentation de la carte mère et de la carte outil, en évitant de partager un circuit d'alimentation instable avec les moteurs ou les appareils à forte puissance comme le lit chauffant.
  4. Confirmez que les câbles de communication USB / CAN évitent les câbles moteur, les câbles de chauffage et les câbles du lit chauffant.
  5. Exécutez FIRMWARE_RESTART ; si nécessaire, coupez complètement l'alimentation pendant 10 secondes puis remettez sous tension.
  6. Si le problème persiste, continuez à vous référer à Lost communication with MCU et au dépannage des erreurs CAN.

Got EOF when reading from device​

Message d'erreur : Got EOF when reading from device, généralement présent dans le journal après Attempting MCU 'xxx' reset command, indiquant que lorsque l'ordinateur hôte initie une réinitialisation du MCU, la connexion série / USB est déjà coupée.

Nature de l'erreur : Il s'agit d'une erreur renvoyée par le système d'exploitation de l'ordinateur hôte (Linux) ; Klipper ne fait que transmettre l'indicateur de fin de fichier (EOF) lu par pyserial. Elle indique que le lien USB / série est physiquement déconnecté ou que le périphérique a disparu, et non un problème de paramètres de configuration.

Causes courantes :

  • Câble USB de mauvaise qualité, mauvais contact ou alimentation insuffisante du port USB, entraînant une déconnexion du périphérique pendant la réinitialisation.
  • Fluctuation de l'alimentation de la carte mère ou de la carte outil, le MCU se réinitialise ou s'éteint, faisant disparaître le périphérique du système.
  • Anomalie du contrôleur USB de l'ordinateur hôte, panne du port USB ou politique de mise en veille USB du système.
  • Pour une carte outil CAN connectée via un pont USB, déconnexion du périphérique de pontage (le journal peut alors contenir également Unable to issue reset command on MCU).

Méthode de résolution :

Opération hors tension

Avant de rebrancher ou de débrancher les câbles USB / CAN, de vérifier les câbles d'alimentation ou de remplacer les câbles, éteignez complètement l'imprimante et coupez l'alimentation électrique.

  1. Identifiez d'abord quel MCU signale l'erreur, puis vérifiez la chaîne de connexion USB / CAN correspondante.
  2. Après une coupure de courant, rebranchez le câble USB, remplacez-le par un câble USB de haute qualité et testez avec un autre port USB de l'ordinateur hôte.
  3. Exécutez ls /dev/serial/by-id/* pour vérifier si le périphérique est toujours présent dans le système ; s'il a disparu, cela indique un problème d'alimentation, de câble ou de réinitialisation du MCU.
  4. Vérifiez la stabilité de l'alimentation de la carte mère et de la carte outil, et confirmez que la chute de tension des câbles d'alimentation est normale (ne démontez pas vous-même l'alimentation ni ne modifiez le câblage secteur).
  5. Si Unable to issue reset command on MCU apparaît également dans le journal, traitez-le conjointement avec Unable to issue reset command.
  6. Si le problème est lié à la carte outil CAN, vérifiez l'état du bus selon le dépannage des erreurs CAN.
  7. Si le problème se reproduit fréquemment, continuez à vous référer à Lost communication with MCU.

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 :

  • Chaîne de communication CAN / USB instable, le MCU ne répond pas à temps aux requêtes de l'ordinateur hôte.
  • Charge trop élevée du MCU (par exemple impression à grande vitesse + mouvements multi-axes + requêtes de l'accéléromètre simultanées).
  • Nombre trop élevé de LEDs Neopixel ou câble de données de mauvaise qualité, provoquant un délai d'attente dépassé pour neopixel_result.
  • Version du firmware MCU incompatible avec l'ordinateur hôte.

Méthode de résolution :

  1. Vérifiez que les connexions des câbles de communication USB / CAN sont fermes, en les tenant éloignées des moteurs, des câbles de chauffage et autres sources d'interférences.
  2. En cas de délai d'attente Neopixel, réduisez le nombre de LEDs ou remplacez par un câble de données de haute qualité, et vérifiez la configuration de data_pin.
  3. Assurez-vous que toutes les versions du firmware MCU sont cohérentes, et recompilez / reflashez si nécessaire.
  4. Réduisez la vitesse d'impression et l'accélération pour observer 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 :

  • Mise à jour de Klipper sur l'ordinateur hôte sans recompiler ni reflasher le firmware de la carte mère ou de la carte outil.
  • Version du firmware des MCU externes (carte mère, carte outil, EDDY, ADXL, etc.) incompatible avec Klipper de l'ordinateur hôte.
  • Utilisation d'un système personnalisé ou de plugins tiers, entraînant une divergence entre les commandes prises en charge par l'hôte Klipper et celles du MCU.

Méthode de résolution :

  1. Vérifiez si une mise à jour récente de Klipper, de l'image système ou des plugins a été effectuée.
  2. Recompilez et reflashez le firmware Klipper de tous les MCU.
  3. Pour les MCU externes comme la carte outil, EDDY, ADXL, etc., mettez également à jour le firmware du périphérique correspondant.
  4. Si un système personnalisé est utilisé, confirmez 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.

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 correspondant sur le bus.
  • Connexion I2C desserrée, cassée ou inversion de SDA/SCL.
  • Absence de résistances de tirage, ou signal dégradé en raison d'un bus trop long.
  • Capteur interrogé avant d'être prêt (par exemple, requête immédiate après la mise sous tension).
  • Conflit d'adresses entre plusieurs périphériques I2C.

Solutions :

Opération hors tension

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

  1. Après la mise hors tension, vérifiez que le câblage I2C (SDA, SCL, VCC, GND) est bien fixe et qu'il n'y a pas d'inversion.
  2. Confirmez 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 la présence de résistances de tirage sur le bus I2C (généralement 4,7 kΩ) ; si le module intègre déjà des résistances de tirage, aucune addition n'est nécessaire.
  4. Si le bus est long (plus de 30 cm), essayez de raccourcir les câbles ou de réduire la vitesse I2C.
  5. Si l'erreur n'apparaît qu'une seule fois au démarrage, il peut s'agir d'un délai d'initialisation du capteur — observez si le fonctionnement devient stable par la suite.
  6. Assurez-vous qu'aucun autre périphérique sur le même bus I2C n'utilise la même adresse.

Erreur I2C de la sonde EDDY : si vous rencontrez un BUS_TIMEOUT avec la sonde EDDY à courants de Foucault, consultez Recueil de problèmes EDDY.

FAQ spécialisée​

SpécialitéEntrée
Conflits de configuration, analyse des paramètres, SAVE_CONFIGErreurs de configuration
Commandes inconnues, modèles de macros, G-code de départ du slicerErreurs de configuration
Mouvement, homing, fins de course, sonde, nivellement du litErreurs de mouvement, fins de course et nivellement
Homing sans fin de course, virtual_endstop, sensibilité DIAGDépannage du homing sans fin de course, Utilisation sans fin de course
Température, chauffage, extrusion, détection de rupture de filamentErreurs de température, chauffage et extrusion
Performances, dépassement de délai, firmware, services systèmeErreurs système, performances et services
G2/G3, interpolation d'arcs, précision des trajectoires du slicerRecommandations pour l'ajustement des arcs
Communication TMC, surchauffe, problèmes de bobineDépannage des erreurs TMC
Réseau CAN, UUID, bytes_invalidRéseau CAN et recherche d'ID
Accéléromètre et test de résonanceTest et calibration de l'accéléromètre
Sonde EDDY à courants de FoucaultRecueil de problèmes EDDY
Load Cell, sonde à détection de pressionDépannage des sondes Load Cell
Loading...