EK057 User Manual Prerelease version 0.2 Espressif Systems Copyright © 2020 www.espressif.
About This Document This user manual shows how to get started with EK057 module. Document Updates Please always refer to the latest version on https://www.espressif.com/en/support/download/documents. Revision History For revision history of this document, please refer to the last page. Documentation Change Notification Espressif provides email notifications to keep customers updated on changes to technical documentation. Please subscribe at www.espressif.com/en/subscribe.
Contents 1 Overview 1 1.1 Module Overview 1 1.2 Pin Description 1 2 Get Started on EK057 3 2.1 What You Need 3 2.2 Hardware Connection 3 2.3 Set up Development Environment 4 2.4 2.3.1 Install Prerequisites 4 2.3.2 Get ESP-IDF 4 2.3.3 Set up Tools 5 2.3.4 Set up Environment Variables 5 Create Your First Project 5 2.4.1 Start a Project 5 2.4.2 Connect Your Device 5 2.4.3 Configure 6 2.4.4 Build the Project 6 2.4.5 Flash onto the Device 7 2.4.
1. Overview 1. Overview 1.1 Module Overview EK057 is a powerful, generic Wi-Fi+Bluetooth® +Bluetooth® LE MCU module that targets 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: EK057 Specifications Categories Wi-Fi Items Specifications 802.11 b/g/n (802.11n up to 150 Mbps) Protocols A-MPDU and A-MSDU aggregation and 0.
1. Overview Name No. Type Function GND A7 P Ground GND A8 P Ground GND A9 P Ground IO18 A10 I/O GPIO18, VSPICLK, HS1_DATA7 IO23 A11 I/O GPIO23, VSPID, HS1_STROBE IO19 A12 I/O GPIO19, VSPIQ, U0CTS, EMAC_TXD0 IO33 A13 I/O GPIO33, XTAL_32K_N (32.768 kHz crystal oscillator output), ADC1_CH5, TOUCH8, RTC_GPIO8 High: On; enables the chip EN A14 I Low: Off; the chip powers off Note: Do not leave the pin floating.
2. Get Started on EK057 2. Get Started on EK057 2.1 What You Need To develop applications for EK057 module you need: • 1 x EK057 module • 1 x Espressif RF testing board • 1 x USB-to-Serial board • 1 x Micro-USB cable • 1 x PC running Linux In this user guide, we take Linux operating system as an example. For more information about the configuration on Windows and macOS, please refer to ESP-IDF Programming Guide. 2.2 Hardware Connection 1.
2. Get Started on EK057 6. Download firmware into flash. For details, see the sections below. 7. After download, remove the jumper on IO0 and GND. 8. Power up the RF testing board again. EK057 will switch to working mode. The chip will read programs from flash upon initialization. Note: IO0 is internally logic high. If IO0 is set to pull-up, the Boot mode is selected. If this pin is pull-down or left floating, the Download mode is selected. For more information on EK057, please refer to EK057 Datasheet.
2. Get Started on EK057 ESP-IDF will be downloaded into ~/esp/esp-idf. Consult ESP-IDF Versions for information about which ESP-IDF version to use in a given situation. 2.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 ./ install .sh 2.3.
2. Get Started on EK057 2.4.3 Configure Navigate to your ‘hello_world’ directory from Step 2.4.1. Start a Project, set ESP32 chip as the target and run the project configuration utility ‘menuconfig’. cd ~/esp/hello_world idf .py set−target esp32 idf .py menuconfig Setting the target with ‘idf.py set-target esp32’ should be done once, after opening a new project. If the project contains some existing builds and configuration, they will be cleared and initialized.
2. Get Started on EK057 −− 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.
2. Get Started on EK057 Configuring flash size ... Auto−detected Flash size : 4MB Flash params set to 0x0220 Compressed 22992 bytes to 13019... Wrote 22992 bytes (13019 compressed) at 0x00001000 in 0.3 seconds ( effective 558.9 kbit/s )... 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.
2. Get Started on EK057 That’s all what you need to get started with EK057 module! Now you are ready to try some other examples in ESP-IDF, or go right to developing your own applications. Espressif Systems 9 EK057 User Manual V0.
3. Learning Resources 3. Learning Resources 3.1 Must-Read Documents The following link provides documents related to ESP32. • ESP32 Datasheet This document provides an introduction to the specifications of the ESP32 hardware, including overview, pin definitions, functional description, peripheral interface, electrical characteristics, etc. • ESP32 ECO V3 User Guide This document describes differences between V3 and previous ESP32 silicon wafer revisions.
3. Learning Resources • ESP32 Tools This is a webpage where users can download ESP32 Flash Download Tools and the zip file ”ESP32 Certification and Test”. • ESP-IDF This webpage links users to the official IoT development framework for ESP32. • ESP32 Resources This webpage provides the links to all available ESP32 documents, SDK and tools. Espressif Systems 11 EK057 User Manual V0.
Revision History Revision History Date Version Release notes 2020-11-06 V0.2 Preliminary release v0.2 Espressif Systems 12 EK057 User Manual V0.