Tổng Quan
Cách kết nối, quản lý và sử dụng thiết bị phần cứng với trợ lý.
Thiết bị là các điểm cuối phần cứng của Assistant Core. Chúng nghe, nói, hiển thị trạng thái, nhận cấu hình và cung cấp các khả năng phần cứng mà trợ lý có thể gọi trong suốt cuộc hội thoại.
Các thiết bị được hỗ trợ hiện tại là các sản phẩm giọng nói ESP32-S3 tích hợp micro, loa, màn hình, kết nối Wi-Fi, hỗ trợ từ đánh thức (wake word) và cập nhật OTA. Mỗi thiết bị được đăng ký trong Admin Panel, sau đó được liên kết với một trợ lý cụ thể. Sau khi liên kết, thiết bị sẽ nhận cấu hình từ nền tảng, mở các phiên hội thoại giọng nói thời gian thực và có thể chạy các lệnh phần cứng được hỗ trợ.
Các thiết bị ESP32-S3 được hỗ trợ kết nối với Assistant Core qua phiên thoại realtime, cấu hình OTA và kênh điều khiển.
Thiết Bị Gồm Những Gì?
Một thiết bị thường bao gồm:
| Thành phần | Vai trò |
|---|---|
| Firmware | Chạy trên ESP32 hoặc phần cứng tương thích, xử lý audio, màn hình, nút bấm và kết nối mạng |
| Thông tin thiết bị | Tên, MAC, board, phiên bản firmware, trợ lý đang liên kết và trạng thái online |
| Phiên giọng nói | Cuộc hội thoại thời gian thực giữa thiết bị và trợ lý |
| Công cụ thiết bị | Khả năng mà trợ lý có thể gọi, ví dụ đổi màu LED, đọc cảm biến hoặc điều khiển phần cứng |
| Giao diện tùy chỉnh | Font, emoji, nền chat và wake word được đóng gói thành assets.bin cho thiết bị có màn hình |
Kiến Trúc Kết Nối
Kiến trúc kết nối của thiết bị qua MQTT Gateway tới Assistant Core.
Thiết bị không nói chuyện trực tiếp với toàn bộ hệ thống phía sau. Firmware chỉ cần kết nối tới MQTT Gateway; gateway chịu trách nhiệm chuyển tiếp trạng thái, âm thanh và lệnh tới đúng phiên trợ lý.
Assistant Core xử lý việc định tuyến trợ lý, điều phối mô hình, bộ nhớ, truy xuất tri thức và phân phối công cụ đằng sau ba đường dẫn tích hợp này:
| Đường dẫn | Dữ liệu truyền tải |
|---|---|
| Cấu hình OTA | Trạng thái kích hoạt, thông tin kết nối trợ lý, thời gian hệ thống và siêu dữ liệu firmware |
| Giọng nói thời gian thực | Âm thanh Opus từ micro đến Assistant Core và audio phản hồi từ phiên voice về loa |
| Kênh điều khiển | Trạng thái hoạt động (online/offline), các lệnh và công cụ thiết bị được firmware cung cấp |
Vòng Đời Thiết Bị
Vòng đời hoàn chỉnh của thiết bị từ khi nạp firmware đến phiên hội thoại giọng nói hoạt động.
Thiết bị bắt đầu bằng việc lấy cấu hình OTA từ nền tảng. Nếu chưa được liên kết, thiết bị sẽ hiển thị mã kích hoạt để bạn nhập vào dashboard. Sau khi liên kết, thiết bị có thể bắt đầu các phiên giọng nói, nhận phản hồi từ trợ lý, cung cấp các công cụ thiết bị và tiếp tục kiểm tra các bản cập nhật OTA mà không cần nạp lại firmware.
Bạn Muốn Làm Gì?
| Nhu cầu | Trang liên quan |
|---|---|
| Trỏ firmware về server của bạn (OTA URL) | Cấu Hình OTA URL |
| Nạp firmware cho thiết bị mới | Nạp Firmware |
| Thêm thiết bị phần cứng mới | Đăng Ký Thiết Bị |
| Cập nhật firmware từ xa | Cập Nhật Firmware OTA |
| Tùy chỉnh font, emoji, hình nền và từ đánh thức | Tùy Chỉnh Giao Diện |
| Xem các thiết bị phần cứng được hỗ trợ | Thiết Bị Hỗ Trợ |
| Nạp firmware tùy chỉnh (.bin) | Custom Flash |
| Cho phép trợ lý gọi các khả năng của thiết bị | Công Cụ Thiết Bị |
Nếu bạn chỉ muốn kết nối ESP32 để nói chuyện với trợ lý, hãy bắt đầu từ Nạp Firmware rồi Đăng Ký Thiết Bị.