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.
- 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
- Cài Arduino IDE 2.x từ arduino.cc.
- File → Preferences → Additional boards manager URLs, thêm:
https://espressif.github.io/arduino-esp32/package_esp32_index.json - Tools → Board → Boards Manager, tìm "esp32" của Espressif Systems, cài bản mới nhất (dòng 3.x).
- 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.
- Chọn Tools → Board → ESP32 Dev Module và cổng COM tương ứng, nạp ví dụ Blink.
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

| Tùy chọn (Tools) | Nên chọn |
|---|---|
| Upload Speed | 921600 (giảm xuống 115200 nếu nạp hay lỗi, cáp dài) |
| Flash Size | Theo module, thường 4 MB |
| Partition Scheme | Default (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 |
| PSRAM | Enabled chỉ với module có PSRAM (WROVER, ESP32-CAM) |
| Core Debug Level | None khi chạy thật; Info/Debug khi cần xem log nội bộ |
3. Cơ chế vào chế độ nạp

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áo | Nguyên nhân / cách xử lý |
|---|---|
| Không thấy cổng COM | Cá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) |