Configuration et dépannage du BLTouch

Cet article présente le câblage, la configuration, les tests, l'étalonnage et le dépannage courant de la sonde BLTouch dans Klipper.

Erreurs associées : Pour un dépannage rapide des erreurs liées au BLTouch, consultez Erreurs de mouvement, de fin de course et de nivellement.

Câblage et configuration

Opération hors tension

Avant de commencer, éteignez complètement l'imprimante et débranchez l'alimentation électrique. Ne branchez/débranchez pas les faisceaux, ne réorganisez pas les fils des connecteurs et ne touchez pas les bornes sous tension.

Le BLTouch comporte deux groupes de fils :

• Trois fils (côté servo/contrôle) : Le fil jaune est le signal control_pin.
• Deux fils (côté capteur) : Le fil blanc est le signal sensor_pin.

Connectez le côté contrôle aux broches Servo / BLTouch de la carte mère et le côté capteur aux broches d'entrée de fin de course Probe / Z-Max de la carte mère. Consultez la documentation de configuration de la carte FLY correspondante pour les broches spécifiques.

Résistance de tirage vers le haut

La plupart des sensor_pin du BLTouch nécessitent une résistance de tirage vers le haut, avec le préfixe ^ devant le nom de la broche, par exemple sensor_pin: ^PC4.

Exemple de configuration de base :

[bltouch]
sensor_pin: ^PC4
control_pin: PA1
x_offset: 0
y_offset: 0
z_offset: 0
speed: 5

Si vous utilisez le BLTouch comme fin de course pour l'axe Z, vous devez :

1. Définir endstop_pin: probe:z_virtual_endstop dans [stepper_z] et supprimer position_endstop.
2. Ajouter la configuration [safe_z_home] :

[safe_z_home]
home_xy_position: 100, 100  # Remplacez par les coordonnées du centre du lit
speed: 50
z_hop: 10                   # Soulevez de 10 mm avant l'initialisation
z_hop_speed: 5

Hauteur du z_hop

z_hop doit être suffisamment haut pour garantir que même si la sonde est déployée, elle ne heurte pas le lit ou les pinces.

Tests initiaux

Auto-test

Une fois sous tension, le BLTouch doit effectuer un auto-test : la sonde s'étend et se rétracte plusieurs fois, puis se rétracte complètement et la LED rouge reste allumée en continu. Si la LED rouge clignote ou si la sonde reste en position déployée, coupez l'alimentation et vérifiez le câblage et la configuration.

Test des broches de contrôle

BLTOUCH_DEBUG COMMAND=pin_down

Confirmez que la sonde est déployée et que la LED rouge est éteinte. Ensuite :

BLTOUCH_DEBUG COMMAND=pin_up

Confirmez que la sonde est rétractée et que la LED rouge se rallume. Si la LED rouge clignote, il y a une anomalie.

Test des broches du capteur

1. Exécutez BLTOUCH_DEBUG COMMAND=pin_down et confirmez que la sonde est déployée.
2. Exécutez BLTOUCH_DEBUG COMMAND=touch_mode.
3. Exécutez QUERY_PROBE. Il doit retourner probe: open.
4. Poussez doucement la sonde vers le haut avec votre ongle, puis exécutez à nouveau QUERY_PROBE. Il doit retourner probe: TRIGGERED.
5. Exécutez BLTOUCH_DEBUG COMMAND=pin_up pour rétracter la sonde.

Si le résultat de QUERY_PROBE est incorrect, il s'agit généralement d'une erreur de câblage ou de configuration (certaines versions clone nécessitent un traitement spécial, voir ci-dessous).

Test de détection

Déplacez la tête d'impression loin du lit, exécutez G28 (ou PROBE), puis lorsque la tête d'impression commence à descendre, touchez légèrement la sonde avec votre ongle pour la déclencher. Soyez prêt à éteindre l'imprimante à tout moment. Après la réussite, effectuez un autre déplacement normal pour que la sonde touche le lit.

Récupération après panne (clignotement de la LED rouge)

Lorsque le BLTouch entre dans un état anormal et que la LED rouge clignote en continu, exécutez :

BLTOUCH_DEBUG COMMAND=reset

Causes courantes : la sonde est bloquée lors du déploiement, interrompant l'étalonnage.

Si le BLTouch ne fonctionne toujours pas correctement après reset, le noyau magnétique à l'intérieur de la sonde peut s'être déplacé :

Opération hors tension

Avant de démonter ou d'ajuster la sonde BLTouch, éteignez complètement l'imprimante et débranchez l'alimentation électrique.

1. Dévissez la vis du dessus de la sonde après avoir coupé l'alimentation. Utilisez un stylo à bille pour repousser doucement le noyau magnétique à sa place.
2. Remontez la sonde de sorte qu'elle tombe naturellement en position déployée.
3. Ajustez soigneusement la position de la vis. Après la mise sous tension, utilisez BLTOUCH_DEBUG COMMAND=reset, pin_up et pin_down pour tester si le déploiement, la rétraction et la LED rouge sont normaux.

Compatibilité des versions clones

La plupart des clones de BLTouch fonctionnent correctement avec la configuration par défaut, mais certains clones présentent les problèmes suivants :

Important

Ne définissez pas pin_up_reports_not_triggered ou pin_up_touch_mode_reports_triggered sur False sans avoir vérifié la nécessité. Les BLTouch authentiques ne doivent pas modifier ces paramètres. Une configuration incorrecte augmente le temps de détection et peut endommager l'imprimante.

Ne prend pas en charge touch_mode

Certains clones ne prennent pas en charge touch_mode. La commande QUERY_PROBE ne fonctionne pas correctement, mais G28/PROBE peut encore réussir. Pour ces appareils, n'activez pas probe_with_touch_mode.

BLTouch failed to verify sensor state

Les clones ne peuvent pas passer la vérification interne du capteur de Klipper. Suivez d'abord le Test des broches du capteur pour confirmer que le résultat de QUERY_PROBE est correct. Si le test manuel fonctionne toujours correctement mais que l'erreur persiste, ajoutez :

[bltouch]
pin_up_touch_mode_reports_triggered: False

BLTouch failed to raise probe

Les anciennes versions de clones ne peuvent pas signaler l'état de rétraction de la sonde. Méthode de test :

1. Déplacez la tête d'impression loin du lit.
2. BLTOUCH_DEBUG COMMAND=pin_down → Confirmez le déploiement.
3. QUERY_PROBE → Doit retourner probe: open.
4. BLTOUCH_DEBUG COMMAND=pin_up → Confirmez la rétraction.
5. QUERY_PROBE → Si elle retourne probe: TRIGGERED (au lieu de open), l'appareil ne peut pas signaler la rétraction.

Après confirmation, ajoutez :

[bltouch]
pin_up_reports_not_triggered: False

Précautions pour les versions BLTouch V3

Problème de signal V3.0

Si le sensor_pin du BLTouch V3.0 est connecté à une broche de fin de course avec un condensateur de filtrage, il peut ne pas envoyer de signal de déclenchement de manière stable. Cela se manifeste par le fait que le test QUERY_PROBE est normal, mais que la tête d'impression ne s'arrête parfois pas lors de G28/PROBE. Solution :

[bltouch]
probe_with_touch_mode: True

Erreur sporadique V3.1

Le BLTouch V3.1 clignote parfois en rouge pendant quelques secondes après une détection réussie. Klipper efface automatiquement cette erreur, qui est généralement inoffensive. Définir probe_with_touch_mode: True peut éviter ce problème.

Impact sur la précision

Certains clones et les BLTouch V2.0 et versions antérieures peuvent voir leur précision diminuer lorsque probe_with_touch_mode: True est activé, et le temps de déploiement de la sonde augmente. Comparez les résultats avec la commande PROBE_ACCURACY avant et après la modification.

Pas de rétraction lors de plusieurs détections

Par défaut, Klipper rétracte la sonde après chaque détection, puis la redéploie, ce qui prend du temps pour plusieurs détections. L'option suivante permet de maintenir la sonde déployée entre les détections consécutives :

[bltouch]
stow_on_each_sample: False

Consigne de sécurité

Lorsque cette option est définie sur False, Klipper peut effectuer des mouvements horizontaux avec la sonde déployée. Assurez-vous que le jeu en Z est suffisant pour toutes les opérations de détection, sinon la sonde pourrait heurter un obstacle et endommager l'imprimante.

Recommandation

Lorsque vous utilisez stow_on_each_sample: False, il est recommandé de définir également probe_with_touch_mode: True, ce qui simplifie la logique du signal et améliore la stabilité. Certains clones peuvent ne pas détecter les déclenchements ultérieurs sans cette option.

Étalonnage des décalages

Utilisez la commande PROBE_CALIBRATE pour calibrer x_offset, y_offset et z_offset.

Recommandation pour le décalage Z

La valeur idéale de z_offset est proche de 1 mm. Si l'écart est trop important, ajustez la hauteur de montage de la sonde : celle-ci doit se déclencher suffisamment tôt avant que la buse ne touche le lit, tout en étant rétractée suffisamment haut pour éviter de racler les pièces imprimées. Après l'ajustement, réexécutez PROBE_CALIBRATE.

Mode de sortie (5V / Open-Drain)

Les BLTouch V3.0 et V3.1 prennent en charge les modes de sortie 5V et Open-Drain. Le mode par défaut est Open-Drain.

• Si la broche d'entrée de la carte mère nécessite un niveau haut de 5 V et supporte 5 V, vous pouvez définir :

[bltouch]
set_output_mode: 5V

Compatibilité de tension

Utilisez le mode 5 V uniquement lorsque vous confirmez que la ligne de signal d'entrée de la carte mère peut tolérer 5 V. Un réglage incorrect pourrait endommager le processeur de la carte mère.

• V3.0 : Le mode doit être défini via set_output_mode: 5V à chaque démarrage, car le V3.0 ne le mémorise pas.
• V3.1 : Exécutez BLTOUCH_STORE MODE=5V une fois pour écrire le mode dans l'EEPROM interne. Ensuite, set_output_mode n'est plus nécessaire. N'exécutez pas la commande de stockage de manière répétée ; la durée de vie de l'EEPROM est d'environ 100 000 cycles d'écriture.
• Autres sondes : Certaines sondes utilisent des cavaliers ou des coupes de pistes sur le circuit imprimé pour définir de manière permanente le mode de sortie. Dans ce cas, le paramètre set_output_mode n'est pas nécessaire.