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 펌웨어를 컴파일하고, 하위 장치에 다시 펌웨어를 플래싱해야 합니다.