Điều khiển thiết bị bằng chân GPIO trên XiaoZhi ESP32

Sử dụng đúng các chân mà firmware đã cấu hình sẵn để bật/tắt thiết bị an toàn – ổn định.

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

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

Sơ đồ chân ESP32-S3 Mạch Tím
Sơ đồ chân chuẩn – đối chiếu để cắm đúng relay.

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.