KlipperBoxOS 使用教程

前言

原创文章，转载引用请务必注明链接，水平有限，如有疏漏，欢迎指正交流。

本文是 KlipperBoxOS(以下简称 KbOS ) 的使用指南，向你介绍它的基本使用方法与不同之处。本文将会持续更新，请访问原文链接获取最新的内容和更好的阅读体验。

版本：2022年12月13日 第 1 版，by 思兼
【2023-2-15更新】：

• 实装log_uploader，支持一键上传配置文件、宕机日志、系统负载图
• 实装WebSSH，可以直接在网页打开终端
• 默认界面语言更改为中文
• 支持从旧版Kbox OS 升级
  【2023年2月21日】发布 KlipperBoxOS v2.1：
• 禁用 ipv6，提升网络访问速度，可以使用 armbian-config 重新开启
• 默认SSH界面语言为中文
• 修复终端中文显示不正确的问题
• 添加 WebSSH 终端，:8090
• 添加 PGcode 实时预览跟踪模型打印进度
• 升级使用 crowsnest 摄像头服务，默认禁止，使用sudo systemctl enable --now crowsnest 启用开机自启
• 预装 Klipper + Moonraker + Fluidd + KlipperScreen + Crwosnest 最新版
• 使用 APT/github/pypi 国内镜像源，加速下载升级
• 升级内核为 5.15 主线 LTS，支持 CAN 工具板
• 增加方便的无线网络管理界面，:9527
• 支持 http://kbox.local 直接访问，无需知道设备IP地址(需要支持 mDNS，不支持 Android)
• 优化了系统空间占用，可用空间增加
• 重新编译优化了无线网卡驱动，更稳定
• 修复 Fluidd 网页界面关机/重启功能
• 支持一键提取配置文件、最近一次宕机日志，自动生成负载图，并上传，方便远程调试
• 添加查询设备id的快捷命令
• 部分主板支持一键编译固件
• 修复 Arduino Uno/Nano 等的固件编译问题（Atmel 328p）
• 修复 Duet2WiFi 等的固件编译问题
  【2023年3月2日】优化zram逻辑，支持大模型延时摄影渲染
  【注意】
  智能插座如果修改结束Gcode后无法生效，请在_ON_OFFF_CHECK命令上增加一行M400，等待之前运动结束，避免打断判断流程。
  TODO:
• 完善打印机、主板、模块配置数据库，实装 KlipperBoxConfigs 配置文件数据库
• 实装主板固件更新编译管理系统
• 更新 Linux 6.1 LTS 内核

一、硬件配置

【2023年1月13日更新】由于部署后清理垃圾文件时的失误，如果遇到打不开 Klipper 网页控制界面如 Fluidd/Mainsail 等，需要使用 MobaXterm 之类的 SSH 软件登陆设备，手动执行 sudo mkdir /var/log/nginx/ && sudo systemctl restart nginx.service 命令进行修复。

硬件主要有两款，都是 4核 CPU，板载 WiFi，搭载有线网口，不同之处如下：

TypeA：

• 1G 内存，8G eMMC 板载存储
• 12V DC 供电
• USB 2.0 × 2

TypeB：

• 5V DC 供电
• USB 2.0 × 4

二、系统基本信息

• 基于 Armbian bullseye 操作系统制作，Linux 5.15 长期支持版本内核。

• 默认用户名 pi，密码 52mxpi，可以使用 passwd 命令进行修改，注意输入时不会回显。root 密码同上。

• 终端快捷命令：

  • 查看以 serial 串口方式连接的主板设备号： lid
  • 打开 kiauh 助手：k，目前建议使用 kiauh 进行升级 klipper 和 moonraker，而不是从网页升级
  • 查看以 CANBus 连接的主板ID：lc
  • 编译 MKS Monster8 主板固件：cm8 ，编译好的固件会出现在 Fluidd 配置文件界面的 prebuilt_fw 文件夹内，右键可以下载
  • 生成故障排除信息：dk
  • 生成系统负载图：lg

• 默认提供 Gcode 实时预览（基于 PGcode），默认打印尺寸为200×200，可以在 设置 - 摄像头 - PGcode- 摄像头地址 处修改，默认为 http://kbox.local:7136?bed.width=200&bed.depth=200&bed.origin=lowerleft。如果零点位于中心，则将 lowerleft 修改为 center

三、KbOS 联网设置

1. 使用正确的电源为设备供电，稍等片刻手机或者电脑可以搜索到名为 KlipperBox 的无线网络，点击连接（无需密码）
2. 使用浏览器打开 192.168.10.1:9527 可以添加无线网络信息
3. 联网后，电脑浏览器可以先尝试打开 http://kbox.local 访问 Fluidd 网页控制界面，如果浏览器或者操作系统不支持，可以从路由器中查看设备 IP 地址。也可以使用 Fing 等软件进行扫描。

3.1 KlipperBox 离线使用

KlipperBox 支持离线使用，包括：

1. 使用环境没有无线网络的情况下，其会自动创建名为 KlipperBox 的无线热点，其他设备连接之后会组成一个无线局域网
2. 支持插卡打印 Gcode 文件

四、默认设置

• 摄像头服务使用 crowsnest 取代原来的 webcamd，性能更好，配置文件：crowsnest.conf，默认禁用
• 已安装 KlipperScreen，为了防止不必要的系统资源占用，默认关闭。配置文件：KlipperScren.conf
• 启用：sudo systemctl enable --now crowsnest

更新管理系统

故障排除系统