Page 2
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 Version Release notes Sep. 2020 V0.1 Preliminary release. Documentation Change Notification Espressif provides email notifications to keep customers updated on changes to...
3.4. Add IDF_PATH to User Profile ....................3.4.1. Windows ........................3.4.2. Linux and MacOS ....................... 4. Establish Serial Connection with ESP32-S2-MINI-1 & ESP32-S2-MINI-1U ......4.1. Connect ESP32-S2-MINI-1 and ESP32-S2-MINI-1U to PC ............ 4.2. Check Port on Windows ......................4.3. Check Port on Linux and MacOS ....................
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.
Page 8
1. Introduction to ESP32-S2-MINI-1 & ESP32-S2-MINI-1U Type Function Description Name IO46 GPIO46 Hign: on, enables the chip. Low: off, the chip powers off. Note: Do not leave the EN pin floating Espressif Systems / 5 22 Sep. 2020...
• 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.
Page 10
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 flash 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.
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. 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 flashing the ESP32. This can be solved by adding the current user to the dialout group.
3. Getting Started with ESP32-S2-MINI-1 & ESP32-S2-MINI-1U 3.3. 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.
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.
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, first with the board / dongle unplugged, then with...
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...
Page 18
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...
Page 19
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.
Python, idf.py may not work properly (the file 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 file settings. Espressif Systems 17 22 Sep. 2020...
flash these binaries to your ESP32-S2 board. $ idf.py build 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 files. Espressif Systems 18 22 Sep. 2020...
Hash of data verified. Compressed 3072 bytes to 82... Wrote 3072 bytes (82 compressed) at 0x00008000 in 0.0 seconds (effective 5789.3 kbit/s)... Hash of data verified. Compressed 136672 bytes to 67544... Wrote 136672 bytes (67544 compressed) at 0x00010000 in 1.9 seconds (effective 567.5 kbit/ s)... Hash of data verified. Leaving... Hard resetting via RTS pin... If there are no issues by the end of the flash process, the module will be reset and the “hello_world” application will be running. Espressif Systems 19 22 Sep. 2020...
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. Examples Examples For ESP-IDF examples, please go to ESP-IDF GitHub. Espressif Systems 21 22 Sep. 2020...
Page 25
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.
Need help?
Do you have a question about the ESP32-S2-MINI-1 and is the answer not in the manual?
Questions and answers