m8schmit/ecovacs-stack

🧹 Ecovacs Stack: Giải pháp tự quản lý robot vacuum Deebot T9

Bộ phần mềm backend và frontend giúp quản lý và điều khiển robot vacuum Deebot T9 trực tiếp trên hệ thống local, loại bỏ phụ thuộc vào cloud.

Ecovacs-stack là một dự án mã nguồn mở được phát triển bởi m8schmit, tập trung vào việc quản lý robot vacuum Deebot T9 (đã được test trên model T9 AIVI running Linux). Dự án bao gồm một backend server xử lý giao tiếp MQTT và một frontend web để người dùng tương tác, tất cả đều được thiết kế để chạy tự hosting.

✨ Điểm nổi bật

• Kiến trúc phân tách Backend/Frontend: Backend xử lý MQTT trên cổng 8883 và 443, trong khi frontend listen trên cổng 3000 qua WebSocket để cập nhật sự kiện theo thời gian thực.
• Hỗ trợ cơ sở dữ liệu tích hợp: Sử dụng MySQL trên cổng 3306 để đồng bộ hóa các sự kiện, lỗi và thông tin tuổi thọ, giúp hiển thị dữ liệu nhất quán.
• Cài đặt với Docker: Toàn bộ hệ thống có thể khởi chạy dễ dàng bằng Docker-compose, chỉ cần sao chép file .env.example và điều chỉnh thông tin thiết bị.
• Chuyển hướng DNS local: Cần thiết lập rule trong Dnsmasq để chuyển hướng các domain của Ecovacs (như ecouser.net, ecovacs.com) về địa chỉ IP local, đảm bảo robot vacuum kết nối đúng server.
• MQTT Topic linh hoạt: Backend đăng ký các topic như iot/p2p/ và iot/cfg/ để nhận và xử lý các lệnh từ robot, hỗ trợ nhiều command như playSound, getBattery, getCleanInfo.
• Phản hồi chuẩn hóa: Hầu hết các command đều trả về đối tượng JSON gồm code, msg và data, đơn giản hóa việc phân tích dữ liệu.

💡 Vì sao đáng chú ý

Điểm khác biệt của ecovacs-stack là việc mang toàn bộ quy trình quản lý robot vacuum về môi trường local, tăng tính riêng tư và kiểm soát. Thay vì phụ thuộc vào dịch vụ cloud, người dùng có thể tự host và tối ưu hóa dữ liệu. Đây là lựa chọn phù hợp cho những ai muốn tích hợp Deebot T9 vào hệ thống thông minh tự quản lý, hoặc đơn giản là theo dõi hiệu suất thiết bị một cách trực quan qua giao diện web.

Dự án vẫn đang trong giai đoạn phát triển sớm, nhưng đã cho thấy tiềm năng lớn trong việc đơn giản hóa giao tiếp với robot vacuum thông qua MQTT và WebSocket, đồng thời cung cấp nền tảng để mở rộng các tính năng mới.

---

#Deebot #Ecovacs #SelfHosted #VacuumRobot #TiniX