User's Guide

2. Get Started

2.1. Standard Setup of Toolchain for Linux

The quickest way to start development with ESP32 is by installing a prebuilt toolchain. Pick

up your OS below and follow provided instructions.

2.1.1. Install Prerequisites

To compile with ESP-IDF you need to get the following packages:

• CentOS 7:

sudo󰲧yum󰲧install󰲧git󰲧wget󰲧make󰲧ncurses-devel󰲧flex󰲧bison󰲧gperf󰲧python󰲧pyserial

• Ubuntu and Debian:

sudo󰲧apt-get󰲧install󰲧git󰲧wget󰲧make󰲧libncurses-dev󰲧flex󰲧bison󰲧gperf󰲧python󰲧python-serial

• Arch:

sudo󰲧pacman󰲧-S󰲧--needed󰲧gcc󰲧git󰲧make󰲧ncurses󰲧flex󰲧bison󰲧gperf󰲧python2-pyserial

2.1.2. Toolchain Setup

ESP32 toolchain for Linux is available for download from Espressif website:

• for 64-bit Linux:

https://dl.espressif.com/dl/xtensa-esp32-elf-linux64-1.22.0-61-gab8375a-5.2.0.tar.gz

• for 32-bit Linux:

https://dl.espressif.com/dl/xtensa-esp32-elf-linux32-1.22.0-61-gab8375a-5.2.0.tar.gz

Download this ﬁle, then extract it in ~/esp directory

mkdir󰲧-p󰲧~/esp

cd󰲧~/esp

tar󰲧-xzf󰲧~/Downloads/xtensa-esp32-elf-linux64-1.22.0-61-gab8375a-5.2.0.tar.gz

The toolchain will be extracted into ~/esp/xtensa-esp32-elf/ directory.

To use it, you will need to update your ``PATH`` environment variable in ~/.bash_profile ﬁle.

To make xtensa-esp32-elf` available for all terminal sessions, add the following line to your

~/.bash_profile ﬁle:

export󰲧PATH=$PATH:$HOME/esp/xtensa-esp32-elf/bin

Alternatively, you may create an alias for the above command. This way you can get the

toolchain only when you need it. To do this, add different line to your ~/.bash_profile ﬁle:

alias󰲧get_esp32="export󰲧PATH=$PATH:$HOME/esp/xtensa-esp32-elf/bin"

Xinyuan

! /122

2019.04