前言

原創(chuàng)文章，轉載引用請務必注明鏈接，水平有限，如有疏漏，歡迎指正交流。

本文是 KlipperBoxOS(以下簡稱 KbOS ) 的使用指南，向你介紹它的基本使用方法與不同之處。本文將會持續(xù)更新，請訪問原文鏈接獲取最新的內容和更好的閱讀體驗。

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

• 實裝log_uploader，支持一鍵上傳配置文件、宕機日志、系統(tǒng)負載圖
• 實裝WebSSH，可以直接在網頁打開終端
• 默認界面語言更改為中文
• 支持從舊版Kbox OS 升級
  【2023年2月21日】發(fā)布 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)
• 優(yōu)化了系統(tǒng)空間占用，可用空間增加
• 重新編譯優(yōu)化了無線網卡驅動，更穩(wěn)定
• 修復 Fluidd 網頁界面關機/重啟功能
• 支持一鍵提取配置文件、最近一次宕機日志，自動生成負載圖，并上傳，方便遠程調試
• 添加查詢設備id的快捷命令
• 部分主板支持一鍵編譯固件
• 修復 Arduino Uno/Nano 等的固件編譯問題（Atmel 328p）
• 修復 Duet2WiFi 等的固件編譯問題
  【2023年3月2日】優(yōu)化zram邏輯，支持大模型延時攝影渲染
  【注意】
  智能插座如果修改結束Gcode后無法生效，請在_ON_OFFF_CHECK命令上增加一行M400，等待之前運動結束，避免打斷判斷流程。
  TODO:
• 完善打印機、主板、模塊配置數據庫，實裝 KlipperBoxConfigs 配置文件數據庫
• 實裝主板固件更新編譯管理系統(tǒng)
• 更新 Linux 6.1 LTS 內核

一、硬件配置

【2023年1月13日更新】由于部署后清理垃圾文件時的失誤，如果遇到打不開 Klipper 網頁控制界面如 Fluidd/Mainsail 等，需要使用 MobaXterm 之類的 SSH 軟件登陸設備，手動執(zhí)行 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

二、系統(tǒng)基本信息

• 基于 Armbian bullseye 操作系統(tǒng)制作，Linux 5.15 長期支持版本內核。

• 默認用戶名 pi，密碼 52mxpi，可以使用 passwd 命令進行修改，注意輸入時不會回顯。root 密碼同上。

• 終端快捷命令：

  • 查看以 serial 串口方式連接的主板設備號： lid
  • 打開 kiauh 助手：k，目前建議使用 kiauh 進行升級 klipper 和 moonraker，而不是從網頁升級
  • 查看以 CANBus 連接的主板ID：lc
  • 編譯 MKS Monster8 主板固件：cm8 ，編譯好的固件會出現(xiàn)在 Fluidd 配置文件界面的 prebuilt_fw 文件夾內，右鍵可以下載
  • 生成故障排除信息：dk
  • 生成系統(tǒng)負載圖：lg

• 默認提供 Gcode 實時預覽（基于 PGcode），默認打印尺寸為200×200，可以在 設置 - 攝像頭 - PGcode- 攝像頭地址 處修改，默認為 http://kbox.local:7136?bed.width=200&bed.depth=200&bed.origin=lowerleft。如果零點位于中心，則將 lowerleft 修改為 center

三、KbOS 聯(lián)網設置

1. 使用正確的電源為設備供電，稍等片刻手機或者電腦可以搜索到名為 KlipperBox 的無線網絡，點擊連接（無需密碼）
2. 使用瀏覽器打開 192.168.10.1:9527 可以添加無線網絡信息
3. 聯(lián)網后，電腦瀏覽器可以先嘗試打開 http://kbox.local 訪問 Fluidd 網頁控制界面，如果瀏覽器或者操作系統(tǒng)不支持，可以從路由器中查看設備 IP 地址。也可以使用 Fing 等軟件進行掃描。

3.1 KlipperBox 離線使用

KlipperBox 支持離線使用，包括：

1. 使用環(huán)境沒有無線網絡的情況下，其會自動創(chuàng)建名為 KlipperBox 的無線熱點，其他設備連接之后會組成一個無線局域網
2. 支持插卡打印 Gcode 文件

四、默認設置

• 攝像頭服務使用 crowsnest 取代原來的 webcamd，性能更好，配置文件：crowsnest.conf，默認禁用
• 已安裝 KlipperScreen，為了防止不必要的系統(tǒng)資源占用，默認關閉。配置文件：KlipperScren.conf
• 啟用：sudo systemctl enable --now crowsnest

更新管理系統(tǒng)

故障排除系統(tǒng)