OpenPrintTag Scanner – Máy quét spool NFC tương thích OpenPrintTag

Thiết bị này là máy quét spool tương thích OpenPrintTag dùng để đọc/ghi thẻ NFC cho filament, hiển thị dữ liệu spool trên màn hình LCD, và tự động cập nhật lượng filament còn lại thông qua PrusaLink API. Thiết bị cũng “expose” các spool vào Home Assistant và đồng bộ với Spoolman. Ngoài ra còn có browser UI chạy qua Bluetooth để cấu hình và chỉnh sửa metadata của spool. Firmware và thiết kế phần cứng đều open source đầy đủ trên GitHub.

Tình trạng dự án (BETA):

• Các phần đang chạy ổn:

  • Scanner đọc và ghi thẻ NFC chuẩn OpenPrintTag

  • Thẻ đọc được bằng app Prusa trên điện thoại

  • LCD hiển thị đúng metadata của spool

  • Tích hợp PrusaLink API hoạt động

  • Website cấu hình qua Bluetooth hoạt động

  • LCD tự sleep khi nội dung không đổi

  • Hỗ trợ Spoolman: spool được cập nhật và tạo mới trong Spoolman

  • Spool hiển thị trong Home Assistant và có thể chỉnh sửa qua automation

• Các phần cần làm thêm:

  • Hiện chỉ hỗ trợ use case in cơ bản: 1 spool, không đổi filament.

  • Nếu bạn gặp lỗi khác – tạo issue tại đây.

Cách hoạt động

• ESP32 đảm nhiệm xử lý, Wi‑Fi và Bluetooth

• Cấu hình thực hiện qua Bluetooth bằng browser UI

• Dữ liệu in được lấy qua Wi‑Fi từ PrusaLink API

• Thẻ spool được đọc/ghi bằng đầu đọc NFC PN5180

• Trạng thái và thông tin spool hiển thị trên LCD

Hướng dẫn in

• In mỗi part 1 cái, dùng vật liệu nào cũng được (mình dùng PLA)

• Không cần support

Phần cứng cần chuẩn bị

• Module NFC PN5180 Reader/Writer: https://a.co/d/0h4ioHrx

• Màn hình 1602 I2C LCD Display: https://a.co/d/dryhwvd (chỉ cần 1 cái)

• Board ESP-WROOM-32 ESP32 ESP-32S Development Board: https://a.co/d/gW3zBIJ (chỉ cần 1 cái)

• Ốc/đai ốc M3 (nuts and bolts)

• Dây có đầu dupont cái (female) ở cả hai đầu (ví dụ: https://a.co/d/0aCINFrP)

• 1 cái wire nut hoặc wago

• Command strips / băng keo 2 mặt

Lắp ráp

1. In 1x mỗi part. (không cần support, 15% infill, layer height 0.2mm)

2. Hàn header pin vào board NFC (nếu chưa có sẵn).

3. Gắn 4 sợi dây vào các đầu dupont trên board LCD.

4. Lắp board LCD và cố định bằng 2 con ốc M3 dài 6mm.

5. Cố định board NFC bằng command strip hoặc băng keo 2 mặt.

6. Gắn dây vào các đầu dupont trên board NFC.

7. Đi dây theo bảng bên dưới. Lưu ý: đường 5V chỉ có 1 pin, nên bạn cần dùng wago hoặc wirenut để nối LCD và NFC chung vào 5V.

8. Kiểm tra lại toàn bộ kết nối – đặc biệt là GND, 3V và 5V.

9. Cắm cáp USB vào ESP32.

10. Cố định ESP32 bằng command strip hoặc băng keo 2 mặt.

11. Dùng dây rút (zip tie) cố định cáp USB vào phần ngàm buộc hình nửa vòng tròn để tránh bị giật tuột.

12. Lắp nắp sau: đặt đai ốc M3 vào các ngàm giữ, rồi bắt ốc M3.

13. Nạp firmware cho ESP32 bằng tool này. hoặc dùng pio build từ source trong github repo.

14. Cấu hình Wi‑Fi và xem chi tiết spool bằng website: https://ryanch.github.io/openprinttag_scanner/

15. Đặt scanner cạnh giá treo spool của máy in.

Bảng đấu dây

⚠ Cảnh báo nguồn (Power Warning)
Trước khi cấp nguồn, kiểm tra kỹ 3.3V, 5V và GND.
Cắm ngược cực có thể làm hư vĩnh viễn ESP32, LCD và module NFC. Nhớ kiểm tra 3 lần các dây, nhất là Ground và Power.

PN5180 Pin

LCD Pin

ESP32 Pin

RST

D13

NSS

D14

MOSI

D27

MISO

D26

SCK

D25

BUSY

D33

GPIO

D32

IRQ

D35

AUX

D34

REQ

- not connected -

3V

3V

5V

VIN (5V)

GND

GND

GND

GND

VCC

VIN (5V)

SDA

D23

SCL

D22

Ảnh chụp màn hình Web UI

Hiển thị các spool mà scanner vừa thấy gần đây.

Cho phép chỉnh sửa metadata của spool:

Chỉnh setting của thiết bị: