Problèmes de configuration de la compensation de résonance et de l'avance de pression

Cette page répertorie les erreurs de configuration et les anomalies de réglage liées à Input Shaper (compensation de résonance) et à Pressure Advance (avance de pression). Pour les erreurs de connexion matérielle et de communication de l'accéléromètre, veuillez vous référer à Test et étalonnage de l'accéléromètre.

Les ondulations s'aggravent ou l'impression devient floue après l'activation d'Input Shaper

Symptôme : Après la configuration de [input_shaper], les ondulations de surface (ghosting/ondulations) sur la pièce imprimée sont plus visibles qu'avant l'activation, ou les détails deviennent flous, les coins s'arrondissent.

Causes courantes :

• shaper_freq_x / shaper_freq_y s'écartent trop de la fréquence de résonance réelle.
• Le shaper_type choisi ne convient pas à la machine actuelle (par exemple, l'utilisation de 2hump_ei sur une machine à haute rigidité entraîne un lissage excessif).
• La structure mécanique présente des jeux (courroie trop lâche, jeu important dans les chariots, vis non serrées), la compensation de résonance ne peut pas corriger les problèmes mécaniques.
• Après l'activation d'Input Shaper, Pressure Advance n'a pas été réétalonné, la combinaison des deux entraîne une extrusion anormale.

Solutions :

1. Éliminez d'abord les problèmes mécaniques : après la mise hors tension, vérifiez la tension des courroies, le jeu des chariots/rails, le serrage des vis du cadre.

2. Refaites la mesure de résonance pour obtenir des fréquences précises :

   TEST_RESONANCES AXIS=X
   TEST_RESONANCES AXIS=Y

3. Choisissez le type de formeur approprié en fonction du graphique de résonance :

   Formeur	Scénario d'application	Tolérance de fréquence	Impact sur le lissage
   zv	Machines à haute rigidité et faibles vibrations	±5%	Le plus faible
   mzv	La plupart des machines de bureau (recommandé en premier)	±10%	Moyen
   ei	Machines à plateau mobile / vibrations importantes	±20%	Moyen à élevé
   2hump_ei	Présence de plusieurs fréquences de résonance	±45%	Élevé
   3hump_ei	Modes de résonance complexes	±60%	Le plus élevé

4. Après l'activation d'Input Shaper, il est obligatoire de réétalonner Pressure Advance :

   SET_PRESSURE_ADVANCE ADVANCE=0
   TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005

5. Si le flou est important, essayez de réduire shaper_freq d'environ 5 à 10 % ou passez à un type de formeur avec une tolérance plus faible.

Référence de configuration associée : Documentation officielle Klipper sur la compensation de résonance.

Erreurs de configuration de TEST_RESONANCES / SHAPER_CALIBRATE

Messages d'erreur :

• accel_chip not configured / No accelerometer configured
• probe_points must be specified ou coordonnées hors de la zone d'impression
• Invalid accel_chip / nom de puce spécifié introuvable

Causes courantes :

• accel_chip n'est pas configuré dans [resonance_tester], ou le nom ne correspond pas au nom de section [adxl345] / [mpu9250] / [lis2dw].
• Les coordonnées de probe_points dépassent la plage de position_max définie dans [stepper_x] / [stepper_y].
• En cas de configuration multi-accéléromètres, accel_chip contient une casse ou un préfixe incorrect.

Solutions :

1. Vérifiez que les noms de sections de configuration correspondent :

   [adxl345]
   cs_pin: toolboard:gpio12
   spi_bus:spi0_gpio4_gpio3_gpio2
   
   [resonance_tester]
   accel_chip: adxl345
   probe_points:
       150, 150, 20

2. Les coordonnées X, Y de probe_points doivent être dans la zone d'impression, la coordonnée Z est la hauteur de la buse au-dessus du plateau pendant le test (20 mm recommandé).

3. Si vous utilisez un accéléromètre sur la carte d'outil, le nom accel_chip doit être identique au nom de section (sensible à la casse).

4. Dans un scénario multi-puces, vous pouvez spécifier accel_chip_x et accel_chip_y pour correspondre respectivement aux différents axes.

Erreur de communication matérielle : Si ACCELEROMETER_QUERY renvoie un délai d'attente ou une erreur d'ID, veuillez vous référer aux problèmes courants dans Test et étalonnage de l'accéléromètre.

axes_map n'est pas détecté automatiquement

Symptôme : ACCELEROMETER_QUERY renvoie des données correctement, mais après l'exécution de TEST_RESONANCES / SHAPER_CALIBRATE, la direction du graphique de résonance est anormale, les résultats des axes X/Y semblent inversés, ou la qualité d'impression ne s'améliore pas après l'activation d'Input Shaper.

Explication :

Dans Klipper, les configurations d'accéléromètres comme [adxl345], [lis2dw], [mpu9250], [bmi160], [icm20948] utilisent la même logique d'analyse axes_map. Klipper lit uniquement le axes_map de la configuration et ne détermine pas automatiquement le mappage des coordonnées en fonction de la direction d'installation du capteur.

Si axes_map n'est pas renseigné, la valeur par défaut est :

axes_map: x,y,z

Causes courantes :

• La direction d'installation de la carte d'outil ou de l'accéléromètre externe ne correspond pas aux directions des coordonnées X/Y/Z de l'imprimante.
• Copie d'une configuration d'une autre machine ou d'une autre direction d'installation, ce qui entraîne un ordre ou un signe incorrect pour x, y, z.
• Après avoir changé la carte d'outil, le boîtier de la buse ou la position d'installation de l'accéléromètre, axes_map n'a pas été revérifié.

Écriture correcte :

axes_map doit contenir 3 axes, prend en charge l'échange de l'ordre des axes et la négation :

[adxl345]
axes_map: x,y,z

# Exemple : X inchangé, Y/Z échangés
# axes_map: x,z,y

# Exemple : directions X/Y inversées, Z inchangé
# axes_map: -x,-y,z

Méthode de vérification :

1. Vérifiez d'abord que la communication avec l'accéléromètre est normale :

   ACCELEROMETER_QUERY

2. Commencez l'enregistrement des données de l'accéléromètre, puis testez les directions X et Y avec de petits mouvements :

   ACCELEROMETER_MEASURE
   G91
   G1 X10 F3000
   G1 X-10 F3000
   G1 Y10 F3000
   G1 Y-10 F3000
   G90
   ACCELEROMETER_MEASURE NAME=axes_map_check

3. Dans /tmp/<type de puce>-axes_map_check.csv, vérifiez quelle colonne de données change le plus lors des mouvements X/Y. Par exemple, pour [adxl345], le fichier sera /tmp/adxl345-axes_map_check.csv ; si vous utilisez une section avec nom (comme [adxl345 hotend]), le nom de fichier contiendra le nom de la puce correspondant.

4. Si un mouvement en direction X provoque principalement une réponse sur Y ou Z, l'ordre des axes doit être ajusté ; si la réponse est dans la direction opposée, ajoutez - devant l'axe correspondant.

5. Dans un scénario multi-accéléromètres, ACCELEROMETER_MEASURE peut accepter l'ajout de CHIP=<nom de la puce> pour spécifier l'accéléromètre à tester.

6. Après avoir modifié axes_map, exécutez RESTART, puis relancez TEST_RESONANCES ou SHAPER_CALIBRATE.

Conseil

axes_map affecte uniquement la manière dont les données de l'accéléromètre sont mappées aux coordonnées de l'imprimante, il ne répare pas les problèmes de communication de l'accéléromètre. Si ACCELEROMETER_QUERY lui-même renvoie une erreur, traitez d'abord les problèmes de communication ou de câblage de l'accéléromètre.

Échec de la configuration du ou des formeurs

Message d'erreur : configparser.Error: Failed to configure shaper(s) shaper_x with given parameters, Failed to configure shaper(s) shaper_z with given parameters.

Causes courantes :

• shaper_freq_x ou shaper_freq_y dépasse la plage de fréquences disponible pour le shaper_type choisi. Par exemple, mzv peut ne pas avoir de solution valide à des fréquences élevées.
• damping_ratio est mal réglé (trop petit ou trop grand), ce qui empêche la génération de paramètres valides pour le formeur.
• Saisie manuelle d'une combinaison de paramètres non validée par SHAPER_CALIBRATE.

Solutions :

1. Relancez SHAPER_CALIBRATE pour utiliser le shaper_type et le shaper_freq recommandés automatiquement.
2. Si vous ajustez manuellement, essayez de réduire shaper_freq, ou passez à un type de formeur avec une tolérance plus élevée (comme ei ou 2hump_ei).
3. Vérifiez que damping_ratio est dans une plage raisonnable (défaut 0,1, plage courante 0,05–0,2).
4. Si vous souhaitez désactiver le formeur pour un axe, définissez shaper_freq_x: 0 au lieu de saisir une valeur invalide.

shaper_freq trop élevé provoque des bruits anormaux du moteur ou des pas perdus

Symptôme : Après l'activation d'Input Shaper, le moteur émet des sifflements à haute fréquence, la pièce imprimée présente des stries régulières, ou des pas sont perdus lors des déplacements à grande vitesse.

Causes courantes :

• La valeur de shaper_freq est bien supérieure à la fréquence de résonance réelle (par exemple, 80 Hz saisi pour une résonance réelle de 40 Hz).
• Erreur d'interprétation du graphique de résonance, confondant un pic de bruit avec la fréquence de résonance.
• max_accel est trop élevé, dépassant le couple des moteurs. Solutions :

1. Relancez SHAPER_CALIBRATE et laissez l’outil recommander automatiquement la fréquence et le type d’amortisseur.

2. Lors de l’interprétation manuelle du graphique de résonance, choisissez la fréquence correspondant au pic le plus haut et le plus net, en ignorant le bruit large et peu prononcé.

3. Réduisez max_accel jusqu’à une plage où le moteur ne perd pas de pas (il est recommandé de commencer à 3000 puis d’augmenter progressivement) :

   [printer]
   max_accel: 3000

4. Si le moteur continue d’émettre des bruits anormaux, désactivez temporairement Input Shaper pour vérifier s’il s’agit d’un problème de configuration :

   SET_INPUT_SHAPER SHAPER_FREQ_X=0 SHAPER_FREQ_Y=0

Bourrelet ou manque de matière aux angles après activation du Pressure Advance

Symptôme : Après activation de pressure_advance, les angles des pièces imprimées présentent un excès de matière (bourrelet) ou un manque/amincissement juste avant l’angle.

Causes courantes :

• Valeur de PA trop faible : la pression résiduelle dans la buse n’est pas suffisamment compensée lors de la décélération → bourrelet aux angles.
• Valeur de PA trop élevée : rétraction excessive lors de l’accélération → manque de matière avant l’angle, lignes plus fines.
• Le slicer active simultanément Coasting ou Extra restart distance, ce qui entre en conflit avec la compensation PA.
• Le rotation_distance de l’extrudeuse n’est pas calibré, ce qui rend le débit de base inexact.

Solutions :

1. Assurez-vous de désactiver dans le slicer Coasting, Extra restart distance et le contrôle dynamique de l’accélération.

2. Calibrez d’abord le rotation_distance de l’extrudeuse, puis le PA.

3. Imprimez une tour de test avec TUNING_TOWER :

   SET_VELOCITY_LIMIT SQUARE_CORNER_VELOCITY=1 ACCEL=500
   TUNING_TOWER COMMAND=SET_PRESSURE_ADVANCE PARAMETER=ADVANCE START=0 FACTOR=.005

   Pour une extrudeuse à entraînement direct, utilisez FACTOR=.005 ; pour un système Bowden distant, utilisez FACTOR=.020.

4. Choisissez la hauteur correspondant au calque avec les angles les plus nets et les lignes les plus uniformes, puis calculez la valeur PA :

   pressure_advance = START + hauteur × FACTOR

5. Plages de valeurs typiques : extrudeuse directe 0,02–0,15, Bowden 0,1–1,0. Si aucune amélioration n’est observée au-delà de 1,0, le problème ne vient pas du PA.

Pour référence : Documentation officielle Klipper Pressure Advance.

Sauts de pas de l’extrudeuse dus à une valeur de PA trop élevée

Symptôme : Après utilisation d’une valeur pressure_advance élevée (par exemple >0,2), l’extrudeuse émet des clics pendant les phases d’accélération/décélération ou la pièce présente des ruptures de filament.

Causes courantes :

• La compensation PA génère un mouvement d’extrusion/rétraction supplémentaire important pendant l’accélération/décélération, dépassant le couple de l’extrudeuse.
• L’accélération est réglée trop haut, ce qui rend la compensation PA instantanée excessive.
• Le courant de l’extrudeuse est insuffisant ou le filament patine.

Solutions :

1. Réduisez max_accel pour diminuer le débit instantané généré par la compensation PA.
2. Réduisez raisonnablement la valeur PA pour trouver un équilibre entre la qualité des angles et la fiabilité de l’extrusion.
3. Vérifiez si le réglage du courant de l’extrudeuse (run_current des drivers TMC) est suffisant.
4. Assurez-vous que le filament ne patine pas (contrôlez l’usure de la roue d’entraînement et la pression du ressort).

Attention

Le système PA ne modifie ni le temps d’impression ni le débit total ; il redistribue uniquement le mouvement d’extrusion pendant les phases d’accélération/décélération. Des valeurs de PA extrêmement élevées entraînent des mouvements instantanés très importants de l’extrudeuse, et aucun paramètre ne permet de limiter cette amplitude.

Réglage inadapté de pressure_advance_smooth_time

Symptôme : Des ondulations périodiques apparaissent sur la surface d’impression, la vitesse d’extrusion est irrégulière ou les transitions d’angles ne sont pas naturelles.

Causes courantes :

• pressure_advance_smooth_time réglé trop haut (>0,1 s), la compensation PA répond avec lenteur.
• Réglé trop bas (<0,01 s), la compensation PA devient trop agressive et provoque des tremblements d’extrusion.
• Les anciennes configurations utilisent un bloc [pressure_advance] indépendant désormais obsolète.

Solutions :

1. La valeur par défaut 0.040 convient à la plupart des scénarios et ne nécessite généralement aucune modification.

2. La configuration doit être placée dans le bloc [extruder] :

   [extruder]
   pressure_advance: 0.05
   pressure_advance_smooth_time: 0.040

3. N’utilisez pas de bloc [pressure_advance] indépendant (obsolète).

4. Pour les longs tubes Bowden, vous pouvez augmenter légèrement jusqu’à 0.060–0.080.

Conflit entre les réglages du slicer et le contrôle d’extrusion de Klipper

Symptôme : Après configuration du PA, la qualité d’impression se dégrade au lieu de s’améliorer : plus de filage, angles anormaux ou particules d’extrusion.

Causes courantes :

• Le slicer active Coasting, qui s’ajoute à la compensation de décélération du PA.
• Le paramètre Extra restart distance de Simplify3D provoque des variations brusques de la vitesse d’extrusion.
• Le PreloadVE de KISSlicer fait doublon avec la fonction PA.
• Le contrôle dynamique de l’accélération ou le Scarf joint du slicer interfère avec les tests.

Solutions :

1. Désactivez les fonctions suivantes du slicer :
   • Coasting
   • Extra restart distance
   • PreloadVE (KISSlicer)
   • Contrôle dynamique de l’accélération / pression dynamique
   • Scarf joint (pendant le calibrage PA)
2. Conservez les réglages normaux de rétraction (0,5–1,0 mm recommandé) et “essuyage lors de la rétraction”.
3. Désactivez le “Z-lift on retract” (soulèvement de l’axe Z lors de la rétraction) du slicer ; il sera contrôlé par les macros Klipper.

Astuce

Pour le calibrage PA, il est recommandé d’utiliser une vitesse de slicer de 100 mm/s, une hauteur de couche d’environ 75 % du diamètre de la buse, un remplissage de 0 % et de désactiver le contrôle dynamique de l’accélération afin de révéler pleinement l’effet du PA.

Modifications de configuration de compensation de résonance après mise à jour de Klipper

Symptôme : Après une mise à jour de Klipper, le comportement de SHAPER_CALIBRATE change, les résultats des tests de résonance diffèrent de ceux obtenus précédemment, ou des avertissements de paramètres obsolètes apparaissent.

Causes courantes :

• Klipper a mis à jour les paramètres par défaut de [resonance_tester] (comme sweeping_period, accel_per_hz).
• L’ancien max_accel_to_decel a été remplacé par minimum_cruise_ratio.
• La logique d’échantillonnage de l’accéléromètre ou l’algorithme de filtrage ont été mis à jour.

Solutions :

1. Après la mise à jour, consultez le journal des changements de configuration Klipper pour vérifier les entrées pouvant affecter la compensation de résonance.

2. Pour restaurer l’ancien comportement de test, ajoutez explicitement dans [resonance_tester] :

   [resonance_tester]
   sweeping_period: 0
   accel_per_hz: 75

3. Après la mise à jour, il est recommandé de relancer une fois SHAPER_CALIBRATE et de ne pas conserver les anciennes valeurs de fréquence.

4. Si max_accel_to_decel signale qu’il est obsolète, utilisez à la place :

   [printer]
   minimum_cruise_ratio: 0.5

Migration de configuration : Pour davantage de problèmes de migration après mise à jour, reportez-vous aux sections correspondantes de Erreurs de configuration.