Erreurs de mouvement, de fin de course et de nivellement

Cette page répertorie les erreurs liées au déplacement, à la recherche d'origine, aux fin de course, à la sonde, au maillage du lit et au nivellement multi-Z. Avant toute intervention sur le câblage, les connecteurs ou les réglages mécaniques manuels, veuillez d'abord couper l'alimentation électrique.

Déplacement hors plage

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ébut, 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.
• 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.

Solutions :

1. Déterminez quel axe est hors plage en fonction des coordonnées dans le message d'erreur.
2. Vérifiez les position_min, position_max de l'axe concerné et les dimensions de la machine dans le slicer.
3. Vérifiez les coordonnées de stationnement dans les macros de début, fin, pause, changement de filament, etc., en évitant de s'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.

Configuration associée : Présentation des macros, Guide de recherche d'origine et de calibration des directions.

Impossible d'analyser le déplacement / Vitesse invalide

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 fait que la commande de déplacement générée manque de valeurs X, Y, Z, E ou F.
• Erreur de formatage (sauts de ligne, accolades, noms de variables, échappement) dans le G-code de début/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 supporte pas.
• Le nom utilisé dans SAVE_GCODE_STATE / RESTORE_GCODE_STATE dans une macro est incohérent.

Solutions :

1. Trouvez 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ébut, fin, pause, reprise et changement de filament du slicer pour vous assurer que toutes les commandes de déplacement 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 en millimètres et n'émettez pas G20.
5. Si Unknown g-code state apparaît, vérifiez que SAVE_GCODE_STATE NAME= et RESTORE_GCODE_STATE NAME= utilisent le même nom.

Configuration associée : Présentation des macros.

Doit d'abord trouver l'origine de l'axe

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

Causes courantes :

• G28 n'a pas été exécuté après la mise sous tension ou un FIRMWARE_RESTART.
• Une macro exécute d'abord une commande de déplacement avant une commande de recherche d'origine.
• L'état de la machine est réinitialisé après une pause, une reprise ou une annulation d'impression.
• La configuration de la macro de recherche d'origine, de la macro de sonde ou de la recherche d'origine sans fin de course est anormale, empêchant Klipper d'enregistrer correctement l'état de recherche d'origine.

Solutions :

1. Exécutez G28 manuellement avant de déplacer l'axe concerné.
2. Vérifiez le G-code de début et les macros pour vous assurer que la recherche d'origine est effectuée avant les commandes de déplacement.
3. Si Klipper ou le firmware a été récemment mis à jour, vérifiez la compatibilité des macros de recherche d'origine avec la version actuelle.
4. Si vous utilisez une recherche d'origine sans fin de course, vérifiez le courant moteur, la sensibilité et homing_retract_dist.

Configuration associée : Guide de recherche d'origine et de calibration des directions, Utilisation des positions illimitées.

Fin de course toujours déclenché après la rétraction

Message d'erreur : Après que la fin de course a été déclenché lors de la recherche d'origine, il est toujours à l'état déclenché à la fin de la distance de retrait.

Causes courantes :

• La logique normalement ouvert/fermé du fin de course est configurée à l'envers.
• Le fin de course est coincé, endommagé ou a un mauvais ordre de câblage.
• homing_retract_dist est trop petit, le fin de course est toujours enfoncé après le retrait.
• La sensibilité de la recherche d'origine sans fin de course est trop élevée, elle est toujours considérée comme déclenchée après le retrait.
• La configuration de enable_pin du pilote, la direction du moteur ou la broche du fin de course est incorrecte, ce qui entraîne un fonctionnement anormal de la recherche d'origine.

Solutions :

Couper l'alimentation

Avant de vérifier le connecteur du fin de course, l'ordre des câbles du moteur ou de rebrancher le faisceau, éteignez complètement l'imprimante et débranchez l'alimentation électrique. Lors des tests sous tension, n'utilisez que les commandes web et les parties de déclenchement mécanique du fin de course, ne touchez pas aux bornes.

1. Exécutez QUERY_ENDSTOPS, vérifiez qu'il est open lorsqu'il n'est pas déclenché et TRIGGERED lorsqu'il est déclenché manuellement.
2. Si l'état est inversé, ajustez le ! devant la broche du fin de course.
3. Après avoir coupé l'alimentation, vérifiez l'état mécanique du fin de course, l'ordre des câbles et le connecteur.
4. Augmentez homing_retract_dist de manière appropriée, puis testez à nouveau.
5. Si vous utilisez une recherche d'origine sans fin de course, réduisez la sensibilité et assurez-vous que le courant de recherche d'origine est approprié.

Configuration associée : Fin de course, Utilisation des positions illimitées.

Aucun déclenchement sur le fin de course après le mouvement complet

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

Causes courantes :

• La direction de recherche d'origine est mal configurée, le moteur se déplace dans la direction opposée au fin de course.
• Le 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 réelle, la distance de recherche d'origine est insuffisante.
• La sensibilité de la recherche d'origine sans fin de course est trop faible, la butée mécanique n'est pas détectée comme déclenchée.
• L'ordre des câbles du moteur ou la direction est mal configuré, ce qui fait que l'axe se déplace dans la direction opposée à celle prévue.

Solutions :

1. Exécutez QUERY_ENDSTOPS, appuyez manuellement sur le fin de course et vérifiez que l'état passe de open à TRIGGERED.
2. Déplacez l'axe sur une petite distance pour confirmer la 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 le 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 de recherche d'origine sans fin de course, réduisez la vitesse de recherche d'origine et ajustez la sensibilité TMC.

Configuration associée : Guide de recherche d'origine et de calibration des directions, Fin de course.

Problèmes de sonde et de nivellement

Couper l'alimentation

Avant de vérifier le câblage, les connecteurs ou l'ordre des câbles des sondes BLTouch, Probe, TAP, Klicky, EDDY, etc., éteignez complètement l'imprimante et débranchez l'alimentation électrique. Sous tension, n'exécutez que des commandes de requête ou observez l'état, ne branchez/débranchez pas les faisceaux.

Sonde déclenchée avant le mouvement

Message d'erreur : La sonde est déjà à l'état déclenché avant le début du mouvement de recherche d'origine ou de sondage.

Causes de l'erreur :

• L'état par défaut de la sonde après la mise sous tension ou la réinitialisation est TRIGGERED.
• L'ordre des câbles de la sonde est incorrect ou il y a un mauvais contact, ce qui maintient le signal à l'état déclenché.
• Panne mécanique de la sonde, par exemple la sonde BLTouch coincée et incapable de se rétracter.
• L'axe Z est déjà à sa position la plus basse, ce qui comprime la sonde.

Solutions :

1. Exécutez QUERY_PROBE lorsque la sonde ne touche pas le lit pour confirmer qu'elle est open.
2. Exécutez QUERY_ENDSTOPS pour confirmer que le signal du fin de course/de la sonde est correct.
3. Pour BLTouch : BLTOUCH_DEBUG COMMAND=pin_up pour vous assurer que la sonde est rétractée, puis QUERY_PROBE pour confirmer.
4. Vérifiez la position actuelle de l'axe Z, soulevez l'axe Z si nécessaire.
5. Après avoir coupé l'alimentation, vérifiez le câblage de la sonde et la configuration sensor_pin.

Configuration associée : Fin de course, Commandes de débogage courantes.

Aucun déclenchement de la sonde après le mouvement complet

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

Causes courantes :

• Problème de câblage, d'alimentation ou de configuration de broche de la sonde.
• Hauteur d'installation de la sonde inappropriée, ne permettant pas le déclenchement pendant la course de descente.
• Mauvaise configuration de la direction de l'axe Z, du décalage de la sonde ou de la zone de nivellement.
• Panne de la sonde elle-même, ou mauvais contact du faisceau lors du déplacement.

Solutions :

1. Exécutez QUERY_PROBE, déclenchez manuellement la sonde et vérifiez que l'état change correctement.
2. Après avoir coupé l'alimentation, vérifiez l'alimentation de la sonde, le câble de signal et la broche de configuration.
3. Vérifiez la hauteur d'installation de la sonde pour vous assurer qu'elle se trouve dans la plage de déclenchement avant la descente.
4. Vérifiez que les points de mesure dans [probe], [bed_mesh], [z_tilt] ou [quad_gantry_level] ne dépassent pas le lit.
5. Si le problème ne se produit qu'à certains endroits, vérifiez particulièrement le tirage du faisceau et le décalage de la sonde.

Configuration associée : Fin de course, Présentation des macros.

Les échantillons de la sonde dépassent samples_tolerance

Message d'erreur : Probe samples exceed samples_tolerance, ou le journal affiche de manière répétée Probe samples exceed tolerance. Retrying....

Causes courantes :

• Faible répétabilité de la sonde, la différence de hauteur Z entre plusieurs échantillonnages dépasse samples_tolerance.
• Le lit, le portique, la buse ou la sonde ne sont pas solidement fixés, ce qui provoque des oscillations lors du sondage.
• La vitesse de la sonde est trop élevée, ou la distance de descente/remontée est inappropriée.
• Les capteurs inductifs, à courants de Foucault ou de pression sont affectés par la dérive de température ou les interférences électromagnétiques.

Solutions :

1. Vérifiez que la sonde, la tête chaude, le plateau du lit et le portique sont solidement fixés.
2. Réduisez la speed dans [probe], augmentez sample_retract_dist de manière appropriée.
3. Assouplissez temporairement samples_tolerance pour le test, par exemple de 0.01 à 0.03 ou 0.05.
4. Si vous utilisez une sonde inductive/à courants de Foucault, attendez que la température du lit et de la buse soit stable avant de niveler.
5. Si le problème ne se produit que dans une certaine zone, vérifiez la surface du lit, le revêtement magnétique, le tirage du faisceau et le décalage de la sonde.

Configuration associée : Calibration de la machine, Présentation des macros.

Doit trouver l'origine avant la sonde

Message d'erreur : Must home before probe.

Causes courantes :

• PROBE, BED_MESH_CALIBRATE, Z_TILT_ADJUST ou QUAD_GANTRY_LEVEL est exécuté sans avoir exécuté G28 auparavant.
• Une macro appelle une commande de nivellement sans garantir que XY/Z aient été ramenés à l'origine.
• Après un FIRMWARE_RESTART, une urgence ou une reprise après erreur, Klipper a effacé l'état de recherche d'origine.

Solutions :

1. Exécutez G28 d'abord, puis exécutez la commande de sonde ou de nivellement.
2. Ajoutez une vérification de l'état de recherche d'origine au début de la macro de nivellement, ou ajoutez directement G28.
3. Si vous utilisez une sonde Z indépendante, assurez-vous que endstop_pin: probe:z_virtual_endstop et la configuration [probe] sont complètes.

Configuration associée : Guide de recherche d'origine et de calibration des directions, Présentation des macros.

BLTouch n'a pas pu vérifier l'état du capteur

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

Causes courantes :

• Une BLTouch contrefaite/clone ne peut pas passer la vérification du capteur interne de Klipper.
• sensor_pin n'est pas configuré avec une résistance de pull-up (préfixe ^ manquant).
• Erreur de câblage de la broche de commande ou de la broche du capteur de la BLTouch.
• Échec de l'auto-test de la sonde, clignotement rouge.

Solutions :

1. Exécutez d'abord BLTOUCH_DEBUG COMMAND=pin_down, BLTOUCH_DEBUG COMMAND=touch_mode et QUERY_PROBE pour vérifier l'état.
2. Si le test manuel réussit mais que la recherche d'origine/le sondage automatique échoue encore, ajoutez dans [bltouch] :

pin_up_touch_mode_reports_triggered: False

3. Assurez-vous que sensor_pin est configuré avec une résistance de pull-up, par exemple sensor_pin: ^PC4.
4. Vérifiez si l'auto-test de la BLTouch est normal : après la mise sous tension, la sonde s'étend et se rétracte plusieurs fois, une lumière rouge fixe indique la normale.

BLTouch n'a pas réussi à soulever la sonde

Message d'erreur : Après la recherche d'origine ou le sondage, Klipper détecte que la sonde BLTouch ne s'est pas rétractée avec succès.

Causes courantes :

• Les anciennes versions de BLTouch clone ne peuvent pas signaler l'état de rétraction de la sonde.
• La sonde est mécaniquement bloquée, le noyau magnétique est déplacé ou la vis est desserrée.
• Erreur de câblage ou de configuration de control_pin.

Solutions :

1. Testez la fonction de commande de la sonde : BLTOUCH_DEBUG COMMAND=pin_down et BLTOUCH_DEBUG COMMAND=pin_up.
2. Si le mouvement est normal mais que l'erreur persiste, ajoutez dans [bltouch] :

pin_up_reports_not_triggered: False

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

horizontal_move_z ne peut pas être inférieur au z_offset de la sonde

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

Causes courantes :

• Le z_offset sauvegardé après PROBE_CALIBRATE est supérieur à horizontal_move_z dans la configuration de nivellement.
• Après avoir changé la buse, le support de la sonde ou la tête chaude, la hauteur d'installation de la sonde a beaucoup changé.
• Plusieurs fichiers include configurent horizontal_move_z ou z_offset de manière redondante.

Solutions :

1. Recherchez tous les horizontal_move_z et z_offset, confirmez la configuration finale en vigueur.
2. Définissez horizontal_move_z dans la configuration de nivellement concernée à une valeur sécuritaire supérieure au z_offset de la sonde.
3. Si z_offset est anormalement grand, vérifiez à nouveau la hauteur d'installation de la sonde et exécutez PROBE_CALIBRATE.
4. Après avoir sauvegardé, exécutez RESTART, puis testez à nouveau BED_MESH_CALIBRATE ou la commande de nivellement.

Configuration associée : Calibration de la machine, Présentation des macros.

bed_mesh: ne peut pas dépasser une probe_count de 6

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

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

Solutions :

1. Si vous avez besoin d'une grille de 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 est transmis par le slicer ou une macro avec PROBE_COUNT, assurez-vous également que le nombre final de points et l'algorithme correspondent.
4. Après modification, sauvegardez et exécutez RESTART.

Configuration associée : Présentation des macros.

bed_mesh: Profil inconnu

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ébut ou une macro exécute BED_MESH_PROFILE LOAD=xxx, mais ce nom n'a jamais été sauvegardé.
• BED_MESH_CLEAR a été exécuté ou les données du maillage dans la zone de sauvegarde automatique ont été supprimées.
• SAVE_CONFIG n'a pas été exécuté après la fin de l'étalonnage du maillage.
• Incohérence de casse ou d'espaces dans le nom du profil.

Solutions :

1. Exécutez BED_MESH_OUTPUT ou consultez la zone de sauvegarde automatique à la fin de la configuration pour confirmer les noms de profil existants.
2. Si le profil souhaité n'existe pas, réexécutez BED_MESH_CALIBRATE, puis exécutez SAVE_CONFIG.
3. Modifiez BED_MESH_PROFILE LOAD= dans le G-code de début pour qu'il corresponde au nom réellement sauvegardé.
4. Si vous rescannerez le lit avant chaque impression, vous pouvez supprimer la commande de chargement de profil inutile.

Configuration associée : Présentation des macros.

Erreurs de configuration avancée de bed_mesh

Message 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 :

• fade_target dépasse la plage de hauteur Z actuelle du maillage, ou les données du maillage présentent un écart global trop important.
• mesh_min, mesh_max, zero_reference_position combinés au décalage de la sonde tombent dans une zone non sondable.
• faulty_region couvre le point de référence zéro, empêchant Klipper de sonder la position de référence.
• Formatage incorrect de la liste de coordonnées, virgule manquante ou utilisation de ponctuation chinoise.
• MESH_MIN / MESH_MAX transmis par la macro de maillage adaptatif ne correspondent pas aux dimensions de la machine ou 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-le d'abord pour laisser Klipper utiliser le comportement par défaut.
3. Assurez-vous que tous les points de mesure, après avoir ajouté x_offset / y_offset de [probe], se trouvent toujours dans la plage de déplacement de la machine.
4. Si vous avez configuré zero_reference_position ou faulty_region, assurez-vous que le point de référence zéro ne se trouve pas dans la zone défectueuse.
5. En cas d'erreur de maillage adaptatif, testez d'abord avec des mesh_min / mesh_max fixes pour confirmer que la configuration de base du maillage est correcte avant de restaurer la macro.

Configuration associée : Présentation des macros, Calibration de la machine.

Erreurs Z_TILT_ADJUST / QUAD_GANTRY_LEVEL

Message d'erreur : Z_TILT_ADJUST: Point X,Y not reachable with current probe offset, QUAD_GANTRY_LEVEL: Max adjustment X.XXXX exceeds limit ou l'écart après le nivellement du portique est toujours trop grand.

Causes courantes :

• Le décalage de la sonde est mal configuré, ce qui fait que le point de mesure calculé dépasse la plage du lit.
• L'écart du portique pour les multiples axes Z dépasse la plage autorisée max_adjust.
• Les directions des moteurs Z ne sont pas cohérentes, ce qui fait pencher le portique dans la direction opposée.
• Les hauteurs d'installation des fins de course ne sont pas cohérentes, ce qui entraîne des positions de départ très différentes pour chaque axe Z après la recherche d'origine.
• Structure mécanique du portique desserrée, courroie qui glisse ou jeu excessif dans l'écrou de la vis mère.

Solutions :

Couper l'alimentation

Avant de régler manuellement les vis mères Z, les courroies synchrones, les accouplements, ou de vérifier l'installation des fins de course du portique, éteignez complètement l'imprimante et débranchez l'alimentation électrique. Ne forcez pas la rotation des vis mères ou des courroies synchrones lorsque les moteurs sont sous tension et maintiennent le couple.

1. Vérifiez x_offset, y_offset dans [probe], ainsi que points dans [z_tilt] ou [quad_gantry_level].
2. Si l'écart dépasse max_adjust, mettez complètement hors tension, ajustez manuellement le portique pour qu'il soit approximativement de niveau, puis remettez sous tension, trouvez l'origine et exécutez le nivellement.
3. Exécutez STEPPER_BUZZ STEPPER=stepper_z et STEPPER_BUZZ STEPPER=stepper_z1 (selon le nom réel) pour confirmer que la direction de mouvement de chaque moteur Z individuel est cohérente.
4. Après avoir coupé l'alimentation, vérifiez si les hauteurs d'installation des fins de course à chaque angle du portique sont cohérentes, le serrage de l'écrou de la vis mère, la tension de la courroie synchrone et si l'accouplement glisse.
5. Si la limitation max_adjust est simplement trop petite, vous pouvez augmenter la valeur de manière appropriée, mais ne dépassez pas 2 à 3 fois la valeur par défaut.

Configuration associée : Guide de recherche d'origine et de calibration des directions.