Flash Gateway từ ESP32

Bạn cần: một board ESP32 tương thích (ESP32-C6 / ESP32-C3 / ESP32-S3 / ESP32 cổ điển — tool tự nhận diện) + cáp USB có data + trình duyệt Chrome / Edge / Opera ≥ 89. Quá trình mất 2-3 phút.

Sau khi flash xong

1. Rút USB, cấp nguồn cho gateway (USB-C 5V hoặc nguồn ngoài)
2. Mở app Pipe Home → đăng nhập / tạo tài khoản
3. Vào Tôi → Thêm gateway, làm theo hướng dẫn pair (giống hệt khi mua gateway thương mại):
   • App tìm gateway qua Wi-Fi AP setup hoặc Bluetooth
   • Chọn Wi-Fi nhà bạn, đặt tên gateway, gán vào căn nhà
4. Bắt đầu pair các thiết bị Zigbee, BLE Mesh, RF, IR, Modbus

Về chương trình Early Bird

Trong giai đoạn đầu, Pipe HC Gateway phần cứng chính thức chưa mở bán đại trà. Để bạn trải nghiệm hệ thống ngay, chúng tôi mở chương trình Early Bird — bạn tự dựng gateway từ một board ESP32-C6 phổ thông, firmware do chúng tôi build sẵn và nạp trực tiếp từ website này.

Sau khi flash, board pair vào app Pipe Home qua flow chuẩn — giống y hệt cách pair của gateway thương mại.

Bạn được gì

• Gateway hoạt động đầy đủ chức năng cốt lõi — Wi-Fi 6 + Zigbee 3.0 hoặc BLE Mesh (chọn 1 lúc flash)
• Cập nhật firmware miễn phí dài hạn qua OTA
• Pair flow giống hệt sản phẩm chính thức — dùng cùng app Pipe Home

ESP32-C6 chỉ chạy được 1 trong 2 radio 802.15.4 / Bluetooth tại một thời điểm. Bạn chọn build phù hợp với loại thiết bị mình định dùng:

• Zigbee build (sẵn sàng) — cho thiết bị Zigbee 3.0 (Aqara, IKEA, Tuya, Sonoff…). Hỗ trợ ~5000 model.
• BLE Mesh build (sắp ra) — cho đèn / công tắc theo SIG Mesh.

Phiên bản gateway thương mại sau (Pipe HC v2) sẽ chạy đồng thời cả Zigbee + BLE Mesh, không cần chọn.

Giới hạn so với sản phẩm chính thức

Early Bird gateway không phải bản đầy đủ — có một số giới hạn để khuyến khích nâng cấp khi cần scale:

Phù hợp cho căn hộ nhỏ + ai muốn dùng thử. Khi nhu cầu scale (nhà phố, biệt thự, văn phòng) → nâng cấp sang sản phẩm chính thức để có capacity + bảo hành.

Câu hỏi thường gặp

Trình duyệt báo “navigator.serial is undefined”

Web Serial API chỉ có trên Chrome/Edge/Opera ≥ 89 trên desktop, hoặc Chrome Android. Firefox và Safari chưa hỗ trợ.

Không thấy cổng USB nào khi bấm Connect

• Trên Linux: sudo usermod -aG dialout $USER rồi logout/login lại
• Trên Windows: ESP32-C6 SuperMini với USB native không cần driver; board dùng CP2102/CH340 cần cài driver
• Cáp USB phải hỗ trợ data — nhiều cáp sạc rẻ chỉ có 2 dây nguồn

Flash bị ngắt giữa chừng / báo timeout

• Giữ nút BOOT trên board khi cắm USB (force vào download mode)
• Thử cổng USB / cáp khác
• Reload trang và làm lại từ đầu

Mất kết nối Wi-Fi sau khi flash

ESP32-C6 mặc định không có credential Wi-Fi. Sau flash, gateway phát AP PipeHC-XXXX cho app pair lần đầu. Nếu không thấy AP: reset board (RST hoặc rút cắm lại USB).

Tôi đã có ESP32-S3 / -C3 / -WROOM, dùng được không?

Hiện tại firmware chỉ build cho ESP32-C6. Các chip khác đang trong roadmap.

Có an toàn khi flash từ trình duyệt không?

Trình duyệt sandbox không thể truy cập file hệ thống của bạn. esptool-js chỉ giao tiếp với cổng USB mà bạn chủ động cho phép truy cập. Firmware tải về qua HTTPS, có thể tự verify checksum.

Pre-register MAC để làm gì?

Việc pre-register chỉ là kỹ thuật — tạo “device record” trống trên hệ thống để gateway có thể connect khi boot. Không gắn MAC với tài khoản nào. Việc gateway thuộc tài khoản của bạn quyết định ở bước pair trong app, giống hệt sản phẩm chính thức.

Cần hỗ trợ?

Email: support@mpipe.org — đính kèm log từ Chrome Console (F12) nếu báo lỗi. Báo cáo lỗi firmware: ghi rõ phiên bản firmware, chip target, output serial.