Có ba cách lập trình ESP32 phổ biến: Arduino IDE (dễ nhất), PlatformIO trong VS Code (chuyên nghiệp, quản lý thư viện tốt) và ESP-IDF (framework gốc của Espressif). Series dùng Arduino Core ESP32 – được xây trên ESP-IDF nên vẫn gọi được API cấp thấp khi cần.

Sau bài này bạn sẽ:
  • Cài đặt và nạp được chương trình đầu tiên.
  • Hiểu các tùy chọn board quan trọng.
  • Tự xử lý các lỗi nạp thường gặp.

1. Cài đặt trong Arduino IDE 2

  1. Cài Arduino IDE 2.x từ arduino.cc.
  2. File → Preferences → Additional boards manager URLs, thêm:
    https://espressif.github.io/arduino-esp32/package_esp32_index.json
  3. Tools → Board → Boards Manager, tìm "esp32" của Espressif Systems, cài bản mới nhất (dòng 3.x).
  4. Cắm board, cài driver nếu máy không nhận cổng: CP210x (Silicon Labs) hoặc CH340/CH9102 (WCH) tùy chip USB trên board.
  5. Chọn Tools → Board → ESP32 Dev Module và cổng COM tương ứng, nạp ví dụ Blink.
Core 3.x thay đổi API: nhiều ví dụ cũ trên mạng viết cho core 2.x. Ví dụ PWM ledcSetup()/ledcAttachPin() đã thay bằng ledcAttach() (bài #4); một số callback (ESP-NOW, sự kiện Wi-Fi) đổi chữ ký. Khi gặp lỗi biên dịch với code mẫu, kiểm tra ví dụ đó viết cho phiên bản nào.

2. Quy trình biên dịch và nạp

Hình 1. Quy trình biên dịch và nạp firmware cho ESP32.
Hình 1. Quy trình biên dịch và nạp firmware cho ESP32.
Tùy chọn (Tools)Nên chọn
Upload Speed921600 (giảm xuống 115200 nếu nạp hay lỗi, cáp dài)
Flash SizeTheo module, thường 4 MB
Partition SchemeDefault (2 phân vùng app cho OTA, bài #13); "Huge APP" khi chương trình lớn (dùng BLE + Wi-Fi) mà không cần OTA
PSRAMEnabled chỉ với module có PSRAM (WROVER, ESP32-CAM)
Core Debug LevelNone khi chạy thật; Info/Debug khi cần xem log nội bộ

3. Cơ chế vào chế độ nạp

Hình 2. Mạch tự động reset: DTR/RTS của USB-UART điều khiển EN và GPIO0 để vào bootloader.
Hình 2. Mạch tự động reset: DTR/RTS của USB-UART điều khiển EN và GPIO0 để vào bootloader.

ESP32 vào bootloader nạp code nếu GPIO0 ở mức thấp khi chip khởi động (EN chuyển từ thấp lên cao). Trên board phát triển, hai transistor nối với DTR/RTS của chip USB-UART tự tạo trình tự này. Nếu mạch tự động không hoạt động (board rẻ, tụ trên EN thiếu), IDE dừng ở "Connecting....": giữ nút BOOT khi thấy dòng này, thả khi bắt đầu ghi.

4. PlatformIO – lựa chọn cho dự án lớn

; platformio.ini
[env:esp32dev]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600
board_build.partitions = default.csv
lib_deps =
    knolleary/PubSubClient@^2.8
    bblanchon/ArduinoJson@^7

Ưu điểm: thư viện khai báo trong file (cả nhóm dùng cùng phiên bản), nhiều môi trường build (dev/prod), tích hợp unit test và debug. Lưu ý: nền tảng espressif32 chính thức của PlatformIO có thể dùng phiên bản Arduino core cũ hơn bản mới nhất – kiểm tra phiên bản khi dùng API mới.

5. Kiểm tra môi trường

void setup() {
  Serial.begin(115200);
  delay(200);
  Serial.printf("Arduino-ESP32 %d.%d.%d\n", ESP_ARDUINO_VERSION_MAJOR,
                ESP_ARDUINO_VERSION_MINOR, ESP_ARDUINO_VERSION_PATCH);
  Serial.printf("MAC: %s\n", WiFi.macAddress().c_str());
}

void loop() {}

(Cần #include <WiFi.h> ở đầu file để đọc địa chỉ MAC.)

6. Lỗi nạp thường gặp

Thông báoNguyên nhân / cách xử lý
Không thấy cổng COMCáp USB chỉ sạc (không có dây dữ liệu), thiếu driver
"Failed to connect… No serial data received"Giữ nút BOOT khi nạp; mạch ngoài kéo GPIO0/GPIO2/GPIO12 sai mức
"A fatal error… MD5 of file does not match"Giảm Upload Speed, đổi cáp/cổng USB
Nạp xong board khởi động lại liên tục, log "Brownout detector was triggered"Nguồn USB yếu khi Wi-Fi phát; dùng cổng USB tốt hoặc nguồn ngoài, thêm tụ 470 µF trên 3,3 V/5 V
Serial Monitor ra ký tự lạSai baud rate (115200)

Tài liệu tham khảo