مبتدی⏱ 15 دقیقه مطالعه

برای برنامه‌نویسی ESP32 با C/C++‎، محیط رایج و توصیه‌شده Arduino IDE است. در این درس مراحل نصب کامل، از دانلود نرم‌افزار تا اولین آپلود موفق روی برد، را قدم‌به‌قدم می‌بینیم.

مرحله ۱: نصب Arduino IDE

نسخهٔ رسمی و رایگان Arduino IDE (ترجیحاً نسخهٔ ۲ به بعد) را از آدرس arduino.cc/en/software متناسب با سیستم‌عامل خود (ویندوز، مک یا لینوکس) دانلود و نصب کنید.

مرحله ۲: افزودن بستهٔ برد ESP32

به‌طور پیش‌فرض، Arduino IDE فقط بردهای رسمی خودِ آردوینو را می‌شناسد. برای افزودن پشتیبانی از ESP32:

  1. از منوی File > Preferences، در کادر «Additional Boards Manager URLs» این آدرس را وارد کنید:
    https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
  2. از منوی Tools > Board > Boards Manager، عبارت «esp32» را جستجو و بستهٔ «esp32 by Espressif Systems» را نصب کنید.
  3. پس از پایان نصب، از همان منو، بردی مثل «ESP32 Dev Module» را انتخاب کنید.
فرآیند نصب و آپلود کد روی ESP32

مرحله ۳: انتخاب پورت و اولین آپلود

برد را با کابل USB به کامپیوتر وصل کنید و از منوی Tools > Port، پورت سریال مربوطه را انتخاب کنید.

CPP
void setup() {
  Serial.begin(115200);
  delay(500);
  Serial.println("سلام از ESP32!");
}

void loop() {
  // فعلاً خالی — کد تکرارشونده بعداً اینجا نوشته می‌شود
}
💡 نکته

به‌جای COM3 در ویندوز از نام پورت واقعی برد استفاده کنید؛ در لینوکس و مک معمولاً چیزی شبیه dev/ttyUSB0/ یا dev/cu.usbserial-0001/ است. اگر آپلود با خطا مواجه شد، دکمهٔ BOOT روی برد را هنگام شروع آپلود نگه دارید.

پس از آپلود موفق، از منوی Tools > Serial Monitor (یا میان‌بر Ctrl+Shift+M) صفحهٔ سریال را باز کنید و باودریت آن را روی همان مقدار 115200 که در Serial.begin() نوشتیم تنظیم کنید تا پیام «سلام از ESP32!» را ببینید.

راه سریع‌تر: شروع بدون نصب هیچ نرم‌افزاری، در Wokwi

اگر می‌خواهید بدون نصب Arduino IDE شروع کنید، کافی‌ست یک پروژهٔ خالی «ESP32» در Wokwi بسازید؛ کد بالا را در فایل sketch.ino جایگذاری کنید و مستقیماً در مرورگر اجرا و نتیجه را در پنجرهٔ سریال شبیه‌ساز ببینید — دقیقاً مثل جعبه‌های شبیه‌سازی همین دوره.

🛠️ کارگاه عملی

کارگاه عملی: اگر ESP32 دارید، Arduino IDE را نصب کنید و کد بالا را آپلود کنید. اگر برد ندارید، از دکمهٔ زیر برای باز کردن یک پروژه خالی در Wokwi استفاده کنید.

🧩

برای تمرین این درس، یک پروژهٔ خالی Arduino/ESP32 بسازید و کد Serial.println بالا را در آن اجرا کنید.

ساخت پروژهٔ خالی Arduino/ESP32 در Wokwi ↗
❓ برای افزودن پشتیبانی ESP32 به Arduino IDE، باید یک آدرس JSON را کجا وارد کنید؟
طراحی و توسعه: امین شیخ نجدیglcd.ir | نسخهٔ افزونه: 1.21.0