CrossPink/Cài đặt và cập nhật FAQ · Hướng dẫn và giải đáp
DÀNH CHO METALIO VÀ XTEINK

Cài đặt CrossPink

CrossPink là firmware dựa trên nền CrossPoint.

Đang kiểm tra trình duyệt…

[QUAN TRỌNG] Chọn cách cài phù hợp với dòng máy

Hãy xác định mẫu máy và firmware đang dùng, rồi chọn đúng trường hợp bên dưới. Cài lần đầu, cập nhật và khôi phục dùng các loại file khác nhau, dù đều có đuôi .bin.

METALIO M4 / M4P

Cài qua USB

Khi chuyển từ firmware hãng, dpReader hoặc Mogo sang CrossPink, hoặc muốn cài lại toàn bộ CrossPink.

Dùng file .bin bộ cài USB 16 MB, có -install trong tên. Cách này thay toàn bộ phần mềm trong bộ nhớ trong và xóa cài đặt cũ; hãy sao lưu toàn bộ máy trước khi cài.

METALIO VÀ XTEINK

Cập nhật qua thẻ nhớ

Khi máy đã chạy CrossPink và mở được mục cập nhật, hoặc vào được recovery trên thẻ nhớ.

Dùng file cập nhật ứng dụng .bin, không có -install trong tên. Cách này chỉ thay ứng dụng; không thay phần khởi động hoặc cách chia bộ nhớ của máy.

METALIO M4 / M4P

Khôi phục máy

Khi muốn quay về firmware và cài đặt tại thời điểm đã sao lưu.

Kết nối USB và dùng bản sao lưu toàn bộ 16 MB của chính máy này, không dùng file firmware tải trên trang. Khôi phục sẽ ghi đè toàn bộ bộ nhớ trong của máy.

Vì sao không chỉ chép file .bin vào thẻ nhớ?

Máy có một chương trình khởi động gọi là bootloader, dùng bảng phân vùng để biết ứng dụng nằm ở đâu trong bộ nhớ. File .bin cập nhật qua thẻ nhớ chỉ chứa ứng dụng, không sửa hai phần này. File .bin bộ cài USB có -install trong tên chứa cả bootloader, bảng phân vùng và ứng dụng. Trên M4/M4P còn firmware hãng, dpReader hoặc Mogo, cách bố trí bộ nhớ khác CrossPink; vì vậy cần bộ cài USB đầy đủ để thiết lập lại trước. Xem giải thích chi tiết ↓

Xteink chỉ được cung cấp cách cập nhật thẻ nhớ trên trang này. Nếu máy đang dùng firmware khác CrossPink, hãy kiểm tra hướng dẫn của đúng firmware và phiên bản đang cài trước; có mục cập nhật hoặc nhận file .bin chưa đủ để khẳng định cài được CrossPink. Xem hướng dẫn Xteink ↓

Luôn chọn đúng mẫu máy và bản Full/Light. M4 và M4P dùng file riêng; X3/X4 dùng chung file; X4 Pro và X4 Classic dùng file riêng, không dùng lẫn.

01

Chọn máy của bạn

Chọn dòng máy để xem phương thức cài và file phù hợp.

Metalio · USB hoặc thẻ nhớ

Dòng máy Metalio

Xteink · Chỉ cập nhật thẻ nhớ

Dòng máy Xteink
02

Bạn muốn làm gì?

Chọn cách cài đặt phù hợp với firmware hiện tại trên máy.

Cách cài đặt hoặc cập nhật

Bản CrossPink

Bản firmware
Cài đầy đủ qua USB

Thay bootloader, bảng phân vùng và ứng dụng.

Trọn bộ
Cài đặt sẽ ghi đè firmware và xóa cài đặt cũ trên máy.Hãy lưu bản sao của máy trước khi tiếp tục.
Tải bộ cài USB ↓Cài bằng dòng lệnh (esptool) ↓
03

Kết nối qua USB

Bật máy đọc sách, rồi cắm vào máy tính bằng cáp USB có truyền dữ liệu.

Cắm cáp USB, bấm Kết nối thiết bị rồi chọn máy đọc sách trong cửa sổ hiện ra. Trang sẽ thử kết nối tự động.

Cách kết nối M4/M4P để nạp qua USB ↓

Thiết bị chưa được kết nối
04

Sao lưu và cài đặt

Chọn số bản sao lưu. Kết nối máy ở bước 03 để bắt đầu sao lưu.

Số bản sao lưu
Sao lưu bộ nhớ flash

Đọc toàn bộ flash 1 lần và kiểm tra dữ liệu với thiết bị. Sau đó tải file sao lưu về máy tính.

Thao tác này sẽ ghi đè firmware và cài đặt hiện tại trên máy.

Lưu ý và miễn trừ trách nhiệm

Tiếng Việt

CrossPink là dự án firmware độc lập, phi thương mại, được tác giả phát triển cho mục đích sử dụng cá nhân. Firmware được cung cấp hoàn toàn miễn phí theo nguyên tắc “NGUYÊN TRẠNG” (AS IS) và “HIỆN CÓ” (AS AVAILABLE), không đi kèm bất kỳ bảo hành hay cam kết nào về hỗ trợ, bảo trì, cập nhật, tính tương thích, bảo mật, độ tin cậy hoặc sự phù hợp cho một mục đích cụ thể.

CrossPink có bản ổn định (Stable) và bản thử nghiệm (Release Candidate — RC). Bản RC dành cho thử nghiệm và có thể còn lỗi chưa được khắc phục. Hãy kiểm tra phân loại bản phát hành và hướng dẫn của đúng bản dựng trước khi cài. Dù là Stable hay RC, không có bảo đảm firmware sẽ tương thích hoàn toàn hoặc hoạt động không phát sinh lỗi. Nhãn phát hành hay việc build thành công không tự chứng minh đã kiểm tra trên thiết bị thật.

Việc tải xuống, cài đặt, cập nhật, khôi phục, chỉnh sửa và sử dụng firmware tùy chỉnh là hoàn toàn tự nguyện; bạn tự chịu mọi rủi ro. Quá trình này có thể thất bại hoặc khiến thiết bị không thể khởi động; cũng có thể làm mất dữ liệu, hỏng dữ liệu, thay đổi cài đặt, ảnh hưởng đến phụ kiện kết nối, gây trục trặc hoặc làm hỏng phần cứng. Trước khi tiến hành, hãy xác nhận đúng mẫu máy, phiên bản phần cứng và bản Full/Light, đọc kỹ hướng dẫn và sao lưu dữ liệu quan trọng. Bạn chịu trách nhiệm về việc cài đặt, sao lưu, khôi phục và các hệ quả phát sinh.

Tác giả và bên cung cấp không chịu trách nhiệm đối với bất kỳ mất mát hoặc thiệt hại nào phát sinh từ việc tải xuống, cài đặt, cập nhật, khôi phục, chỉnh sửa hoặc sử dụng firmware, bao gồm hỏng thiết bị, mất dữ liệu, gián đoạn sử dụng và các thiệt hại liên đới khác.

Firmware không đi kèm bảo hành hoặc cam kết hỗ trợ kỹ thuật. Nếu không chấp nhận các rủi ro này, bạn không nên cài đặt hoặc sử dụng firmware.

English

CrossPink is an independent, non-commercial firmware project created by its author for personal use. It is provided free of charge, “as is” and “as available,” without any warranty or promise of support, maintenance, updates, compatibility, security, reliability, or fitness for a particular purpose.

CrossPink may be distributed as a stable release or a release candidate (RC). An RC is intended for testing and may contain unresolved defects. Check the release label and the instructions for the exact build before installing. Neither a Stable nor an RC label guarantees compatibility or error-free operation. A release label or successful build alone is not proof of testing on a physical device.

Downloading, installing, updating, restoring, modifying, and using custom firmware is voluntary and at your own risk. The process may fail. Installation, updates, or restoration may erase data or corrupt it, change settings, prevent the device from starting, affect connected accessories, cause malfunctions, or damage hardware. Before proceeding, confirm the exact device model, hardware revision, and Full/Light edition, read the instructions, and back up important data. You are responsible for installation, backups, recovery, and the consequences of using the firmware.

The author and providers are not liable for loss or damage arising from downloading, installing, updating, restoring, modifying, or using this firmware, including device damage, data loss, loss of use, and consequential loss.

No warranty or commitment to technical support is offered. If you do not accept these risks, do not install or use the firmware.

Đang tải thông tin firmware…

Kết nối thiết bị để bắt đầu sao lưu.

Nhật ký thao tác
Công cụ cài đặt CrossPink đã sẵn sàng.
Trợ giúp CrossPink
FAQ

Hướng dẫn và câu hỏi thường gặp

Tìm câu trả lời theo từng bước: chọn cách cài, sao lưu, cập nhật và khôi phục.

1. Trước khi cài

Trang này hỗ trợ những mẫu máy nào?

Trang có bộ cài USB cho Metalio M4 3.97″ dùng ESP32-S3 và Metalio M4P Plus 4.7″ dùng ESP32-S31; đồng thời cung cấp cập nhật thẻ nhớ cho Metalio và Xteink X3/X4, X4 Pro, X4 Classic. Chọn đúng mẫu máy ở bước 01: Xteink chỉ có cập nhật thẻ nhớ, M4 và M4P có bộ cài USB riêng.

Trang kiểm tra loại chip khi kết nối nhưng chưa tự xác định được đời bo mạch M4P. Các bộ cài hiện được cung cấp dưới dạng thử nghiệm. Hãy giữ bản sao lưu của chính thiết bị trước khi cài qua USB.

Khi nào cài qua USB, khi nào cập nhật qua thẻ nhớ?

.bin chỉ là đuôi file dữ liệu, không cho biết đó là bộ cài đầy đủ hay chỉ là ứng dụng. Khi bật máy, một chương trình nhỏ gọi là bootloader đọc bảng phân vùng — sơ đồ chia bộ nhớ — để tìm và chạy ứng dụng. Trình cập nhật là chức năng nhận file rồi ghi vào bộ nhớ; có chức năng này không đồng nghĩa máy nhận được mọi loại .bin.

Trên Metalio M4/M4P đang dùng firmware hãng, dpReader hoặc Mogo: bố trí bộ nhớ cũ không phù hợp với file ứng dụng CrossPink. File cập nhật thẻ nhớ không thay bootloader và bảng phân vùng, nên dù ghi được ứng dụng cũng chưa bảo đảm máy khởi động được. Chọn “Cài qua USB” với bộ cài đầy đủ 16 MB đúng mẫu máy; bộ cài thiết lập lại phần khởi động, bảng phân vùng và ứng dụng. Thao tác này xóa cài đặt cũ, nên cần giữ bản sao toàn bộ flash của chính máy trước khi cài.

Khi máy đã chạy CrossPink: dùng “Cập nhật qua thẻ nhớ” với file ứng dụng đúng mẫu máy, qua mục cập nhật hoặc recovery. Cách này giữ nguyên bootloader và bảng phân vùng. Nếu máy đang chạy firmware khác, hãy đối chiếu hướng dẫn của đúng mẫu máy và phiên bản đó trước; nếu trình cập nhật từ chối file, dừng lại.

Nguyên tắc chọn đúng gói cài cũng áp dụng khi cài CrossPoint: làm theo hướng dẫn cho đúng thiết bị và phiên bản, không suy ra tương thích chỉ từ đuôi .bin hoặc loại chip. Trang này chỉ cung cấp nạp USB và khôi phục toàn bộ flash cho M4/M4P; Xteink chỉ có file cập nhật thẻ nhớ.

Nên chọn Full hay Light?

Full có thêm các chức năng như tra từ điển, đánh dấu trang, lưu trích đoạn và chụp màn hình. Light tập trung vào đọc sách và lược bớt các chức năng này.

Chọn Light nếu chỉ cần đọc sách; chọn Full nếu cần các tiện ích bổ sung. Cả 2 bản đều phải đúng mẫu máy M4 hoặc M4P. Lựa chọn Full/Light không thay thế bước chọn mẫu máy.

Cần tải file nào cho từng cách cài?
  • Cài qua USB cho Metalio M4/M4P: dùng “Tải bộ cài USB”. Tên file có phần -install; file này gồm cả bootloader và bảng phân vùng.
  • Cập nhật qua thẻ nhớ hoặc recovery cho Metalio và Xteink: chọn “Cập nhật qua thẻ nhớ”, rồi bấm “Tải firmware (.bin) cho thẻ nhớ”. Dùng file cập nhật đúng mẫu máy và bản Full/Light, không dùng bộ cài USB.

Chọn mẫu máy, Full/Light và phiên bản trước khi tải. Trang sẽ cập nhật liên kết tải theo lựa chọn của bạn.

2. Sao lưu và dữ liệu

Cài đặt có làm mất dữ liệu không?

Trên Metalio M4/M4P, bộ cài USB ghi đè toàn bộ flash 16 MiB, gồm bootloader, bảng phân vùng và firmware; các vùng còn lại được xóa. Trang kiểm tra lại toàn bộ 16 MiB sau khi ghi. Bản sao lưu toàn bộ flash của chính máy là cách để trở về trạng thái trước đó.

Cập nhật bằng file ứng dụng qua thẻ nhớ giữ bootloader và bảng phân vùng hiện tại. Trước khi thực hiện, bạn vẫn nên sao lưu dữ liệu đọc quan trọng. Bản sao lưu flash không bao gồm sách và dữ liệu trên thẻ nhớ; cần sao lưu thẻ riêng.

Cần giữ những file sao lưu nào?

Bạn có thể chọn 1 bản hoặc 2 bản đối chiếu. Với 1 bản, trang đọc toàn bộ flash 1 lần và kiểm tra MD5 với thiết bị. Với 2 bản, trang đọc lại toàn bộ flash và so sánh thêm SHA-256 giữa 2 lần đọc; cách này mất thêm thời gian.

Hãy tải và lưu số file .bin tương ứng với lựa chọn. Mỗi file phải đủ 16.777.216 byte (16 MB). Nên lưu thêm file thông tin sao lưu .json để có mã SHA-256 và thông tin thiết bị khi cần khôi phục.

Chỉ dùng bản sao lưu của chính thiết bị này. Các file được xử lý trong trình duyệt, không tải lên máy chủ. Bản sao lưu flash không gồm sách và dữ liệu trên thẻ nhớ; cần sao lưu thẻ riêng.

Đã có bản sao lưu 16 MB, có thể bỏ qua sao lưu mới không?

Với Metalio M4/M4P, có thể bỏ qua sao lưu mới. Sau khi kết nối USB, ở bước “Sao lưu và cài đặt”, chọn ô “Đã có bản sao lưu 16 MB”. File phải đủ 16.777.216 byte và thuộc chính thiết bị đang kết nối; file cập nhật hoặc bộ cài USB không phải bản sao lưu toàn bộ flash.

Trang ghi nhận xác nhận của bạn nhưng không kiểm tra file có sẵn. Nếu chưa chắc file đầy đủ hoặc đúng máy, hãy tạo bản sao lưu mới. Xác nhận bỏ qua sao lưu sẽ được xóa khi ngắt kết nối hoặc đổi thao tác.

3. Kết nối và cập nhật

Trình duyệt nào hỗ trợ nạp firmware qua USB?

Dùng Chrome hoặc Edge trên máy tính có hỗ trợ Web Serial. Thông báo dưới tiêu đề cho biết trình duyệt có hỗ trợ kết nối USB ngay khi mở trang. Nạp USB cần trang chạy qua HTTPS.

Thông báo hỗ trợ của trình duyệt chưa xác nhận cáp hoặc thiết bị hoạt động; trang chỉ kiểm tra thiết bị sau khi bạn bấm “Kết nối thiết bị” và chọn cổng USB. Nếu chỉ tải file để cập nhật qua thẻ nhớ, bạn không cần Web Serial.

Kết nối M4 hoặc M4P để nạp qua USB như thế nào?
  1. Nếu máy đang chạy CrossPink: bật máy về màn hình chính. Nếu đang chia sẻ thẻ nhớ qua USB, hãy tháo ổ đĩa an toàn trên máy tính rồi thoát chế độ chia sẻ trên máy đọc sách.
  2. Dùng cáp USB có truyền dữ liệu. Trên trang, chọn đúng mẫu máy, chọn “Cài qua USB” hoặc “Khôi phục máy”, rồi bấm “Kết nối thiết bị”.
  3. Chọn cổng USB của máy đọc sách. Tên thường là “USB JTAG/serial debug unit”; trên Mac có thể kèm “cu.usbmodem…”. Giữ tùy chọn kết nối “Tự động” để trang thử đưa máy vào chế độ nạp.

Đừng chọn các dòng Bluetooth, loa, tai nghe hoặc debug-console. Nếu có nhiều thiết bị USB và bạn chưa rõ dòng nào là máy đọc sách: bấm Cancel (Hủy), rút cáp máy đọc sách rồi mở lại danh sách để so sánh. Sau đó hủy, cắm lại cáp và chọn dòng vừa xuất hiện.

Down + Nguồn là thao tác vào recovery của CrossPink để cập nhật từ thẻ nhớ, không phải hướng dẫn vào chế độ nạp USB. Nếu không thấy cổng hoặc kết nối thất bại, xem câu hỏi bên dưới.

Tải và cài Python ở đâu?

Tải bản Python ổn định, từ 3.10 trở lên, tại python.org; cài xong, mở lại Terminal trên macOS/Linux hoặc PowerShell trên Windows. Tiếp theo làm theo hướng dẫn cài esptool.

Tải và cài esptool như thế nào?

Dùng gói esptool chính thức trên PyPI do Espressif duy trì (mã nguồn GitHub); các lệnh dưới tự cài esptool 5.4 trở lên và pySerial trong môi trường riêng, rồi liệt kê cổng USB. Nếu thiếu pip/venv, xem hướng dẫn cài công cụ của Espressif.

Cổng thường có dạng /dev/cu.usbmodem… (macOS), /dev/ttyACM0 (Linux) hoặc COM4 (Windows). Quay lại hướng dẫn nạp USB ↓

Cài bộ USB bằng dòng lệnh (esptool) như thế nào?

Dành cho Metalio M4/M4P, không cần trình duyệt hỗ trợ Web Serial. Các lệnh đổi theo mẫu máy, Full/Light và phiên bản đã chọn. Đây là cài lại toàn bộ flash 16 MiB, sẽ xóa firmware và cài đặt cũ.

Chọn mẫu máy và phiên bản có bộ cài USB đủ 16 MiB ở bước 02. Hướng dẫn này không dùng để ghi file cập nhật thẻ nhớ hoặc khôi phục từ bản sao lưu.

Không thấy máy trong danh sách cổng USB thì làm gì?

Kiểm tra máy đã bật và thoát chế độ chia sẻ thẻ nhớ. Dùng cáp USB có truyền dữ liệu, thử cắm trực tiếp vào máy tính hoặc đổi cáp và cổng USB. Đóng các ứng dụng đang dùng cổng của máy đọc sách.

Chỉ chọn cổng vừa xuất hiện khi cắm máy. Không chọn Bluetooth, loa, tai nghe hoặc “debug-console”. Nếu hệ điều hành chưa nhận thiết bị, đổi tùy chọn kết nối trên trang sẽ không làm xuất hiện cổng USB.

Chỉ chọn “Máy đã ở chế độ nạp USB” khi đã xác nhận thiết bị đang ở chế độ đó. Tùy chọn này bỏ qua bước đưa máy vào chế độ nạp, không tự chuyển chế độ cho máy.

Cập nhật Xteink X3/X4, X4 Pro và X4 Classic như thế nào?

Chọn đúng máy ở bước 01, rồi chọn Full/Light và phiên bản ở bước 02; tải file .bin và chép vào thẻ nhớ để dùng trình cập nhật trên máy. X3/X4 dùng chung file, còn X4 Pro và X4 Classic có file riêng; chỉ cập nhật khi bootloader và trình cập nhật đang có tương thích, và chỉ đổi tên file nếu hướng dẫn của firmware hiện tại yêu cầu.

Nếu đã cài CrossPink nhưng không vào được giao diện, thử recovery: X3/X4 giữ Nguồn + Lên; X4 Pro và X4 Classic giữ Nguồn + Xuống khi khởi động. Trang này không cung cấp nạp USB hoặc khôi phục bản sao flash cho Xteink.

Cập nhật firmware qua thẻ nhớ như thế nào?

Dành cho máy đã chạy CrossPink. Nếu đang dùng firmware khác, kiểm tra điều kiện cài đặt trước khi làm.

  1. Chọn đúng mẫu máy, bản Full/Light và phiên bản. Chọn “Cập nhật qua thẻ nhớ”, rồi tải file .bin.
  2. Chép file vào thẻ nhớ, giữ nguyên dữ liệu đọc đang có trên thẻ.
  3. Mở mục cập nhật firmware trên máy và chọn file vừa chép. Nếu CrossPink không khởi động bình thường, xem recovery cho M4/M4P hoặc Xteink.
  4. Giữ nguồn ổn định và không rút thẻ khi đang ghi. Sau khi máy khởi động lại, kiểm tra phiên bản firmware.

Không dùng bộ cài USB có -install trong tên file để cập nhật từ thẻ nhớ. Chỉ đổi tên file nếu hướng dẫn của firmware và phiên bản đang cài yêu cầu.

4. Khôi phục và xử lý lỗi

Vào chế độ recovery trên M4 và M4P như thế nào?

Dành cho máy đã cài CrossPink. Recovery cho phép cài lại file ứng dụng từ thẻ nhớ, không khôi phục bootloader hoặc bảng phân vùng cũ.

  1. Chép file cập nhật .bin đúng mẫu máy và bản Full/Light vào thẻ nhớ. Không dùng bộ cài USB.
  2. Tắt máy. Giữ đồng thời nút Down và nút Nguồn để bật máy.
  3. Khi màn hình chọn file cập nhật xuất hiện, thả cả 2 nút rồi chọn file trên thẻ.

M4 và M4P dùng cùng thao tác giữ nút, nhưng phải chọn file cập nhật riêng cho từng mẫu máy.

Cần làm gì nếu nạp firmware bị gián đoạn hoặc máy không khởi động?

Nếu trang báo 100% nhưng máy chưa phản hồi: dữ liệu vừa ghi đã được kiểm tra, còn máy đã chạy lại hay chưa thì trang không xác nhận được. Hình cũ trên màn có thể vẫn còn dù máy không chạy. Thả mọi nút đang giữ, bấm “Gửi lệnh khởi động lại máy” và chờ máy phản hồi. Nếu đã đóng trang, hãy mở lại, kết nối máy rồi bấm “Khởi động lại máy” ở bước kết nối; thao tác này không nạp lại firmware. Chỉ rút rồi cắm lại USB có thể không khởi động lại máy đang dùng pin. Nếu máy vẫn không phản hồi, đừng đánh dấu hoàn tất hoặc nạp lại ngay; giữ bản sao lưu và tải Nhật ký thao tác để kiểm tra.

Nếu đang nạp qua USB mà bị gián đoạn: kiểm tra cáp và nguồn. Nếu máy vẫn vào được chế độ nạp USB, hãy kết nối lại để cài lại CrossPink hoặc khôi phục bản sao lưu của chính máy.

Nếu máy đã cài CrossPink: thử vào recovery theo hướng dẫn ở trên và chọn file cập nhật phù hợp từ thẻ nhớ. Nếu không vào được recovery, cần quay lại chế độ nạp USB để cài lại hoặc khôi phục bản sao lưu.

Làm thế nào để khôi phục firmware cũ?

Kết nối máy qua USB, chọn “Khôi phục máy”, rồi chọn 1 file sao lưu toàn bộ flash của chính thiết bị này. Không bắt buộc có bản sao thứ hai hoặc file thông tin sao lưu.

Nếu có, mở “Đối chiếu thêm” và chọn thêm bản sao thứ hai hoặc file .json/.sha256 để kiểm tra. Các file đã chọn phải khớp nhau. Trang luôn kiểm tra kích thước, chip và tính toàn vẹn bootloader; nếu chỉ có 1 file, trang không thể đối chiếu phần dữ liệu còn lại với bản thứ hai hoặc mã SHA-256 đã lưu từ trước.

Khôi phục sẽ ghi đè toàn bộ flash, gồm bootloader, bảng phân vùng, firmware và cài đặt. Bạn cần xác nhận bản sao thuộc chính máy đang kết nối. Recovery qua thẻ nhớ chỉ thay ứng dụng nên không dùng để đưa toàn bộ máy về bố trí firmware cũ.
Lưu ý và miễn trừ trách nhiệm