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.
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 Tools | Giá trị | Vì sao |
|---|---|---|
| USB CDC On Boot | Enabled | Serial đi qua cổng USB native của chip |
| USB Mode | Hardware CDC and JTAG | Dùng đúng bộ USB tích hợp trong S3 |
| Flash Size | 16MB (128Mb) | Khớp dung lượng flash thực của module |
| PSRAM | OPI PSRAM | Đúng cho PSRAM octal 8 MB |
| Partition Scheme | 16M Flash (3MB APP/9.9MB FATFS) | Vừa chương trình vừa vùng lưu dữ liệu |
| Upload Speed | 921600 | Nhanh, 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ân | ESP32 cổ điển | ESP32-S3 |
|---|---|---|
| GPIO22 đến GPIO25 | Dùng được | Không tồn tại trên chip |
| GPIO26 đến GPIO32 | Dùng được | Dành cho flash và PSRAM |
| GPIO33 đến GPIO37 | Dùng được | Dành cho PSRAM octal |
| GPIO19 và GPIO20 | Dùng được | USB D- và D+ |
| GPIO43 và GPIO44 | UART0 | UART0 TX và RX |
| GPIO34 đến GPIO39 | Chỉ vào | Không tồn tại trên chip |
| Chân strapping | 0, 2, 12, 15 | 0, 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
Disablednế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.
