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
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
- Ouvrez le fichier
printer.cfg. - Recherchez le paramètre
reg_drive_current =en bas de la configuration. - Augmentez ou diminuez la valeur actuelle de
1, par exemple15peut être changé en16ou14. - Veuillez saisir directement le résultat calculé, ne saisissez pas d'expression comme
15+1. - Enregistrez le fichier et redémarrez l'imprimante, puis retestez le retour à l'origine.
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.
- Dans
printer.cfg, recherchez la section de configuration[probe_eddy_current fly_eddy_probe]. - Augmentez légèrement
descend_z:. La valeur par défaut est généralement0.5, vous pouvez d'abord essayer2.0ou2.5. - Ce paramètre ne doit être conservé qu'à un seul endroit dans cette section de configuration, veuillez ne pas le configurer en double.
- 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. - Enregistrez et redémarrez l'imprimante, puis testez à nouveau le retour à l'origine.
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.
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_currentest 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 :
- Recalibrez le courant d'excitation :
LDC_CALIBRATE_DRIVE_CURRENT CHIP=fly_eddy_probe, puisSAVE_CONFIG. - 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. - 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.
- Assurez-vous que le lit chauffant est une surface métallique plane, sans déformation ni bomberment.
- 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 :
- Assurez-vous que toutes les hauteurs de descente des actions de sondage sont dans la plage utilisable d'EDDY.
- Évitez que plusieurs macros ou sections de configuration ne remplacent le même paramètre de hauteur.
- Après modification, enregistrez et redémarrez Klipper, puis réexécutez le retour à l'origine ou le nivellement.
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 :
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.
- Débranchez puis rebranchez le faisceau EDDY hors tension, vérifiez que les bornes ne sont pas desserrées.
- Éloignez les câbles de communication EDDY des fils moteurs, de chauffage et du lit chauffant.
- Si vous utilisez l'I2C matériel, essayez de réduire la vitesse I2C ; si l'instabilité persiste, testez l'I2C logiciel.
- 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.
- 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_currentinapproprié, plage de fréquences du capteur insuffisante.- Calibrage du courant d'excitation ou de la hauteur Z pas encore effectué.
Traitement :
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.
- 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. - 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.
- Réexécutez
LDC_CALIBRATE_DRIVE_CURRENT CHIP=fly_eddy_probepuisSAVE_CONFIG. - Réexécutez
PROBE_EDDY_CURRENT_CALIBRATE CHIP=fly_eddy_probe. - 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_currentetdescend_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 :
- Consultez
Git versionetLoaded MCU 'eddy' ... versiondansklippy.logpour confirmer si l'hôte et le firmware EDDY proviennent de la même version de Klipper. - 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.
- 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.
- 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
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 :
- Assurez-vous que la buse et le lit sont propres ; les résidus sur la buse affectent directement le résultat TAP.
- Avant de commencer le TAP, gardez la buse à quelques millimètres du lit ; ni trop près ni trop loin.
- Si elle s'arrête sans contact avec le lit,
tap_thresholdest peut-être trop bas ; augmentez-le légèrement. - Si elle ne s'arrête pas après le contact avec le lit,
tap_thresholdest peut-être trop élevé ; arrêtez immédiatement et baissez le seuil. - Après ajustement, réexécutez
PROBE_EDDY_CURRENT_TAP_CALIBRATE, puisSAVE_CONFIGune 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
Statsavant 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 :
- 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.
Z_TILT_ADJUSTpeut temporairement utiliserMETHOD=scan; le mode scan n'utilise pas le chemin trsync, ce qui réduit considérablement la probabilité de déclenchement.- 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.
- 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.
- 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 :
- Conservez le fichier
klippy.logcomplet, et vérifiez la trace Python et la commande en cours d'exécution avant et après l'erreur. - 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.
- Désactivez temporairement les plugins tiers (scanner, régulation automatique de vitesse, amélioration du nivellement automatique, etc.) et retestez avec Klipper d'origine.
- 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 :
- Effectuez l'étalonnage EDDY à une température aussi proche que possible de la température d'impression réelle.
- 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.
- Si l'EDDY dispose d'un capteur de température, configurez
[temperature_probe]et effectuez une compensation de la dérive thermique. - 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.
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.