韌體與軟體術語 · V-Core 4 手冊

RatOS

RatRig 韌體

由 RatRig 官方維護的 Klipper 整合發行版，預先配置好 V-Core 4 系列的硬體設定、巨集與 VAOC 等功能。版本：2.1.0。

Klipper

Klipper 韌體

開源 3D 印表機韌體。運算核心執行於 Raspberry Pi（Host），並透過 USB/串列埠傳送指令給印表機主板（MCU）。相較傳統韌體提供更高精度與更彈性的設定。

Mainsail

Mainsail 操作介面

基於瀏覽器的 Klipper Web UI，提供列印控制、溫度監控、G-code 終端、檔案管理等功能。透過區網 IP 存取（如 http://192.168.x.x）。

Moonraker

Moonraker API 服務

Klipper 的 HTTP API 中介層，負責連接 Klipper 程序與 Mainsail / Fluidd 等 Web 前端。使用者通常無需直接操作 Moonraker。

Host / Raspberry Pi

主機 / 樹莓派

執行 Klipper 主程式、Moonraker 與 Mainsail 的單板電腦。V-Core 4 通常搭配 Raspberry Pi 4B 或 CM4。

MCU

微控制器（主板）

Micro Controller Unit，印表機主板上直接控制馬達、加熱器與感測器的微處理器。接收 Host 傳來的精確時序指令並執行。V-Core 4 常見搭配 Octopus Pro 或 Manta M8P 主板。

printer.cfg

主設定檔

Klipper 的主要設定檔，定義所有硬體配置（馬達、加熱器、感測器）、巨集與校正數值。RatOS 將設定分散至多個 include 檔案，通常位於 ~/printer_data/config/。

G-code

G-code 指令

3D 印表機通用的運動控制指令語言。常見指令如 G28（歸零）、G29（自動床面校正）、M104（設定 Hotend 溫度）。切片軟體自動產生；操作者也可在 Mainsail 終端手動輸入。

Macro / 巨集

巨集指令

在 Klipper 設定中定義的自訂指令序列，可封裝複雜操作為單一按鈕。RatOS 預置多個巨集，如 START_PRINT、END_PRINT、LOAD_FILAMENT。

VAOC IDEX

視覺輔助偏移校正

Visual Assisted Offset Calibration，RatOS 2.x 內建的 IDEX 專屬校正功能。透過固定相機自動偵測 T0 與 T1 噴嘴位置，計算雙頭的 XY 對位偏移量，取代傳統手動校正流程。

Slicer / 切片軟體

切片軟體

將 3D 模型（.STL/.3MF）轉換為印表機可執行 G-code 的軟體。常見選項：OrcaSlicer、PrusaSlicer、SuperSlicer。須針對機型設定正確的列印機設定檔。