ESP32-S2-MINI-1 &
ESP32-S2-MINI-1U User Manual www.espressif.com Preliminary version 0.1 Espressif Systems Copyright 2020 About This Guide This document is intended to help users set up the basic software development environment for developing applications using hardware based on ESP32-S2-MINI-1 and ESP32-S2-MINI-1U modules. Release Notes Date Sep. 2020 Version V0.1 Release notes Preliminary release. Documentation Change Notication Espressif provides email notications to keep customers updated on changes to technical documentation. Please subscribe at www.espressif.com/en/subscribe. Certication Download certicates for Espressif products from www.espressif.com/en/certicates. Table of Contents 1. Introduction to ESP32-S2-MINI-1 & ESP32-S2-MINI-1U
....................................................... 1 1.1. ESP32-S2-MINI-1 & ESP32-S2-MINI-1U
.................................................................................. 1 1.2. Pin Description
........................................................................................................................... 1 2. Hardware Preparation
............................................................................................................. 6 2.1. Hardware Preparation
................................................................................................................ 6 2.2. Hardware Connection
................................................................................................................ 6 3. Getting Started with ESP32-S2-MINI-1 & ESP32-S2-MINI-1U
.............................................. 8 3.1. ESP-IDF
..................................................................................................................................... 8 3.2. Set up the Tools
......................................................................................................................... .................................................................. ........................................................................ 3.2.1. Standard Setup of Toolchain for Windows 3.2.2. Standard Setup of Toolchain for Linux 3.2.3. Standard Setup of Toolchain for Mac OS
................................................................... 8 8 9 10 3.3. Get ESP-IDF
............................................................................................................................. 11 3.4. Add IDF_PATH to User Prole
.................................................................................................. 11 3.4.1. Windows 3.4.2. Linux and MacOS
..................................................................................................................... ...................................................................................................... 11 11 4. Establish Serial Connection with ESP32-S2-MINI-1 & ESP32-S2-MINI-1U
........................ 12 4.1. Connect ESP32-S2-MINI-1 and ESP32-S2-MINI-1U to PC
.................................................... 12 4.2. Check Port on Windows
.......................................................................................................... 12 4.3. Check Port on Linux and MacOS
............................................................................................ 13 4.4. Adding User to dialout on Linux
............................................................................................... 14 4.5. Verify Serial Connection
........................................................................................................... 14 5. Congure
.............................................................................................................................. 17 6. Build and Flash
..................................................................................................................... 18 7. Flash onto the Device
........................................................................................................... 19 8. IDF Monitor
........................................................................................................................... 20 9. Examples
.............................................................................................................................. 21 1. 1. Introduction to ESP32-S2-MINI-1 & ESP32-S2-MINI-1U Introduction to ESP32-S2-
MINI-1 & ESP32-S2-MINI-1U 1.1. ESP32-S2-MINI-1 & ESP32-S2-MINI-1U ESP32-S2-MINI-1 and ESP32-S2-MINI-1U are two powerful, generic Wi-Fi MCU modules that target a wide variety of applications, ranging from low-power sensor networks to the most demanding tasks, such as voice encoding, music streaming and MP3 decoding. Table 1-1. Specications Category Parameters Description Wi-Fi protocols 802.11 b/g/n Wi-Fi 2412 MHz ~ 2484 MHz Operating frequency range Peripherals Operating voltage 3.0 V ~ 3.6 V Operating current TX: 120 ~ 190 mA RX: 63 ~ 68 mA Power supply Minimum: 500 mA Hardware Operating temperature Storage temperature Dimensions 40 C ~ 85 C 40 C ~ 150 C GPIO, SPI, LCD, UART, I2C, I2S, Camera interface, IR, pulse counter, LED PWM, USB OTG 1.1, ADC, DAC, touch sensor, temperature sensor
(18.000.10) mm x (31.000.10) mm x (3.300.10) mm (with shielding box) 1.2. Pin Description Espressif Systems
/ 1 22 Sep. 2020 1. Introduction to ESP32-S2-MINI-1 & ESP32-S2-MINI-1U Keepout Zone D N G 0 6 n P i D N G 9 5 n P i D N G 8 5 n P i D N G 7 5 n P i D N G 6 5 n P i D N G 5 5 n P i D N G 4 5 n P i D N G 3 5 n P i D N G 2 5 n P i D N G 1 5 n P i D N G 0 5 n P i D N G 9 4 n P i D N G 8 4 n P i D N G 7 4 n P i D N G 6 4 n P i Pin 65 GND GND GND GND GND GND Pin 61 GND GND GND GND Pin 45 EN Pin 44 IO46 Pin 43 GND Pin 42 GND Pin 41 IO45 Pin 40 RXD0 Pin 39 TXD0 Pin 38 IO42 Pin 37 IO41 Pin 36 IO40 Pin 35 IO39 Pin 34 IO38 Pin 33 IO37 Pin 32 IO36 Pin 31 IO35 Pin 64 GND GND Pin 1 IO1 Pin 5 GND 3V3 IO0 IO2 IO3 IO4 IO5 IO6 IO7 IO8 IO9 Pin 62 GND Pin 2 Pin 3 Pin 4 Pin 6 Pin 7 Pin 8 Pin 9 Pin 10 Pin 11 Pin 12 Pin 13 Pin 63 GND IO10 Pin 14 IO11 Pin 15 6 1 n P i 2 1 O I 7 1 n P i 3 1 O I 8 1 n P i 4 1 O I 9 1 n P i 5 1 O I 0 2 n P i 6 1 O I 1 2 n P i 7 1 O I 2 2 n P i 8 1 O I 3 2 n P i 9 1 O I 4 2 n P i 0 2 O I 5 2 n P i 1 2 O I 6 2 n P i 6 2 O I 7 2 n P i C N 8 2 n P i 3 3 O I 9 2 n P i 4 3 O I 0 3 n P i D N G Figure 1-1. ESP32-S2-MINI-1 Pin Layout (Top View) Espressif Systems
/ 2 22 Sep. 2020 1. Introduction to ESP32-S2-MINI-1 & ESP32-S2-MINI-1U D N G 0 6 i n P D N G 9 5 i n P D N G 8 5 i n P D N G 7 5 i n P D N G 6 5 i n P D N G 5 5 i n P D N G 4 5 i n P D N G 3 5 i n P D N G 2 5 i n P D N G 1 5 i n P D N G 0 5 i n P D N G 9 4 i n P D N G 8 4 i n P D N G 7 4 i n P D N G 6 4 i n P Pin 65 GND GND Pin 1 IO1 Pin 5 GND 3V3 IO0 IO2 IO3 IO4 IO5 IO6 IO7 IO8 IO9 Pin 62 GND Pin 2 Pin 3 Pin 4 Pin 6 Pin 7 Pin 8 Pin 9 Pin 10 Pin 11 Pin 12 Pin 13 Pin 63 GND IO10 Pin 14 IO11 Pin 15 GND GND GND GND GND Pin 61 GND GND GND GND Pin 45 EN Pin 44 IO46 Pin 43 GND Pin 42 GND Pin 41 IO45 Pin 40 RXD0 Pin 39 TXD0 Pin 38 IO42 Pin 37 IO41 Pin 36 IO40 Pin 35 IO39 Pin 34 IO38 Pin 33 IO37 Pin 32 IO36 Pin 31 IO35 Pin 64 GND 6 1 i n P 2 1 O I 7 1 i n P 3 1 O I 8 1 i n P 4 1 O I 9 1 i n P 5 1 O I 0 2 i n P 6 1 O I 1 2 i n P 7 1 O I 2 2 i n P 8 1 O I 3 2 i n P 9 1 O I 4 2 i n P 0 2 O I 5 2 i n P 1 2 O I 6 2 i n P 6 2 O I 7 2 i n P C N 8 2 i n P 3 3 O I 9 2 i n P 4 3 O I 0 3 i n P D N G Figure 1-2. ESP32-S2-MINI-1U Pin Layout (Top View) Pin Name GND 3V3 IO0 IO1 IO2 IO3 IO4 The modules have 65 pins. which are described in Table 1-2 Table 1-2. Pin Description No. Type Function Description 1, 2, 30, 42, 43, 46-65 3 4 5 6 7 8 P P I/O/T I/O/T I/O/T I/O/T I/O/T Ground Power supply RTC_GPIO0, GPIO0 RTC_GPIO1, GPIO1, TOUCH1, ADC1_CH0 RTC_GPIO2, GPIO2, TOUCH2, ADC1_CH1 RTC_GPIO3, GPIO3, TOUCH3, ADC1_CH2 RTC_GPIO4, GPIO4, TOUCH4, ADC1_CH3 Espressif Systems
/ 3 22 Sep. 2020 Pin Name No. Type Function Description 1. Introduction to ESP32-S2-MINI-1 & ESP32-S2-MINI-1U IO5 IO6 IO7 IO8 IO9 IO10 IO11 IO12 IO13 IO14 IO15 IO16 IO17 IO18 IO19 IO20 IO21 IO26 NC IO33 IO34 IO35 IO36 IO37 IO38 IO39 IO40 IO41 IO42 TXD0 RXD0 IO45 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 31 32 33 34 35 36 37 38 39 40 41 I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T
I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T I/O/T RTC_GPIO5, GPIO5, TOUCH5, ADC1_CH4 RTC_GPIO6, GPIO6, TOUCH6, ADC1_CH5 RTC_GPIO7, GPIO7, TOUCH7, ADC1_CH6 RTC_GPIO8, GPIO8, TOUCH8, ADC1_CH7 RTC_GPIO9, GPIO9, TOUCH9, ADC1_CH8, FSPIHD RTC_GPIO10, GPIO10, TOUCH10, ADC1_CH9, FSPICS0, FSPIIO4 RTC_GPIO11, GPIO11, TOUCH11, ADC2_CH0, FSPID, FSPIIO5 RTC_GPIO12, GPIO12, TOUCH12, ADC2_CH1, FSPICLK, FSPIIO6 RTC_GPIO13, GPIO13, TOUCH13, ADC2_CH2, FSPIQ, FSPIIO7 RTC_GPIO14, GPIO14, TOUCH14, ADC2_CH3, FSPIWP, FSPIDQS RTC_GPIO15, GPIO15, U0RTS, ADC2_CH4, XTAL_32K_P RTC_GPIO16, GPIO16, U0CTS, ADC2_CH5, XTAL_32K_N RTC_GPIO17, GPIO17, U1TXD, ADC2_CH6, DAC_1 RTC_GPIO18, GPIO18, U1RXD, ADC2_CH7, DAC_2, CLK_OUT3 RTC_GPIO19, GPIO19, U1RTS, ADC2_CH8, CLK_OUT2, USB_D-
RTC_GPIO20, GPIO20, U1CTS, ADC2_CH9, CLK_OUT1, USB_D+
RTC_GPIO21, GPIO21 SPICS1, GPIO26 NC SPIIO4, GPIO33, FSPIHD SPIIO5, GPIO34, FSPICS0 SPIIO6, GPIO35, FSPID SPIIO7, GPIO36, FSPICLK SPIDQS, GPIO37, FSPIQ GPIO38, FSPIWP MTCK, GPIO39, CLK_OUT3 MTDO, GPIO40, CLK_OUT2 MTDI, GPIO41, CLK_OUT1 MTMS, GPIO42 U0TXD, GPIO43, CLK_OUT1 U0RXD, GPIO44, CLK_OUT2 GPIO45 Espressif Systems
/ 4 22 Sep. 2020 1. Introduction to ESP32-S2-MINI-1 & ESP32-S2-MINI-1U No. Type Function Description Pin Name IO46 EN 44 45 I I GPIO46 Hign: on, enables the chip. Low: off, the chip powers off. Note: Do not leave the EN pin oating Espressif Systems
/ 5 22 Sep. 2020 2. 2. Hardware Preparation Hardware Preparation 2.1. Hardware Preparation ESP32-S2-MINI-1 and ESP32-S2-MINI-1U modules Espressif RF testing board One USB-TTL serial module PC, Windows 7 recommended Micro-USB cable 2.2. Hardware Connection 1. Connect ESP32-S2-MINI-1, ESP32-S2-MINI-1U and the RF testing board, as Figure 2-1 shows. Figure 2-1. Testing Environment Setup 2. Connect USB -UART serial module to the RF testing board via TXD, RXD and GND. 3. Connect USB-UART module to the PC. 4. Connect the RF testing board to the PC or a power adaptor to enable 5 V power supply, via the Micro-USB cable. 5. During download, short IO0 to GND via a jumper. Then, turn "ON" the board. 6. Download rmware into ash using the download tool ESP32-S2 DOWNLOAD TOOL. 7. After download, remove the jumper on IO0 and GND. Espressif Systems
/ 6 22 Sep. 2020 2. Hardware Preparation 8. Power up the RF testing board again. ESP32-S2-MINI-1 and ESP32-S2-MINI-1U will switch to working mode. The chip will read programs from ash upon initialization. Notes:
IO0 is internally logic high. For more information on ESP32-S2-MINI-1 and ESP32-S2-MINI-1U, please refer to ESP32-S2-
MINI-1 and ESP32-S2-MINI-1U Datasheet. Espressif Systems
/ 7 22 Sep. 2020 3. 3. Getting Started with ESP32-S2-MINI-1 &
ESP32-S2-MINI-1U Getting Started with ESP32-
S2-MINI-1 & ESP32-S2-
MINI-1U 3.1. ESP-IDF The Espressif IoT Development Framework (ESP-IDF for short) is a framework for developing applications based on the Espressif ESP32. Users can develop applications with ESP32-S2 in Windows/Linux/MacOS based on ESP-IDF. 3.2. Set up the 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. 3.2.1. Standard Setup of Toolchain for Windows The quickest way is to download the toolchain and MSYS2 zip from dl.espressif.com:
https://dl.espressif.com/dl/toolchains/preview/xtensa-esp32s2-elf-gcc8_2_0-esp32s2-
dev-4-g3a626e-win32.zip Checking out mkdir -p ~/esp Run C:\msys32\mingw32.exe to open an MSYS2 terminal. Run:
Input cd ~/esp to enter the new directory. Updating the Environment When IDF is updated, sometimes new toolchains are required or new requirements are added to the Windows MSYS2 environment. To move any data from an old version of the precompiled environment to a new one:
Take the old MSYS2 environment (ie C:\msys32) and move/rename it to a different directory (ie C:\msys32_old). Download the new precompiled environment using the steps above. Unzip the new MSYS2 environment to C:\msys32 (or another location). Find the old C:\msys32_old\home directory and move this into C:\msys32. You can now delete the C:\msys32_old directory if you no longer need it. You can have independent different MSYS2 environments on your system, as long as they are in different directories. Espressif Systems
/ 8 22 Sep. 2020 3.2.2. Standard Setup of Toolchain for Linux 3. Getting Started with ESP32-S2-MINI-1 &
ESP32-S2-MINI-1U Install Prerequisites CentOS 7 Ubuntu Debian Arch Set up The Toolchain sudo yum install gcc git wget make ncurses-devel flex bison gperf python pyserial python-
pyelftools sudo apt-get install gcc git wget make libncurses-dev flex bison gperf python python-pip python-setuptools python-serial python-cryptography python-future python-pyparsing python-
pyelftools sudo pacman -S --needed gcc git make ncurses flex bison gperf python2-pyserial python2-
cryptography python2-future python2-pyparsing python2-pyelftools 64-bit Linux https://dl.espressif.com/dl/toolchains/preview/xtensa-esp32s2-elf-gcc8_2_0-esp32s2-
dev-4-g3a626e-linux-amd64.tar.gz 32-bit Linux https://dl.espressif.com/dl/toolchains/preview/xtensa-esp32s2-elf-gcc8_2_0-esp32s2-
dev-4-g3a626e-linux-i686.tar.gz 1. Unzip the le to ~/esp directory:
tar -xzf ~/Downloads/xtensa-esp32s2-elf-gcc8_2_0-esp32s2-dev-4-g3a626e-linux-amd64.tar.gz 64-bit Linux mkdir -p ~/esp cd ~/esp 32-bit Linux mkdir -p ~/esp cd ~/esp tar -xzf ~/Downloads/xtensa-esp32s2-elf-gcc8_2_0-esp32s2-dev-4-g3a626e-linux-i686.tar.gz 2. The toolchain will be unzipped to ~/esp/xtensa-esp32s2-elf/ directory. Add the following to ~/.profile:
export PATH="$HOME/esp/xtensa-esp32s2-elf/bin:$PATH"
Optionally, add the following to ~/.profile:
alias get_esp32s2='export PATH="$HOME/esp/xtensa-esp32s2-elf/bin:$PATH"'
3. Re-log in to validate .profile. Run the following to check PATH:
printenv PATH Espressif Systems
/ 9 22 Sep. 2020 3. Getting Started with ESP32-S2-MINI-1 &
ESP32-S2-MINI-1U
$ printenv PATH
/home/user-name/esp/xtensa-esp32s2-elf/bin:/home/user-name/bin:/home/user-name/.local/
bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/
games:/snap/bin Permission issues /dev/ttyUSB0 Linux ESP32-S2 Failed to open port /dev/ttyUSB0 With some Linux distributions you may get the Failed to open port /dev/ttyUSB0 error message when ashing the ESP32. This can be solved by adding the current user to the dialout group. Arch Linux Users To run the precompiled gdb (xtensa-esp32-elf-gdb) in Arch Linux requires ncurses 5, but Arch uses ncurses 6. Backwards compatibility libraries are available in AUR for native and lib32 congurations:
https://aur.archlinux.org/packages/ncurses5-compat-libs/
https://aur.archlinux.org/packages/lib32-ncurses5-compat-libs/
Before installing these packages you might need to add the authors public key to your keyring as described in the Comments section at the links above. Alternatively, use crosstool-NG to compile a gdb that links against ncurses 6. 3.2.3. Standard Setup of Toolchain for Mac OS Install pip:
sudo easy_install pip Install Toolchain:
https://dl.espressif.com/dl/toolchains/preview/xtensa-esp32s2-elf-gcc8_2_0-esp32s2-
dev-4-g3a626e-macos.tar.gz Unzip the le into ~/esp directory. The toolchain will be unzipped into ~/esp/xtensa-esp32s2-elf/ path. Add the following to ~/.profile:
export PATH=$HOME/esp/xtensa-esp32s2-elf/bin:$PATH Optionally, add the following to / .profile:
alias get_esp32s2="export PATH=$HOME/esp/xtensa-esp32s2-elf/bin:$PATH"
Input get_esp32s2 to add the toolchain to PATH. Espressif Systems
/ 10 22 Sep. 2020 3.3. Get ESP-IDF 3. Getting Started with ESP32-S2-MINI-1 &
ESP32-S2-MINI-1U Once you have the toolchain (that contains programs to compile and build the application) installed, you also need ESP32 specic 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:
git clone --recursive -b feature/esp32s2beta https://github.com/espressif/esp-idf.git ESP-IDF will be downloaded into ~/esp/esp-idf. 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 3.4. Add IDF_PATH to User Prole To preserve setting of IDF_PATH environment variable between system restarts, add it to the user prole, following instructions below. 3.4.1. Windows Search for "Edit Environment Variables" on Windows 10. Click New... and add a new system variable IDF_PATH. The conguration should include an ESP-IDF directory, such as C:\Users\user-name\esp\esp-idf. Add ;%IDF_PATH%\tools to the Path variable to run idf.py and other tools. 3.4.2. Linux and MacOS Add the following to ~/.profile:
export IDF_PATH=~/esp/esp-idf export PATH="$IDF_PATH/tools:$PATH"
Run the following to check IDF_PATH:
printenv IDF_PATH which idf.py Run the following to check if idf.py is included in PAT:
It will print a path similar to ${IDF_PATH}/tools/idf.py. You can also enter the following if you do not want to modify IDF_PATH or PATH:
export IDF_PATH=~/esp/esp-idf export PATH="$IDF_PATH/tools:$PATH"
Espressif Systems
/ 11 22 Sep. 2020 4. 4. Establish Serial Connection with ESP32-S2-MINI-1 &
ESP32-S2-MINI-1U Establish Serial Connection with ESP32-S2-MINI-1 &
ESP32-S2-MINI-1U This section provides guidance how to establish serial connection between ESP32-S2-
MINI-1 and ESP32-S2-MINI-1U and PC. 4.1. Connect ESP32-S2-MINI-1 and ESP32-S2-MINI-1U to PC Connect the ESP32 board to the PC using the USB cable. If device driver does not install automatically, identify USB to serial converter chip on your ESP32 board (or external converter dongle), search for drivers in internet and install them. Below are the links to drivers for ESP32-S2-MINI-1 and ESP32-S2-MINI-1U boards produced by Espressif:
CP210x USB to UART Bridge VCP Drivers FTDI Virtual COM Port Drivers The drivers above are primarily for reference. Under normal circumstances, the drivers should be bundled with and operating system and automatically installed upon connecting one of the listed boards to the PC. 4.2. Check Port on Windows Check the list of identied COM ports in the Windows Device Manager. Disconnect ESP32-
S2 and connect it back, to verify which port disappears from the list and then shows back again. Espressif Systems
/ 12 22 Sep. 2020 4. Establish Serial Connection with ESP32-S2-MINI-1 &
ESP32-S2-MINI-1U Figure 4-1. USB to UART bridge of ESP32-S2 Board in Windows Device Manager Figure 4-2. Two USB Serial Ports of ESP32-S2 Board in Windows Device Manager 4.3. Check Port on Linux and MacOS To check the device name for the serial port of your ESP32-S2 board (or external converter dongle), run this command two times, rst with the board / dongle unplugged, then with plugged in. The port which appears the second time is the one you need:
Linux Espressif Systems
/ 13 22 Sep. 2020 4. Establish Serial Connection with ESP32-S2-MINI-1 &
ESP32-S2-MINI-1U ls /dev/tty*
MacOS ls /dev/cu.*
4.4. Adding User to dialout on Linux The currently logged user should have read and write access the serial port over USB. On most Linux distributions, this is done by adding the user to dialout group with the following command:
sudo usermod -a -G dialout $USER sudo usermod -a -G uucp $USER on Arch Linux this is done by adding the user to uucp group with the following command:
Make sure you re-login to enable read and write permissions for the serial port. 4.5. Verify Serial Connection Now verify that the serial connection is operational. You can do this using a serial terminal program. In this example we will use PuTTY SSH Client that is available for both Windows and Linux. You can use other serial program and set communication parameters like below. Run terminal, set identied serial port, baud rate = 115200, data bits = 8, stop bits = 1, and parity = N. Below are example screen shots of setting the port and such transmission parameters (in short described as 115200-8-1-N) on Windows and Linux. Remember to select exactly the same serial port you have identied in steps above. Espressif Systems
/ 14 22 Sep. 2020 4. Establish Serial Connection with ESP32-S2-MINI-1 &
ESP32-S2-MINI-1U Figure 4-3. Setting Serial Communication in PuTTY on Windows Espressif Systems
/ 15 22 Sep. 2020 4. Establish Serial Connection with ESP32-S2-MINI-1 &
ESP32-S2-MINI-1U Figure 4-4. Setting Serial Communication in PuTTY on Linux Then open serial port in terminal and check, if you see any log printed out by ESP32-S2. The log contents will depend on application loaded to ESP32-S2. Notes:
For some serial port wiring congurations, the serial RTS & DTR pins need to be disabled in the terminal program before the ESP32-S2 will boot and produce serial output. This depends on the hardware itself, most development boards (including all Espressif boards) do not have this issue. The issue is present if RTS & DTR are wired directly to the EN & GPIO0 pins. See the esptool documentation for more details. Close serial terminal after verication that communication is working. In the next step we are going to use a different application to upload a new rmware to ESP32-S2. This application will not be able to access serial port while it is open in terminal. Espressif Systems
/ 16 22 Sep. 2020 5. 5. Congure Congure Enter hello_world directory and run menucong. Linux and MacOS cd ~/esp/hello_world idf.py -DIDF_TARGET=esp32s2beta menuconfig You may need to run python2 idf.py on Python 3.0. Windows cd %userprofile%\esp\hello_world idf.py -DIDF_TARGET=esp32s2beta menuconfig The Python 2.7 installer will attempt to congure Windows to associate a .py le with Python 2. If other programs (such as Visual Studio Python tools) have been associated with other versions of Python, idf.py may not work properly (the le will open in Visual Studio). In this case, you can choose to run C:\Python27\python idf.py every time, or change the Windows .py associated le settings. Espressif Systems
/ 17 22 Sep. 2020 6. 6. Build and Flash Build and Flash Now you can build and ash the application. Run:
idf.py build
$ idf.py build This will compile the application and all the ESP-IDF components, generate bootloader, partition table, and application binaries, and ash these binaries to your ESP32-S2 board. Running cmake in directory /path/to/hello_world/build Executing "cmake -G Ninja --warn-uninitialized /path/to/hello_world"... Warn about uninitialized values.
-- Found Git: /usr/bin/git (found version "2.17.0")
-- Building empty aws_iot component due to configuration
-- Component names: ...
-- Component paths: ... .. (more lines of build system output)
[527/527] Generating hello-world.bin esptool.py v2.3.1 Project build complete. To flash, run this command:
../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash --
flash_mode dio --flash_size detect --flash_freq 40m 0x10000 build/hello-world.bin build 0x1000 build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin or run 'idf.py -p PORT flash'
If there are no issues, at the end of build process, you should see generated .bin les. Espressif Systems
/ 18 22 Sep. 2020 7. 7. Flash onto the Device Flash onto the Device Flash the binaries that you just built onto your ESP32-S2 board by running:
idf.py -p PORT [-b BAUD] flash Replace PORT with your ESP32-S2 board's serial port name. You can also change the asher baud rate by replacing BAUD with the baud rate you need. The default baud rate is 460800. Running esptool.py in directory [...]/esp/hello_world Executing "python [...]/esp-idf/components/esptool_py/esptool/esptool.py -b 460800 write_flash @flash_project_args"... esptool.py -b 460800 write_flash --flash_mode dio --flash_size detect --flash_freq 40m 0x1000 bootloader/bootloader.bin 0x8000 partition_table/partition-table.bin 0x10000 hello-
world.bin esptool.py v2.3.1 Connecting.... Detecting chip type... ESP32 Chip is ESP32D0WDQ6 (revision 1) Features: WiFi, BT, Dual Core Uploading stub... Running stub... Stub running... Changing baud rate to 460800 Changed. Configuring flash size... Auto-detected Flash size: 4MB Flash params set to 0x0220 Compressed 22992 bytes to 13019... Hash of data verified. Compressed 3072 bytes to 82... Hash of data verified. Compressed 136672 bytes to 67544... Hash of data verified. Leaving... Hard resetting via RTS pin... Wrote 22992 bytes (13019 compressed) at 0x00001000 in 0.3 seconds (effective 558.9 kbit/
s)... Wrote 3072 bytes (82 compressed) at 0x00008000 in 0.0 seconds (effective 5789.3 kbit/s)... Wrote 136672 bytes (67544 compressed) at 0x00010000 in 1.9 seconds (effective 567.5 kbit/
s)... If there are no issues by the end of the ash process, the module will be reset and the hello_world application will be running. Espressif Systems
/ 19 22 Sep. 2020 8. 8. IDF Monitor IDF Monitor To check if "hello_world" is indeed running, type idf.py -p PORT monitor (Do not forget to replace PORT with your serial port name). This command launches the monitor application:
$ idf.py -p /dev/ttyUSB0 monitor Running idf_monitor in directory [...]/esp/hello_world/build Executing "python [...]/esp-idf/tools/idf_monitor.py -b 115200 [...]/esp/hello_world/build/
hello-world.elf"...
--- idf_monitor on /dev/ttyUSB0 115200 ---
--- Quit: Ctrl+] | Menu: Ctrl+T | Help: Ctrl+T followed by Ctrl+H ---
ets Jun 8 2016 00:22:57 After startup and diagnostic logs scroll up, you should see "Hello world!" printed out by the application. rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT) ets Jun 8 2016 00:22:57
... .. I (211) cpu_start: Starting scheduler on APP CPU. Hello world!
Restarting in 10 seconds... Restarting in 9 seconds... Restarting in 8 seconds... Restarting in 7 seconds... To exit IDF monitor use the shortcut Ctrl+]. If IDF monitor fails shortly after the upload, or, if instead of the messages above, you see random garbage similar to what is given below, your board is likely using a 26MHz crystal. Most development board designs use 40MHz, so ESP-IDF uses this frequency as a default value. Espressif Systems
/ 20 22 Sep. 2020 9. For ESP-IDF examples, please go to ESP-IDF GitHub. 9. Examples Examples Espressif Systems
/ 21 22 Sep. 2020 Disclaimer and Copyright Notice Information in this document, including URL references, is subject to change without notice. THIS DOCUMENT IS PROVIDED AS IS WITH NO WARRANTIES WHATSOEVER, INCLUDING ANY WARRANTY OF MERCHANTABILITY, NON-INFRINGEMENT, FITNESS FOR ANY PARTICULAR PURPOSE, OR ANY WARRANTY OTHERWISE ARISING OUT OF ANY PROPOSAL, SPECIFICATION OR SAMPLE. All liability, including liability for infringement of any proprietary rights, relating to use of information in this document is disclaimed. No licenses express or implied, by estoppel or otherwise, to any intellectual property rights are granted herein. The Wi-Fi Alliance Member logo is a trademark of the Wi-Fi Alliance. The Bluetooth logo is a registered trademark of Bluetooth SIG. All trade names, trademarks and registered trademarks mentioned in this document are property of their respective owners, and are hereby acknowledged. Copyright 2020 Espressif Inc. All rights reserved. Espressif IoT Team www.espressif.com