آموزش نصب Arduino Core برای ESP32

برای برنامه‌نویسی بردهای ESP32 در Arduino IDE باید بستهٔ رسمی esp32 by Espressif Systems نصب شود. این راهنما از URL پایدار رسمی Espressif استفاده می‌کند؛ URL توسعه‌ای برای استفادهٔ روزمره مناسب نیست.

نصب در Arduino IDE 2

1. Arduino IDE را باز و وارد File → Preferences شوید.
2. در Additional Boards Manager URLs نشانی زیر را اضافه کنید:

https://espressif.github.io/arduino-esp32/package_esp32_index.json

3. Boards Manager را باز و esp32 را جست‌وجو کنید.
4. بستهٔ esp32 by Espressif Systems را نصب کنید.
5. IDE را دوباره باز کنید و مدل دقیق برد و Port را انتخاب کنید.

نصب با Arduino CLI

arduino-cli config init
arduino-cli config add board_manager.additional_urls https://espressif.github.io/arduino-esp32/package_esp32_index.json
arduino-cli core update-index
arduino-cli core install esp32:esp32
arduino-cli board list

کد تست Blink

#ifndef LED_BUILTIN
#define LED_BUILTIN 2
#endif

void setup() {
  pinMode(LED_BUILTIN, OUTPUT);
}

void loop() {
  digitalWrite(LED_BUILTIN, HIGH);
  delay(500);
  digitalWrite(LED_BUILTIN, LOW);
  delay(500);
}

پین LED داخلی بین بردها متفاوت است. اگر LED چشمک نزد ولی Upload موفق بود، پین تعریف‌شده در مستندات همان برد را بررسی کنید.

Compile و Upload با CLI

شناسهٔ FQBN و نام پورت را با خروجی arduino-cli board list جایگزین کنید:

arduino-cli compile --fqbn esp32:esp32:esp32 Blink
arduino-cli upload -p COM5 --fqbn esp32:esp32:esp32 Blink

رفع خطاهای رایج

• اگر برد در Port دیده نمی‌شود، کابل داده و درایور تراشهٔ USB-to-Serial واقعی روی برد را بررسی کنید.
• اگر پیام اتصال تکرار می‌شود، در بردهایی که نیاز دارند هنگام شروع Upload کلید BOOT را نگه دارید.
• مدل عمومی ESP32 را برای بردی با ESP32-C3، S2، S3 یا C6 انتخاب نکنید؛ FQBN باید با چیپ و برد یکسان باشد.
• برای محیط تولید از Stable release URL استفاده کنید، نه Development release URL.

منابع مرتبط در دیجیتالاجیک

صفحهٔ Coreهای ESP32 و ESP8266 و Arduino IDE.

منابع رسمی

• راهنمای رسمی نصب Arduino-ESP32
• فهرست پایدار رسمی Boards Manager