본문으로 건너뛰기

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 펌웨어를 수동으로 컴파일하고, 하위 시스템 펌웨어를 다시 플래싱하십시오.
Loading...