User's Manual

ManualsBrandsESPRESSIF ManualsElectronicsWi-Fi Internet or Things Module

www.espressif.com

ESP32-S2-MINI-1 &

ESP32-S2-MINI-1U

User Manual

Preliminary version 0.1

Espressif Systems

Summary of content (25 pages)

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 technical documentation. Please subscribe at www.espressif.com/en/subscribe.
PAGE 3
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 .........................................................................................
PAGE 4
1. Introduction to ESP32-S2-MINI-1 & ESP32-S2-MINI-1U 1. Introduction to ESP32-S2MINI-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. Specifications Category Wi-Fi Parameters Description Wi-Fi protocols 802.
PAGE 5
1.
PAGE 6
GND GND GND GND GND GND GND GND GND GND GND GND GND GND GND Pin 59 Pin 58 Pin 57 Pin 56 Pin 55 Pin 54 Pin 53 Pin 52 Pin 51 Pin 50 Pin 49 Pin 48 Pin 47 Pin 46 Pin 62 GND Pin 60 1.
PAGE 7
1. Introduction to ESP32-S2-MINI-1 & ESP32-S2-MINI-1U Espressif Systems Pin Name No.
PAGE 8
1. Introduction to ESP32-S2-MINI-1 & ESP32-S2-MINI-1U Pin Name No. Type Function Description IO46 44 I GPIO46 Hign: on, enables the chip. EN 45 I Low: off, the chip powers off. Note: Do not leave the EN pin floating Espressif Systems 5/22 Sep.
PAGE 9
2. Hardware Preparation 2. 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.
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: • • Espressif Systems IO0 is internally logic high. For more information on ESP32-S2-MINI-1 and ESP32-S2-MINI-1U, please refer to ESP32-S2MINI-1 and ESP32-S2-MINI-1U Datasheet. 7/22 Sep.
PAGE 11
3. Getting Started with ESP32-S2-MINI-1 & ESP32-S2-MINI-1U 3. Getting Started with ESP32S2-MINI-1 & ESP32-S2MINI-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.
PAGE 12
3. Getting Started with ESP32-S2-MINI-1 & ESP32-S2-MINI-1U 3.2.2.
PAGE 13
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.
PAGE 14
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. To get it, open terminal, navigate to the directory you want to put ESPIDF, and clone it using git clone command: git clone --recursive -b feature/esp32s2beta https://github.com/espressif/esp-idf.
PAGE 15
4. Establish Serial Connection with ESP32-S2-MINI-1 & ESP32-S2-MINI-1U 4. Establish Serial Connection with ESP32-S2-MINI-1 & ESP32-S2-MINI-1U This section provides guidance how to establish serial connection between ESP32-S2MINI-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.
PAGE 16
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 plugged in.
PAGE 17
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.
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.
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. Notes: • For some serial port wiring configurations, the serial RTS & DTR pins need to be disabled in the terminal program before the ESP32-S2 will boot and produce serial output.
PAGE 20
5. Configure 5. Configure Enter hello_world directory and run menuconfig. 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 configure Windows to associate a .py file with Python 2. If other programs (such as Visual Studio Python tools) have been associated with other versions of Python, idf.
PAGE 21
6. Build and Flash 6. Build and Flash Now you can build and flash the application. Run: idf.py build This will compile the application and all the ESP-IDF components, generate bootloader, partition table, and application binaries, and 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.
PAGE 22
7. Flash onto the Device 7. 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 flasher 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"...
PAGE 23
8. IDF Monitor 8. 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"...
PAGE 24
9. Examples 9. Examples For ESP-IDF examples, please go to ESP-IDF GitHub. Espressif Systems 21/ 22 Sep.
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. All liability, including liability for infringement of any proprietary rights, relating to use of information in this document is disclaimed.