Go to file
2017-06-21 12:42:58 +03:00
cores/esp32 Revert "Fix enable Update partition" 2017-06-03 20:11:41 +03:00
doc Add for if user has custom sketchbook directory (#446) 2017-06-15 15:35:08 +02:00
libraries Make sure that WiFi is started before trying to erase configuration. 2017-06-21 12:42:58 +03:00
package Update IDF to 65acd99 (#358) 2017-05-06 20:29:12 +03:00
tools Increase partition size to 1.25MB so BT and WiFi can fit 2017-05-29 13:13:44 +03:00
variants Add DOIT ESP32 DEVKIT V1 board (#415) 2017-06-14 10:18:33 +02:00
.gitignore move to binary esptool. Run get.py/get.exe to get it! 2017-01-19 15:58:29 +02:00
.travis.yml It's pyserial not serial 2017-04-04 02:50:27 +03:00
appveyor.yml Initial version of build script for @PlatformIO; CI integration for Linux, macOS and Windows (#153) 2017-01-28 14:19:56 +02:00
boards.txt Add DOIT ESP32 DEVKIT V1 board (#415) 2017-06-14 10:18:33 +02:00
component.mk fix IDF library includes 2017-03-10 15:00:15 +02:00
Kconfig Allow Arduino to be run without BT support in IDF 2017-05-06 18:27:03 +03:00
Makefile.projbuild Add some Arduino defines to IDF 2017-02-16 00:18:03 +02:00
package.json Initial version of build script for @PlatformIO; CI integration for Linux, macOS and Windows (#153) 2017-01-28 14:19:56 +02:00
platform.txt Update IDF to 65acd99 (#358) 2017-05-06 20:29:12 +03:00
programmers.txt initial import 2016-10-06 07:09:44 -06:00
README.md Fix heading (#412) 2017-06-02 18:21:54 +02:00

Arduino core for ESP32 WiFi chip

Build Status

Need help or have a question? Join the chat at https://gitter.im/espressif/arduino-esp32

Development Status

Most of the framework is implemented. Most noticable is the missing analogWrite. While analogWrite is on it's way, there are a few other options that you can use:

  • 16 channels LEDC which is PWM
  • 8 channels SigmaDelta which uses SigmaDelta modulation
  • 2 channels DAC which gives real analog output

Installation Instructions

Using through Arduino IDE

Instructions for Windows

Instructions for Mac

  • Install latest Arduino IDE from arduino.cc

  • Open Terminal and execute the following command (copy->paste and hit enter):

    mkdir -p ~/Documents/Arduino/hardware/espressif && \
    cd ~/Documents/Arduino/hardware/espressif && \
    git clone https://github.com/espressif/arduino-esp32.git esp32 && \
    cd esp32/tools/ && \
    python get.py
    
  • Restart Arduino IDE

Instructions for Debian/Ubuntu Linux

  • Install latest Arduino IDE from arduino.cc

  • Open Terminal and execute the following command (copy->paste and hit enter):

    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 && \
    mkdir -p ~/Arduino/hardware/espressif && \
    cd ~/Arduino/hardware/espressif && \
    git clone https://github.com/espressif/arduino-esp32.git esp32 && \
    cd esp32/tools/ && \
    python get.py
    
  • Restart Arduino IDE

Instructions for Fedora

  • Install the latest Arduino IDE from arduino.cc. $ sudo dnf -y install arduino will most likely install an older release.

  • Open Terminal and execute the following command (copy->paste and hit enter):

    sudo usermod -a -G dialout $USER && \
    sudo dnf install git python3-pip python3-pyserial && \
    mkdir -p ~/Arduino/hardware/espressif && \
    cd ~/Arduino/hardware/espressif && \
    git clone https://github.com/espressif/arduino-esp32.git esp32 && \
    cd esp32/tools/ && \
    python get.py
    
  • Restart Arduino IDE

Decoding exceptions

You can use EspExceptionDecoder to get meaningful call trace.

Using PlatformIO

PlatformIO is an open source ecosystem for IoT development with cross platform build system, library manager and full support for Espressif ESP32 development. It works on the popular host OS: Mac OS X, Windows, Linux 32/64, Linux ARM (like Raspberry Pi, BeagleBone, CubieBoard).

Building with make

makeEspArduino is a generic makefile for any ESP8266/ESP32 Arduino project. Using make instead of the Arduino IDE makes it easier to do automated and production builds.

Using as ESP-IDF component

  • Download and install esp-idf

  • Create blank idf project (from one of the examples)

  • in the project folder, create a folder called components and clone this repository inside

    mkdir -p components && \
    cd components && \
    git clone https://github.com/espressif/arduino-esp32.git arduino && \
    cd .. && \
    make menuconfig
    
  • make menuconfig has some Arduino options

    • "Autostart Arduino setup and loop on boot"
      • If you enable this options, your main.cpp should be formated like any other sketch

        //file: main.cpp
        #include "Arduino.h"
        
        void setup(){
          Serial.begin(115200);
        }
        
        void loop(){
          Serial.println("loop");
          delay(1000);
        }
        
      • Else you need to implement app_main() and call initArduino(); in it.

        Keep in mind that setup() and loop() will not be called in this case. If you plan to base your code on examples provided in esp-idf, please make sure move the app_main() function in main.cpp from the files in the example.

        //file: main.cpp
        #include "Arduino.h"
        
        extern "C" void app_main()
        {
            initArduino();
            pinMode(4, OUTPUT);
            digitalWrite(4, HIGH);
            //do your own thing
        }
        
    • "Disable mutex locks for HAL"
      • If enabled, there will be no protection on the drivers from concurently accessing them from another thread/interrupt/core
    • "Autoconnect WiFi on boot"
      • If enabled, WiFi will start with the last known configuration
      • Else it will wait for WiFi.begin
  • make flash monitor will build, upload and open serial monitor to your board

ESP32Dev Board PINMAP

Pin Functions

Hint

Sometimes to program ESP32 via serial you must keep GPIO0 LOW during the programming process