본문으로 건너뛰기

AI Guard 확장 설명

AI Guard는 FLYOS-FAST v1.4.0 베타 이미지에 기본 내장된 Klipper 이미지 감지 확장 기능으로, 카메라 화면을 주기적으로 읽어 국수(스파게티) 및 실타래(스트링잉) 같은 인쇄 이상을 인식하려 시도합니다.

테스트 기능, 매우 높은 인쇄 실패 위험

AI Guard는 카메라 이미지를 지속적으로 가져와 로컬 AI 추론을 실행하므로 CPU, 메모리 및 저장 장치 부하가 눈에 띄게 증가합니다. 시스템 부하가 너무 높아지면 높은 확률로 Klipper 스케줄링 이상, MCU 통신 중단 또는 인쇄 작업의 직접적인 실패가 발생할 수 있습니다.

  • 정식 인쇄, 장시간 인쇄, 무인 인쇄 또는 중요한 모델 인쇄 시에는 활성화하지 마십시오.
  • 언제든지 중단할 수 있는 단기 테스트에서만 사용하고 시스템 부하와 Klipper 로그를 지속적으로 관찰하십시오.
  • AI 감지는 오탐 또는 누락이 발생할 수 있으며, 수동 모니터링을 대체할 수 없고 프린터 안전 보호 메커니즘으로도 사용할 수 없습니다.

버전 및 기본 상태​

  • FLYOS-FAST v1.4.0 베타 이미지에서만 확인되었습니다.
  • 시스템에 fly_ai_guard 확장, 모델 파일 및 fly-ai.cfg 예제가 기본 내장되어 있습니다.
  • 기본 printer.cfg에는 fly-ai.cfg가 로드되지 않으므로 AI Guard는 기본적으로 실행되지 않습니다.

활성화 전 준비​

  1. 먼저 카메라 스냅샷 주소가 정상적인 이미지를 반환하는지 확인하십시오.
  2. 프린터가 현재 인쇄 작업을 실행 중이 아닌지 확인하십시오.
  3. printer.cfg와 fly-ai.cfg를 백업하십시오.
  4. top 명령으로 AI Guard를 활성화하지 않은 상태의 시스템 부하를 관찰하여 비교 기준으로 삼으십시오.

참조 구성​

이미지의 예제 파일 위치는 다음과 같습니다:

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

GoCam 사용 시 다음을 참조할 수 있습니다:

[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 AI检测触发
매개변수v1.4.0 이미지 기본값설명
camerahttp://127.0.0.1/webcam/?action=snapshotAI Guard가 읽는 카메라 스냅샷 주소. GoCam 사용 시 http://127.0.0.1:8080/snapshot로 변경
cpu_affinity0,1,2AI 작업 프로세스가 사용할 수 있는 CPU 코어 번호
spaghetti_threshold0.5국수(스파게티) 감지 신뢰도 임계값
stringing_threshold0.5실타래(스트링잉) 감지 신뢰도 임계값
interval_time10.0두 감지 사이의 간격(초 단위)
discover_count1이상 이벤트가 트리거되는 연속 감지 횟수
print_onlyTrueTrue인 경우 인쇄 상태에서만 감지 수행
pause_on_discoverFalse트리거 횟수에 도달한 후 인쇄를 일시 중지할지 여부
discover_gcodeM118 AI检测触发트리거 조건 충족 후 실행되는 G-code
보수적인 매개변수 유지
  • 초기 테스트에서는 pause_on_discover: False를 유지하여 오탐으로 인한 즉시 인쇄 일시 중지를 방지하십시오.
  • 응답 속도를 높이기 위해 interval_time을 크게 줄이지 마십시오. 감지가 빈번할수록 시스템 부하가 높아집니다.
  • 단 한 번의 테스트만으로 감지 임계값을 낮추거나 자동 일시 중지를 활성화하지 마십시오.

확장 활성화​

printer.cfg에 다음을 추가합니다:

[include fly-ai.cfg]

저장 후 Klipper를 재시작합니다. 첫 테스트에서는 인쇄를 시작하지 말고 먼저 SSH로 다음을 실행합니다:

top

동시에 Klipper 로그를 확인합니다:

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

지속적인 높은 부하, Klipper 스케줄링 이상, MCU 연결 끊김, 카메라 이미지 캡처 실패 또는 AI worker 반복 재시작이 발생하면 즉시 AI Guard를 비활성화해야 합니다.

확장 비활성화​

printer.cfg에서 다음을 삭제하거나 주석 처리합니다:

[include fly-ai.cfg]

그런 다음 Klipper를 재시작합니다. pause_on_discover만 수정한다고 해서 AI 추론이 꺼지지는 않습니다. 리소스 점유를 중지하려면 전체 [fly_ai_guard] 구성 섹션의 로드를 중지해야 합니다.

알려진 제한 사항​

  • 이는 v1.4.0 베타 기능으로, 인식 정확도와 장기 안정성은 아직 검증되지 않았습니다.
  • 추론 부하는 KlipperScreen, 카메라, 타임랩스, 원격 에이전트 및 기타 플러그인과 중첩됩니다.
  • 카메라 신호 없음, 스냅샷 주소 오류 또는 네트워크 이미지 캡처 타임아웃은 감지에 영향을 미칩니다.
  • 현재 예제는 자동 일시 중지가 기본적으로 활성화되어 있지 않으며, 활성화하더라도 오탐으로 인해 정상 인쇄가 중단될 수 있습니다.
  • 시스템 부하가 너무 높으면 AI Guard 자체와 인쇄 제어 모두 작동하지 않을 수 있습니다.
Loading...