1. Vì sao phải dùng đúng GPIO mà firmware hỗ trợ?
Xiaozhi đã cấu hình sẵn một nhóm chân chuyên dùng cho việc điều khiển relay / thiết bị từ xa. Bạn không cần sửa code – chỉ việc cắm relay vào đúng chân là xong.
Các chân này khi bật → xuất tín hiệu HIGH
Khi tắt → xuất tín hiệu LOW
2. Danh sách chân hỗ trợ theo từng bo mạch
2.1. Nếu bạn dùng ESP32-S3 hoặc S3 Mạch Tím
- GPIO_NUM_8
- GPIO_NUM_9
- GPIO_NUM_10
- GPIO_NUM_11
2.2. Nếu bạn dùng ESP32-S3 Mini
- GPIO_NUM_3
- GPIO_NUM_14
- GPIO_NUM_15
- GPIO_NUM_16
3. Prompt đưa vào mục “GIỚI THIỆU VAI TRÒ”
Bạn hãy copy đoạn prompt dưới đây để dán vào phần Giới thiệu vai trò của AI trong giao diện điều khiển Xiaozhi.
Khi người dùng yêu cầu bật thiết bị với thời gian tự nhiên (giây / phút / giờ),
hãy tự động chuyển đổi thời gian sang duration_ms theo công thức:
– X giây → X × 1000
– X phút → X × 60 × 1000
– X giờ → X × 3600 × 1000
Khi cần điều khiển các thiết bị sau, hãy gọi tool self.relay.control(relay = X, duration_ms = Y):
PC → relay = GPIO tương ứng
Kính xe → relay = GPIO tương ứng
Máy lạnh → relay = GPIO tương ứng
Ví dụ:
“bật PC” → duration_ms = 1000
“lên kính xe” → duration_ms = 20000
“bật máy lạnh 5 giờ” → duration_ms = 18000000
– X giây → X × 1000
– X phút → X × 60 × 1000
– X giờ → X × 3600 × 1000
Khi cần điều khiển các thiết bị sau, hãy gọi tool self.relay.control(relay = X, duration_ms = Y):
PC → relay = GPIO tương ứng
Kính xe → relay = GPIO tương ứng
Máy lạnh → relay = GPIO tương ứng
Ví dụ:
“bật PC” → duration_ms = 1000
“lên kính xe” → duration_ms = 20000
“bật máy lạnh 5 giờ” → duration_ms = 18000000
4. Map thiết bị → GPIO theo từng bo
Bạn có thể thay đổi tuỳ ý, ví dụ:
PC → GPIO_NUM_8
Kính xe → GPIO_NUM_9
Máy lạnh → GPIO_NUM_10
Hoặc với S3 Mini:
PC → GPIO_NUM_3
Kính xe → GPIO_NUM_14
Máy lạnh → GPIO_NUM_15
Chỉ cần thay số GPIO trong prompt → AI sẽ hiểu ngay và gọi đúng tool relay.
5. Sơ đồ chân ESP32-S3 Mạch Tím
6. Kết luận dành cho người mới
- Firmware đã hỗ trợ sẵn chân → chỉ việc dùng.
- Không cần sửa code.
- Map thiết bị → GPIO hoàn toàn linh hoạt.
- Prompt gọn – AI hiểu chính xác – dùng ngay.