آموزش نصب برد ESP32 به روی Arduino IDE (ویندوز، لینوکس، مک OS)

فهرست مطالب

مقدمه

امروزه بردهای ESP32 به علت ویژگی‌ها و قابلیت‌های جذاب زیادی که ارائه می‌دهند و در عین حال قیمت پایینشان، بسیار مورد توجه واقع شده‌اند. این میکروکنترلر همچنین قابلیت برنامه‌نویسی بسیار ساده‌ای دارد. این برنامه‌نویسی می‌تواند در بسیاری از محیط‌های برنامه‌نویسی گوناگون مانند محیط برنامه‌نویسی Lua، Arduino IDE، میکروپایتون، ESP-IDF و … انجام شود. در بین این محیط‌ها، نرم‌افزار Arduino IDE به علت منبع باز (Open Source) و شناخته شده بودن، گزینه مناسبی برای شروع کار با بردهای ESP32 است. در این آموزش نحوه نصب برد ESP32 بر روی نرم‌افزار Arduino IDE را یاد می‌گیرید.

آنچه در این آموزش یاد می گیرید

  • مراحل کامل نصب برد ESP32 در نرم‌افزار Arduino IDE
  • راه‌اندازی وای‌فای برد ESP32 برای اسکن وای‌فای‌های موجود‌

آنچه برای نصب برد ESP32 نیاز دارید

برای آن که بتوانید از این آموزش استفاده کنید، لازم است که نرم‌افزار Arduino IDE را بر روی سیستم خود نصب کرده باشید. ترجیحا نرم‌افزار را آپدیت نگه دارید. آخرین ورژن Arduino IDE را می‌توانید از لینک زیر دانلود کنید.

https://www.arduino.cc/en/software/

اگر برای نصب نرم‌افزار Arduino IDE به راهنمایی نیاز دارید، می‌توانید به لینک زیر مراجعه کنید.

آموزش نصب نرم افزار آردوینو IDE روی ویندوز و مک

نصب برد ESP32 بر روی Arduino IDE

برای نصب برد ESP32 بر روی Arduino IDE به ترتیب زیر عمل کنید.

گام اول: آماده‌سازی نرم‌افزار Arduino IDE

نرم‌افزار Arduino IDE را باز کنید. به قسمت File -> Preferences بروید.

گام دوم: اضافه کردن لینک ESP32

در قسمت Additional Boards Manager URLs لینک “https://espressif.github.io/arduino-esp32/package_esp32_index.json” را وارد کنید. در ادامه بر روی گزینه OK کلیک کنید.

توجه

اگر از قبل لینکی در این قسمت وجود دارد، می‌توانید به راحتی با یک کاما این دو لینک را جدا کنید.

گام سوم: باز کردن قسمت بردهای برنامه Arduino IDE

در Arduino IDE، قسمت Tools -> Board -> Boards manager… را باز کنید.

گام چهارم: نصب برد ESP32

کلمه ESP32 را تایپ کنید. در ادامه esp32 by Espressif Systems را با کلیک روی گزینه Install آن نصب کنید.

با کلیک روی گزینه Install نرم‌افزار شروع به دانلود و نصب برد ESP32 می‌کند. تصویری مشابه تصویر زیر را مشاهده خواهید کرد.

منتظر بمانید تا نصب کامل شود. با کامل شدن نصب تصویری مشابه تصویر زیر را خواهید دید.

موفق شدید!

شما برد ESP32 را با موفقیت نصب کردید.

صحت سنجیِ نصب: راه‌اندازی وای‌فای برد ESP32

بردی که در اینجا استفاده کرده‌ایم، برد NodeMCU – ESP32S Edition است. در زیر می‌توانید لینک قطعات و نرم‌افزار مورد نیاز را مشاهده کنید.

قطعات مورد نیاز

ماژول وای فای و بلوتوث دو هسته ای × 1

نرم افزار های مورد نیاز

Arduino IDE

اگر از بردهای مبتنی بر ESP32 دیگر نیز استفاده می‌کنید، می‌توانید از همین کد استفاده کنید. تنها لازم است که در Arduino IDE برد مناسب خود را انتخاب نمایید.

کد

ابتدا دقت کنید که در نرم‌افزار Ardunio IDE، نوع برد و پورت را به درستی انتخاب کنید.

سپس کد زیر را بر روی برد ESP32 خود آپلود کنید. این کد از مثال‌های خود آردوینو است و می‌توانید آن را از طریق File -> Examples -> Wifi -> WifiScan بیابید.

/*
 *  This sketch demonstrates how to scan WiFi networks.
 *  The API is almost the same as with the WiFi Shield library,
 *  the most obvious difference being the different file you need to include:
 */
#include "WiFi.h"

void setup()
{
    Serial.begin(115200);

    // Set WiFi to station mode and disconnect from an AP if it was previously connected
    WiFi.mode(WIFI_STA);
    WiFi.disconnect();
    delay(100);

    Serial.println("Setup done");
}

void loop()
{
    Serial.println("scan start");

    // WiFi.scanNetworks will return the number of networks found
    int n = WiFi.scanNetworks();
    Serial.println("scan done");
    if (n == 0) {
        Serial.println("no networks found");
    } else {
        Serial.print(n);
        Serial.println(" networks found");
        for (int i = 0; i < n; ++i) {
            // Print SSID and RSSI for each network found
            Serial.print(i + 1);
            Serial.print(": ");
            Serial.print(WiFi.SSID(i));
            Serial.print(" (");
            Serial.print(WiFi.RSSI(i));
            Serial.print(")");
            Serial.println((WiFi.encryptionType(i) == WIFI_AUTH_OPEN)?" ":"*");
            delay(10);
        }
    }
    Serial.println("");

    // Wait a bit before scanning again
    delay(5000);
}

پس از آپلود موفق‌آمیز کد به روی برد، تصویری مشابه تصویر زیر در نرم‌افزار Arduino IDE مشاهده خواهید نمود:

همانطور که گفته شد، کد بالا شبکه‌های وای‌فای را اسکن کرده و لیست شبکه‌های موجود را در Serial Monitor نمایش می‌دهد.

در نرم‌افزار Arduino IDE، پنجره Serial Monitor را باز کنید. خروجی کد به شکل زیر است.

یک گام جلوتر

اکنون که برد ESP32 را روی آردوینو نصب کرده‌ و با موفقیت آن را برای اسکن وای‌فای‌های موجود برنامه‌ریزی کردید، این بار سعی کنید آن را به عنوان یک منبع وای‌فای (مود Access Point) برنامه‌ریزی کرده و با گوشی خود به آن متصل شوید.

آموزش های مشابه

Comments (19)

  • امین Reply

    با سلام. در هنگام نصب در قسمت board manager این ارور رو آورد. چه کنم؟ هرچه قدر هم تلاش میکنم باز همینه.
    CRC doesn’t match, file is corrupted. It may be a temporary problem, please retry later.
    java.lang.RuntimeException: java.lang.Exception: CRC doesn’t match, file is corrupted. It may be a temporary problem, please retry later.
    at cc.arduino.contributions.packages.ui.ContributionManagerUI.lambda$onInstallPressed$2(ContributionManagerUI.java:179)
    at java.lang.Thread.run(Thread.java:748)
    Caused by: java.lang.Exception: CRC doesn’t match, file is corrupted. It may be a temporary problem, please retry later.
    at cc.arduino.contributions.DownloadableContributionsDownloader.download(DownloadableContributionsDownloader.java:101)
    at cc.arduino.contributions.DownloadableContributionsDownloader.download(DownloadableContributionsDownloader.java:56)
    at cc.arduino.contributions.packages.ContributionInstaller.install(ContributionInstaller.java:100)
    at cc.arduino.contributions.packages.ui.ContributionManagerUI.lambda$onInstallPressed$2(ContributionManagerUI.java:172)
    … 1 more

    فوریه 23, 2024 at 12:22 ق.ظ
  • majid Reply

    Failed to install platform: ‘esp32:esp32:2.0.14’.
    Error: 2 UNKNOWN: Get “http://downloads.arduino.cc/tools/dfu-util-0.11-arduino5-windows_386.tar.gz”: read tcp 192.168.1.117:58457->104.18.10.21:80: wsarecv: An existing connection was forcibly closed by the remote host.

    آوریل 10, 2024 at 7:07 ب.ظ
    • محمد دمیرچی Reply

      با سلام
      از VPN برای نصب استفاده کنید.

      آوریل 13, 2024 at 9:35 ق.ظ
    • محمد دمیرچی Reply

      با سلام
      از نسخه های قدیمی برنامه آردوینو استفاده بنمایید. ورژن 1.8.19
      همچنین میتوانید ارتباط اینترنت خود را قطع بنمایید شاید دارد تلاش میکند یک فایلی را دانلود بکنید و قفل میکند.
      همچنین یک بار از نو نصب بنمایید تا شرایط را بررسی بنمایید.

      دسامبر 16, 2025 at 5:32 ب.ظ
  • الیاسین اطمینان Reply

    سلام وقتتون بخیر.من هنگام نصب نسخه ۱.۰.۶ esp یه ارور میگیرم که فقط میگه ارور و یه لینک میده.هم با فیلتر تلاش کردم هم بدونش.اما باز همین ارور رو میگیرم.اگه سریع جواب بدید ممنون میشم.

    جولای 31, 2025 at 7:08 ب.ظ
    • محمد دمیرچی Reply

      با سلام
      دوست عزیز ارور خود را نیز ذکر بکنید.
      همچنین در این زمان آخرین نسخه ای که وجود دارد نسخه 3.3.0 هست. از این رو پیشنهاد میشود به آخرین نسخه آپدیت بنمایید.

      آگوست 2, 2025 at 10:19 ق.ظ
  • امیر شاهرخی Reply

    با سلام و احترام
    برای نصب برد esp32 با این ارور مواجه میشم از vpn هم استفاده کردم ولی درست نشد
    The system cannot find the path
    specified.
    exit status 1

    Compilation error: exit status 1

    آگوست 21, 2025 at 1:23 ق.ظ
  • مصطفی غم خوار Reply

    سلام استاد ، همه این کار ها رو کردم ، حتی مبدل سریالش هم نصب کردم ولی تو مرحله compiling گیر می‌کنه و نه جلو می‌ره نه عقب

    اکتبر 6, 2025 at 9:29 ب.ظ
    • محمد دمیرچی Reply

      با سلام
      در باکس سیاه رنگ پایین باید به شما اطلاعاتی در این زمینه بدهد و احتمال خیلی زیاد به رنگ نارنجی خطا ها را مینویسد. آنها را بخوانید. یا به عنوان سوال در انجمن مطرح بنمایید تا مورد بررسی قرار بگیرد.

      اکتبر 28, 2025 at 8:59 ق.ظ
  • حمید رضا روانبخشیان Reply

    با سلام و خسته نباشید .
    الان که به اینترنت دسترسی نداریم . آموزش و لینکی برای دانلود و نصب آفلاین esp32 توی برد منیجر دارید که بتونم ازش استفاده کنم

    آوریل 27, 2026 at 7:10 ق.ظ
  • رضا Reply

    سلام
    من از برد ESP-WROOM-32 استفاده می کنم می خوام از کدی که خودم نوشتم رو پرگرام کنم ایا امکان دارد یه توضیح دهید

    می 4, 2026 at 4:03 ق.ظ
    • محمد دمیرچی Reply

      با سلام
      متوجه منظور شما نشدم.
      شما میتوانید هر کدی که بخواهید بر روی ESP ها آپلود بنمایید.
      این یک آموزش اولیه در مورد نصب کتابخانه ESP بر روی برنامه Arduino IDE می باشد.

      می 12, 2026 at 10:32 ق.ظ
  • سعید Reply

    با سلام. در شرایط قطع اینترنت بین الملل برای esp32 چکار کنیم؟اگه امکان داره آموزش راه اندازی آفلاین برای این ماژول را هم بگذارید

    می 4, 2026 at 5:02 ب.ظ
  • علی فنودی Reply

    با سلام و خسته نباشید
    بنده همه اتصال ها رو درست انجام دادم کتابخانه esp رو نصب کردم و برد esp رو انتخاب کردم و برای پروگرام کردن از مبدل usb به ttl استفاده میکنم هنگامی برنامه رو آپلود میکنم تا اخر میره بعد خطای زیر رو میده
    A fatal error occurred: Failed to connect to ESP32: No serial data received.
    For troubleshooting steps visit: https://docs.espressif.com/projects/esptool/en/latest/troubleshooting.html
    در ضمن ابتدا که نرم افزار رو باز میکنم در قسمت ارور ها همچین چیزی مینویسه نمیدونم مشکل از کجاست.
    the selected serial port .
    does not exist or your board is not connected
    پورت سریال رو فعال کردم ولی پایین سمت راست نرم افزار نوشته disble on com 5
    چگونه مشکل ور حل کنم ممنون

    ژوئن 16, 2026 at 7:09 ب.ظ
    • محمد دمیرچی Reply

      با سلام
      در مرحله اول باید از دیوایس منیجر بررسی بنمایید که پورت انتخابی شما درست می باشد یا خیر (شاید هم درایور مبدل به درستی نصب نشده باشد که این خطا را میگیرید) این موضوع را باید ابتدا از آن بخش حل بنمایید.
      پس از حل این موضوع در برنامه آردوینو پورت مورد نظر را انتخاب میکنید و سریال مانیتور را باز میکنید. در این نقطه اگر سریال مانیتور بدون خطا باز شد یعنی برنامه نیز پورت را شناسایی کرده است. حال دکمه ریست روی برد را یک بار کلیک میکنید (اگر از نسخه های خام استفاده میکنید پایه EN را به زمین یک اتصال کوتاه میدهید) در این شرایط دیتا هایی باید در سریال مانیتور نوشته بشود. که نشانه کامل وصل بودن می باشد.
      در این مرحله اگر زمان پروگرام بر روی Connecting گیر کردید. دکمه Boot را نگه دارید یا پایه GPIO0 را به GND وصل بنمایید تا عملیات پروگرام شروع بشود. سپس میتوانید رها بنمایید.

      ژوئن 20, 2026 at 9:41 ق.ظ

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد.