Nhảy tới nội dung

Lập trình ESP32-S3 với Arduino IDE

Cài board package hỗ trợ ESP32-S3, cấu hình USB CDC và PSRAM cho đúng phiên bản module, những khác biệt chân so với ESP32 cổ điển và cách xử lý lỗi nạp thường gặp.

Đăng ngày: 25/08/2026

Cài board package và chọn board ESP32S3 Dev Module

ESP32-S3 chỉ được hỗ trợ từ gói esp32 by Espressif Systems phiên bản 3.0.0 trở lên, nên hãy cập nhật gói board trong Boards Manager rồi chọn Tools > Board > ESP32 Arduino > ESP32S3 Dev Module.

Cấu hình Tools cho một board phổ biến loại N16R8 (16 MB flash, 8 MB PSRAM) như sau:

Mục trong ToolsGiá trịVì sao
USB CDC On BootEnabledSerial đi qua cổng USB native của chip
USB ModeHardware CDC and JTAGDùng đúng bộ USB tích hợp trong S3
Flash Size16MB (128Mb)Khớp dung lượng flash thực của module
PSRAMOPI PSRAMĐúng cho PSRAM octal 8 MB
Partition Scheme16M Flash (3MB APP/9.9MB FATFS)Vừa chương trình vừa vùng lưu dữ liệu
Upload Speed921600Nhanh, hạ xuống 460800 nếu cáp kém

Nếu module của bạn là loại N8R2 với 2 MB PSRAM quad, hãy chọn QSPI PSRAM. Chọn sai loại PSRAM khiến board khởi động lại liên tục sau khi nạp.

ESP32-S3 vẫn là chip 3.3 V. Đừng nối chân GPIO trực tiếp với cảm biến hoặc module 5 V, kể cả khi board có chân 5V cấp ra từ cổng USB.

USB CDC, cổng Serial và cách nạp chương trình

ESP32-S3 có bộ USB native nối thẳng vào hai chân GPIO19 (D-) và GPIO20 (D+), tách biệt với UART0 trên GPIO43 (TX) và GPIO44 (RX). Cách hai cổng này hoạt động phụ thuộc vào tùy chọn USB CDC On Boot.

Khi tùy chọn này bật, Serial ghi log ra cổng USB native, trên máy tính hiện dưới dạng cổng ACM (/dev/ttyACM0 trên Linux) hoặc USB JTAG/serial debug unit trên Windows. Khi tắt, Serial quay về UART0 và cổng USB native chỉ hiện ra lúc chip ở chế độ nạp, dễ khiến bạn tưởng nhầm là chương trình không chạy.

Khi USB CDC bật, chương trình có thể chạy trước khi máy tính mở cổng nối tiếp; hãy thêm delay(1500) ở đầu setup() để không mất những dòng log đầu tiên.

PSRAM và phân vùng bộ nhớ

PSRAM là bộ nhớ ngoài gắn thêm cho ESP32-S3, dùng chứa ảnh, bộ đệm lớn hoặc log dài. Muốn dùng phải bật tùy chọn PSRAM trong Tools; nếu chưa bật, psramFound() trả về false và mọi lệnh ps_malloc() đều thất bại.

Phân vùng cũng cần khớp với chương trình: chương trình dùng Wi-Fi, MQTT và TLS thường vượt qua 1.3 MB, tức vượt hạn mức của phân vùng mặc định cho flash 4 MB. Với board 16 MB, chọn 16M Flash (3MB APP/9.9MB FATFS) hoặc Huge APP tùy nhu cầu lưu tệp.

Khác biệt chân so với ESP32 cổ điển

Đây là phần khiến nhiều dự án chuyển từ ESP32 sang ESP32-S3 phải sửa bo mạch: số hiệu chân không tương đương nhau.

Nhóm chânESP32 cổ điểnESP32-S3
GPIO22 đến GPIO25Dùng đượcKhông tồn tại trên chip
GPIO26 đến GPIO32Dùng đượcDành cho flash và PSRAM
GPIO33 đến GPIO37Dùng đượcDành cho PSRAM octal
GPIO19 và GPIO20Dùng đượcUSB D- và D+
GPIO43 và GPIO44UART0UART0 TX và RX
GPIO34 đến GPIO39Chỉ vàoKhông tồn tại trên chip
Chân strapping0, 2, 12, 150, 3, 45, 46

Về ADC, ESP32-S3 có ADC1 trên GPIO1 đến GPIO10 và ADC2 trên GPIO11 đến GPIO20. Khối ADC2 dùng chung tài nguyên với Wi-Fi nên khi Wi-Fi đang bật, hãy chỉ dùng ADC1.

#include <WiFi.h>

const int PIN_LED = 4;

void setup() {
  Serial.begin(115200);
  delay(1500);
  Serial.print("Chip: ");
  Serial.println(ESP.getChipModel());
  Serial.print("So loi CPU: ");
  Serial.println(ESP.getChipCores());
  Serial.print("Flash: ");
  Serial.println(ESP.getFlashChipSize());
  if (psramFound()) {
    Serial.print("PSRAM: ");
    Serial.println(ESP.getPsramSize());
  } else {
    Serial.println("PSRAM chua duoc bat trong Tools");
  }
  pinMode(PIN_LED, OUTPUT);
  Serial.println("USB CDC da san sang");
}

void loop() {
  digitalWrite(PIN_LED, HIGH);
  delay(500);
  digitalWrite(PIN_LED, LOW);
  delay(500);
  Serial.print("Heap con lai: ");
  Serial.println(ESP.getFreeHeap());
}

Đoạn mã trên dùng LED nối ngoài vào GPIO4 qua trở 220 Ω, vì đa số board ESP32-S3 không có LED gắn cố định vào một chân GPIO như DevKit V1.

Lỗi nạp thường gặp và cách xử lý

  • `Failed to connect to ESP32-S3: No serial data received`: giữ BOOT (GPIO0), nhấn và thả RESET, rồi thả BOOT khi IDE hiện dòng Connecting.... Nếu vẫn lỗi, hạ Upload Speed xuống 460800.
  • Board khởi động lại liên tục, log báo lỗi PSRAM: chọn lại đúng OPI hoặc QSPI PSRAM, hoặc chọn Disabled nếu module không có PSRAM.
  • Nạp xong nhưng Serial Monitor trống: kiểm tra tùy chọn USB CDC On Boot và cổng nối tiếp đang mở.
  • Lỗi `Sketch too big`: đổi sang phân vùng Application lớn hơn trong Tools.
  • Cổng nối tiếp tự mất sau khi nạp: hiện tượng bình thường khi chip khởi động lại bộ USB; đợi vài giây rồi mở lại cổng.
  • Trên Linux, tài khoản cần thuộc nhóm dialout để mở được /dev/ttyACM0.

Sản phẩm liên quan