ESP32 Installation and Setup

Install Miniconda and packages

You need to use Python on your PC to program the ESP32. This assumes that you already have miniconda installed. For more instructions, see here for detailed instructions.

  1. Installing Thonny and other Packages: Open up your anaconda environment (start–>anaconda prompt)
    1. (optional) Activate your desired environment conda activate <environment_name>.

      You can ignore if you want to install in the base environment

    2. type the following to install a prerequisite package

      conda install -y -c conda-forge wrapt
      
    3. Install the ESP32 commandline flashing tool

      pip install esptool
      
    4. To install Thonny type the following (This is optional):

      pip install thonny
      

      Note: on Mac, open up terminal or xterm and type pip3 install esptool thonny

Install Device Drivers (Required for Windows)

The device drivers will help your computer recognize the ESP32 as a USB Device

  1. Install Silabs cp210x driver (windows download)

    This step is required if the device is not recognized as a virtual COM port.

    Open Device Manager and Select Update Driver
    Open Device Manager and Select Update Driver

    Browse specific directories
    Browse specific directories

    Select the directory
    Select the directory

    Let it Install
    Let it Install

    Done
    Done

Flashing the ESP32 Firmware for MicroPython

  1. Download the most recent version of the micropython firmware

Option 1: Thonny approach

Requires thonny to be installed, see above

  1. open cmd and type thonny

    Start Thonny
    Start Thonny

  2. open up tools–>options, select the “interpreter” tab and ensure that “Micropython (ESP32)” is selected. Select the “Silicon Labs CP210X USB to UART Bridge Com(XY)” down below.

    Open Tools–>Options
    Open Tools–>Options

    Select Interpreter Tab, then the ESP32 Interpreter
    Select Interpreter Tab, then the ESP32 Interpreter

    Select the Port
    Select the Port

    Selection Made
    Selection Made

  3. Before selecting ok, in the bottom right hand corner select “install or update firmware”. select the right port corresponding to the “Silicon Labs CP210X USB to UART Bridge Com(XY)”

    Install or Update Firmware
    Install or Update Firmware

  4. select the firmware you downloaded and hit “install”.

    Select Firmware File
    Select Firmware File

    Hit install
    Hit install

  5. wait for the install to finish

    Done
    Done

  6. Look at the interpreter window. You should see something similar to:

    MicroPython v1.XX on 20XX-YY-ZZ; ESP32 module with ESP32
    
    Type "help()" for more information.
    >>> 
    

    Blank
    Blank

  7. type print('hello, world!') into the shell and that’s it! You should have a working python interpreter loaded on your ESP32!

    Hello World!
    Hello World!

Option 2: Command-line approach with esptool

windows:

esptool --chip esp32 --port COM7 erase_flash

linux:

esptool.py --chip esp32 --port /dev/ttyUSB0 erase_flash

Now flash it using the template below. Check device manager in windows to identify the appropriate COM port

Windows:

esptool --chip esp32 --port <serial_port> write_flash -z 0x1000 <esp32-X.bin>

For Example:

esptool --chip esp32 --port COM7 write_flash -z 0x1000 Downloads/esp32-20220618-v1.19.1.bin

Linux:

esptool.py --chip esp32 --port <serial_port> write_flash -z 0x1000 <esp32-X.bin>

For Example:

esptool.py --chip esp32 --port /dev/ttyUSB0 write_flash -z 0x1000 esp32-20220618-v1.19.1.bin

Mac Specific Suggestions

  • use terminal or xterm if you have it as Macs do not have powershell

  • use pip3 install ... instead of pip install ... with the most recent flavors of MacOS

  • make sure pip or pip3(Mac) is updated to avoid installation errors

    python3 -m pip install --upgrade pip
    
  • Mac doesn’t do COM, but can list USB devices. In your terminal, type:

    ls -al /dev/tty.
    

    then unplug your ESP32 and run the previous command again to see which name for the device is the ESP32

  • when selecting the port, there may be two Silicon Labs CP210X USB to UART Bridge (ESP device name here) devices. Watch the messages in the terminal to determine the correct selection (obviously, don’t use the one that says error/cannot find/etc.)

  • when running the program you may need to press ctrl + c twice within thonny

External Resources


Issues

If you install on a computer where you don’t have administrative access, it is still possible to install but you have to remember a couple things:

After instlling anaconda, you must add it to your path every time you want to run it.

  1. Start –> “cmd”

    set PATH=C:\Users\<MYUSERNAME>\Miniconda3;C:\Users\<MYUSERNAME>\Miniconda3\Library\mingw-w64\bin;C:\Users\<MYUSERNAME>\Miniconda3\Library\usr\bin;C:\Users\<MYUSERNAME>\Miniconda3\Library\bin;C:\Users\daukes\Miniconda3\Scripts;%PATH%

    • Replace with your username; confirm the path exists.
    • This step is required every time you load thonny if you installed “just for me” or are on an administratively locked pc.