现在Klipper流行的操作界面,流行两个软件Mainsail与Fluidd。下是以Fluidd为基础写的,未来会删除,因为我用的是Mainsail。
- 今后推荐使用Mailsail,因为在github上比较活跃,具体安装也很简单,请参考这个文档。
在看本节,请先看蜘蛛 2.3 硬件部分。建议将树莓派,蜘蛛的内置软件配置好了,再安装到机器上。
这个文档仅限于我购买的硬件设备进行接线。
- 蜘蛛 2.3:这个版本与 2.2 的接线方式不一样。不要看错文档了。
- TMC2209
- 树莓派 3B+
目前 Klipper 的可视化操作界面主要有以下 3 种:
- Octoprint 官方主页: https://octoprint.org/
- Mainsail 官方主页: https://docs.mainsail.xyz/
- Fluidd 官方主页: https://docs.fluidd.xyz/
本文主要以目前较为活跃的轻量级系统–Fluidd 来介绍 Klipper 的安装及使用。以上所说的 Fluidd、 klipper 等等一系列软件并不是直接在打印机主板上用的,而是需要安装在树莓派里的,这就需要有一定 linux 操作知识。
1 烧录 FluiddPI 镜像
Fluidd 官网提供了树莓派系统的专用镜像–FluiddPI,这个镜像已经预安装了 Fluidd、Klipper、 Moonraker 及一些必须的系统依赖。
1.1 硬件准备
- 树莓派 3B、3B+或者 4B
- 一张不小于 16G 的 TF 存储卡
- 一个 TF 读卡器
- 一台安装有 windows 操作系统的 PC。
1.2 软件准备
- SDformatter v4.0 及以上版本 (格式化 SD 卡工具,可以使用 win10 自带的格式化)https://www.sdcardformatter.com
- balenaEtcher v1.5 及以上版本 下载地址:https://www.balena.io/etcher/
- xshell 下载地址:https://www.xshell.com/zh/xshell/
- WinSCP 最新版本 下载地址:https://winscp.net/eng/docs/lang:chs
- FluiddPI 最新镜像 下载地址: https://docs.fluidd.xyz/installation/fluiddpi
- 是从 github 下载,科学无边际,绕道香港下载的。速度还挺快
1.3 烧录镜像
- 首先将 SD 卡格式化成 FAT32 格式。
- 接着使用 balenaEtcher 烧录镜像
- 选取 FluiddPI 镜像文件
- 选择 SD 卡
- 开烧录
2 树莓派接入网络
当然最简单的是用网线接入网络,当然现在流行设置无线网络,但是这一步也容易错误。
这一步最容易出现的错误
- 现在路由器都是 2.4 与 5G 赫兹了,但是树莓派 3B 只支持 2.4G 赫兹,但是你设置的 SSID 是 5G 赫兹,当然连接不上了。插网线就一了百了。
- 树莓派默认的
WIFI contry
是英国,中国刚好不一样,所以要设置。
2.1 方法 1:命令输入
这种适合有网线,或者有键盘+显示器,对 linux 系统比较熟悉。我是用的这个方法。
#修改密码password #进行配置sudo raspi-config## 设置无线网络 System Options -> Wireless LAN### 一定要配置中国,因为天朝的比较特殊Localization Options -> change WIFI contry -> China## 通过以下方式更改时区。Localization Options -> Timezone## 通过 更改区域设置。Localization Options -> Locale 这个我没有修改,用en-utf8挺好的,不容易出错。## 通过 更改主机名 System Options -> Hostmane
2.2 方法 2:修改文件
网上推荐的,但是感觉没有设置 WIFI contry
,就没用。下面方法,适合没有外接显示器、键盘、有线网络。 很方便操作,但是大部分问题也出现在这里。
- 不要为此使用写字板(Windows)或文本编辑(MacOS X),已知这些编辑器会破坏文件,使配置失败。改用 Notepad++,Atom 或 VSCode 之类的东西,或者至少注意文件中的警告。a. *注意:*通常,连接问题可以归结为 WiFi 问题。如果遇到问题,请尝试插入以太网电缆。
将树莓派连入无线网络。
安全弹出读卡器,并重新插入读卡器。系统将识别到一个 256M 大小的分区,打开该分区找到 “fluiddpi-wpa-supplicant.txt“。使用 Notepad++打开该文件找到下列字段
使用 Notepad++打开该文件找到下列字段
删除相关设置的注释符“#”,设置路由器热点名称及连接密码,保存退出
将 TF 卡插入树莓派接通电源,树莓派将自动启动。启动期间,绿色的指示灯将无规律闪烁。约 1 分钟 左右,启动完成。
3 验证 FluiddPI 烧录情况
在浏览器地址栏输入上述 IP 地址,可以打开 Fluidd 的 Web 页面。第一次打开,由于还没有正确的配 置 klipper,状态栏会有报错信息,当我们正确配置了 klipper 后,这些报错信息将会消失
4 配置树莓派
现在我们要利用 klipper 来生成一个蜘蛛主板的固件,蜘蛛主板刷入 了这个固件之后,才能接受 klipper 的指令,控制相应的电机、热床,反馈传感器信息等。
4.1 SSH 接入树莓派
树莓派的 linux 的系统连入网络后,可以通过 SSH 进行远程设置。它不像我们传统的 windows 操作系统, 有图形界面,所有的操作都要通过键盘输入文本或者命令来执行,所以接下来先给大家介绍如何远程连 接到树莓派。
在 xshell 中输入:
接受并保存安全密钥,输入用户名:pi,密码:raspberry
注意:为了安全起见,建议使用 sudo raspi-config 命令进入树莓派配置界面,通过 System Options>–Password 选项更改密码。
4.2 设置树莓派更新源
由于历史原因老版本的树莓派使用的是 Buster,新版本是 Bullseye。
4.2.1 换国内源
在 shell 中输入
# 安装vim,不然vi在XShell7下,使用上下键有问题。sudo apt install vimsudo vim /etc/apt/sources.list # 取消vim的鼠标模式,好从xshell中将下面的代码复制到vim中:set mouse=
进入文档编辑界面,将原国外服务器地址前加#进行注释,换行输入国内镜像服务器地址:
deb http://mirrors.ustc.edu.cn/raspbian/raspbian/ bullseye main contrib non-free rpi
然后保存,具体如下图:
4.2.2 修改系统源
sudo vim /etc/apt/sources.list.d/raspi.list # 取消vim的鼠标模式,好从xshell中将下面的代码复制到vim中:set mouse=
进入文档编辑界面,将原国外服务器地址前加#进行注释,换行输入国内镜像服务器地址:
deb http://mirrors.ustc.edu.cn/archive.raspberrypi.org/debian/ bullseye main
见下图
4.3 升级树莓派软件
更换好国内源,就可以对树莓派的系统和软件进行升级,新的系统和软件会修复一些已知的 bug,建议升级。(此步骤不是必须的,也可跳过)
# 约 5-10 分钟左右升级完毕。sudo apt-get update && sudo apt-get upgrade -y# 升级完毕,重启树莓派sudo reboot
4.4 升级 klipper
klipper 不是 linux 自带的软件,所以还是需要手动升级。新的版本会支持一些新的功能,建议及时升级。升级方法如下,重新连接 SSH。
cd ~/klipper && git pull
约 1-2 分钟左右会自动执行完升级。升级成功后会有如下显示 有些时候,由于服务器连接速度等原因,可能会升级不成功,可重复执行命令进行升级。
5 编译蜘蛛固件
在树莓派中编译。虽然蜘蛛主板在它的 github 上提供了编译好的文件。但是必须自己编译,因为你用的 klipper 版本可能与蜘蛛的不一样。
在蜘蛛的 github 上FYSETC-SPIDER\说明文档_中文.md
中有各种详细的说明,这里只针对我购买的蜘蛛主板的编译进行说明。
5.1 执行 menuconfig
cd ~/klipper && make menuconfig
请在编译时,给蜘蛛主板选择以下的选项,有些选项是多选的,根据自己的主板和机器的情况进行选择。
- Enable
extra low-level configuration options
- Micro-controller Architecture
- 选择
STMicroelectronics STM32
- 选择
- Processor model
- 选择
STM32F446
- 选择
- Clock reference
- 选择
12 MHz crystal
- 选择
- Bootloader offset
- 请选择
32KiB bootloader
偏移,如下图蓝色部分。自 2021/06/23 之后买的蜘蛛,不需要刷,因为出厂时蜘蛛自带32k bootloader
。 如果你真要刷,那么看看蜘蛛 github 上的文档。
- 请选择
- Communication interface
- 这个选项有两个选择:使用 USB 线连接树莓派和蜘蛛主板、使用串口线连接树莓派和蜘蛛主板。 我用的是串口线,所以只写了串口线的配置。使用 USB 的看蜘蛛的文档。
- 如果使用串口连接树莓派和蜘蛛,选择选项
Serial (on USART1 PA10/PA9)
- 上面配置完毕后,点击 q 退出,并保存。
5.1.1 修改 printer.cfg 文件
现在还不用配置,但是后续需要配置。具体可以见第 7 章内容
除了编译配置文件以外,还需要进行下面的配置,后续会说明
此外在你的 printer.cfg
中, serial 部分需要使用如下的配置。我们提供了一个 VORON 2.4 的配置文件示例进行参考,在 github gitee.
serial: /dev/ttyAMA0
5.1.2 修改树莓派 uart 设置
这个可以现在做。
除了要修改 serial 的配置之外,你还需要根据 Connect RPI uart_中文版.md
说明文件配置树莓派,这个说明文件在 github gitee.
移除 USB 控制
SSH
进你的树莓派。然后编辑 /boot/config.txt
文件.
sudo vim /boot/cmdline.txt
移除文件中的 “console=serial0,115200” 或者 “console=ttyAMA0,115200” 部分,然后保存退出。
sudo reboot
配置 raspi-config
再次 SSH
进树莓派系统。
sudo raspi-config
=> Interfacing Option
=> Serial
=> NO
=> YES
=> Ok
=> Finish
=> Yes
修改 config.txt
然后重启树莓派,并再次SSH
进树莓派系统。
sudo vim /boot/config.txt #进入vim后,要屏蔽鼠标模式,这样可以复制黏贴 :set mouse=
然后把下面这行添加到文件的末尾,并保存退出。
dtoverlay=pi3-disable-bt
再次重启即可。
sudo reboot
5.2 编译固件
先清空一下已经编译的内容,然后编译
make cleanmake
编译完成,会显示当前 klipper 的版本号,生成 的固件名称为 klipper.bin,存放在~/klipper/out 目录下。
5.3 上传固件
蜘蛛提供了 4 种上传固件的方法:
- TF 卡:需要有一个单独的 TF 卡(SD 卡)
- dfu-util 方式:只适用于 linux 系统
- DFU 方式:只适用于 windows 系统
- platformio 方式:只适合于采用 platformio 编译 Marlin 固件的情况
本次只给出 TF 卡的方法,其他的方法看蜘蛛的文档。
蜘蛛主板出厂时自带 bootloader(引导程序),可以采用 TF 卡进行固件上传。
5.3.1 将文件复制到 SD 卡
用 SD 进行固件更新,只需要把你编译好的 firmware.bin
文件(如果是 klipper 固件的话,默认生成 klipper.bin
你需要把 klipper.bin
改名成 firmware.bin
)拷贝到你的 TF 卡中。
5.3.2 将 SD 卡插入主板
插入蜘蛛主板的 TF 卡槽中
5.3.3 给主板上电烧录
给主板上电分两种:使用 24 外接上电;通过 USB 上电,USB 模式只建议在 debug 模式下使用。
具体上电操作如下:
- 将跳线帽跳到 5V 供电。具体怎么跳,看硬件的主板图说明。
- 将主板附带的 USB 线,一端插入电脑,一端插入主板,就开始上电了。
给蜘蛛上电,指示灯开始闪烁表示开始烧录,TF 卡旁边的指示灯不再闪烁即烧录完成。 重点提示:操作完毕,拔下 USB 线后,一定要将跳线帽重新跳回。
5.3.4 验证是否成功
拔下 TF 卡,然后插到电脑上,你会发现 firmware.bin
被重新命名为 old.bin
,说明烧录成功。如果名称不变,说明没有烧录成功。
5.4 测试固件
此步可以不做。
如果怀疑你的主板有问题,可以使用测试固件来进行测试。根据对应链接 (github gitee) 的 README 来操作。
蜘蛛给出了一些常见的错误,具体看蜘蛛的文档
6 读取主板 ID
只有在 USB 模式下才读取主板,因为有多个 USB。但是在 UART 下就不需要了。
主板的 ID 是主板的唯一识别码,klipper 可以通过识别 ID 来同时控制多块主板协同工作,这个 ID 也是 klipper 配置文件里必不可少的参数,下面就来看下如何读取 ID。
- 连接树莓派与主板,并都通上电。
- 输入下面命令
- ls /dev/serial/by-id/*
- 如果主板的固件烧录正确,将会有如下显示,复制出来备用。
7 修改 printer.cfg
Klipper 安装到这里,还会遇到好多错误提示,需要操作的内容比较多,专门放在首次打印里面说明