Aller au contenu principal

Extension AI Guard

AI Guard est une extension de détection d'images Klipper préinstallée dans FLYOS-FAST v1.4.0. Elle peut lire périodiquement les images de la caméra et tenter d'identifier des anomalies d'impression telles que le spaghetti et le stringing.

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

AI Guard capture en continu les images de la caméra et exécute une inférence IA locale, ce qui augmente sensiblement 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 une anomalie d'ordonnancement Klipper, une interruption de communication MCU ou un échec direct de la tâche d'impression.

  • Ne pas activer lors d'impressions officielles, d'impressions de longue durée, d'impressions sans surveillance ou d'impressions de modèles importants.
  • Utilisable uniquement pour des tests de courte durée pouvant être arrêtés à tout moment, en surveillant en continu la charge système et les journaux Klipper.
  • La détection IA peut produire des faux positifs ou des faux négatifs, ne peut pas remplacer la surveillance humaine et ne peut pas servir de mécanisme de protection de sécurité de l'imprimante.

Version et état par défaut​

  • Disponible uniquement dans FLYOS-FAST v1.4.0.
  • Le système préinstalle 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 ne fonctionne pas 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é expérimentale de la v1.4.0, dont la précision de 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, du time-lapse, du proxy distant et d'autres plugins.
  • L'absence de signal de la caméra, une adresse d'instantané erronée ou un délai d'attente réseau lors de la récupération d'image peuvent affecter la détection.
  • L'exemple actuel n'active pas la pause automatique par défaut ; une fois activée, elle peut encore interrompre une impression normale en cas de fausse détection.
  • En cas de charge système excessive, l'AI Guard lui-même ainsi que le contrôle de l'impression peuvent devenir inopérants.
Loading...