跳到主要内容

安装扫床插件方法

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