[1]

Development on Mac

Install Prerequisites

brew install cmake ninja dfu-util

Get ESP-IDF

See https://idf.espressif.com/ for links to detailed instructions on how to set up the ESP-IDF depending on chip you use.

  • Standard Toolchain Setup for Linux and macOS[2]
  • vscode extension[3]

Need to install esp-idf

mkdir -p ~/esp
cd ~/esp
git clone --recursive https://github.com/espressif/esp-idf.git

Aside from the ESP-IDF, you also need to install the tools used by ESP-IDF, such as the compiler, debugger, Python packages, etc, for projects supporting ESP32.

cd ~/esp/esp-idf
./install.sh esp32s3
...
All done! You can now run:

  . ./export.sh
$ . ./export.sh
Checking "python3" ...
Python 3.12.2
"python3" has been detected
Activating ESP-IDF 5.5
Setting IDF_PATH to '/Users/riguz/esp/esp-idf'.
* Checking python version ... 3.12.2
* Checking python dependencies ... OK
* Deactivating the current ESP-IDF environment (if any) ... OK
* Establishing a new ESP-IDF environment ... OK
* Identifying shell ... zsh
* Detecting outdated tools in system ... OK - no outdated tools found
* Shell completion ... Autocompletion code generated
compinit:503: no such file or directory: /usr/local/share/zsh/site-functions/_brew_services

Done! You can now compile ESP-IDF projects.
Go to the project directory and run:

  idf.py build

Vscode extension