1. Tổng quan chức năng thẻ nhớ
Thẻ nhớ SD trên Xiaozhi đóng vai trò vừa là bộ nhớ cache offline, vừa là nơi để bạn tự tạo các thư mục nhạc yêu thích. Thiết bị sẽ:
- Tự tạo thư mục
offlineđể chứa các bài nhạc tải về từ Zing / SoundCloud / YouTube. - Cho phép bạn tự tạo thêm thư mục nhạc, ví dụ
music/vuivehoặcmusic/chonloc. - Hỗ trợ phát toàn bộ nhạc trong một thư mục bằng khẩu lệnh, ví dụ: “Hãy phát nhạc thư mục vui vẻ.”
👉 Khuyến nghị dùng thẻ nhớ chất lượng tốt, dung lượng vừa phải (8–32GB), format Fat32 trước khi sử dụng.
2. Sơ đồ đấu nối thẻ nhớ SD
Hình dưới đây minh họa cách đấu dây giữa module thẻ SD và mạch Xiaozhi ESP32. Bạn chỉ cần nối đúng 4 chân SPI và nguồn:
- MISO →
GPIO_NUM_12 - MOSI →
GPIO_NUM_13 - CLK →
GPIO_NUM_14 - VCC → 3.3V
- GND → GND chung với mạch Xiaozhi
3. Chuẩn bị thẻ nhớ & cấu trúc thư mục
3.1. Format thẻ nhớ
- Dùng máy tính để format thẻ nhớ về Fat32.
- Không nên dùng exFAT vì nhiều thư viện trên ESP32 không hỗ trợ ổn định.
- Sau khi format xong, cắm thẻ vào module SD như hình minh họa.
3.2. Thư mục offline do Xiaozhi tự tạo
Khi bạn yêu cầu Xiaozhi “hãy chép bài nhạc vừa phát vào thẻ nhớ”, thiết bị sẽ:
- Tự kiểm tra và tạo thư mục
/offline(nếu chưa có). - Lưu file nhạc đã tải về vào thư mục này để lần sau phát lại mà không cần mạng.
- Giảm tải cho server nhờ cơ chế cache, chỉ tải một lần và dùng lại nhiều lần.
3.3. Thư mục phát nhạc liên tục do người dùng tự tạo
Ngoài thư mục offline, bạn có thể tạo thêm thư mục để nghe nhạc theo playlist cá nhân, ví dụ:
music/vuive– chứa những bài nhạc sôi động, nghe khi cần năng lượng.music/chonloc– chứa các bài “chọn lọc” yêu thích nhất.
Chỉ cần copy các file .mp3 vào đúng thư mục, Xiaozhi sẽ tự nhận.
Khẩu lệnh gợi ý:
“Hãy phát nhạc thư mục vui vẻ.”
Hoặc: “Phát nhạc thư mục chọn lọc.”
Xiaozhi sẽ tự phát lần lượt toàn bộ các bài có trong thư mục tương ứng.
“Hãy phát nhạc thư mục vui vẻ.”
Hoặc: “Phát nhạc thư mục chọn lọc.”
Xiaozhi sẽ tự phát lần lượt toàn bộ các bài có trong thư mục tương ứng.
4. Kiểm tra sau khi đấu nối
Sau khi đấu dây và cắm thẻ nhớ, bạn có thể kiểm tra nhanh:
- Reset lại thiết bị Xiaozhi.
- Quan sát log serial (nếu có) để kiểm tra trạng thái mount SD: “[SD] Already mounted” hoặc tương tự.
- Dùng khẩu lệnh tải nhạc về thẻ hoặc phát nhạc thư mục để xác nhận hoạt động ổn định.
Nếu thiết bị báo lỗi “không đọc được thẻ”:
- Kiểm tra lại dây MISO/MOSI/SCK/CS đã nối đúng chân.
- Đảm bảo GND chung và nguồn 3.3V đủ ổn định.
- Kiểm tra lại xem thẻ đã format Fat32 hay chưa.
5. Tóm tắt nhanh
- Đấu 4 dây SPI: MISO–12, MOSI–13, CLK–14.
- Dùng thẻ nhớ tốt, format Fat32 trước khi sử dụng.
- Thư mục
offlinedo Xiaozhi tự tạo để cache nhạc tải về. - Tự tạo thư mục
music/vuive,music/chonloc… để phát nhạc liên tục bằng khẩu lệnh. - Khẩu lệnh mẫu: “Hãy phát nhạc thư mục vui vẻ.”
6. Các hướng dẫn liên quan
Nếu bạn mới làm quen với Xiaozhi hoặc cần tham khảo thêm các sơ đồ, bạn có thể xem thêm các bài viết sau: