User's Manual

!
2. Getting Started
alias󰲧get_esp32="export󰲧PATH=$PATH:$HOME/esp/xtensa-esp32-elf/bin"
Then when you need the toolchain you can type get_esp32 on the command line and the
toolchain will be added to your PATH.
2.2. Get ESP-IDF
Once you have the toolchain (that contains programs to compile and build the application)
installed, you also need ESP32 specific API / libraries. They are provided by Espressif in
ESP-IDF repository. To get it, open terminal, navigate to the directory you want to put ESP-
IDF, and clone it using git clone command:
cd󰲧~/esp
git󰲧clone󰲧--recursive󰲧https://github.com/espressif/esp-idf.git
ESP-IDF will be downloaded into ~/esp/esp-idf.
2.3. Set up Path to ESP-IDF
The toolchain programs access ESP-IDF using IDF_PATH environment variable. This
variable should be set up on your PC, otherwise projects will not build. Setting may be
done manually, each time PC is restarted. Another option is to set up it permanently by
defining IDF_PATH in user profile.
Set up IDF_PATH by adding the following line to ~/.bash file:
export󰲧IDF_PATH=~/esp/esp-idf
Log off and log in back to make this change effective.
If you do not like to have IDF_PATH set up permanently, you should enter it manually in
terminal window on each restart or logout.
Run the following command to check if IDF_PATH is set:
printenv󰲧IDF_PATH
The path previously entered in ~/.bash file (or set manually) should be printed out.
📖 Note:
Do not miss the --recursive option. If you have already cloned ESP-IDF without this option, run another
command to get all the submodules:
cd󰲧~/esp/esp-idf
git󰲧submodule󰲧update󰲧--init
Espressif
! /123
2017.05