Guide de résolution des problèmes courants du capteur EDDY

FAQ capteur EDDY

Erreur lors du retour à l'origine Error during homing z: Eddy current sensor error

Si vous rencontrez cette erreur, procédez aux vérifications dans l'ordre.

Mettre à jour Klipper ou le système

Avis important

La fonction de retour à l'origine Z d'EDDY présentait auparavant des problèmes de compatibilité, qui ont été optimisés dans la mise à jour Klipper du 6 janvier 2026.

• Ordinateur hôte standard : mettez Klipper à jour vers une version stable plus récente.
• Ordinateur hôte FLY : mettez à niveau la version du système vers V1.3.5 ou supérieure.

Après la mise à jour, il est nécessaire de recalibrer EDDY.

Ajuster le courant d'excitation

1. Ouvrez le fichier printer.cfg.
2. Recherchez le paramètre reg_drive_current = en bas de la configuration.
3. Augmentez ou diminuez la valeur actuelle de 1, par exemple 15 peut être changé en 16 ou 14.
4. Veuillez saisir directement le résultat calculé, ne saisissez pas d'expression comme 15+1.
5. Enregistrez le fichier et redémarrez l'imprimante, puis retestez le retour à l'origine.

Loading...

Ajuster le décalage de la sonde

Si la mise à jour et l'ajustement du courant d'excitation restent sans effet, vous pouvez continuer à vérifier descend_z.

1. Dans printer.cfg, recherchez la section de configuration [probe_eddy_current fly_eddy_probe].
2. Augmentez légèrement descend_z:. La valeur par défaut est généralement 0.5, vous pouvez d'abord essayer 2.0 ou 2.5.
3. Ce paramètre ne doit être conservé qu'à un seul endroit dans cette section de configuration, veuillez ne pas le configurer en double.
4. Il est recommandé de ne pas dépasser 3.0 ; la valeur finale doit être déterminée en fonction de la structure de la machine et de la hauteur d'installation de la sonde.
5. Enregistrez et redémarrez l'imprimante, puis testez à nouveau le retour à l'origine.

Note de version

La configuration [probe_eddy_current] après mars 2026 utilise descend_z. L'ancien z_offset de la configuration est obsolète et pourrait être supprimé dans les versions ultérieures ; si des tutoriels, d'anciennes configurations ou des captures d'écran mentionnent encore z_offset, veuillez d'abord le remplacer par descend_z.

Loading...

Message Amplitude Low/High warning

Message d'erreur : my_eddy_probe: Amplitude Low/High warning (36), Amplitude Low/High warning (48), etc. Le nombre entre parenthèses est la valeur d'amplitude mesurée.

Causes courantes :

• Le réglage de reg_drive_current est inapproprié, l'amplitude d'oscillation du capteur sort de la plage idéale.
• La distance (standoff) entre la sonde et le lit chauffant est trop grande ou trop petite.
• La sonde est mal fixée ou la surface du lit chauffant n'est pas plane.

Solutions :

1. Recalibrez le courant d'excitation : LDC_CALIBRATE_DRIVE_CURRENT CHIP=fly_eddy_probe, puis SAVE_CONFIG.
2. Si l'avertissement persiste après le calibrage, ajustez manuellement reg_drive_current (par pas de ±1) comme indiqué dans la section « Ajuster le courant d'excitation » ci-dessus.
3. Vérifiez que la sonde est bien fixée ; la distance entre le bas de la sonde et la surface du lit chauffant doit être comprise entre 0,3 et 1,0 mm.
4. Assurez-vous que le lit chauffant est une surface métallique plane, sans déformation ni bomberment.
5. Si l'avertissement n'apparaît qu'à des endroits spécifiques, il peut s'agir d'une irrégularité locale du lit ; essayez de recalibrer à différents endroits.

Message !! probe_eddy_current sensor not in valid range

Cette erreur signifie que la lecture de la sonde sort de la plage valide. La cause courante est qu'après l'activation de la sonde EDDY, la hauteur de sonde dans d'autres sections de configuration n'est pas appliquée comme prévu, ce qui fait que la sonde se déplace hors de sa plage physique.

Veuillez vérifier en priorité les emplacements suivants :

• [probe_eddy_current fly_eddy_probe]
• [bed_mesh]
• [z_tilt] ou [quad_gantry_level]
• Macros personnalisées de retour à l'origine, de nivellement, de balayage du lit

Traitement :

1. Assurez-vous que toutes les hauteurs de descente des actions de sondage sont dans la plage utilisable d'EDDY.
2. Évitez que plusieurs macros ou sections de configuration ne remplacent le même paramètre de hauteur.
3. Après modification, enregistrez et redémarrez Klipper, puis réexécutez le retour à l'origine ou le nivellement.

Loading...

Message Eddy I2C STATUS/DATA error ou Invalid read data

Ce type d'erreur indique une anomalie de communication ou de lecture entre EDDY et le MCU.

Causes courantes :

• Mauvais contact du faisceau de câbles EDDY, des connecteurs ou des soudures.
• Câbles I2C trop longs, de mauvaise qualité, ou acheminés parallèlement aux fils moteurs ou de chauffage, provoquant des interférences.
• Vitesse I2C trop élevée, instable dans l'environnement de câblage actuel.
• Alimentation de la sonde instable.

Traitement :

Opération hors tension

Avant de rebrancher le faisceau EDDY, de réorganiser le câblage ou de vérifier les connecteurs, éteignez complètement l'imprimante et débranchez l'alimentation électrique. Ne débranchez pas le capteur ni ne touchez les bornes lorsque l'appareil est sous tension.

1. Débranchez puis rebranchez le faisceau EDDY hors tension, vérifiez que les bornes ne sont pas desserrées.
2. Éloignez les câbles de communication EDDY des fils moteurs, de chauffage et du lit chauffant.
3. Si vous utilisez l'I2C matériel, essayez de réduire la vitesse I2C ; si l'instabilité persiste, testez l'I2C logiciel.
4. Pour le dépannage croisé, privilégiez le remplacement du faisceau de câbles d'origine, le changement de port ou le remplacement du capteur ; pour les tests électriques sur bornes nues, contactez le service après-vente ou un professionnel.
5. Après modification, réexécutez le retour à l'origine ou PROBE_EDDY_CURRENT_CALIBRATE.

Broches et câblage I2C : Explication des broches et de la configuration I2C EDDY

Message Unable to obtain probe_eddy_current sensor readings

Cette erreur signifie que Klipper n'a pas obtenu de données valides du capteur EDDY dans le délai imparti.

Causes courantes :

• Ligne de communication du capteur déconnectée ou erreur de bus/broche dans la configuration.
• Sonde trop éloignée de la surface métallique du lit, lecture hors plage utilisable.
• reg_drive_current inapproprié, plage de fréquences du capteur insuffisante.
• Calibrage du courant d'excitation ou de la hauteur Z pas encore effectué.

Traitement :

Opération hors tension

Avant de vérifier le bus EDDY, le câblage des broches ou de remplacer le faisceau du capteur, éteignez complètement l'imprimante et débranchez l'alimentation électrique. Ne débranchez pas le capteur lorsque l'appareil est sous tension.

1. Hors tension, vérifiez que la configuration du bus et des broches dans [probe_eddy_current fly_eddy_probe] correspond au câblage réel.
2. Déplacez la tête d'impression au centre du lit chauffant, en vous assurant qu'EDDY est au-dessus de la surface métallique.
3. Réexécutez LDC_CALIBRATE_DRIVE_CURRENT CHIP=fly_eddy_probe puis SAVE_CONFIG.
4. Réexécutez PROBE_EDDY_CURRENT_CALIBRATE CHIP=fly_eddy_probe.
5. Si cela ne se produit qu'au retour à l'origine, continuez avec la section « Erreur lors du retour à l'origine » ci-dessus pour ajuster reg_drive_current et descend_z.

MCU Protocol error: Unknown command i2c_write

Message d'erreur : MCU Protocol error, mcu 'eddy': Unknown command: i2c_write, Command format mismatch.

Ce type d'erreur indique généralement une incompatibilité de version entre le firmware du MCU périphérique EDDY / RP2040 et la version Klipper de l'ordinateur hôte. Le scénario courant est une mise à jour de Klipper sur l'hôte sans recompiler et reflasher le firmware EDDY ; il est également possible que le firmware EDDY soit plus récent que Klipper sur l'hôte, et que le maître ne reconnaisse pas encore les nouvelles commandes utilisées par le firmware périphérique.

Traitement :

1. Consultez Git version et Loaded MCU 'eddy' ... version dans klippy.log pour confirmer si l'hôte et le firmware EDDY proviennent de la même version de Klipper.
2. Recompilez et reflashez le firmware du MCU EDDY ; la méthode de flashage dépend de la carte outil ou de la documentation produit EDDY correspondante.
3. Si vous utilisez un système intégré tiers ou un Klipper personnalisé par le fabricant, vérifiez d'abord que ce système prend en charge le firmware EDDY actuel ; en cas de doute, privilégiez le package firmware fourni par le même système.
4. Après le flashage, exécutez FIRMWARE_RESTART, puis réexécutez le calibrage du courant d'excitation et de la hauteur EDDY.

Vérification générique de version : MCU Protocol error

Anomalie de déclenchement du mode TAP

Lors de l'utilisation de METHOD=tap avec EDDY, si la sonde s'arrête trop tôt, ne s'arrête pas après le contact avec le lit, ou si les résultats sont manifestement instables, cela est généralement lié à tap_threshold et à l'état de la buse / du lit.

Procédure détaillée : Méthode de débogage du mode TAP EDDY

Risque de mouvement

Le test TAP amène la buse à proximité ou en contact avec le lit chauffant. Avant d'exécuter, assurez-vous que la buse et la surface du lit sont propres, que les mains et les outils sont éloignés de la zone de mouvement, et préparez un arrêt d'urgence.

Points de vérification :

1. Assurez-vous que la buse et le lit sont propres ; les résidus sur la buse affectent directement le résultat TAP.
2. Avant de commencer le TAP, gardez la buse à quelques millimètres du lit ; ni trop près ni trop loin.
3. Si elle s'arrête sans contact avec le lit, tap_threshold est peut-être trop bas ; augmentez-le légèrement.
4. Si elle ne s'arrête pas après le contact avec le lit, tap_threshold est peut-être trop élevé ; arrêtez immédiatement et baissez le seuil.
5. Après ajustement, réexécutez PROBE_EDDY_CURRENT_TAP_CALIBRATE, puis SAVE_CONFIG une fois la procédure réussie.

Déclenchement de Timer too close lors du retour à l'origine / TAP

Message d'erreur : MCU 'xxx' shutdown: Timer too close.

Nature de l'erreur : Le retour à l'origine EDDY, le TAP ou Z_TILT_ADJUST utilisent le mécanisme de synchronisation temporelle trsync. Dans certaines conditions, un saut d'horloge arrière peut se produire. Les développeurs en amont de Klipper ont confirmé des cas liés (sauts d'horloge trsync, débordement 32 bits dans les journaux), il s'agit d'un problème connu en attente de correction, se manifestant de manière intermittente et difficilement reproductible, ce qui ne signifie pas nécessairement un dommage du faisceau ou du matériel. Causes fréquentes :

• La synchronisation temporelle trsync de EDDY homing / TAP peut revenir en arrière dans certaines conditions.
• Les scénarios avec carte d'outil CAN sont plus susceptibles de déclencher ce problème ; la ligne Stats avant et après l'erreur peut également montrer des retransmissions CAN ou des pics de charge sur l'hôte.
• La superposition de plugins tiers (régulation automatique de vitesse, auto-tuning, synchronisation moteur, etc.) augmente la probabilité de déclenchement.

Mesures à prendre :

1. Mettez à jour Klipper et réinstallez tous les firmwares MCU, en vérifiant que les versions des MCU de l'hôte, de la carte d'outil et d'EDDY sont cohérentes.
2. Z_TILT_ADJUST peut temporairement utiliser METHOD=scan ; le mode scan n'utilise pas le chemin trsync, ce qui réduit considérablement la probabilité de déclenchement.
3. Simplifiez les macros de démarrage en évitant les homing répétés, les TAP répétés et les balayages de lit continus, afin de réduire les opportunités de déclenchement.
4. Désactivez un par un les plugins tiers (régulation automatique de vitesse, auto-tuning, etc.) et retestez pour confirmer si la superposition de plugins en est la cause.
5. Si des retransmissions CAN ou des anomalies de communication apparaissent en même temps, consultez Dépannage des erreurs CAN pour vérifier le câblage et l'état du bus.

Dépannage spécifique TAP : EDDY TAP / Z_TILT déclenche Timer too close

Dépannage système : Timer too close

Erreur interne stepcompress déclenchée lors du balayage du lit / nivellement

Message d'erreur : Internal error in stepcompress, Error in syncemitter 'xxx' step generation, Exception in flush_handler.

Lors du balayage haute vitesse EDDY, de BED_MESH_CALIBRATE, de Z_TILT_ADJUST ou d'un balayage par scanner, si la file de mouvement et l'échantillonnage EDDY se superposent et provoquent une anomalie interne dans la génération des pas, ce type d'erreur peut apparaître.

Mesures à prendre :

1. Conservez le fichier klippy.log complet, et vérifiez la trace Python et la commande en cours d'exécution avant et après l'erreur.
2. Réduisez la vitesse de balayage, le nombre de points de sonde, la densité d'interpolation et les paramètres de balayage EDDY, puis retestez.
3. Désactivez temporairement les plugins tiers (scanner, régulation automatique de vitesse, amélioration du nivellement automatique, etc.) et retestez avec Klipper d'origine.
4. Mettez à jour Klipper puis réinstallez tous les firmwares MCU.

Dépannage détaillé : Erreurs internes stepcompress / syncemitter / flush_handler

Dérive thermique entraînant une première couche instable

EDDY est un capteur à courants de Foucault ; les variations de température du lit, de la buse, de la bobine du capteur et des pièces métalliques environnantes affectent les mesures. Le symptôme typique est : l'étalonnage fonctionne correctement à froid, mais la première couche d'impression à chaud est trop haute ou trop basse.

Mesures à prendre :

1. Effectuez l'étalonnage EDDY à une température aussi proche que possible de la température d'impression réelle.
2. Avant l'impression, attendez que la température du lit et de la buse soit stable, puis effectuez le homing, le nivellement ou le balayage du lit.
3. Si l'EDDY dispose d'un capteur de température, configurez [temperature_probe] et effectuez une compensation de la dérive thermique.
4. Pour les machines fermées, il est recommandé d'effectuer un étalonnage fin une fois la température de l'enceinte stable.

Conseils de débogage pour descend_z

Dans de nombreux cas de débogage, définir la valeur initiale de descend_z dans [probe_eddy_current fly_eddy_probe] sur 2.5 permet généralement d'amener plus rapidement de nombreux capteurs EDDY dans un état de fonctionnement.

Attention

2.5 n'est qu'un point de départ pour le débogage, ce n'est pas une valeur fixe universelle ni une configuration par défaut officielle. Le décalage optimal dépend de la position de montage de la sonde, de la hauteur de la buse et de la structure de la machine ; veuillez vous référer aux résultats d'étalonnage réels.