Shares

Installing the ESP32 Board in Arduino IDE (Mac and Linux instructions)

Shares

The ESP32 is currently being integrated with the Arduino IDE just like it was done for the ESP8266, but not everything is working at the moment (see here).

This add-on for the Arduino IDE allows you to program the ESP32 using the Arduino IDE and its programming language.

If you like the ESP32, you might also enjoy reading all my ESP8266 tutorials.

Let’s get started!

ESP32 Dev Board (ESP-WROOM-32)

Note: this post is divided in two sections “A – Instructions for Mac” and “B – Instructions for Debian/Ubuntu Linux”, read the section for your specific operating system and continue reading the rest of the post. You can also learn how to install the ESP32 Board in Arduino IDE on a Windows PC  or you read my Getting Started with ESP32 Dev Module.

A – Instructions for Mac

Having the latest Arduino IDE software installed from arduino.cc/en/Main/Software.

1) Open your Terminal and execute the following command to install Git and Python’s required packages:

curl -o get-pip.py https://bootstrap.pypa.io/get-pip.py && \
sudo python get-pip.py && \
sudo pip install pyserial

2) Use the cd command to move to your Hardware folder inside your Arduino IDE installation and create a folder called espressif:

cd Downloads/arduino-1.6.11/hardware
mkdir espressif
cd espressif

3) Finally, run the git clone command inside the espressif folder to download the latest version of the ESP32 add-on and execute the get.py file:

git clone https://github.com/espressif/arduino-esp32.git esp32 && \
cd esp32/tools/ && \
python get.py

4) Re-open Arduino IDE

B – Instructions for Debian/Ubuntu Linux

Having the latest Arduino IDE software installed from arduino.cc/en/Main/Software.

1) Open your Terminal and execute the following command to install Git and Python’s required packages:

sudo usermod -a -G dialout $USER && \
sudo apt-get install git && \
wget https://bootstrap.pypa.io/get-pip.py && \
sudo python get-pip.py && \
sudo pip install pyserial

2) Use the cd command to move to your Hardware folder inside your Arduino IDE installation and create a folder called espressif:

cd Downloads/arduino-1.6.11/hardware
mkdir espressif
cd espressif

3) Finally, run the git clone command inside the espressif folder to download the latest version of the ESP32 add-on and execute the get.py file:

git clone https://github.com/espressif/arduino-esp32.git esp32 && \
cd esp32/tools/ && \
python get.py

4) Re-open Arduino IDE

Testing the Installation

Plug your ESP32 dev board to your computer.

1) Open Arduino IDE

2) Select your board in Tools > Board menu (in my case it’s the ESP32 Dev Module)

3) Select the COM port

4) Open one of these examples under File > Examples > WiFi (ESP32) > WiFi Scan

5) To make your ESP32 go into downloading/uploading mode: hold the BOOT button and press the EN button to reboot your ESP32

6) Press the Upload button in the Arduino IDE and wait a few seconds while the code compiles and uploads to your board. If everything is correct this what you should see:

7) Open the Arduino IDE serial monitor at a baud rate of 115200 to see the networks available near your ESP32:

This is a very basic tutorial that illustrates how to prepare your Arduino IDE for the ESP32 on a Mac or a Linux PC.

Do you have any questions? Leave a comment down below!

Thanks for reading. If you like this post probably you might like my next ones, so please support me by subscribing my blog and my Facebook Page.

P.S. Learn how to install the ESP32 Board in Arduino IDE (Windows instructions)

P.P.S. Getting Started with ESP32 Dev Module

Leave a Comment: