Aller au contenu principal

Extension AI Guard

AI Guard est une extension de détection d'images Klipper préinstallée dans l'image bêta FLYOS-FAST v1.4.0. Elle lit périodiquement les images de la caméra et tente de détecter des anomalies d'impression telles que les spaghettis et le filage.

Fonctionnalité de test, risque très élevé d'échec d'impression

AI Guard récupère en continu les images de la caméra et exécute une inférence IA locale, ce qui augmente considérablement la charge CPU, mémoire et stockage. Une fois la charge système trop élevée, il y a une très forte probabilité de provoquer des anomalies de planification Klipper, des interruptions de communication MCU ou un échec direct de la tâche d'impression.

  • Ne pas activer lors d'impressions officielles, de longues impressions, d'impressions sans surveillance ou d'impressions de modèles importants.
  • Utiliser uniquement pour des tests de courte durée pouvant être interrompus à tout moment, tout en surveillant en continu la charge système et les journaux Klipper.
  • La détection IA peut générer de faux positifs ou manquer des anomalies ; elle ne remplace pas la surveillance humaine et ne peut pas être utilisée comme mécanisme de sécurité de l'imprimante.

Version et état par défaut​

  • Confirmé uniquement dans l'image bêta FLYOS-FAST v1.4.0.
  • Le système inclut préinstallés l'extension fly_ai_guard, les fichiers de modèle et l'exemple fly-ai.cfg.
  • Par défaut, printer.cfg ne charge pas fly-ai.cfg, donc AI Guard n'est pas exécuté par défaut.

Préparation avant activation​

  1. Vérifiez d'abord que l'URL d'instantané de la caméra renvoie une image correcte.
  2. Confirmez que l'imprimante n'exécute actuellement aucune tâche d'impression.
  3. Sauvegardez printer.cfg et fly-ai.cfg.
  4. Utilisez top pour observer la charge système sans AI Guard activé, afin d'établir une référence de comparaison.

Configuration de référence​

Le fichier d'exemple dans l'image se trouve à :

/usr/share/printer_data/config/fly-ai.cfg

Avec GoCam, vous pouvez vous référer à :

[fly_ai_guard]
camera: http://127.0.0.1:8080/snapshot
cpu_affinity: 0,1,2
spaghetti_threshold: 0.5
stringing_threshold: 0.5
interval_time: 10.0
discover_count: 1
print_only: True
pause_on_discover: False
discover_gcode:
    M118 Détection IA déclenchée
ParamètreValeur par défaut image v1.4.0Description
camerahttp://127.0.0.1/webcam/?action=snapshotAdresse de l'instantané de la caméra lue par AI Guard ; avec GoCam, remplacez par http://127.0.0.1:8080/snapshot
cpu_affinity0,1,2Numéros de cœurs CPU autorisés pour le processus de travail IA
spaghetti_threshold0.5Seuil de confiance pour la détection de spaghettis
stringing_threshold0.5Seuil de confiance pour la détection de filage
interval_time10.0Intervalle entre deux détections, en secondes
discover_count1Nombre de détections consécutives avant de déclencher un événement d'anomalie
print_onlyTrueSi True, la détection n'est effectuée qu'en état d'impression
pause_on_discoverFalseSi mettre l'impression en pause après avoir atteint le nombre de déclenchements
discover_gcodeM118 Détection IA déclenchéeG-code exécuté lorsque les conditions de déclenchement sont atteintes
Maintenir des paramètres prudents
  • Lors des premiers tests, conservez pause_on_discover: False pour éviter qu'une fausse détection ne mette l'impression en pause directement.
  • Ne réduisez pas considérablement interval_time pour améliorer la réactivité ; plus la détection est fréquente, plus la charge système est élevée.
  • Ne baissez pas les seuils de détection ou n'activez pas la pause automatique sur la base d'un seul test.

Activation de l'extension​

Ajoutez dans printer.cfg :

[include fly-ai.cfg]

Enregistrez puis redémarrez Klipper. Pour le premier test, ne démarrez pas d'impression ; exécutez d'abord via SSH :

top

Consultez simultanément les journaux Klipper :

tail -f /usr/share/printer_data/logs/klippy.log

Si une charge élevée persistante, des anomalies de planification Klipper, une perte de connexion MCU, un échec de capture d'image de la caméra ou des redémarrages répétés du worker IA apparaissent, désactivez immédiatement AI Guard.

Désactivation de l'extension​

Supprimez ou commentez dans printer.cfg :

[include fly-ai.cfg]

Puis redémarrez Klipper. Modifier uniquement pause_on_discover ne désactive pas l'inférence IA ; pour arrêter l'utilisation des ressources, vous devez cesser de charger l'intégralité de la section de configuration [fly_ai_guard].

Limitations connues​

  • Il s'agit d'une fonctionnalité bêta de v1.4.0 ; la précision de la reconnaissance et la stabilité à long terme n'ont pas encore été validées.
  • La charge d'inférence s'ajoute à celle de KlipperScreen, de la caméra, de la timelapse, des agents distants et d'autres plugins.
  • Un signal de caméra absent, une adresse d'instantané erronée ou un délai de capture réseau trop long affecteront la détection.
  • L'exemple actuel n'active pas la pause automatique par défaut ; une fois activée, de faux positifs peuvent toujours interrompre une impression normale.
  • En cas de charge système excessive, AI Guard lui-même et le contrôle d'impression peuvent tous deux échouer.
Loading...