1. ESP-Web-Tools là gì?

ESP-Web-Tools là bộ công cụ cho phép nạp firmware vào các bo mạch ESP32, ESP32-S3, ESP32-C3 trực tiếp từ trình duyệt (Chrome, Edge…) thông qua WebUSB. Trên XIAOZHI.VN, toàn bộ firmware đã được chuẩn hoá sẵn manifest – bạn chỉ cần chọn đúng mạch và bấm Nạp FW.

Lưu ý: Tính năng WebUSB chỉ hoạt động tốt trên Google Chrome, Microsoft Edge và yêu cầu kết nối qua HTTPS (đã được bật sẵn trên XIAOZHI.VN).

2. Chuẩn bị trước khi nạp firmware

  • Một bo mạch ESP32 / ESP32-S3 / ESP32-C3 (mạch tím, S3Nx, Super Mini, C3 Mini…).
  • Dây cáp USB còn tốt (có truyền dữ liệu, không phải cáp sạc chỉ có 2 dây).
  • Máy tính chạy Windows, macOS hoặc Linux có cài Chrome hoặc Edge bản mới.
Một số bo mạch ESP32 được XIAOZHI.VN hỗ trợ nạp firmware
Ví dụ một số bo mạch ESP32/ESP32-S3/ESP32-C3 được hỗ trợ.

3. Truy cập trang nạp firmware chính thức

Mở trình duyệt và truy cập trang nạp firmware chính thức của XIAOZHI.VN: https://xiaozhi.vn.

Tại đây, bạn sẽ thấy các nhóm bo mạch như ESP32, Legacy Devices, Test Devices. Chọn đúng nhóm tương ứng với mạch bạn đang sử dụng.

Giao diện trang nạp firmware XIAOZHI.VN với danh sách mạch ESP32
Giao diện trang nạp firmware ESP32 trên XIAOZHI.VN.

4. Chọn đúng bo mạch và màn hình

  1. Nhấn vào tab ESP32 (hoặc nhóm bo mạch phù hợp).
  2. Bấm nút Chọn ở card đúng với mạch của bạn (ví dụ: Mạch tím huyền thoại, ESP32-S3 Super Mini, ESP32 C3…).
  3. Sau khi chọn bo mạch, danh sách các phiên bản theo loại màn hình sẽ hiện ra (OLED 0.91, OLED 0.96, SH1106 1.3”, TFT 1.28 Round, 1.3”, 1.47”, 1.54”…).
Danh sách các cấu hình firmware cho từng loại màn hình
Danh sách các cấu hình firmware tương ứng từng loại màn hình.

5. Kết nối bo mạch với máy tính

  1. Cắm cáp USB vào bo mạch và cổng USB của máy tính.
  2. Đảm bảo bo mạch đang được cấp nguồn (đèn báo nguồn sáng).
  3. Nếu đây là lần đầu kết nối, hệ điều hành có thể tự cài driver trong vài giây.
Kết nối bo mạch ESP32 với máy tính bằng cáp USB
Cắm cáp USB nối bo mạch ESP32 với máy tính.

6. Bấm “Nạp FW” và chọn cổng kết nối

Mỗi cấu hình màn hình sẽ có nút Nạp FW màu xanh dương.

  1. Bấm nút Nạp FW ở cấu hình bạn muốn.
  2. Trình duyệt sẽ bật cửa sổ Chọn cổng serial.
  3. Chọn đúng cổng serial tương ứng với bo mạch ESP32 của bạn, sau đó nhấn Kết nối.
Cửa sổ WebUSB chọn cổng ESP32 trong Chrome/Edge
Cửa sổ WebUSB trong trình duyệt cho phép chọn bo mạch ESP32 cần nạp.
Nếu không thấy cổng nào trong danh sách, hãy thử:
  • Đổi sang cổng USB khác trên máy tính.
  • Đổi sang một sợi cáp USB khác (có cả dây dữ liệu).
  • Đảm bảo bạn đang dùng Chrome/Edge mới nhất.

7. Quá trình nạp firmware

Sau khi chọn xong cổng, ESP-Web-Tools sẽ tự động:

  • Kết nối tới bo mạch.
  • Xoá vùng flash cũ nếu cần.
  • Ghi firmware mới kèm dữ liệu cấu hình.

Trên màn hình sẽ hiển thị thanh trạng thái tiến độ (0% → 100%). Trong lúc nạp, không rút cáp USB và không tắt trình duyệt.

Tiến trình nạp firmware ESP32 bằng ESP-Web-Tools
Thanh tiến trình nạp firmware bằng ESP-Web-Tools.

8. Hoàn tất và kiểm tra bo mạch

  1. Khi tiến trình đạt 100% và hiện trạng thái thành công, bạn có thể rút bo mạch ra và cấp nguồn lại (nếu cần).
  2. Màn hình sẽ hiển thị giao diện khởi động của Xiaozhi, loa/bộ giải mã âm thanh bắt đầu hoạt động theo cấu hình mới.
  3. Thử gọi wake word (ví dụ “Hi Telly” hoặc “Hi Jayson” tùy mạch) để kiểm tra.
Nếu sau khi nạp xong, bo mạch không chạy đúng:
  • Kiểm tra lại xem bạn đã chọn đúng phiên bản cho loại màn hình chưa.
  • Thử nạp lại lần nữa, đảm bảo cáp USB ổn định.
  • Trao đổi thêm trong nhóm Facebook/Zalo của cộng đồng XIAOZHI VIỆT NAM.

9. Khi nào nên nạp lại firmware?

  • Khi bạn đổi loại màn hình (ví dụ từ OLED sang TFT).
  • Khi có bản firmware mới trên XIAOZHI.VN (sửa lỗi, thêm tính năng…).
  • Khi bo mạch chạy không ổn định sau thời gian dài sử dụng.
Trở lại trang Hướng dẫn Xiaozhi

Bài viết liên quan