FAST 시스템 사용 가이드 및 주의사항

시스템 특징 및 설계 설명

1. 시스템 사용자 설명

• FAST 시스템은 극한의 경량성과 보안성을 추구하여 싱글 유저 모드를 채택하였습니다.
• 유일한 사용자: root
• 제한 사항: 시스템은 다른 사용자 계정 생성 또는 전환을 지원하지 않습니다.

2. 패키지 관리

• FAST 시스템은 경량성과 빠른 부팅을 유지하기 위해 apt와 같은 전통적인 패키지 관리자를 통합하지 않았으므로, apt update와 같은 명령어를 실행할 수 없습니다.
• 사전 설치 소프트웨어: 시스템에는 Klipper 생태계 및 일상 유지보수에 필요한 일반 도구들이 이미 내장되어 있습니다.
• 소프트웨어 요구 사항: 추가적인 소프트웨어 패키지가 필요하신 경우, 저희에게 피드백을 주시기 바랍니다. 귀하의 요청을 검토하여 향후 버전에 사전 설치 여부를 고려하겠습니다.

3. 파일 시스템 및 영구 저장

• 수정 가능한 경로: 시스템 코어의 무결성을 보장하기 위해, FAST 시스템은 /etc 및 /data 디렉터리 내의 파일만 수정을 허용합니다.
• 제한 사항 설명: 시스템의 다른 디렉터리는 모두 읽기 전용이며, 어떤 변경 사항도 저장되지 않습니다. 사용자 정의 설정 및 데이터는 위의 두 지정 디렉터리에 저장하시기 바랍니다.

4. 시스템 업데이트 전략

FAST 시스템은 두 가지 업데이트 방식을 지원합니다:

OTA 온라인 업데이트(권장)

• V1.3.0 버전부터 FAST 시스템은 OTA 업그레이드를 지원합니다.
• 업데이트 진입점: 상위 컴퓨터의 IP 주소:9998 포트에 접속하여 시스템 OTA 업데이트 페이지로 들어갈 수 있습니다.
• 중요 안내 사항:
  • 시스템 업데이트를 시작하기 전에 모든 인쇄 작업을 일시 중지하시기 바랍니다.
  • 업데이트 중 시스템 서비스가 재시작되므로 인쇄 작업을 하지 마시기 바랍니다. 그렇지 않으면 인쇄 실패 또는 하드웨어 제어 불능 상태가 발생할 수 있습니다.

플래싱 업데이트

• 적용 상황: 시스템이 정상적으로 부팅되지 않을 때 사용합니다.
• 중요 경고:
  • 플래싱 전 구성 설정 백업 필수: 플래싱 과정에서 모든 사용자 데이터가 삭제되므로, 반드시 프린터 시스템 설정을 미리 백업하시기 바랍니다.
  • 플래싱 완료 후 수동으로 백업한 구성 파일을 복원해야 합니다.
• 플래싱 방법: 공식 제공 플래싱 튜토리얼과 도구를 참조하시기 바랍니다.

경로 및 환경 차이점

펌웨어 생성 위치

• FAST 시스템에서 Klipper 펌웨어 컴파일이 성공적으로 완료되면 생성된 펌웨어 파일은 다음 위치에 저장됩니다:

/data/klipper/out/

설정 파일 위치

• FAST 시스템 내에서

펌웨어 버전	Klipper 설정 경로	RRF 설정 경로
펌웨어 설정 경로	Loading...	Loading...

Python 환경 차이점

FAST 시스템은 Klipper 공식 추천 Python venv 가상 환경을 사용하지 않고, 전역 Python 환경을 사용합니다. 이로 인해 Klipper 환경의 Python 스크립트 명령어를 호출하는 데 필요한 모든 명령어가 조정되어야 합니다.

핵심 수정 사항: 명령어 내의 ~/klippy-env/bin/python을 python으로 교체합니다.

시나리오 설명	표준 시스템 명령어	FAST 시스템 명령어
CANBUS UUID 조회	Loading...	Loading...

일반 문제: 명령어 실행 시 다음과 같은 오류가 발생할 수 있습니다:

-bash: ~/klippy-env/bin/python: No such file or directory

해결 방법: 위 표에 따라 명령어 내 Python 인터프리터 경로를 교체하면 됩니다.

구성 요소 설치 가이드

이 문서는 FAST 시스템에서 Klipper 플러그인을 설치하는 일반적인 방법을 설명합니다.

일반 설치 단계

대부분의 Klipper 플러그인은 다음 간단한 단계를 통해 설치할 수 있습니다:

1. /data 디렉터리에 구성 요소 다운로드

   cd /data
   git clone [플러그인 저장소 주소]

2. 필요한 Python 파일을 Klipper 확장 디렉터리로 복사

   cp /data/[플러그인 디렉터리]/[플러그인 주 파일].py /data/klipper/klippy/extras/

3. Klipper 서비스 재시작하여 적용

   systemctl restart klipper

중요 안내 사항

• 파일 선택: 플러그인 문서를 확인하여 복사해야 할 구체적인 Python 파일을 확인하시기 바랍니다. 모든 .py 파일을 무작정 복사하지 마십시오.
• 의존성 검사: 설치 전 플러그인이 특별한 의존성 요구 사항이 있는지 확인하시기 바랍니다.
• 버전 호환성: 플러그인 버전이 사용 중인 Klipper 버전과 호환되는지 확인하시기 바랍니다.

의존성 설명

주의 사항: FlyOS_FAST-V1.3.0 이상 버전을 사용하시는 경우, 시스템에 일반적인 의존성들이 이미 내장되어 있어 추가 설치가 필요하지 않습니다.

일반 구성 요소 설치 예시

Beacon 3D 프로브

cd /data && git clone https://github.com/beacon3d/beacon_klipper.git
cp /data/beacon_klipper/beacon.py /data/klipper/klippy/extras/

IDM 또는 Scanner

cd /data && git clone https://gitee.com/NBTP/IDM.git
cp /data/IDM/idm.py /data/klipper/klippy/extras/
cp /data/IDM/scanner.py /data/klipper/klippy/extras/

Cartographer 3D

cd /data && git clone https://github.com/Cartographer3D/cartographer-klipper.git
cp /data/cartographer-klipper/idm.py /data/klipper/klippy/extras/
cp /data/cartographer-klipper/scanner.py /data/klipper/klippy/extras/
cp /data/cartographer-klipper/cartographer.py /data/klipper/klippy/extras/

주의 사항

1. 설치 위치: 모든 사용자 정의 구성 요소는 /data 디렉터리에 통일하여 설치하시기 바랍니다.
2. 파일 확인: 복사 전 파일의 용도를 확인하시고, 중요한 파일을 덮어쓰지 않도록 주의하시기 바랍니다.
3. 서비스 재시작: 설치 완료 후 Klipper 서비스를 재시작해야 적용됩니다.
4. 문제 해결: 설치 후 이상이 발생하면 복사한 파일이 올바른지 확인하시기 바랍니다.

자주 묻는 질문

1. 9999 포트의 fly-tools에 접근할 수 없는 이유는 무엇인가요?

FAST 시스템은 핵심 실행 환경으로서 기본적으로 fly-tools 웹 도구를 사전 설치하지 않았습니다.

2. 왜 시스템은 Klipper 등의 구성 요소를 웹에서 한 번에 업데이트할 수 없는가요?

• 원인: FAST 시스템에 사전 설치된 Klipper, Moonraker 등의 핵심 구성 요소는 심층적인 최적화 및 2차 개발이 적용된 커스텀 버전으로, 공식 버전과 차이가 있습니다.
• 권장 사항:
  • 이러한 구성 요소들을 명령어로 수동 업데이트하는 것은 시스템 불안정, 기능 오작동 또는 최적화 효과 상실을 초래할 수 있으므로 수동 업데이트를 절대 권장하지 않습니다.
  • 모든 핵심 구성 요소의 기능 업데이트 및 보안 패치는 OTA 방식 또는 최신 이미지를 다시 플래싱하여 업데이트해야 합니다.