TanDev
original creator of Mochi and Xiaozhi trend
Chọn Chương Trình
Hướng dẫn nạp firmware
- Vui lòng sử dụng máy tính để nạp chương trình
- Nếu gặp tình trạng cổng COM ẩn hiện liên tục, nhấn giữ nút BOOT và gim cáp kết nối với máy tính
- Chọn chip và màn hình phù hợp và nhấn kết nối
- Chọn cổng COM của chip và nhấn Kết nối -> Install -> Install -> chờ nạp xong code
Chat Bot AI (Xiaozhi) - Firmware Version 2.4.0
-
🆕 CHỨC NĂNG MỚI UPDATE
🚀 Nâng cấp nền tảng
• Update theo dự án gốc lên 2.4.0 với IDF 6.0.
• Tối ưu firmware hoạt động nhanh nhất.
🎵 Nâng cấp phát nhạc
• Sửa các lỗi khi phát nhạc hiện có.
• Sửa lỗi và tăng tốc độ hiển thị thumb bài hát.
• Hỗ trợ phát nhạc với định dạng gốc YouTube mp4, webm, opus.
📻 Radio
• Sửa lỗi radio.
🔄 OTA & cấu hình
• Thêm cập nhật qua OTA cho ESP32-S3 N16R8.
• Thêm xuất nhập config.json từ web cấu hình thiết bị.
• Update giao diện web WiFi config.
• Hỗ trợ thêm nhiều cấu hình thiết bị có sẵn trong cấu hình nhanh trong web config WiFi.
🔊 Hỗ trợ output âm thanh
• Hỗ trợ nhiều loại output khác nhau như I2S MAX98357A, ES8311, Box Audio (ES8311 + ES7210), 2 mic,...
🧠 Nâng cấp giọng nói & wakeup word
• Nâng cấp công nghệ logic xử lý giọng nói và wakeup word giúp nhận diện và thu âm chính xác hơn.
🛠 Tiện ích & sửa lỗi
• Thêm MCP tắt/mở màn hình chờ thời tiết.
• Fix và nâng cấp báo thức.
• Thêm giữ nút tăng âm lượng khi khởi động để vào cấu hình WiFi cho thiết bị không có nút boot.
⚠️ Lưu ý
• Đối với phiên bản ESP32-S3 N4R2 (Mini/Zero), sẽ không sử dụng được giao diện assets vì đã đến giới hạn bộ nhớ. -
✅ CHỨC NĂNG HIỆN CÓ (ĐÃ ỔN ĐỊNH)
🕒 Giao diện thời tiết + đồng hồ lật (Auto Idle) cho màn hình LCD TFT
• Tự động chuyển sang giao diện thời tiết và đồng hồ lật sau 10 giây không sử dụng thiết bị.
• Hiển thị trực quan, tối ưu làm màn hình chờ.
🔵 Bluetooth
• Thêm chức năng kết nối Bluetooth.
• Hỗ trợ phát âm thanh và mở rộng thiết bị ngoại vi.
🛠 Fix lỗi nâng cấp hệ thống
• Sửa lỗi trong quá trình update firmware.
• Tăng độ ổn định khi nâng cấp OTA và nạp firmware.
🔥 Firmware hợp nhất - 1 file duy nhất
• Chỉ cần nạp 1 firmware cho tất cả thiết bị.
• Hỗ trợ đa dạng phần cứng: màn hình, micro, loa, thiết bị ngoại vi.
• Tùy chọn linh hoạt theo nhu cầu sử dụng.
🔌 Tùy chỉnh GPIO linh hoạt
• Không cần sơ đồ phần cứng cố định.
• Cho phép tự do hàn nối theo cách tối ưu nhất.
• Cấu hình GPIO không giới hạn, dễ dàng thay đổi trực tiếp trên firmware.
🌐 Tab Cấu Hình Thiết Bị (Device Config)
• Tích hợp trong trang Web Setup WiFi, cho phép cấu hình toàn bộ thiết bị.
📟 Cấu Hình Thiết Bị
• Chọn loại màn hình, ngôn ngữ hệ thống.
🖥️ Màn Hình (Screen Preset)
• Chọn driver, kích thước, xoay màn hình.
• Hỗ trợ giao diện như WeChat UI và nhiều preset khác.
🔧 GPIO Màn Hình & Âm Thanh
• Display SPI GPIO: cấu hình chân SPI cho màn hình.
• Mic & Audio GPIO: cấu hình chân micro và loa.
🔘 Thiết Bị Ngoại Vi (Peripherals)
• LED trạng thái
• Nút Wakeup
• Nút Volume (+ / -)
• Hiển thị & đo mức pin
⚡ Tối ưu hiệu năng hệ thống
• Cải tiến hệ thống nhạc và API.
• Mang lại trải nghiệm nhẹ hơn - mượt hơn - ổn định hơn trong mọi hoạt động.
✅ Âm thanh Stereo 2 kênh
• Phát âm thanh trái / phải (Stereo) rõ ràng, tách kênh tốt hơn.
✅ Báo thức & Đếm ngược
• Đặt / xoá / kiểm tra bằng giọng nói.
✅ Code gốc từ GitHub
https://github.com/78/xiaozhi-esp32
Sơ Đồ Đấu Nối ESP32-S3 DevKit
⚠️ Ghi chú
- Màn hình OLED: SSD1306, giao tiếp I2C, địa chỉ mặc định 0x3C
- MIC INMP441: micro kỹ thuật số, sử dụng giao tiếp I2S
- MAX98357A: bộ khuếch đại mono, cũng sử dụng giao tiếp I2S
- Nút bấm: Kéo xuống GND
- ESP32-S3: sử dụng GPIO từ 0 đến 46 (chọn GPIO hỗ trợ I2S/I2C)
Sơ Đồ Đấu Nối ESP32-S3 Super Mini / ESP32 S3 Zero dùng chung
⚠️ Ghi chú
- Màn hình OLED: SSD1306, giao tiếp I2C, địa chỉ mặc định 0x3C
- MIC INMP441: micro kỹ thuật số, sử dụng giao tiếp I2S
- MAX98357A: bộ khuếch đại mono, cũng sử dụng giao tiếp I2S
- Nút bấm: Kéo xuống GND
- ESP32-S3: sử dụng GPIO từ 0 đến 46 (chọn GPIO hỗ trợ I2S/I2C)
Linh tinh
Bluetooth Xiaozhi (Có Phí)
FW ESP32 Bluetooth là firmware cầu nối âm thanh Bluetooth dành cho hệ thống chatbot Xiaozhi, sử dụng ESP32 để nhận âm thanh từ ESP32-S3 qua I2S và phát ra loa hoặc tai nghe Bluetooth bằng chuẩn A2DP.
- ✅ Âm thanh chất lượng cao 44.1kHz Stereo
- ✅ Kết nối với chatbot Xiaozhi
- ✅ Quét và kết nối loa Bluetooth
- ✅ Tự lưu và tự kết nối lại thiết bị đã ghép đôi
- ✅ Điều khiển bằng giọng nói
- ✅ Streaming âm thanh ổn định, độ trễ thấp
Danh sách lệnh điều khiển (Voice Commands)
Chính Sách Mua Key
📋 Thông Tin Cơ Bản
- Khi mua, người dùng nhận được 01 key kích hoạt
- Mỗi key chỉ sử dụng được trên 01 thiết bị ESP32
- Có thể sử dụng key nhiều lần trên cùng 1 thiết bị
🆓 Key Được Cấp Miễn Phí Khi
- Người dùng thay bo mạch ESP32 do lỗi phần cứng
- Làm thêm thiết bị với mục đích cá nhân (không thương mại)
💼 Chính Sách Cấp Key Bổ Sung
Nếu sử dụng để tạo thêm nhiều sản phẩm hoặc triển khai thương mại, người dùng cần:
- Mua key bổ sung theo số lượng thiết bị
- Liên hệ trực tiếp để được báo giá và hỗ trợ
Sơ Đồ Đấu Nối Bluetooth Xiaozhi
⚠️ Ghi chú quan trọng
- Nguồn điện: Đảm bảo chân MASS (GND) cả 2 thiết bị phải dùng chung, chúng mới có thể kết nối với nhau.
Retro-Go - ESP32-S3
Retro-Go là firmware chơi game retro dành cho thiết bị ESP32-S3 Retro-Go, sử dụng màn hình, nút điều khiển và loa tích hợp trên board.
- Thiết bị hỗ trợ: ESP32-S3 Retro-Go
- Ghi chú: Vui lòng tải fw về và dùng Flash Download Tool nạp ở địa chỉ 0x0, nạp online sẽ bị treo web.
Hướng dẫn Retro
-
Hướng dẫn Video: Tải video về máy, sau đó dùng
ffmpeg để chuyển đổi sang định dạng ESP32-S3 Retro-Go có thể xem
được. Copy file video đã convert vào thẻ nhớ theo thư mục
roms/video.
ffmpeg -i input.mp4 -vf "scale=320:-2,fps=12" -c:v libx264 -profile:v baseline -level 3.0 -pix_fmt yuv420p -preset veryslow -tune fastdecode -b:v 180k -maxrate 220k -bufsize 440k -c:a aac -ar 44100 -ac 1 -b:a 64k output.mp4
- Nếu chưa cài ffmpeg, có thể cài bằng lệnh:
winget install Gyan.FFmpeg
- input.mp4: file video gốc.
- output.mp4: file sau khi chuyển đổi.
- fps=12: tốc độ khung hình tốt nhất để ESP32-S3 phát mượt, bạn cũng có thể thử các fps khác nhau.
- Nếu chưa cài ffmpeg, có thể cài bằng lệnh:
-
Hướng dẫn Xiaozhi:
- Lần đầu vào Xiaozhi có thể bị đơ ở màn hình icon loading. Hãy bắt WiFi do thiết bị phát ra, mở web 192.168.4.1, vào cấu hình thiết bị, chọn cấu hình nhanh là Retro-Go rồi lưu cấu hình. Sau đó mới config WiFi. Khi config WiFi thành công, tắt thiết bị và khởi động lại để dùng Xiaozhi bình thường.
- Lần đầu dùng sẽ chưa có custom Xiaozhi. Vào xiaozhi.me để custom lại giao diện Xiaozhi.
- Để chuyển đổi giữa Retro-Go và Xiaozhi: khi bật nguồn, giữ phím A khoảng 5-10 giây để mở giao diện chọn ROM rồi chuyển đổi.
-
Hướng dẫn YouTube:
- Phải có key và kết nối WiFi mới sử dụng được.
- Spam key 5 lần sẽ bị khóa thiết bị.
- Key giá 30 cá, 1 key dùng vĩnh viễn trên 1 ESP32 duy nhất.
Chương trình hỗ trợ
| Chương trình | Mục | Định dạng file |
|---|---|---|
| Nintendo Entertainment System | nes | nes, fc, fds, nsf, zip |
| Super Nintendo | snes | smc, sfc, zip |
| Nintendo Gameboy | gb | gb, gbc, zip |
| Nintendo Gameboy Color | gbc | gbc, gb, zip |
| Nintendo Gameboy Advance | gba | gba, zip |
| Nintendo Game & Watch | gw | gw |
| Sega Master System | sms | sms, sg, zip |
| Sega Game Gear | gg | gg, zip |
| Sega Mega Drive | md | md, gen, bin, zip |
| Coleco ColecoVision | col | col, rom, zip |
| NEC PC Engine | pce | pce, zip |
| Atari Lynx | lnx | lnx, zip |
| DOOM | doom | wad, zip |
| MSX | msx | rom, mx1, mx2, dsk |
| YouTube | youtube | mp3, m3u |
| Video Player | video | mp4 |
| Xiaozhi | xiaozhi | bin |
Sơ Đồ ESP32-S3 Retro-Go
⚠️ Ghi chú
- Kiểm tra đúng chiều cắm và nguồn cấp trước khi nạp firmware.
- Sử dụng đúng file firmware Retro-Go cho ESP32-S3 Retro-Go.
MochiNav V5.5.0
- Kết nối:
1. Thêm chức năng cho phép chỉnh thời gian tự động tắt BLE khi không có kết nối với điện thoại: 5 10 15 20 25 30 phút. - Biểu cảm:
1. Vẫn giữ lại 84 biểu cảm thay vì bản chính thức trên sản phẩm thương mại là 102 biểu cảm
2. Thêm một số tùy chọn khi phát emoji như: Ngẫu nhiên - tuần tự, Delay - No delay, Nháy mắt,...
- Âm Thanh
1. Thêm bật / tắt âm thanh tổng cho toàn bộ thiết bị, và âm thanh cho emoji khi phát
2. Bộ nhớ ESP32-C3 Super Mini chỉ 4MB nên tôi chỉ lưu được 102 biểu cảm + 2 âm thanh intro / Nên âm thanh biểu cảm sẽ được lưu vào thẻ nhớ.
3.Thẻ nhớ chuẩn Format FAT32, Âm thanh biểu cảm sẽ có dạng Wav 16bit 22050HZ Mono, và được đánh số thứ tự từ 1 đến 102. 4. Ở bản này vẫn chưa công khai âm thanh full cho biểu cảm, biểu cảm vẫn sẽ không có âm thanh
- Thêm Menu Update (Đang phát triển)
1. Cho phép nhập và lưu SSID và Passwrod WiFi vào thiết bị
2. Hiển thị phiên bản hiện tại và chức năng kiểm tra phiên bản cập nhật khi có phiên bản mới
3. Thêm chuyển đổi ngôn ngữ: Hiện tại hỗ trợ 2 ngôn ngữ chính là Vietnamese và English, điều chỉnh trực tiếp trong app Chronos hoặc trong Menu -> Cập nhật
- Đồng hồ
1. Đã thêm hiển thị âm lịch trong giao diện đồng hồ
2. Thêm dự báo thời tiết, nhiệt độ hiện tại, Sync từ app Chronos
- Tối ưu xử lý:
Đã tối ưu chương trình ngắn gọn hoạt động ổn định và nhanh hơn. - Phím tắt nhanh: Đã thêm phím tắt nhanh ở giao diện
emoji:
1. Nếu có nút bạn nhấn 1 lần hoặc nhấn "Tìm Đồng Hồ" sẽ tắt chuyển sang màn hình Đồng Hồ.
2. Nếu có nút bạn nhấn 2 lần nhanh sẽ tắt hoặc bật phát animations ngẫu nhiên hay tuần tự.
3. Nếu có nút bạn nhấn 3 lần nhanh sẽ tắt hoặc bật âm thanh.
4. Nếu có nút bạn nhấn 4 lần nhanh sẽ tắt hoặc bật thời gian chờ khi phát animations ngẫu nhiên - Bug:
Đã fix một số lỗi như: không setting đã cài đặt,... - Còn nữa: .....
📌 Lưu ý
- Người dùng đã có key cũ có thể tiếp tục sử dụng lại key trên cùng thiết bị
- Khuyến nghị cập nhật để nhận được các tính năng mới nhất
Sơ Đồ Đấu Nối ESP32-C3
ESP32-C3 - OLED 0.96inch
| ESP32-C3 | OLED 0.96inch |
|---|---|
| 3V3 | VCC |
| GND | GND |
| GPIO8 | SDA |
| GPIO9 | SCL |
ESP32-C3 - MAX98357A
| ESP32-C3 | MAX98357A |
|---|---|
| GPIO5 | LRCLK |
| GPIO6 | BCLK |
| GPIO7 | DIN |
| GND | GAIN |
| 3V3 | SD |
| GND | GND |
| 3V3 | VIN |
ESP32-C3 - Module TF Micro SD Card Mini
| ESP32-C3 | Module TF Micro SD Card Mini |
|---|---|
| GPIO1 | CLK |
| GPIO2 | MISO |
| GPIO3 | MOSI |
| GPIO4 | CS |
| GND | GND |
| 3V3 | 3v3 |
⚠️ Lưu Ý
- Không lắp màn hình, chương trình sẽ không chạy
- Màn hình OLED: Sử dụng loại 0.96" SSD1306 I2C (địa chỉ 0x3C)
- Nút nhấn (có thể làm hoặc không, không ảnh hưởng gì): Kết nối GND với GPIO0 để điều khiển thiết bị
Sơ Đồ Đấu Nối ESP32
ESP32 - OLED 0.96inch
| ESP32 | OLED 0.96inch |
|---|---|
| 3V3 | VCC |
| GND | GND |
| GPIO21 | SDA |
| GPIO22 | SCL |
ESP32 - MAX98357A
| ESP32 | MAX98357A |
|---|---|
| GPIO25 | LRCLK |
| GPIO26 | BCLK |
| GPIO27 | DIN |
| GND | GAIN |
| 3V3 | SD |
| GND | GND |
| 3V3 | VIN |
⚠️ Lưu Ý
- Màn hình OLED: Sử dụng loại 0.96" SSD1306 I2C (địa chỉ 0x3C)
- Nút nhấn (có thể làm hoặc không, không ảnh hưởng gì): Kết nối GND với GPIO0 để điều khiển thiết bị
Chính Sách Mua Key
📋 Thông Tin Cơ Bản
- Khi mua, người dùng nhận được 01 key kích hoạt
- Mỗi key chỉ sử dụng được trên 01 thiết bị ESP32
- Có thể sử dụng key nhiều lần trên cùng 1 thiết bị
🆓 Key Được Cấp Miễn Phí Khi
- Người dùng thay bo mạch ESP32 do lỗi phần cứng
- Làm thêm thiết bị với mục đích cá nhân (không thương mại)
💼 Chính Sách Cấp Key Bổ Sung
Nếu sử dụng để tạo thêm nhiều sản phẩm hoặc triển khai thương mại, người dùng cần:
- Mua key bổ sung theo số lượng thiết bị
- Liên hệ trực tiếp để được báo giá và hỗ trợ
⚠️ Lưu Ý
- Bạn đã mua Key và chỉ update code, có thể sử dụng lại Key cũ trên chính ESP32 mà bạn đã kích hoạt trước đó
- Nếu bạn chưa mua Key và spam kích hoạt sẽ bị hệ thống chúng tôi chặn
- Mua 1 lần sử dụng trọn đời, hỗ trợ update vô thời hạn
Tính Năng Chính
Biểu Cảm Dasai Mochi
Hơn 80 hiệu ứng chuyển động ngẫu nhiên tạo cảm giác sinh động và thú vị
Intro Khởi Động
Linh hoạt chuyển đổi Intro khởi động giữa Bassic hoặc Liberty Walk có kèm theo âm thanh
Âm Thanh Biểu Cảm
Hơn 50% biểu cảm đã có âm thanh, giúp cho trải nghiệm thêm sống động.
Hiển Thị Thời Gian Thực
Đồng hồ, phần trăm pin điện thoại, ngày tháng được cập nhật liên tục đồng bộ với điện thoại
Dẫn Đường Google Maps
Hiện hướng đi, thời gian di chuyển, chỉ dẫn bằng biểu tượng và văn bản
Thông Báo Cuộc Gọi & Ứng Dụng
Hiện tên người gọi, tin nhắn Zalo, Messenger, và các ứng dụng khác
Dự Báo Thời Tiết
Đồng bộ thông tin thời tiết hiện tại từ điện thoại
Menu Tinh Chỉnh
Bật/tắt Bluetooth, âm thanh, điều chỉnh âm lượng, cập nhật phần mềm,...
Chức Năng Ẩn
-
Chuyển Màn Hình
Nếu có nút bạn nhấn nhã 1 lần sẽ chuyển sang màn hình thời gian, không có nút kết nối với thiết bị và nhấn "Tìm đồng hồ" trên App Chronos 1 lần.
-
Menu
Nếu có nút bạn nhấn giữ 1 lần để vào Menu, không có nút kết nối với thiết bị và nhấn "Tìm đồng hồ" trên App Chronos 2 lần liên tiếp.
-
Di Chuyển Và Chọn Trong Menu
1. Nếu có nút bạn nhấn nhã 1 lần sẽ là di chuyển trong Menu, không có nút kết nối với thiết bị và nhấn "Tìm đồng hồ" trên App Chronos 1 lần.
2. Nếu có nút bạn nhấn giữ 1 lần sẽ là chọn trong Menu, không có nút kết nối với thiết bị và nhấn "Tìm đồng hồ" trên App Chronos 2 lần liên tiếp.
-
Phím Tắt Nhanh
1. Nếu có nút bạn nhấn 2 lần sẽ tắt hoặc bật phát animations ngẫu nhiên hay tuần tự
2. Nếu có nút bạn nhấn 3 lần sẽ tắt hoặc bật âm thanh
3. Nếu có nút bạn nhấn 4 lần nhanh sẽ tắt hoặc bật thời gian chờ khi phát animations ngẫu nhiên
Cập Nhật Liên Tục
Thiết bị sẽ liên tục được nâng cấp phần mềm/tính năng trong thời gian tới để mang đến trải nghiệm tốt nhất cho người dùng.
⚠️ Lưu Ý
- Tính từ khi khởi động, nếu bạn không kết nối điện thoại với thiết bị, thiết bị sẽ tự động tắt Bluetooth sau 3 phút giúp tăng thời gian sử dụng pin và tránh tình trạng thiết bị bị nóng khi không sử dụng.
Hướng Dẫn Thêm Âm Thanh Vào Thiết Bị MochiNav
Tải file "audio.bin"
Tải file "audio.bin", file này chứa 70 âm thanh biểu cảm cho chương trình MochiNav
Chọn ổ đĩa và Format
Chọn ổ đĩa thẻ nhớ -> chuột phải chọn Format
Format
File system: chọn FAT32
Format options: bỏ tích Quick Format "Để nó định dạng lại toàn bộ thẻ nhớ"
Nhấn Start để bắt đầu
Copy File Audio.bin
Copy file "audio.bin" đã tải ở bước 1, vào thẳng thẻ nhớ, không cần tạo thư mục. Bắt buộc tên file phải là "audio.bin"
Cập nhật ChatBot AI
1. Trang cập nhật firmware cho thiết bị Chatbot AI — chỉ dành cho khách hàng đã mua sản phẩm bên TanDev
2. Thiết bị sẽ không hoạt động nếu không phải thiết bị được mua từ TanDev
3. Link tải firmware cho khách hàng lỡ cài firmware người khác bị treo thiết bị-> Link: Firmware Chatbot Ai - TanDev
Gỡ liên kết thiết bị khỏi tài khoản
1. DeviceID (Có thể có hoặc không) lấy ở đâu? Bạn hãy mở ChatBot và nói với nó Mã thiết bị của tôi là gì, nó đọc cho bạn nghe.
2. MAC Address (Bắt buộc phải có) lấy ở đâu? Bạn chỉ cần kết nối thiết bị với máy tính qua cáp USB, nhấn Kết nối để lấy MAC, sau đó chọn cổng COM thiết bị và nhấn Lấy MAC.
3. Điền MAC Address và Device ID của thiết bị Xiaozhi, sau đó bấm Gửi mail để mở Gmail với mẫu nội dung sẵn có gửi đến xiaozhi.ai@tenclass.com.
4. NOTE: Bạn cũng có thể sử dụng tính năng Pypass Device của Fw TanDev nếu muốn nhanh gọn lẹ (Chỉ có hiệu lực khi dùng Fw bên TanDev).
📌 Lưu ý
- Chỉ sử dụng khi bạn đã liên kết thiết bị ChatBot Xiaozhi với một tài khoản mà bây giờ bạn không thể đăng nhập được. Việc gỡ liên kết này sẽ giúp bạn có thể đăng ký tài khoản mới và liên kết lại thiết bị với tài khoản mới.
Ủng hộ TanDev
Nếu bạn yêu thích sản phẩm Xiaozhi và muốn hỗ trợ đội ngũ phát triển, bạn có thể ủng hộ chúng tôi. Mọi đóng góp đều giúp chúng tôi nâng cao chất lượng sản phẩm và phát triển thêm các tính năng mới!
Chúng tôi xin chân thành cảm ơn sự ủng hộ của bạn!
Phương thức ủng hộ:
MoMo
Chủ tài khoản: TRAN NGOC TAN
Nếu bạn có bất kỳ câu hỏi nào, vui lòng liên hệ với chúng tôi qua: Facebook, Zalo, hoặc TikTok.