Chapter 1. Get Started
• CentOS 7 & 8:
sudo yum -y update && sudo yum install git wget flex bison gperf python3␣
,→python3-pip python3-setuptools cmake ninja-build ccache dfu-util libusbx
CentOS 7 is still supported but CentOS version 8 is recommended for a better user experience.
• Arch:
sudo pacman -S --needed gcc git make flex bison gperf python-pip cmake ninja␣
,→ccache dfu-util libusb
Note:
• CMake version 3.5 or newer is required for use with ESP-IDF. Older Linux distributions may require updating,
enabling of a “backports”repository, or installing of a “cmake3”package rather than “cmake”.
• If you do not see your Linux distribution in the above list then please check its documentation to find out which
command to use for package installation.
Additional Tips
Permission issues /dev/ttyUSB0 With some Linux distributions you may get the Failed to open port
/dev/ttyUSB0 error message when flashing the ESP32-S2. This can be solved by adding the current user to the
dialout group.
Python compatibility
ESP-IDF supports Python 3.6 or newer. It is recommended to upgrade your operating system to a recent version
satisfying this requirement. Other options include the installation of Python from sources or the use of a Python
version management system such as pyenv.
Next Steps
To carry on with development environment setup, proceed to Step 2. Get ESP-IDF.
1.5.3 Standard Setup of Toolchain for Mac OS
Install Prerequisites
ESP-IDF will use the version of Python installed by default on macOS.
• install pip:
sudo easy_install pip
• install CMake & Ninja build:
– If you have HomeBrew, you can run:
brew install cmake ninja dfu-util
– If you have MacPorts, you can run:
sudo port install cmake ninja dfu-util
– Otherwise, consult the CMake and Ninja home pages for macOS installation downloads.
• It is strongly recommended to also install ccache for faster builds. If you have HomeBrew, this can be done
via brew install ccache or sudo port install ccache on MacPorts.
Espressif Systems 60
Submit Document Feedback
Release v4.4