본문으로 건너뛰기

스캔 플러그인 설치 방법

Beacon 설치​

공식 설치 스크립트를 직접 실행하지 마세요

Beacon 현재 install.sh는 기본적으로 ~/klipper와 ~/klippy-env를 찾도록 되어 있어 FLYOS-FAST의 /data/klipper 경로와 호환되지 않습니다. 아래 절차는 Klipper 호스트 모듈만 설치하거나 업데이트하며, 프로브 펌웨어는 자동으로 업데이트되지 않습니다.

플러그인 가져오기 또는 업데이트​

이 단계에서는 해당 코드 호스팅 사이트에 정상적으로 연결되어 있어야 합니다. 명령이 성공적으로 실행된 후 소프트 링크 생성을 계속 진행하세요.

cd /data
if [ -d /data/beacon_klipper/.git ]; then
  git -C /data/beacon_klipper pull --ff-only
else
  git clone https://github.com/beacon3d/beacon_klipper.git /data/beacon_klipper
fi
Loading...

소프트 링크 생성​

ln -sfn /data/beacon_klipper/beacon.py /data/klipper/klippy/extras/beacon.py
if [ -d /data/klipper/.git/info ]; then
  grep -qxF 'klippy/extras/beacon.py' /data/klipper/.git/info/exclude || \
    echo 'klippy/extras/beacon.py' >> /data/klipper/.git/info/exclude
fi

systemctl restart klipper
Loading...

설치 경로 확인​

readlink -f /data/klipper/klippy/extras/beacon.py

출력은 /data/beacon_klipper/beacon.py여야 합니다. 소프트 링크를 사용한 후에는 플러그인 저장소만 업데이트하고 Klipper를 재시작하면 되며, beacon.py를 다시 복사할 필요가 없습니다.

IDM 또는 Scanner 설치​

플러그인은 하나만 선택하세요

IDM/Scanner와 Cartographer3D는 모두 idm.py와 scanner.py를 제공합니다. Klipper에서는 두 모듈 중 하나만 사용할 수 있으며, 두 플러그인의 파일을 혼합하지 마세요.

플러그인 가져오기 또는 업데이트​

새 버전의 IDM 설치 스크립트는 이미 FLYOS-FAST의 /data/klipper 경로를 지원하며, idm.py, scanner.py, scanner_touch_mesh.py를 설치합니다:

cd /data
if [ -d /data/IDM/.git ]; then
  git -C /data/IDM pull --ff-only
else
  git clone https://gitee.com/NBTP/IDM.git /data/IDM
fi
Loading...

이 단계에서는 Gitee에 정상적으로 연결되어 있어야 합니다. 명령이 성공적으로 실행된 후 설치 스크립트를 계속 실행하세요.

설치 스크립트 실행​

설치 단계는 네트워크에 접근하지 않습니다. IDM/Scanner로 전환하기 전에 Cartographer3D에서 남긴 동일한 이름의 플러그인 진입점을 제거합니다:

rm -f /data/klipper/klippy/extras/cartographer.py
cd /data/IDM
chmod +x install.sh
./install.sh
systemctl restart klipper
Loading...

스크립트에 idm: installation successful.이 표시되고 Klipper 재시작 후 관련 오류가 없으면 모듈 설치가 완료된 것입니다.

설치 경로 확인​

readlink -f /data/klipper/klippy/extras/idm.py
readlink -f /data/klipper/klippy/extras/scanner.py
readlink -f /data/klipper/klippy/extras/scanner_touch_mesh.py

위 경로는 /data/IDM/의 해당 파일을 가리켜야 합니다.

Cartographer3D 설치​

공식 설치 스크립트를 직접 실행하지 마세요

Cartographer3D 현재 install.sh는 기본적으로 ~/klipper와 ~/klippy-env를 찾도록 되어 있어 FLYOS-FAST의 /data/klipper 경로와 호환되지 않습니다. 아래 명령을 사용하여 설치하세요.

플러그인 가져오기 또는 업데이트​

이 단계에서는 GitHub에 정상적으로 연결되어 있어야 합니다. 명령이 성공적으로 실행된 후 소프트 링크 생성을 계속 진행하세요.

cd /data
if [ -d /data/cartographer-klipper/.git ]; then
  git -C /data/cartographer-klipper pull --ff-only
else
  git clone https://github.com/Cartographer3D/cartographer-klipper.git /data/cartographer-klipper
fi
Loading...

소프트 링크 생성​

설치 단계는 네트워크에 접근하지 않습니다. Cartographer3D로 전환하기 전에 IDM/Scanner 전용 scanner_touch_mesh.py를 제거합니다:

rm -f /data/klipper/klippy/extras/scanner_touch_mesh.py
for file in idm.py scanner.py cartographer.py; do
  ln -sfn "/data/cartographer-klipper/$file" "/data/klipper/klippy/extras/$file"
  if [ -d /data/klipper/.git/info ]; then
    grep -qxF "klippy/extras/$file" /data/klipper/.git/info/exclude || \
      echo "klippy/extras/$file" >> /data/klipper/.git/info/exclude
  fi
done

systemctl restart klipper
Loading...

이 절차를 통해 이전 버전에서 직접 복사한 모듈도 소프트 링크로 교체할 수 있으며, 이후 저장소를 업데이트할 때 Python 파일을 다시 복사할 필요가 없습니다.

설치 경로 확인​

readlink -f /data/klipper/klippy/extras/idm.py
readlink -f /data/klipper/klippy/extras/scanner.py
readlink -f /data/klipper/klippy/extras/cartographer.py

위 경로는 /data/cartographer-klipper/의 해당 파일을 가리켜야 합니다.

BDsensor 설치​

하위 컴퓨터 펌웨어를 다시 컴파일해야 합니다

BDsensor는 Klipper 호스트 모듈을 제공할 뿐만 아니라 Klipper MCU 소스 코드에 BD_sensor.c를 추가합니다. 설치 완료 후 반드시 make_with_bdsensor.sh를 사용하여 센서가 연결된 하위 컴퓨터 펌웨어를 다시 컴파일하고 플래시해야 합니다.

플러그인 가져오기 또는 업데이트​

이 단계에서는 GitHub에 연결되어 있어야 합니다. 가져오기가 성공한 후 로컬 설치 단계를 실행하세요.

cd /data
if [ -d /data/Bed_Distance_sensor/.git ]; then
  git -C /data/Bed_Distance_sensor pull --ff-only
else
  git clone https://github.com/markniu/Bed_Distance_sensor.git /data/Bed_Distance_sensor
fi
Loading...

소프트 링크 생성​

상위 저장소의 install_BDsensor.sh는 기본적으로 ~/klipper를 찾고 Klipper 디렉터리에 .git/info가 있다고 가정하므로 FLYOS-FAST v1.4.0과 완전히 호환되지 않습니다. 다음 명령을 사용하여 설치하세요:

ln -sfn /data/Bed_Distance_sensor/klipper/BDsensor.py /data/klipper/klippy/extras/BDsensor.py
ln -sfn /data/Bed_Distance_sensor/klipper/BD_sensor.c /data/klipper/src/BD_sensor.c
ln -sfn /data/Bed_Distance_sensor/klipper/make_with_bdsensor.sh /data/klipper/make_with_bdsensor.sh
grep -qF 'BD_sensor.c' /data/klipper/src/Makefile || \
  echo 'src-y += BD_sensor.c' >> /data/klipper/src/Makefile

systemctl restart klipper
Loading...

설치 경로 검증​

readlink -f /data/klipper/klippy/extras/BDsensor.py
readlink -f /data/klipper/src/BD_sensor.c
readlink -f /data/klipper/make_with_bdsensor.sh
systemctl is-active klipper

세 개의 심볼릭 링크는 /data/Bed_Distance_sensor/klipper/ 내의 해당 파일을 가리켜야 하며, 서비스 상태는 active를 반환해야 합니다.

BDsensor 구성, 컴파일 및 보정: BDsensor 사용 설명서 보기

Loading...