Plugin d'analyse de résonance Klippain Shake&Tune

Klippain Shake&Tune est un plugin Klipper d'analyse de résonance et de calibrage de l'Input Shaper, capable de générer des graphiques visuels à partir des données de vibration collectées par l'accéléromètre, aidant à diagnostiquer les problèmes mécaniques et à optimiser les filtres de l'Input Shaper.

Utilisateurs FlyOS-FAST

FlyOS-FAST v1.3.5 et versions ultérieures incluent Shake&Tune préinstallé, aucune installation manuelle n'est nécessaire. Il suffit d'ajouter la section de configuration [shaketune] dans printer.cfg puis de redémarrer.

Pour les paramètres de configuration complets et les explications, veuillez consulter : Documentation du plugin Shake&Tune FlyOS-FAST

Installation

Veuillez utiliser un outil SSH pour vous connecter à l'ordinateur hôte et vérifier les conditions suivantes :

1. Le firmware Klipper est installé sur l'ordinateur hôte.
2. L'accéléromètre (ADXL345, LIS2DW, etc.) est installé et correctement configuré, et ACCELEROMETER_QUERY retourne correctement les données.
3. La section [resonance_tester] est définie dans printer.cfg.

Récupérer ou mettre à jour le plugin

Cette étape nécessite une connexion à GitHub. Après avoir confirmé que la récupération a réussi, exécutez le script d'installation.

cd ~
if [ -d ~/klippain-shaketune/.git ]; then
  git -C ~/klippain-shaketune pull --ff-only
else
  git clone https://github.com/Frix-x/klippain-shaketune.git ~/klippain-shaketune
fi

Exécuter le script d'installation

cd ~/klippain-shaketune
chmod +x install.sh
./install.sh
systemctl restart klipper

Si vous utilisez le système FlyOS-FAST, le chemin d'installation doit être ajusté vers le répertoire /data/, veuillez vous référer à la documentation dédiée FlyOS-FAST ci-dessus.

Ajouter la section de configuration

Ajoutez dans printer.cfg :

[shaketune]
# result_folder: ~/printer_data/config/ShakeTune_results
#    Chemin de sauvegarde des résultats, le dossier est créé automatiquement s'il n'existe pas
# number_of_results_to_keep: 10
#    Nombre de résultats récents à conserver, les anciens fichiers sont automatiquement nettoyés au-delà de cette limite
# keep_raw_data: False
#    Mettre sur True pour également sauvegarder les fichiers .stdata bruts afin de faciliter le diagnostic ou l'envoi de retours
# show_macros_in_webui: True
#    Afficher les boutons des macros Shake&Tune dans l'interface web Fluidd / Mainsail
# timeout: 600
#    Temps maximum (en secondes) pour la génération des graphiques, peut être augmenté sur les appareils à faibles performances

Enregistrez et redémarrez Klipper.

Vérifier l'installation

systemctl is-active klipper

Une fois que active est retourné, saisissez des commandes macro telles que TEST_RESONANCES dans la console web pour confirmer que les commandes sont reconnues.

Commandes macro disponibles

Une fois l'installation terminée, les commandes macro suivantes peuvent être utilisées dans la console web ou en G-code :

Macro	Fonction
TEST_RESONANCES AXIS=X	Mesure la résonance de l'axe X et génère un graphique de spectre avec des paramètres Input Shaper suggérés
TEST_RESONANCES AXIS=Y	Mesure la résonance de l'axe Y et génère un graphique de spectre
TEST_RESONANCES AXIS=X OUTPUT=raw_data	Collecte uniquement les données brutes, sans génération automatique de graphiques
COMPARE_RESONANCES	Compare les deux dernières mesures de résonance pour observer l'effet des ajustements
BELTS_SHAPER_TUNING	Test de résonance des courroies dédié, génère un graphique de comparaison de spectres avec fenêtre de Hanning

À chaque exécution, Shake&Tune génère des fichiers graphiques PNG dans result_folder, consultables directement via le gestionnaire de fichiers Fluidd / Mainsail.

Différences avec les commandes intégrées de Klipper

Shake&Tune ne remplace pas SHAPER_CALIBRATE intégré à Klipper, mais fournit des analyses visuelles plus riches en complément :

Fonctionnalité	Intégré à Klipper	Shake&Tune
Calcul automatique des paramètres Input Shaper	SHAPER_CALIBRATE écrit directement dans la configuration	TEST_RESONANCES génère des graphiques de référence
Graphiques visuels du spectre	Aucun	Génère automatiquement des graphiques de spectre PNG
Comparaison de la tension des courroies	Aucune	BELTS_SHAPER_TUNING génère un graphique de comparaison
Comparaison de plusieurs mesures	Aucune	COMPARE_RESONANCES compare les derniers résultats

Les commandes intégrées conviennent à un calibrage automatique rapide ; Shake&Tune est adapté aux scénarios où l'on souhaite consulter le spectre détaillé, diagnostiquer des problèmes mécaniques ou comparer la tension des courroies.

Problèmes courants

Délai d'attente dépassé pour la génération des graphiques

La génération de graphiques sur les appareils à faibles performances peut expirer. Augmentez la valeur de timeout dans [shaketune], par exemple timeout: 900.

Aucun fichier généré dans le dossier des résultats

Vérifiez que le chemin result_folder existe et que Klipper dispose des droits d'écriture.

Erreur ACCELEROMETER_QUERY après l'installation

Shake&Tune n'affecte pas la communication sous-jacente de l'accéléromètre. Si une erreur de communication apparaît après l'installation, veuillez d'abord diagnostiquer le matériel et la configuration en suivant Test et calibration de l'accéléromètre.

Configuration et test de l'accéléromètre : Voir le test et la calibration de l'accéléromètre

Compensation de résonance et réglage de l'Input Shaper : Voir la compensation de résonance et les problèmes de configuration de la pression anticipée