3D Printer Reference Configurator

Klipper Hardware Wiki & Configurator Suite

Một bộ tham chiếu phần cứng miễn phí, mở, do cộng đồng đóng góp và một bộ công cụ tương tác được xây dựng cho hệ sinh thái in 3D Klipper.

https://3dprintref.com/#home

Nó làm được gì

Tự build một máy in 3D DIY đồng nghĩa với việc phải mò giữa một “mê cung” linh kiện, thông số, pinout và cấu hình firmware nằm rải rác trong thread Discord, bảng tính cũ, hay mấy file README GitHub viết dang dở. Trang này gom hết lại một chỗ. Nó kết hợp một wiki linh kiện đã được kiểm chứng với một bộ configurator tương tác tạo ra đầu ra thực sự dùng được — không chỉ là bảng tham khảo.

Build Configurator — Chọn máy in (Voron 2.4, Trident, RatRig V-Core, và nhiều mẫu khác), chọn build volume và tier, rồi nhận về Bill of Materials đầy đủ gồm số lượng, tên linh kiện, và link mua trực tiếp. Các add-on như MMU, enclosure, và màn hình có thể thêm vào chỉ bằng một checkbox. Có tab riêng cho người mua kit và người tự đi sourcing.

Component Wiki — Danh mục có thể tìm kiếm và lọc cho hotend (51+), extruder (30+), MCU mainboard (20+), single-board computer (13+), toolhead board (29+), và addressable LEDs. Mỗi mục đều có specs, ưu/nhược, ghi chú tương thích, và link tới trang sản phẩm hoặc GitHub repo. Bấm vào bất kỳ thẻ nào để mở modal chi tiết với toàn bộ phân tích.

Klipper Config Generator — Chọn MCU và máy in, gán linh kiện vào đúng pin cụ thể qua dropdown, cấu hình stepper driver (TMC2209, TMC5160, TMC2240, v.v.), set chế độ endstop, và chọn loại probe. Một file printer.cfg mẫu sẽ được tạo theo thời gian thực khi bạn thay đổi. Dữ liệu pin được lấy trực tiếp từ upstream Klipper configs.

Slicer Config Generator — Chọn slicer (OrcaSlicer, PrusaSlicer, Cura, SuperSlicer, Bambu Studio, Slic3r) và máy in, rồi lấy g-code start/end cho slicer dạng copy-paste và macro Klipper PRINT_START/PRINT_END. Máy Voron dùng chuẩn cộng đồng jontek2 "A better print_start macro" với logic heatsoak, tích hợp LED Stealthburner, và Beacon Contact hooks. Máy không phải Voron sẽ có macro generic gọn gàng, được chỉnh theo phương pháp leveling và kinematics của từng máy.

Neopixel Designer — Cấu hình dải LED và hiệu ứng với phần preview canvas trực tiếp. Hỗ trợ palette đa màu, blend modes, và preview animation có giới hạn FPS.

Cách nó được xây dựng

Toàn bộ website dùng vanilla HTML, CSS và JavaScript với Tailwind CSS. Không framework, không build step, không server — chạy hoàn toàn trong trình duyệt. Dữ liệu linh kiện nằm trong các file cơ sở dữ liệu JS dạng module, dễ update hoặc mở rộng. Kiến trúc là single-page app với routing dựa trên hash, hệ thống modal dùng chung, và tách bạch chặt chẽ giữa logic dữ liệu và phần render DOM.

Tính toàn vẹn dữ liệu

Mọi điểm dữ liệu — pinout, specs, URL, ghi chú tương thích — đều được kiểm chứng thủ công đối chiếu tài liệu hãng và upstream Klipper source configs. Nếu có gì không thể xác nhận, nó sẽ được gắn cờ "Requires Manual Verification" thay vì đoán. Không bịa URL, không dùng dữ liệu placeholder.

Dành cho ai

Bất kỳ ai đang build hoặc bảo trì máy in 3D chạy Klipper. Dù bạn đang lên kế hoạch build Voron đầu tiên, nâng cấp extruder, cân nhắc giữa các MCU board, hay đơn giản là cần một macro PRINT_START chạy ổn cho slicer, đây là bộ tham chiếu mà bạn sẽ quay lại hoài.