Set Up Tools; Set Up Environment Variables; Create Your First Project; Start A Project - Espressif Systems ESP32-S3-MINI-1 User Manual

3 Get Started
mkdir -p ~/esp
1
cd ~/esp
2
git clone --recursive https://github.com/espressif/esp-idf.git
3
ESP-IDF will be downloaded into
version to use in a given situation.

3.3.3 Set up Tools

Aside from the ESP-IDF, you also need to install the tools used by ESP-IDF, such as the compiler, debugger,
Python packages, etc. ESP-IDF provides a script named 'install.sh' to help set up the tools in one go.
cd ~/esp/esp-idf
1
./install.sh
2

3.3.4 Set up Environment Variables

The installed tools are not yet added to the PATH environment variable. To make the tools usable from the
command line, some environment variables must be set. ESP-IDF provides another script 'export.sh' which does
that. In the terminal where you are going to use ESP-IDF, run:
. $HOME/esp/esp-idf/export.sh
1
Now everything is ready, you can build your first project on ESP32-S3-MINI-1 or ESP32-S3-MINI-1U
module.

3.4 Create Your First Project

3.4.1 Start a Project

Now you are ready to prepare your application for ESP32-S3-MINI-1 or ESP32-S3-MINI-1U module. You can
start with get-started/hello_world
Copy get-started/hello_world to
cd ~/esp
1
cp -r $IDF_PATH/examples/get-started/hello_world .
2
There is a range of example projects
way as presented above and run it. It is also possible to build examples in-place, without copying them
first.

3.4.2 Connect Your Device

Now connect your module to the computer and check under what serial port the module is visible. Serial ports in
Linux start with '/dev/tty' in their names. Run the command below two times, first with the board unplugged,
then with plugged in. The port which appears the second time is the one you need:
ls /dev/tty*
1
Espressif Systems
~ /esp/esp-idf. Consult ESP-IDF Versions
project from examples directory
~ /esp directory:
in the examples directory in ESP-IDF. You can copy any project in the same
10
Submit Documentation Feedback
for information about which ESP-IDF
in ESP-IDF.
ESP32-S3-MINI-1 & MINI-1U User Manual v0.6