Get set up
One place with the official download links you need before your first ESP32 project.
Everything here comes from the people who make it. Links go to each publisher’s own page, never to a mirror. Do the first two steps once; the others only if you need them.
1. Arduino IDE 2
The program where you write code and send it to your board.
- Download: arduino.cc/en/software
- Install guide: Downloading and installing the Arduino IDE 2
2. The ESP32 board package
This teaches the IDE about your board. Open Preferences, paste this into Additional boards manager URLs, then install esp32 (by Espressif) from the Boards Manager and restart the IDE:
https://espressif.github.io/arduino-esp32/package_esp32_index.json
Our sketches are tested with esp32 core 3.3.x. If you install a much older or newer version and something fails to compile, check this first.
Guides: Espressif, Installing and Arduino, Installing a board package. Step by step with pictures: lesson K1.
3. USB drivers (only if your board is not recognised)
Plug the board in and look at Tools > Port. If a new port appears, skip this step: your system already has the driver.
Which driver do I need?
Look at the small square chip next to the USB socket and read the text on top (a magnifier helps).
- CP2102 (or CP210x): Silicon Labs, CP210x USB to UART Bridge VCP Drivers
- CH340: SparkFun, How to install CH340 drivers · WCH, CH340 (a chip made by WCH, common on clone boards)
- Another name? Search for it with your board’s name, or check the board’s user guide.
On macOS, the system may ask you to allow the driver in System Settings > Privacy & Security.
4. Libraries
Install them from inside the IDE, with the Library Manager (the library icon in the left column). Nothing to download from a website. See Installing a library.
One exception: a sketch folder that contains a src folder comes as a ZIP with the lesson. Unzip it, keep the folder name, keep src next to the .ino file, and open the .ino from there.
5. 3D printing software (lesson M2)
Only if you print your own box. Pick the one for your printer:
- Bambu Studio, for Bambu Lab printers
- PrusaSlicer, for Prusa printers and many others
Stuck?
- No port in the list: try another USB cable (some only charge), then step 3.
- “Failed to connect” while uploading: hold the BOOT button on the board while it says “Connecting…”.
- Garbled text in the Serial Monitor: set it to 115200.