본문으로 건너뛰기

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: 해당 파일이나 디렉터리가 없습니다

해결 방법: 위 표와 같이 명령어의 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 또는 스캐너​

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. 문제 해결: 설치 후 이상이 발생하면 복사한 파일이 올바른지 확인하십시오

자주 묻는 질문 (FAQ)​

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...