Skip to content
We have moved: pcb.esp32s.com → pcb32.comSame store. Existing accounts, orders and affiliate commission records are unchanged.
Номер заказа: USD
Номер заказа: USD
pcb32.com
Cart 0

Как установить ESP32 в Arduino IDE: полное руководство с инструкциями по устранению неполадок.

The ESP32 is a powerful, low-cost, Wi-Fi and Bluetooth-enabled microcontroller that has become a favorite among IoT developers. Using it with the familiar Arduino IDE (Integrated Development Environment) combines simplicity with power. While the installation process is straightforward, network issues or configuration problems can sometimes get in the way.

This guide will walk you through the standard installation process for Arduino IDE 2025 and provide detailed solutions for common errors you might encounter.

Предварительные требования

  • Arduino IDE Installed: Download and install the latest version from the official Arduino website. This guide assumes you are using version 2.x or later.
  • A USB Cable: A reliable data-sync USB cable (not a power-only cable).
  • Internet Connection: Required for downloading the board definitions and tools.

Part 1: Standard Installation Method

This is the recommended and easiest way to install the ESP32 core.

Step 1: Open the Preferences Window

Open the Arduino IDE. Go to Файл > Настройки (Windows/Linux) or Arduino IDE > Settings (macOS).

Step 2: Add the ESP32 Board Manager URL

In the “Additional boards manager URLs” field, paste the following URL:

https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
https://espressif.github.io/arduino-esp32/package_esp32_index.json
https://espressif.github.io/arduino-esp32/package_esp32_dev_index.json
https://arduino.me/packages/esp32.json

If you already have other URLs in this field (e.g., for ESP8266), you can add this new one by clicking the button next to the field and adding it on a new line. Click OK to save.


What I used is the URL https://arduino.me/packages/esp32.json, It’s very good for Chinese engineers.
You can also download the offline softwareto install the ESP32 on Arduino IDE if there are problems to install it.

Step 3: Open the Boards Manager

Go to Tools > Board > Boards Manager….

Step 4: Install the ESP32 Package

In the search bar of the Boards Manager, type esp32. The result “ESP32 by Espressif Systems” should appear. Click on it and then click the Установить button. The installation will take a few minutes as the IDE downloads the compiler tools, libraries, and definitions for all ESP32 variants.

Step 5: Select Your Board

Once installed, close the Boards Manager. Go to Инструменты > Доска. You should now see a new section for “ESP32 Arduino”. Expand it and select your specific ESP32 board (e.g., “ESP32 Dev Module” is a common generic choice).

Step 6: Test with a Simple Blink Sketch

Connect your ESP32 to your computer via USB. Go to Инструменты > Порт and select the new serial port that appeared. Open the classic Blink example: File > Examples > 01.Basics > Blink. Before uploading, change the LED pin to GPIO 2 (for most ESP32 boards):

const int ledPin = 2; // Change from 13 to 2

Нажмите Загрузить button. If successful, the code will compile and upload, and the LED on your ESP32 will start blinking.

Congratulations! If you’ve reached this point without issues, your ESP32 is successfully installed and ready to use!

Part 2: Troubleshooting Common Installation Problems

Problem 1: “Error downloading https://raw.githubusercontent.com/…” or Installation Hangs

This is the most common issue, often caused by network restrictions, firewalls, or GitHub’s CDN.

Solutions:

  1. Manual Installation (The Most Reliable Fix):
    • Go to the Arduino-ESP32 GitHub Releases page
    • Download the latest arduino-esp32.zip file (do not download the “Source code” zip)
    • Find your Arduino sketchbook folder path in File > Preferences > Sketchbook location
    • Navigate to Arduino15/packages/ in that folder (create folders if they don’t exist)
    • Create the folder structure: esp32/hardware/esp32/
    • Extract the ZIP contents into the final esp32 folder
    • Restart Arduino IDE – the ESP32 boards should now be available
  2. Use a Different URL:Replace the URL in the Preferences window with: 
    https://espressif.github.io/arduino-esp32/package_esp32_index.json
https://arduino.me/packages/esp32.json

    Then try installing again from the Boards Manager.

Problem 2: “A fatal error occurred: Failed to connect to ESP32: … No serial data received.”

This error happens after code upload, meaning the IDE can’t communicate with the chip to flash it.

Solutions:

  1. Put the ESP32 into Download Mode: Hold down the BOOT button on your board, click Загрузить in the IDE, and then release the BOOT button once the “Connecting…” message appears.
  2. Check Drivers (Windows):
    • For CP210x chips: Download from Silicon Labs
    • For CH340 chips: Search for “CH340 driver” online
  3. Try a Different USB Cable and Port: Ensure it’s a data cable. Try a different USB port on your computer.

Problem 3: “Could not find a package index file for the board…”

This error means the IDE can’t read the JSON file from the URL you provided.

Solutions:

  1. Check the URL for Typos: Ensure the URL in the preferences is 100% correct.
  2. Check Your Internet Connection: A firewall or proxy might be blocking access to GitHub. Try accessing the URL directly in a web browser.

Problem 4: Python Not Found / Command Error During Compilation

The ESP32 build process relies on Python. Modern Arduino IDE versions usually include it, but sometimes conflicts occur.

Solutions:

  1. Install Python Manually: Download and install Python 3.7 or newer from python.org. During installation, crucially, check the box that says “Add Python to PATH”.
  2. Restart your computer after installation to ensure the new PATH variable is loaded.

Part 3: Verifying a Successful Installation

Once you’ve resolved any issues, follow these steps to confirm everything is working:

  1. Select your ESP32 board and the correct COM port
  2. Откройте Blink example and change the LED pin to 2
  3. Click Загрузить
  4. The bottom of the IDE window should show “Leaving… Hard resetting via RTS pin…” and finally “Done uploading”
  5. The onboard LED should start blinking steadily

Congratulations! You have successfully installed the ESP32 core on Arduino IDE 2025 and are ready to start your IoT projects. The platform offers a vast collection of examples and libraries to explore, from connecting to Wi-Fi to using Bluetooth and various sensors.

Additional Resources

If you continue to experience issues after trying these solutions, consider asking for help on the ESP32 Forum or the Arduino Forum, where you can often get personalized assistance from the community.

 

======================================

О сайте ESP32S.com

С 2016 года, ESP32S.com Наша компания превратилась в полноценного партнера по экосистеме для вашего развития в сфере Интернета вещей. Расположенная в Шэньчжэне, глобальном центре инноваций в электронике, мы помогли сотням разработчиков и компаний реализовать свои проекты. ESP32Воплощаем идеи в жизнь. Наша команда стремится оказывать исключительную поддержку и предлагать инновационные решения, которые помогут вам достичь ваших целей в области Интернета вещей.
В ESP32S.com, мы осваиваем тонкости разработки ESP32Разработка продукта, основанного на концепции, включает в себя множество этапов, от разработки до вывода на рынок. Именно поэтому мы предлагаем комплексные решения, охватывающие весь жизненный цикл продукта. ESP32Устройства на базе [технологии]. Независимо от того, нужна ли вам помощь в проектировании печатных плат, создании прототипов, производстве или даже маркетинге и доставке, мы вам поможем.

Свяжитесь с нами

Готовы вывести свой IoT-проект на новый уровень? Свяжитесь с ESP32S.com Узнайте больше о наших комплексных решениях уже сегодня! ESP32Устройства на базе [технологии]. Позвольте нам стать вашим надежным партнером в воплощении ваших инновационных идей в жизнь. Свяжитесь с нами прямо сейчас для начала.