Klipper A-Z phần 2: Chuẩn bị phần cứng và cài đặt Klipper

Danh sách bài viết:

1. Giới thiệu Klipper
2. Chuẩn bị phần cứng và cài đặt Klipper
3. Flash firmware và tạo file printer.cfg
4. Hiệu chỉnh cơ bản
5. Input Shaper và Pressure Advance
6. Tạo macro Klipper cơ bản
7. Khắc phục sự cố và bảo trì hệ thống

Mua sắm chi tiết

Phần cứng bắt buộc

Raspberry Pi

• Pi 4 Model B 2GB: Tốt nhất cho hiệu năng - Shopee
• Pi 3B+: Đủ dùng cơ bản - Shopee
• Pi Zero 2W: lựa chọn tiết kiệm - Shopee
• Lựa chọn thay thế và dễ tìm hơn ở Việt Nam: Orange Pi Zero, Orang Pi 3, Orange Pi 4

Nên mua chính hãng để có bảo hành

Thẻ nhớ microSD

• Dung lượng: 32GB trở lên
• Class: 10 hoặc A1 (quan trọng cho hiệu năng)
• Tham khảo các sản phẩm chính hãng: Sandisk, Kingston

Hãy chọn thẻ nhớ chính hãng và chất lượng tốt, thẻ nhớ kém chất lượng sẽ gây lag, crash hệ thống và có thể hỏng nhanh.

Adapter nguồn 5V/2A-3A: Shopee

Vỏ case và tản nhiệt: Cho Pi3, Cho Pi4

Cáp kết nối: TypeC, MicroUSB

Phần cứng tùy chọn

Tổng chi phí

• Setup cơ bản: 2.5-3.2 triệu VND
• Setup đầy đủ: 5.5-7.5 triệu VND

Cài đặt MainsailOS

Bài này sẽ tập trung vào MainsailOS + KIAUH, phương pháp được khuyến nghị nhất.

Tại sao chọn MainsailOS?

MainsailOS là image được build sẵn bao gồm:

• Raspberry Pi OS Lite: Hệ điều hành cơ sở
• Klipper: Firmware cốt lõi
• Moonraker: API backend
• Mainsail: Giao diện điều khiển
• Nginx: Web server
• Cấu hình sẵn: Tất cả đã được setup để có thể kết nối với nhau

Bước 1: Tải công cụ cần thiết

Raspberry Pi Imager

1. Truy cập rpi.org
2. Tải phiên bản cho Windows/macOS/Linux
3. Cài đặt và khởi chạy

PuTTY (cho Windows)

1. Truy cập putty.org
2. Tải 32 hoặc 64-bit x86 MSI installer
3. Cài đặt để sử dụng sau

Bước 2: Flash MainsailOS

Trong Raspberry Pi Imager:

1. Chọn device: Raspberry Pi 4 (hoặc model bạn có)
2. Chọn OS:

• Click "Choose OS"
• → "Other specific-purpose OS"
• → "3D printing"
• → "Mainsail OS"
• → Chọn phiên bản phù hợp (32-bit/64-bit)

1. Chọn thẻ SD: Click "Choose storage" và chọn thẻ của bạn
2. Cấu hình nâng cao: Click biểu tượng ⚙️ (gear):

Tab General:

Set username and password  
   Username: pi
   Password: [cùng password như trên]

Configure wireless LAN
   SSID: [tên WiFi nhà bạn]
   Password: [mật khẩu WiFi]
   Country: VN

Tab Services:

Enable SSH

Tab Options:

Eject media when finished

5. Ghi dữ liệu: Click "Save" → "Yes" → "Write"

Bước 3: Khởi động lần đầu

1. Cắm thẻ SD vào Raspberry Pi
2. Kết nối nguồn và đợi MainsailOS khởi động
3. Theo dõi LED:
   • LED xanh lá nhấp nháy: đang đọc thẻ SD
   • LED đỏ sáng liên tục: đã boot xong
   • Thời gian: 3-5 phút cho lần đầu

Lưu ý: lần khởi động đầu tiên sẽ mất nhiều thời gian hơn vì hệ thống phải tốn thời gian để giải nén file.

Kết nối và cấu hình mạng

Tìm IP của Raspberry Pi

Phương pháp 1: Qua hostname

Thử truy cập: http://mainsailos.local

Nếu không được, đổi thành hostname bạn đã đặt: http://[your-hostname].local

Phương pháp 2: Quét mạng

Trên Windows:

1. Tải Advanced IP Scanner
2. Quét dải IP 192.168.1.1-254 hoặc 192.168.0.1-254
3. Tìm device có tên "raspberrypi" hoặc hostname bạn đặt

Trên router:

1. Truy cập gateway router (thường 192.168.1.1)
2. Đăng nhập và tìm "DHCP Client List"
3. Tìm Raspberry Pi trong danh sách

Kiểm tra kết nối web

Mở browser và truy cập IP hoặc hostname. Bạn sẽ thấy:

• Giao diện Mainsail hiển thị
• Cảnh báo: "Printer is not ready" - Đây là bình thường vì chúng ta chưa cấu hình máy in

Kết nối SSH

Với PuTTY (Windows):

1. Mở PuTTY
2. Host Name: Nhập IP Pi (ví dụ: 192.168.1.100)
3. Port: 22
4. Connection type: SSH
5. Click "Open"

Đăng nhập:

login as: pi
password: [password bạn đã đặt]

Lần đầu kết nối sẽ hiện cảnh báo về host key, chọn "Yes" để chấp nhận.

Với Terminal (macOS/Linux):

ssh pi@192.168.1.100

Cập nhật hệ thống

Sau khi SSH thành công, chạy:

sudo apt update && sudo apt upgrade -y

Quá trình này mất 10-15 phút.

Sử dụng KIAUH cài Klipper và các phần bổ sung

KIAUH (Klipper Installation And Update Helper) là script được phát triển bởi th33xitus, giúp cài đặt và quản lý Klipper cùng các component khác dễ dàng.

Cài đặt KIAUH

Cài đặt Git (nếu chưa có):

sudo apt-get update && sudo apt-get install git -y

Tải KIAUH:

cd ~
git clone https://github.com/dw-0/kiauh.git

Chạy KIAUH:

cd kiauh
./kiauh.sh

Giao diện KIAUH

Bạn sẽ thấy menu như này (có thể thay đổi tùy phiên phải KIAUH).

Cài đặt components bổ sung

Với KIAUH, bạn có thể cài thêm:

1. KlipperScreen (cho màn hình cảm ứng)

• Nhập 1 → 5 để cài KlipperScreen
• Cần nếu bạn có màn hình cảm ứng

2. Crowsnest (camera streaming)

• Nhập 1 → 6 để cài Crowsnest
• Cần nếu bạn có camera USB

Cập nhật hệ thống, để đảm bảo mọi thứ mới nhất:

1. Trong KIAUH: Nhập 2 (Update)
2. Chọn: 1 (Update Klipper)
3. Chọn: 2 (Update Moonraker)
4. Chọn: 3 (Update Mainsail)

Kiểm tra hệ thống

Truy cập Mainsail

1. Mở browser: http://[IP-address] hoặc http://mainsailos.local
2. Thành công nếu thấy: Giao diện Mainsail
3. Lỗi bình thường: "Printer is not ready" - sẽ fix ở bài tiếp theo

Kiểm tra trong Mainsail

Tab "Machine":

• Nơi bạn sẽ tìm thấy các file cài đặt của hệ thống như printer.cfg, moonraker...
• Update Manager: Hiển thị trạng thái các components
• System: Thông tin hệ thống
• Logs: File log để debug
• Endstsop: ở đây sẽ hiện trạng thái công tắc hành trình của các trục XYZ, bạn sẽ cần phần này để đảm bảo máy không bị chạy vượt quá hành trình, gây hỏng máy

Tab "Console":

• Giao diện command line của Klipper
• Hiện thời sẽ báo lỗi vì chưa có printer.cfg

Kiểm tra qua SSH

Trạng thái services:

sudo systemctl status klipper
sudo systemctl status moonraker
sudo systemctl status nginx

Nếu service bạn kiểm tra hiển thị trạng thái Active: active (running) tức là đang hoạt động tốt

Phiên bản đã cài:

cd ~/klipper
git log --oneline -1

cd ~/moonraker  
git log --oneline -1

Kiểm tra USB ports:

ls /dev/serial/by-id/*

Lệnh này sẽ list các thiết bị đang kết nối vào cổng usb của Pi, bạn sẽ cần khi kết nối máy in ở bài tiếp theo

Troubleshooting cơ bản

Không kết nối được SSH: PuTTY báo "Connection refused" hoặc timeout

1. SSH chưa bật:

   # Trên Pi (nếu có keyboard/màn hình):
   sudo raspi-config
   # → Interface Options → SSH → Enable

2. Sai IP address:

• Kiểm tra lại IP qua router
• Thử ping trước: ping [IP]

WiFi không kết nối: Pi không xuất hiện trên mạng

Kiểm tra:

1. LED status trên Pi:

• Chỉ LED đỏ: có thể không có mạng
• LED xanh nhấp nháy: đang hoạt động bình thường

2. Thẻ SD bị lỗi:

• Thử ghi lại MainsailOS
• Kiểm tra thẻ SD trên PC

3. Cấu hình WiFi sai:

• Kiểm tra tên WiFi và password
• Thử cáp mạng để test

Nếu vẫn còn vấn đề với Wifi, hãy thử cách này:

Sau khi nạp xong hệ điều hành cho Raspberry Pi, hãy sử dụng dây mạng LAN để kết nối internet trước.

Tiếp theo, tìm địa chỉ IP của Pi (qua router hoặc phần mềm quét mạng) để truy cập SSH bằng PuTTY.

Trước khi cấu hình WiFi, cần kiểm tra và vô hiệu hóa dịch vụ dhcpcd (chế độ quản lý mạng cũ của Pi) nếu nó đang chạy bằng lệnh sudo systemctl disable dhcpcd để tránh xung đột.

Sau đó kích hoạt NetworkManager bằng sudo systemctl enable NetworkManager, quét mạng WiFi với nmcli device wifi list và kết nối WiFi bằng lệnh sudo nmcli device wifi connect "TEN_WIFI" password "MAT_KHAU".

Cuối cùng, đặt chế độ tự động kết nối với nmcli connection modify "TEN_WIFI" connection.autoconnect yes và khởi động lại Pi để kiểm tra.

Sau bước này, Pi sẽ tự động kết nối WiFi mỗi khi khởi động và bạn có thể rút dây LAN.

Chia sẻ bởi bạn Zũng Nguyễn

Lưu ý quan trọng: Trước khi làm gì với máy in, hãy backup:

• Firmware hiện tại của máy in
• Settings/config của máy in
• IP và thông tin kết nối Pi

Setup lần đầu có thể mất cả ngày. Đừng nản nếu gặp lỗi, đây là một phần của quá trình học!

Bài tiếp theo: Flash firmware và tạo file printer.cfg đầu tiên

Nguồn tham khảo:

• Klipper Official Installation Guide
• MainsailOS Documentation
• KIAUH GitHub Repository
• Obico - Install Klipper with KIAUH
• Klipper Installation
• MainsailOS Documentation
• KIAUH GitHub
• Klipper Discord
• Klipper Reddit
• Voron Discord