Outil d'étalonnage de la sonde

Les commandes Klipper de décalage Z de la sonde, de fin de course Z, de bed mesh, d'étalonnage Delta, etc., finissent toutes par passer par le même processus de détection manuelle. Il est fourni par le module manual_probe — ce module est chargé automatiquement par Klipper, il n'y a rien à écrire dans printer.cfg et aucune option n'est disponible ; ce qu'il faut réellement configurer, ce sont [probe] (ou [bltouch]) et [stepper_z].

La plupart des messages produits par ce processus ne font qu'attendre votre saisie de TESTZ : ce ne sont pas des pannes. Seuls les trois cas ci-dessous peuvent réellement invalider un étalonnage ou empêcher une commande de démarrer.

Aide-mémoire en une minute

Message au terminal	Nature	Que faire
Starting manual Z probe…	Message normal, en attente de saisie	TESTZ Z=-0.1 pour approcher vers le bas → ACCEPT ; abandonner avec ABORT
Manual probe failed!…	Étalonnage invalidé (pas de shutdown, aucune écriture de configuration)	Relancer la commande d'étalonnage ; ne pas toucher à X/Y pendant toute l'opération, et le Z final doit être plus bas qu'au départ
Already in a manual Z probe…	Erreur au niveau de la commande	Faire d'abord ABORT pour terminer l'ancienne session, ou terminer l'autre outil qui occupe ACCEPT

Les erreurs liées au matériel de la sonde et à sa configuration (Probe triggered prior to movement, No trigger on probe, Probe samples exceed samples_tolerance, BLTouch, bed_mesh) sont traitées dans Erreurs de mouvement, de fin de course et de nivellement.

Quelles commandes déclenchent la détection manuelle

Commande	Utilisation	Détection manuelle
MANUAL_PROBE	Mesurer le Z d'un point à la feuille de papier, sans sonde	Toujours
PROBE_CALIBRATE	Étalonner le z_offset de la sonde	Réglage fin une fois la détection terminée
Z_ENDSTOP_CALIBRATE	Étalonner position_endstop	Toujours ; n'existe que si [stepper_z] a un position_endstop configuré ; les machines qui utilisent la sonde comme fin de course Z (probe:z_virtual_endstop, comme TAP) n'ont pas cette commande
DELTA_CALIBRATE	Hauteur de tour / rayon Delta	Sans sonde ou avec METHOD=manual
BED_MESH_CALIBRATE, BED_TILT_CALIBRATE, Z_TILT_ADJUST, QUAD_GANTRY_LEVEL	Bed mesh / inclinaison / relevé multi-Z	Avec METHOD=manual

Fenêtre contextuelle de l'interface

La fenêtre d'étalonnage de Mainsail / Fluidd lit justement l'état de manual_probe ; cliquer sur ACCEPT équivaut à saisir ACCEPT au terminal.

Utilisation de TESTZ

Syntaxe	Comportement
TESTZ Z=-0.1	Déplacement selon la valeur, sans contrainte de pas (à utiliser pour arriver d'un coup quand on est loin)
TESTZ Z=- / --	Bissection / saut vers un point déjà testé plus bas, pas ≤ 0.2mm
TESTZ Z=+ / ++	Bissection / saut vers un point déjà testé plus haut, pas ≤ 0.2mm

Deux points à savoir

• + / - / ++ / -- ne déplacent au maximum que de 0.2mm à chaque fois ; si vous trouvez cela trop lent, passez à la syntaxe numérique.
• Chaque TESTZ remonte d'abord à « cible + 0.5mm » puis redescend vers la cible ; il est donc normal de voir la buse monter légèrement en cours de route.

Détail des trois messages

Starting manual Z probe

// Starting manual Z probe. Use TESTZ to adjust position.
// Finish with ACCEPT or ABORT command.
// Z position: ?????? --> 5.000 <-- ??????

Message normal : l'état reste ready, le processus ne se termine pas de lui-même et n'expire pas. Entre --> et <-- se trouve le Z actuel ; de part et d'autre figurent les positions plus basses / plus hautes déjà testées, et ?????? indique qu'aucune valeur n'est encore enregistrée dans cette direction.

À faire : descendre progressivement en suivant la procédure de la feuille de papier, puis ACCEPT au contact.

Manual probe failed!

// Manual probe failed! Use TESTZ commands to position the
// nozzle prior to running ACCEPT.

Cet étalonnage est invalidé : aucun shutdown n'est déclenché, mais aucune configuration n'est écrite, ACCEPT / TESTZ / ABORT deviennent aussitôt inopérants et la commande d'étalonnage doit être relancée (cliquer sur SAVE_CONFIG à ce moment-là n'a aucun sens).

Deux causes possibles, une seule suffit à faire échouer l'opération :

• X/Y ont bougé : utilisation du joystick / des flèches pendant la session, ou macro contenant G1 X.. Y.., ou encore le mouvement de stationnement de Klicky.
• Le Z n'est pas plus bas : vous n'avez fait que remonter, ou vous êtes descendu trop bas avant de revenir au point de départ — le contrôle ne regarde que le Z au moment où ACCEPT est pressé, indépendamment du déroulement intermédiaire (même 0.01mm plus haut suffit à échouer).

Solution :

1. Relancez la commande d'étalonnage et approchez en allant toujours vers le bas avec TESTZ Z=-0.1 (puis -0.05 à l'approche) ; vérifiez que la valeur intermédiaire de Z position est plus petite qu'au départ, puis faites ACCEPT.
2. Ne touchez pas à X/Y pendant la session.
3. Si l'échec est immédiat à chaque fois, vérifiez si la hauteur de départ n'est pas trop basse, selon la structure :
   • Machines avec une fin de course Z indépendante : voir [stepper_z] position_endstop.
   • Sonde utilisée comme fin de course Z (probe:z_virtual_endstop, comme sur les structures à déclenchement par la buse du type Voron TAP) : [stepper_z] n'a pas de position_endstop ; vérifiez plutôt [probe] z_offset et la limite basse de l'axe Z position_min.
   • Machines Delta : vous pouvez aussi vérifier minimum_z_position.

Already in a manual Z probe

Already in a manual Z probe. Use ABORT to abort it.

Erreur au niveau de la commande : au moment de démarrer une nouvelle session, Klipper constate que ACCEPT est déjà pris.

Causes fréquentes : la session précédente ne s'est pas terminée par ACCEPT / ABORT ; des outils comme BED_SCREWS_ADJUST occupent eux aussi ACCEPT ; une gcode_macro personnalisée porte le même nom qu'une commande intégrée.

Solution :

1. Exécutez ABORT pour terminer l'ancienne session. Si le message Unknown command: ABORT s'affiche, c'est qu'il n'y a pas de session en cours — terminez alors l'outil qui occupe réellement ACCEPT (par exemple en exécutant ADJUSTED dans BED_SCREWS_ADJUST).
2. Si le problème est systématique, vérifiez dans tous les fichiers include s'il existe une macro portant le nom d'une commande intégrée ; renommez-la ou supprimez-la, puis réessayez.
3. Actualiser l'interface ou redémarrer Klipper efface la fenêtre d'étalonnage restée affichée.

Après ACCEPT

• MANUAL_PROBE répond Z position is <valeur> ; PROBE_CALIBRATE et Z_ENDSTOP_CALIBRATE proposent une nouvelle valeur.
• Il faut exécuter SAVE_CONFIG (ou SAVE_CONFIG & Restart dans l'interface) pour que la configuration soit écrite et prise en compte au redémarrage.
• Pour abandonner en cours de route, utilisez ABORT : aucune configuration n'est écrite et Manual probe failed! n'est pas déclenché.

Procédure standard de la feuille de papier

Risque de mouvement

Pendant l'étalonnage, la buse descend automatiquement. Avant de lancer, écartez vos mains et vos outils, vérifiez qu'il n'y a aucun obstacle sous la buse ni de pièce résiduelle sur le plateau chauffant, et tenez-vous prêt à déclencher l'arrêt d'urgence.

1. Effectuez le homing, puis placez la buse juste au-dessus du point à étalonner.
2. Exécutez la commande d'étalonnage et vérifiez que Starting manual Z probe apparaît.
3. Placez la feuille de papier entre la buse et le plateau chauffant et faites-la glisser d'avant en arrière.
4. Descendez progressivement avec TESTZ Z=-0.1 ; à l'approche, utilisez TESTZ Z=-0.05 ou Z=- pour affiner.
5. Arrêtez lorsque la feuille est légèrement pincée et que son glissement oppose une résistance nette.
6. Exécutez ACCEPT ; si Manual probe failed! apparaît, reportez-vous à cette entrée pour diagnostiquer, puis recommencez.
7. Exécutez SAVE_CONFIG pour enregistrer et redémarrer.

N'approchez que dans un seul sens

Approchez toujours le point de contact du haut vers le bas : cela réduit l'erreur de jeu de l'axe Z et évite l'échec dû à un Z qui n'est pas plus bas que la hauteur de départ.

Documentation associée

Erreurs de sonde et de nivellement : Erreurs de mouvement, de fin de course et de nivellement · BLTouch : Configuration et dépannage BLTouch · EDDY : Recueil de problèmes EDDY · Load Cell : Dépannage de la sonde Load Cell

Commandes de débogage courantes : Directives de débogage courantes · Procédure d'étalonnage de la machine : Étalonnage de la machine