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. 브라우저에서 fly-tools (포트 9999)에 접속할 수 없는 경우는 어떻게 하나요?

• FAST 시스템은 고도로 통합된 핵심 실행 환경으로, 기본적으로 fly-tools 웹 도구를 설치하지 않았기 때문에 9999 포트에는 서비스가 실행되지 않습니다. 이는 정상 설계입니다.

2. ⚠️ 중요: 시스템 구성 요소 업데이트 관련 안내

• FAST 시스템의 Klipper, Moonraker 등은 커스터마이징된 버전으로, 커뮤니티 공식 버전과 차이가 있습니다.

• 【핵심 원칙】명령줄이나 기타 비공식 경로를 통해 수동으로 업데이트하지 마십시오. 이 경우 시스템 최적화가 손상되어 호환성 문제 및 기능 오작동이 발생할 수 있습니다.
• 【올바른 방법】모든 구성 요소 업데이트는 다음 공식 경로를 통해 진행해야 합니다:
  • 시스템에 내장된 OTA 온라인 업데이트 기능 사용
  • 또는 최신 시스템 이미지를 다시 플래싱하여 전체 재설치

3. OTA 업데이트 시 주의해야 할 사항은?

1. 설정 파일 보안

• OTA 업데이트는 특별히 설계되어 사용자의 개인 설정 파일을 덮어쓰지 않거나 수정하지 않습니다.

2. 업데이트 중 주의 사항

• 업데이트 중에는 장치의 전원 공급이 안정되어야 합니다.
• 예기치 못한 정전은 업데이트 실패를 초래할 수 있으며, 심각한 경우 시스템을 다시 플래싱해야 할 수 있습니다.

3. 사용자 정의 코드 처리

• Klipper 설정 파일을 수정했거나 사용자 정의 플러그인을 설치한 경우
• OTA 업데이트 시 관련 파일은 자동으로 건너뛰어 사용자의 수정 사항이 보존됩니다.

4. 중요 안내: 펌웨어 업데이트

• OTA 업데이트 완료 후 반드시 수동으로 Klipper 펌웨어를 컴파일하고, 하위 장치에 펌웨어를 다시 플래싱하십시오.