WitchHunt 2.53 cho Metalio E-Ink4 Plus: Firmware Đọc Sách Chuẩn Typo & Flash Trực Tiếp Trên Web
Firmware đọc sách WitchHunt 2.53 tùy biến cho Metalio E-Ink4 Plus (ESP32-S31) kèm trình Flash trực tiếp qua Web Serial.
WitchHunt-2.53-Metalio-4-Plus.bin
Cắm cáp USB-C và nạp thẳng firmware từ trình duyệt Chrome / Edge — không cần cài Python hay esptool. Trình flash tự động xác minh đúng chip ESP32-S31 trước khi ghi.
WitchHunt for Metalio 4 Plus là bản firmware đọc sách mã nguồn mở tùy biến riêng cho Metalio E-Ink4 Plus (MCU ESP32-S31, màn hình E-Ink song song 4.7 inch 684×1216), phát triển trên nền tảng Witch(hunt) Reader và CrossPoint Reader.
Firmware hỗ trợ đọc mượt EPUB, TXT, Markdown và XTC với đầy đủ bố cục CSS, OpenType shaping, chữ viết RTL và dàn trang CJK dọc — đồng thời được tinh chỉnh sâu cho phần cứng Metalio 4 Plus từ giao diện Flower Home, Drop Cap chuẩn xuất bản cho tới chế độ khử răng cưa Single-Pass GC16.
01 / Phần Cứng Metalio E-Ink4 Plus (ESP32-S31)
Khác với thế hệ cũ dùng ESP32-S3 và màn hình SPI, Metalio E-Ink4 Plus chuyển sang kiến trúc ESP32-S31 320 MHz kết hợp màn hình E-Ink giao tiếp song song (parallel EPDiy) cho tốc độ làm tươi nhanh và độ sắc nét cao hơn hẳn.
- Vi điều khiển (MCU): ESP32-S31 (320 MHz, kiến trúc RISC-V)
- Màn hình: 4.7 inch 684×1216 parallel E-Ink (driver EPDiy)
- Bộ nhớ: 16 MB Flash · 16 MB PSRAM (
qio_opi) - Cảm ứng & Cảm biến: Cảm ứng điện dung FT6336U · Gia tốc kế SC7A20H (tự xoay 4 chiều)
- Tiện ích phần cứng: RTC PCF8563 · Fuel gauge BQ27220 · Đèn nền 2 tông ấm/lạnh · Motor rung haptic · 4-bit SDMMC
02 / Những Nâng Cấp Đáng Giá Trên Bản Metalio 4 Plus
- Flower Home Theme (
Settings → Theme → Flower): Reading Hero Card nền tối tương phản cao (bìa sách, tên sách, tác giả, thanh tiến độ%và nútResumetrắng tinh gọn), thanh Reading Stats Strip (Today | Streak | WPM), lưới 3 cột Recent Books tràn viền chuẩn tỉ lệ và 5 nút điều hướng icon44×44sắc nét. - Publisher Styling & Drop Cap (
TAG_PageDropCap): Drop Cap phóng trực tiếp từ glyph với thuật toán bao chữ mượt mà. Hỗ trợ đầy đủ CSS sibling combinator (+,~,h1 + p,.firstpara,::first-letter) cực kỳ phổ biến trong EPUB tiếng Việt và quốc tế, cùng font TrueType/OpenType, RTL và CJK dọc. - Single-Pass GC16 Anti-Aliasing (
EpdiyDriver): Tổng hợp lớp chữ đen trắng và lớp khử răng cưa grayscale vào một nhịp quét GC16 duy nhất (hỗ trợ cả Light Mode lẫn Dark Mode), xóa bỏ hoàn toàn cảm giác chớp 2 nhịp khi mở sách và lật trang. - Auto-Rotate Chuẩn Hóa (
SC7A20H): Hiệu chỉnh chính xác góc gắn phần cứng 180° (imuFlipX,imuFlipY) trongBoardConfig.hvàImu.cpp, đảm bảo cả 4 hướng xoay màn hình đều phản hồi đúng. - Haptic Feedback & Khóa Bus I2C: Thống nhất cơ chế khóa bus I2C (
HalI2cBus ↔ freeink::I2cBusLock) giúp motor rung phản hồi ổn định khi chạm màn hình và khi bấm phím cứng chuyển trang (Volume Up / Volume Down). - Repo Độc Lập (Self-Contained): Tích hợp sẵn
freeink-sdk(gồmepdiyvà các bản vá driver/IMU) trực tiếp trong repository — clone về là build ngay bằng PlatformIO.
03 / Thao Tác Cảm Ứng & Hệ Thống Phím Cứng
Mọi thao tác vuốt, chạm và phím vật lý đều có thể tùy biến lại trong Settings → Controls.
Cử chỉ cảm ứng (Touch Gestures)
- Vuốt Trái / Phải: Trang kế tiếp / Trang trước
- Vuốt hướng ra ngoài ở 1/3 Trái / Phải: Nhảy lùi / tiến nhanh 10 trang
- Vuốt Lên / Xuống ở cạnh Trái: Tăng / Giảm độ sáng đèn nền
- Vuốt Lên / Xuống ở cạnh Phải: Chỉnh độ ấm đèn nền (Ấm hơn / Lạnh hơn)
- Vuốt Xuống từ cạnh Trên: Mở bảng điều khiển đèn nền (Frontlight Control Panel)
- Chạm giữa màn hình: Mở Reader Menu
- Nhấn giữ góc Trên-Trái (mọi màn hình): Bật / Tắt nhanh đèn nền
- Nhấn giữ cạnh Trái / Phải: Chương trước / Chương kế tiếp
- Nhấn giữ giữa / cạnh Dưới: Tra từ điển / Đánh dấu trang (Bookmark)
- Chụm / Mở 2 ngón (Pinch): Giảm / Tăng cỡ chữ
- Xoay 2 ngón cùng / ngược chiều kim đồng hồ: Chuyển hướng xoay màn hình
Phím cứng vật lý (Physical Buttons)
- Volume Up / Volume Down (cạnh phải): Trang trước / Trang sau (kèm rung haptic)
- Left / Right (viền dưới): Lật trang / Điều hướng danh sách
- Menu (viền dưới bên trái):
Back(nhấn giữ để về màn hìnhHome) - AI Key (cạnh phải phía trên):
Confirm - Power (cạnh phải phía dưới): Bấm nhanh:
Home· Bấm đúp: Bật/tắt đèn nền · Nhấn giữ:Sleep
04 / Hướng Dẫn Nạp Firmware (3 Cách)
Cách 1: Flash trực tiếp trên Web (Khuyên dùng)
Bấm nút ⚡ Flash Firmware Ngay Trên Web ngay đầu bài viết trên trình duyệt Chrome, Edge hoặc Opera desktop (hỗ trợ Web Serial API). Trình flash đã cấu hình sẵn file WitchHunt-2.53-Metalio-4-Plus.bin, địa chỉ 0x510000, tốc độ 921600, tắt Erase entire flash và tự kiểm tra đúng chip ESP32-S31 trước khi ghi.
Lưu ý an toàn: File
WitchHunt-2.53-Metalio-4-Plus.binlà bản app-only binary nạp vào slot0x510000, giữ nguyên sách, tiến độ đọc, font và cài đặt trên thẻ nhớ microSD. Chỉ bật Erase entire flash khi nạp file full merged image tại0x0.
Cách 2: Nạp qua dòng lệnh esptool.py
esptool.py --chip esp32s31 --port COM3 --baud 921600 write_flash 0x510000 WitchHunt-2.53-Metalio-4-Plus.bin
Cách 3: Cập nhật trực tiếp qua thẻ nhớ microSD (Không cần máy tính)
- Tải file
WitchHunt-2.53-Metalio-4-Plus.binvà chép vào thư mục gốc của thẻ microSD. - Trên máy Metalio, vào Settings → System → SD Firmware Update rồi chọn file
.binvừa chép.
05 / Tự Build Từ Mã Nguồn (PlatformIO)
git clone https://github.com/trungtypo-png/witchhunt-reader.git
cd witchhunt-reader
git checkout metalio-s31
pio run -e metalio_eink4_plus
File firmware sau khi biên dịch sẽ nằm tại .pio/build/metalio_eink4_plus/firmware.bin. Mã nguồn phát hành theo giấy phép MIT License tại github.com/trungtypo-png/witchhunt-reader (branch metalio-s31).
Đinh Toàn Trung (Zed)