Aller au contenu principal

Erreurs de déplacement, de fin de course et de mise à niveau

Cette page répertorie les erreurs liées à la plage de déplacement, l'homing, les fins de course, la sonde, le maillage du lit et la mise à niveau multi-Z. Pour les opérations impliquant le câblage, les connecteurs ou les réglages mécaniques manuels, veuillez d'abord couper l'alimentation avant d'intervenir.

Move out of range​

Message d'erreur : Les coordonnées cibles dépassent la plage de mouvement autorisée par Klipper. Le journal affiche généralement un message similaire à Move out of range: X Y Z [E].

Loading...

Causes courantes :

  • Les dimensions de la machine dans le slicer ne correspondent pas à position_min / position_max dans la configuration Klipper.
  • Le G-code de démarrage, le G-code de fin, la macro de changement de filament ou la macro de pause déplacent la machine en dehors de sa plage.
  • Après avoir utilisé une correction d'inclinaison, un décalage de sonde ou une configuration de 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.

Solutions :

  1. Identifiez quel axe est hors de la plage en fonction des coordonnées dans le message d'erreur.
  2. Vérifiez position_min, position_max pour l'axe concerné et les dimensions de la machine dans le slicer.
  3. Examinez les coordonnées de stationnement dans les macros de démarrage, de fin, de pause et de changement de filament ; évitez de vous arrêter à 0,0 ou aux limites maximales.
  4. Si l'erreur se produit lors du balayage du lit, vérifiez mesh_min, mesh_max dans [bed_mesh] et le décalage de la sonde.
  5. Sauvegardez la configuration, redémarrez Klipper, puis testez à nouveau.

Références de configuration associées : Présentation des macros, Guide d'homing et de calage de la direction.

Unable to parse move / Invalid speed​

Message d'erreur : Unable to parse move 'G1 Z', Unable to parse move 'G1 X... Y... Z...', Invalid speed in 'G1 ...', Machine does not support G20 (inches) command, Unknown g-code state: xxx.

Causes courantes :

  • La ligne G-code est incomplète, par exemple G1 Z sans valeur de coordonnée spécifique.
  • Une variable de macro est vide, ce qui entraîne une commande de mouvement sans valeur X, Y, Z, E ou F.
  • Erreurs de saut de ligne, d'accolades, de noms de variables ou de format d'échappement dans le G-code de démarrage/fin du slicer.
  • Le paramètre de vitesse F est vide, nul ou non numérique.
  • Le fichier G-code utilise le mode pouces G20, que Klipper ne prend pas en charge.
  • Les noms utilisés dans les macros SAVE_GCODE_STATE / RESTORE_GCODE_STATE sont incohérents.

Solutions :

  1. Localisez la ligne d'erreur complète dans klippy.log pour identifier la commande G1, G0 ou d'état défectueuse.
  2. Vérifiez les macros de démarrage, de fin, de pause, de reprise et de changement de filament dans le slicer pour vous assurer que toutes les commandes de mouvement ont des valeurs complètes.
  3. Définissez des valeurs par défaut pour les paramètres de macro et convertissez-les en nombres avant utilisation, par exemple params.Z|default(10)|float.
  4. Assurez-vous que l'unité du slicer est le millimètre et n'émettez pas de G20.
  5. Si l'erreur est Unknown g-code state, vérifiez que SAVE_GCODE_STATE NAME= et RESTORE_GCODE_STATE NAME= utilisent le même nom.

Références de configuration associées : Présentation des macros.

Must home axis first​

Message d'erreur : L'axe n'a pas été ramené à l'origine, la commande de mouvement actuelle ne peut pas être exécutée.

Causes courantes :

  • G28 n'a pas été exécuté après la mise sous tension ou FIRMWARE_RESTART.
  • Une macro exécute une commande de mouvement avant la commande d'homing.
  • 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 d'homing, de la macro de sonde ou de l'homing sans fin de course empêche Klipper d'enregistrer correctement l'état d'homing.

Solutions :

  1. Exécutez manuellement G28 avant de déplacer l'axe concerné.
  2. Vérifiez le G-code de démarrage et les macros pour vous assurer que l'homing est terminé avant les commandes de mouvement.
  3. Si Klipper ou le firmware vient d'être mis à jour, vérifiez que les macros d'homing sont toujours compatibles avec la version actuelle.
  4. Si vous utilisez l'homing sans fin de course, vérifiez le courant moteur, la sensibilité et homing_retract_dist.

Références de configuration associées : Guide d'homing et de calage de la direction, Utilisation sans fin de course.

Endstop still triggered after retract​

Message d'erreur : Après avoir déclenché la fin de course pendant l'homing et effectué la distance de retrait, la fin de course reste déclenchée.

Causes courantes :

  • La logique normalement ouvert/fermé de l'interrupteur de fin de course est configurée à l'envers.
  • L'interrupteur de fin de course est bloqué, endommagé ou son câblage est incorrect.
  • homing_retract_dist est trop petit, la fin de course est toujours enfoncée après le retrait.
  • La sensibilité de l'homing sans fin de course est trop élevée, le déclenchement est toujours détecté après le retrait.
  • La configuration de enable_pin du pilote, la direction du moteur ou la broche de fin de course est incorrecte, ce qui entraîne un comportement anormal de l'homing.

Solutions :

Couper l'alimentation

Avant de vérifier le connecteur de la fin de course, le câblage du moteur ou de rebrancher les faisceaux, éteignez complètement l'imprimante et débranchez l'alimentation électrique. Pendant les tests sous tension, utilisez uniquement les commandes de la page Web et actionnez mécaniquement les fins de course ; ne touchez pas les bornes.

  1. Exécutez QUERY_ENDSTOPS et confirmez que l'état est open lorsqu'il n'est pas déclenché et TRIGGERED lorsqu'il est actionné manuellement.
  2. Si l'état est inversé, ajustez le ! devant la broche de la fin de course.
  3. Coupez l'alimentation, puis vérifiez l'état mécanique de l'interrupteur de fin de course, le câblage et le connecteur.
  4. Augmentez légèrement homing_retract_dist et testez à nouveau.
  5. Si vous utilisez l'homing sans fin de course, réduisez la sensibilité et assurez-vous que le courant d'homing est approprié.

Références de configuration associées : Fins de course, Utilisation sans fin de course.

No trigger on endstop after full movement​

Message d'erreur : No trigger on x after full movement, No trigger on y after full movement ou un message similaire indiquant que la fin de course ne s'est pas déclenchée.

Causes courantes :

  • La direction d'homing est mal configurée, le moteur se déplace loin de la fin de course.
  • L'interrupteur de fin de course n'est pas connecté, le connecteur est desserré ou la broche est mal configurée.
  • position_endstop, position_min, position_max ne correspondent pas à la course mécanique réelle, la distance d'homing est insuffisante.
  • La sensibilité de l'homing sans fin de course est trop faible, le choc contre la butée mécanique n'est pas détecté comme un déclenchement.
  • Le câblage ou la configuration de la direction du moteur est incorrect, ce qui fait que l'axe se déplace dans la direction opposée à celle prévue.

Solutions :

  1. Exécutez QUERY_ENDSTOPS et appuyez manuellement sur la fin de course pour confirmer que l'état passe de open à TRIGGERED.
  2. Déplacez l'axe sur une petite distance pour confirmer sa direction, puis vérifiez si le ! devant dir_pin doit être ajusté.
  3. Assurez-vous que homing_positive_dir correspond à la direction où se trouve la fin de course.
  4. Vérifiez que position_endstop, position_min, position_max correspondent à la course mécanique réelle.
  5. Dans le scénario d'homing sans fin de course, réduisez la vitesse d'homing et ajustez la sensibilité TMC.

Références de configuration associées : Guide d'homing et de calage de la direction, Fins de course.

Dépannage de l'homing sans fin de course (Sensorless Homing)​

L'homing sans fin de course utilise le signal DIAG du pilote TMC pour détecter le blocage du moteur, remplaçant ainsi les interrupteurs de fin de course physiques. Une configuration ou une sensibilité inappropriée peut entraîner les erreurs suivantes. Pour une vérification complète de la compatibilité, des configurations de référence et des méthodes de réglage de la sensibilité, voir Utilisation sans fin de course.

Déclenchement non détecté : No trigger on x after full movement​

Message d'erreur : Lors de l'homing avec virtual_endstop, le message No trigger on x after full movement ou No trigger on y after full movement apparaît, et le chariot ne s'arrête pas lorsqu'il atteint la butée.

Causes courantes :

  • Seuil de sensibilité inapproprié : driver_SGTHRS trop bas (pas assez sensible) pour TMC2209, ou driver_SGT trop élevé pour TMC5160 / TMC2240 / TMC2130.
  • Le cavalier DIAG n'est pas installé sur les cartes mères de classe B, ou un autre périphérique est toujours connecté au port de fin de course correspondant.
  • Il manque le symbole de tirage vers le haut ^ sur diag_pin, le signal à drain ouvert ne peut pas être déclenché de manière stable.
  • Vitesse d'homing trop faible, courant moteur trop faible, la variation de courant de blocage est insuffisante pour déclencher le signal DIAG.
Couper l'alimentation

Avant de vérifier les cavaliers, le câblage des ports de fin de course ou de brancher/débrancher les faisceaux, éteignez d'abord l'imprimante et débranchez l'alimentation. Ne touchez pas les bornes et ne branchez/débranchez pas les faisceaux sous tension.

Solutions :

  1. Suivez la méthode Utilisation sans fin de course · Test de sensibilité pour ajuster progressivement SGTHRS / sgt en commençant par la sensibilité la plus élevée.
  2. Assurez-vous que diag_pin a un tirage vers le haut ^ (ex: diag_pin: ^PD9) ; pour les pilotes à double broche DIAG comme TMC5160, confirmez si diag0_pin ou diag1_pin est utilisé.
  3. Sur les cartes mères de classe B, confirmez que le cavalier DIAG est installé et qu'aucun autre périphérique n'est connecté au port de fin de course correspondant.
  4. Augmentez légèrement le courant et la vitesse d'homing, puis testez à nouveau.

Erreur de configuration : Nom de puce de broche inconnu​

Message d'erreur : Au démarrage, Nom de puce de broche inconnu 'tmc5160 stepper_x', Nom de puce de broche inconnu '^awd', etc. Klipper ne peut pas passer en état ready.

Causes courantes :

  • Espace malencontreux entre le nom du pilote et le nom de l'axe dans endstop_pin, par exemple écrit tmc5160 stepper_x:virtual_endstop ; la syntaxe correcte doit utiliser un trait de soulignement tmc5160_stepper_x:virtual_endstop.
  • Faute d'orthographe dans le nom de broche diag_pin / diag0_pin / diag1_pin ou caractères illégaux inclus.

Solutions :

  1. Vérifiez endstop_pin de [stepper_x], confirmez le format tmcXXXX_stepper_x:virtual_endstop, le nom du pilote et de l'axe sont séparés par un trait de soulignement et non un espace.
  2. Le nom de section de configuration du pilote [tmcXXXX stepper_x] utilise un espace en interne, mais endstop_pin doit utiliser un trait de soulignement lors de la référence ; les deux noms doivent correspondre.
  3. Vérifiez l'orthographe du nom de broche diag_pin, seuls les préfixes ^ et ! suivis d'un nom de broche valide sont autorisés.

Erreur de configuration : Impossible de trouver une section de configuration du pilote TMC​

Message d'erreur : Impossible de trouver une section de configuration du pilote TMC pour 'stepper_x' requis par l'auto-réglage TMC.

Causes courantes :

  • endstop_pin référence tmcXXXX_stepper_x:virtual_endstop, mais il n'y a pas de section de pilote [tmcXXXX stepper_x] correspondante dans la configuration, ou le nom de la section de pilote ne correspond pas.
  • La section de pilote est commentée, a une faute d'orthographe ou le nom de l'axe ne correspond pas.

Solutions :

  1. Assurez-vous qu'il existe une section de configuration de pilote qui correspond exactement à la référence endstop_pin, par exemple endstop_pin: tmc2209_stepper_x:virtual_endstop doit avoir [tmc2209 stepper_x].
  2. Vérifiez si la section de pilote est commentée ou si le nom de l'axe est mal écrit (ne confondez pas stepper_x et stepper_y).

Arrêt d'urgence lors du retour à l'origine : Échec du retour à l'origine en raison d'un arrêt de l'imprimante​

Message d'erreur : Pendant le retour à l'origine, l'imprimante passe en shutdown, indiquant Échec du retour à l'origine en raison d'un arrêt de l'imprimante.

Causes courantes :

  • Ce n'est pas une panne exclusive à l'absence de fin de course, mais un autre arrêt (comme un déclenchement intempestif du signal DIAG, une erreur de pilote, un redémarrage du service) provoquant l'arrêt d'urgence pendant le retour à l'origine.
  • La cause réelle doit être trouvée dans klippy.log : la première erreur d'arrêt avant Échec du retour à l'origine.

Solutions :

  1. Ouvrez klippy.log, recherchez la première erreur shutdown au-dessus de Échec du retour à l'origine en raison d'un arrêt de l'imprimante, et diagnostiquez selon la catégorie correspondante.
  2. Si le message ci-dessus est Impossible de réinitialiser l'heure lorsque le moteur pas à pas est actif, suivez Erreurs système, de performance et de service.
  3. S'il s'agit d'un déclenchement intempestif dû aux fluctuations du signal DIAG, vérifiez la résistance de tirage de diag_pin et le cavalier, et réduisez la sensibilité de manière appropriée.

Documents connexes : Utilisation sans fin de course, Aucun déclenchement sur fin de course après un mouvement complet, Résolution des erreurs TMC

Problèmes de palpeur et de mise à niveau​

Opération hors tension

Avant de vérifier le câblage, les connecteurs ou l'ordre des fils du BLTouch, Probe, TAP, Klicky, EDDY ou autre palpeur, éteignez complètement l'imprimante et débranchez l'alimentation. Sous tension, exécutez uniquement des commandes de requête ou observez l'état, ne branchez et ne débranchez pas les faisceaux.

Probe triggered prior to movement​

Message d'erreur : Le palpeur est déjà en état déclenché avant le début du homing ou du mouvement de palpage.

Causes de l'erreur :

  • Le palpeur est en état TRIGGERED par défaut après la mise sous tension ou la réinitialisation.
  • L'ordre des fils du palpeur est incorrect ou le contact est mauvais, ce qui maintient le signal en état déclenché.
  • Défaillance mécanique du palpeur, par exemple une tige BLTouch coincée qui ne peut pas se rétracter.
  • L'axe Z est déjà en position minimale, ce qui comprime le palpeur.

Solutions :

  1. Exécutez QUERY_PROBE pour confirmer que l'état doit être open lorsque le plateau n'est pas touché.
  2. Exécutez QUERY_ENDSTOPS pour confirmer que les signaux de fin de course/palpeur sont corrects.
  3. Pour BLTouch : BLTOUCH_DEBUG COMMAND=pin_up pour s'assurer que la tige est rétractée, puis QUERY_PROBE pour confirmer.
  4. Vérifiez la position actuelle de l'axe Z, et remontez l'axe Z si nécessaire.
  5. Après mise hors tension, vérifiez le câblage du palpeur et la configuration de sensor_pin.

Références de configuration : Fin de course, Commandes de débogage courantes.

No trigger on probe after full movement​

Message d'erreur : Le palpeur ne s'est pas déclenché pendant toute la course de descente.

Causes courantes :

  • Câblage, alimentation ou configuration de broche du palpeur incorrects.
  • Hauteur d'installation du palpeur inadaptée, ne permettant pas le déclenchement pendant la course de descente.
  • Direction de l'axe Z, décalage du palpeur ou configuration de la zone de mise à niveau incorrects.
  • Défaillance du palpeur lui-même, ou mauvais contact du faisceau pendant le mouvement.

Solutions :

  1. Exécutez QUERY_PROBE, déclenchez manuellement le palpeur et confirmez que l'état change correctement.
  2. Après mise hors tension, vérifiez l'alimentation du palpeur, le fil de signal et la broche configurée.
  3. Vérifiez la hauteur d'installation du palpeur et confirmez qu'il se trouve dans la plage de déclenchement avant la descente.
  4. Vérifiez si les points de palpage dans [probe], [bed_mesh], [z_tilt] ou [quad_gantry_level] dépassent le plateau.
  5. Si le problème n'apparaît qu'à certains endroits, examinez en priorité le tirage du faisceau et le décalage du palpeur.

Références de configuration : Fin de course, Introduction aux macros.

Probe samples exceed samples_tolerance​

Message d'erreur : Probe samples exceed samples_tolerance, ou apparition répétée de Probe samples exceed tolerance. Retrying... dans les journaux.

Causes courantes :

  • Mauvaise répétabilité du palpeur, l'écart de hauteur Z entre plusieurs échantillons dépasse samples_tolerance.
  • Plateau, portique, tête d'impression ou palpeur mal fixés, entraînant des vibrations lors du palpage.
  • Vitesse du palpeur trop élevée, ou distance de descente/ressort inadaptée.
  • Capteurs inductifs, à courants de Foucault ou de pression affectés par la dérive thermique ou les interférences électromagnétiques.

Solutions :

  1. Vérifiez que le palpeur, la hotend, le plateau et la structure du portique sont solidement fixés.
  2. Réduisez speed dans [probe] et augmentez appropriately sample_retract_dist.
  3. Élargissez temporairement samples_tolerance pour tester, par exemple de 0.01 à 0.03 ou 0.05.
  4. Si vous utilisez un palpeur inductif/à courants de Foucault, attendez que les températures du plateau et de la buse se stabilisent avant de mettre à niveau.
  5. Si le problème n'apparaît que dans une certaine zone, vérifiez la surface du plateau, les aimants, le tirage du faisceau et le décalage du palpeur dans cette zone.

Références de configuration : Calibration de la machine, Introduction aux macros.

Must home before probe​

Message d'erreur : Must home before probe.

Causes courantes :

  • PROBE, BED_MESH_CALIBRATE, Z_TILT_ADJUST ou QUAD_GANTRY_LEVEL a été exécuté sans avoir préalablement lancé G28.
  • La macro appelle une commande de mise à niveau sans garantir que XY/Z ont été homés.
  • Après FIRMWARE_RESTART, un arrêt d'urgence ou une reprise après erreur, Klipper a effacé l'état de homing.

Solutions :

  1. Exécutez d'abord G28, puis la commande de palpage ou de mise à niveau.
  2. Ajoutez une vérification du homing ou directement G28 au début de la macro de mise à niveau.
  3. Si vous utilisez un palpeur Z indépendant, vérifiez que endstop_pin: probe:z_virtual_endstop et la configuration [probe] sont complets.

Références de configuration : Guide de homing et de calibration de direction, Introduction aux macros.

BLTouch failed to verify sensor state​

Message d'erreur : BLTouch failed to verify sensor state; retrying. Erreur après plusieurs tentatives.

Causes courantes :

  • BLTouch piraté/cloné ne peut pas passer la vérification du capteur interne de Klipper.
  • sensor_pin n'a pas de résistance de tirage configurée (préfixe ^ manquant).
  • Câblage incorrect de la broche de contrôle ou de la broche du capteur du BLTouch.
  • Échec de l'autotest du palpeur, LED rouge clignotante.

Solutions :

  1. Exécutez d'abord BLTOUCH_DEBUG COMMAND=pin_down, BLTOUCH_DEBUG COMMAND=touch_mode et QUERY_PROBE pour confirmer l'état.

  2. Si le test manuel réussit mais que le homing/palpage automatique échoue encore, ajoutez dans [bltouch] :

    pin_up_touch_mode_reports_triggered: False

  3. Assurez-vous que sensor_pin a une résistance de tirage configurée, par exemple sensor_pin: ^PC4.

  4. Vérifiez que l'autotest du BLTouch est normal : après mise sous tension, la tige sort et rentre plusieurs fois, la LED rouge reste allumée en cas de fonctionnement normal.

BLTouch failed to deploy​

Message d'erreur : BLTouch failed to deploy.

Causes courantes :

  • Tige du BLTouch bloquée mécaniquement, impossible à déployer.
  • Câblage ou configuration de control_pin incorrects, la tige ne reçoit pas le signal de déploiement.
  • Timing incompatible d'un BLTouch piraté/cloné.
  • Alimentation insuffisante du palpeur (utilisation du 3,3 V de la carte mère au lieu du 5 V).

Solutions :

  1. Testez manuellement le contrôle du palpeur : BLTOUCH_DEBUG COMMAND=pin_down, observez si la tige se déploie.
  2. Confirmez que control_pin et sensor_pin dans [bltouch] correspondent à la documentation de la carte mère.
  3. Vérifiez que l'alimentation du BLTouch est bien en 5 V (certaines cartes mères nécessitent un cavalier de sélection).
  4. Si le palpeur ne réagit pas du tout, après mise hors tension, vérifiez le câblage et les connecteurs, et remplacez le module palpeur si nécessaire.

BLTouch failed to raise probe​

Message d'erreur : Après le homing ou le palpage, Klipper détecte que la tige du BLTouch ne s'est pas rétractée avec succès.

Causes courantes :

  • Ancienne version clonée du BLTouch incapable de signaler l'état de rétraction de la tige.
  • Tige bloquée mécaniquement, noyau magnétique déplacé ou vis desserrées.
  • Câblage ou configuration de control_pin incorrects.

Solutions :

  1. Testez la fonction de contrôle du palpeur : BLTOUCH_DEBUG COMMAND=pin_down et BLTOUCH_DEBUG COMMAND=pin_up.

  2. Si le mouvement est normal mais qu'une erreur persiste, ajoutez dans [bltouch] :

    pin_up_reports_not_triggered: False

  3. Si la tige est bloquée, il est recommandé de remplacer le module palpeur ou de contacter le service après-vente, ne démontez pas un équipement sous tension.

Guide complet : Pour le câblage du BLTouch, les tests, la compatibilité des clones et les modes de sortie, consultez Configuration et dépannage du BLTouch.

Communication timeout during homing​

Message d'erreur : Communication timeout during homing x, Communication timeout during homing y, etc.

Causes courantes :

  • Pendant le homing, le bus CAN subit des interférences électromagnétiques générées par le mouvement des moteurs, entraînant des pertes de paquets.
  • Mauvais contact du câble de communication USB, déconnexion lors des vibrations de mouvement.
  • Surcharge du MCU (par exemple, le homing déclenche simultanément un grand nombre de requêtes de capteurs).

Solutions :

  1. Vérifiez le cheminement des câbles de communication CAN / USB, assurez-vous qu'ils sont éloignés des câbles moteur, des câbles de chauffe et des câbles d'alimentation.
  2. Confirmez que les connecteurs des câbles de communication sont bien enfoncés, remplacez par des câbles blindés de meilleure qualité.
  3. Confirmez que tous les MCU ont la même version de firmware.
  4. Si le problème n'apparaît que lors du homing d'un axe spécifique, vérifiez en priorité le blindage et la mise à la terre des câbles moteur et des faisceaux de fin de course de cet axe.

Dépannage associé : Lost communication with MCU, Dépannage des erreurs CAN

horizontal_move_z can't be less than probe's z_offset​

Message d'erreur : horizontal_move_z can't be less than probe's z_offset.

Causes courantes :

  • Le z_offset enregistré après PROBE_CALIBRATE est supérieur au horizontal_move_z de la configuration de mise à niveau.
  • Après le remplacement de la buse, du support de sonde ou de la hotend, la hauteur d'installation de la sonde change considérablement.
  • Le horizontal_move_z ou le z_offset est configuré en double dans plusieurs fichiers include.

Solutions :

  1. Recherchez tous les horizontal_move_z et z_offset pour confirmer la configuration finalement effective.
  2. Définissez le horizontal_move_z dans la configuration de mise à niveau concernée à une valeur sûre supérieure au z_offset de la sonde.
  3. Si le z_offset est anormalement élevé, revérifiez la hauteur d'installation de la sonde et exécutez PROBE_CALIBRATE.
  4. Après l'enregistrement, exécutez RESTART, puis retestez BED_MESH_CALIBRATE ou la commande de mise à niveau.

Références de configuration associées : Calibration machine, Introduction aux macros.

bed_mesh: cannot exceed a probe_count of 6​

Message d'erreur : bed_mesh: cannot exceed a probe_count of 6 when using lagrange interpolation.

Cause de l'erreur : L'interpolation lagrange a tendance à osciller avec un nombre d'échantillons élevé ; Klipper limite le nombre de points de palpage par axe à 6 lors de l'utilisation de cet algorithme.

Solutions :

  1. Si vous avez besoin d'une grille 7x7, 9x9 ou plus dense, définissez dans [bed_mesh] :

    algorithm: bicubic

  2. Si vous n'avez pas besoin d'une grille dense, réduisez probe_count à 6,6 ou moins.

  3. Lorsque le maillage adaptatif reçoit PROBE_COUNT du slicer ou d'une macro, vérifiez également que le nombre final de points correspond à l'algorithme.

  4. Après modification, enregistrez et exécutez RESTART.

Références de configuration associées : Introduction aux macros.

bed_mesh: Unknown profile​

Message d'erreur : bed_mesh: Unknown profile [xxx] ou message indiquant que le profil est introuvable lors du chargement de la configuration du maillage.

Causes courantes :

  • Le G-code de démarrage ou une macro exécute BED_MESH_PROFILE LOAD=xxx, mais ce nom n'a jamais été enregistré.
  • BED_MESH_CLEAR a été exécuté ou les données de maillage dans la zone de sauvegarde automatique ont été supprimées.
  • SAVE_CONFIG n'a pas été exécuté après la calibration du maillage.
  • Le nom du profil diffère par la casse ou les espaces.

Solutions :

  1. Exécutez BED_MESH_OUTPUT ou consultez la zone de sauvegarde automatique à la fin de la configuration pour confirmer les noms de profils existants.
  2. Si le profil nécessaire n'existe pas, réexécutez BED_MESH_CALIBRATE, puis SAVE_CONFIG.
  3. Modifiez BED_MESH_PROFILE LOAD= dans le G-code de démarrage pour que le nom corresponde au nom réellement enregistré.
  4. Si vous refaites un palpage avant chaque impression, vous pouvez supprimer les commandes de chargement de profil inutiles.

Références de configuration associées : Introduction aux macros.

Erreurs de configuration avancée bed_mesh​

Messages d'erreur : bed_mesh: ERROR, fade_target lies outside of mesh z range, bed_mesh: Mesh extends outside of the fade range, bed_mesh: Cannot probe zero reference position, bed_mesh: invalid min/max points, bed_mesh: malformed 'xxx' value.

Causes courantes :

  • Le fade_target dépasse la plage actuelle de hauteur Z du maillage, ou les données de maillage présentent une déviation globale trop importante.
  • mesh_min, mesh_max, zero_reference_position se retrouvent dans une zone non palpable après calcul avec le décalage de la sonde.
  • faulty_region couvre le point de référence zéro, empêchant Klipper de palper la position de référence.
  • Le format de la liste de coordonnées est incorrect, avec des virgules manquantes ou des ponctuations chinoises.
  • Les MESH_MIN / MESH_MAX transmis par la macro de maillage adaptatif ne correspondent pas aux dimensions de la machine et au décalage de la sonde.

Solutions :

  1. Vérifiez mesh_min, mesh_max, probe_count, fade_start, fade_end, fade_target dans [bed_mesh].
  2. Si vous ne comprenez pas la signification de fade_target, supprimez d'abord cette entrée pour laisser Klipper utiliser le comportement par défaut.
  3. Confirmez que tous les points de palpage, additionnés des x_offset / y_offset de [probe], restent dans la plage de déplacement de la machine.
  4. Si zero_reference_position ou faulty_region est configuré, vérifiez que le point de référence zéro ne tombe pas dans une zone défectueuse.
  5. En cas d'erreur du maillage adaptatif, testez d'abord avec des mesh_min / mesh_max fixes pour confirmer que la configuration de base du maillage est correcte, puis restaurez la macro.

Références de configuration associées : Introduction aux macros, Calibration machine.

Erreurs Z_TILT_ADJUST / QUAD_GANTRY_LEVEL​

Messages d'erreur : Z_TILT_ADJUST: Point X,Y not reachable with current probe offset, QUAD_GANTRY_LEVEL: Max adjustment X.XXXX exceeds limit ou déviation encore trop importante après la mise à niveau du portique.

Causes courantes :

  • Le décalage de la sonde est mal configuré, ce qui fait que les points de palpage calculés dépassent la plage du plateau chauffant.
  • La déviation du portique de plusieurs axes Z dépasse la plage autorisée par max_adjust.
  • Le sens des moteurs Z est incohérent, ce qui incline le portique dans des directions opposées.
  • La hauteur d'installation des fins de course est incohérente, entraînant des différences trop importantes de position initiale des axes Z après le homing.
  • La structure mécanique du portique est desserrée, la courroie patine ou le jeu de l'écrou de vis trapézoïdale est trop important.

Solutions :

Opération hors tension

Avant d'ajuster manuellement les vis trapézoïdales Z, la courroie de synchronisation, les accouplements, ou de vérifier l'installation des fins de course du portique, veuillez complètement éteindre l'imprimante et couper l'alimentation. Ne forcez pas la rotation des vis trapézoïdales ou de la courroie de synchronisation lorsque les moteurs sont sous tension et maintiennent un couple.

  1. Vérifiez x_offset, y_offset dans [probe], ainsi que points dans [z_tilt] ou [quad_gantry_level].
  2. Si la déviation dépasse max_adjust, coupez complètement l'alimentation, ajustez manuellement le portique approximativement à l'horizontale, puis remettez sous tension, effectuez le homing et la mise à niveau.
  3. Exécutez STEPPER_BUZZ STEPPER=stepper_z et STEPPER_BUZZ STEPPER=stepper_z1 (selon les noms réels) pour confirmer que chaque moteur Z se déplace individuellement dans le même sens.
  4. Après coupure de l'alimentation, vérifiez la cohérence de la hauteur d'installation des fins de course à chaque coin du portique, le serrage des écrous de vis trapézoïdale, de la courroie de synchronisation et l'absence de patinage des accouplements.
  5. Si seule la limite max_adjust est trop petite, vous pouvez l'augmenter modérément, mais sans dépasser 2 à 3 fois la valeur par défaut.

Références de configuration associées : Guide de calibration du homing et des directions.

no samples between time​

Message d'erreur : no samples between time X.X and X.X, apparaît généralement après l'exécution de BED_MESH_CALIBRATE.

Causes courantes :

  • La version du firmware de la sonde à échantillonnage en flux comme la sonde à courants de Foucault EDDY ou Cartographer ne correspond pas à celle de Klipper sur l'hôte.
  • Le flux de données de la sonde est interrompu pendant l'échantillonnage du maillage (gigue de communication CAN, bande passante USB insuffisante).
  • Le firmware du module de sonde n'a pas été mis à jour en même temps que Klipper.
  • La charge CPU de l'hôte est trop élevée, entraînant des horodatages anormaux des données d'échantillonnage.

Solutions :

  1. Confirmez que la version du firmware du module de sonde (EDDY, Cartographer, etc.) correspond à la version actuelle de Klipper, et reflashez le firmware de la sonde si nécessaire.
  2. Vérifiez l'état du bus CAN et confirmez que bytes_retransmit et bytes_invalid n'augmentent pas continuellement.
  3. Désactivez temporairement la caméra, KlipperScreen et autres services à forte charge, puis réexécutez la calibration du maillage.
  4. Si l'erreur ne se produit que dans une zone spécifique, vérifiez si cette zone dépasse la plage de détection effective de la sonde.
  5. Essayez de réduire la vitesse d'échantillonnage du maillage (réduire le paramètre speed) et retestez.

Concernant la sonde EDDY : Recueil de problèmes EDDY

SVD did not converge in Linear Least Squares​

Message d'erreur : numpy.linalg.LinAlgError: SVD did not converge in Linear Least Squares, déclenche généralement un shutdown après l'exécution de BED_MESH_CALIBRATE ou ACCEPT.

Causes courantes :

  • Les données des points d'échantillonnage du maillage sont anormales (toutes identiques, contenant des NaN ou des sauts extrêmes), numpy ne peut pas terminer l'ajustement matriciel.
  • La sonde déclenche une anomalie pendant l'échantillonnage (par exemple interruption du flux de données EDDY, Cartographer hors plage du modèle).
  • La surface du plateau chauffant présente des corps métalliques étrangers ou la face de détection de la sonde est contaminée, ce qui provoque des lectures gravement déviantes sur certains points.
  • La version de numpy sur l'hôte est trop ancienne ou l'installation est corrompue. Solution :
  1. Réexécutez BED_MESH_CALIBRATE et observez si l'échec se produit toujours au même point.
  2. Vérifiez si la surface du plateau chauffant est propre et si la face de détection de la sonde présente des résidus de filament ou des fragments métalliques.
  3. Si la sonde est une EDDY / Cartographer, confirmez que la version du firmware correspond à Klipper et vérifiez la stabilité de la communication CAN.
  4. Essayez de réduire probe_count (par exemple de 7x7 à 5x5) puis relancez le test pour exclure l'influence d'une anomalie ponctuelle.
  5. Si le problème persiste, essayez de mettre à jour numpy sur l'hôte : pip install --upgrade numpy.
  6. Vérifiez dans klippy.log si des erreurs préalables telles que Toolhead stopped outside model range ou un délai d'expiration de la sonde apparaissent avant l'erreur.
Loading...