ESP32-DevKitC Getting Started Guide Version 1.
About This Guide This user guide introduces how to use the ESP32-DevKitC development board. The document structure is as follows: Chapter Title Content Chapter 1 Overview Introduction to the ESP32-DevKitC. Chapter 2 Compilation and Download Presentation of how to compile and download BIN files to the ESP32-DevKitC by using example/01_hello_world in ESP-IDF as an example. Release Notes Date Version Release notes 2016.09 V1.0 Initial release. 2016.10 V1.1 Updated Figure 1-2.
Table of Contents 1. Overview ................................................................................................................................ 1 1.1. Product Introduction ..................................................................................................................1 1.2. Functional Description ...............................................................................................................2 2. Compilation and Download .......................................
1. Overview ! 1. Overview 1.1. Product Introduction ESP32-DevKitC is a small-sized ESP32-based development board produced by Espressif. Most of the I/O pins are led out to the pin headers on both sides for easy interfacing. Developers can connect these pins to peripherals as needed. Standard headers also make development easy and convenient when using a breadboard. 48.2 mm 27.9 mm 18.0 mm 55.0 mm ! Figure 1-1.
1. Overview ! 1.2. Functional Description Table 1-1. ESP32-DevKitC Functional Description Interface/Module ESP-WROOM-32 EN ESP-WROOM-32 module. Reset button: pressing this button resets the system. Boot Download button: holding down the Boot button and pressing the EN button initiates the firmware download mode. Then users can download firmware through the serial port. USB USB interface. It functions as the power supply for the board and the communication interface between PC and ESP-WROOM-32.
2. Compilation and Download ! 2. Compilation and Download We are using ESP-IDF as an example to show how to download firmware to the ESP32DevKitC. • The hardware listed below are required: - 1 × ESP32-DevKitC - 1 × PC (with Windows OS as an example in this document) - 1 × USB cable • The tools listed below are required: - ESP32 Flash Download Tool: http://espressif.com/en/support/download/othertools?keys=&field_type_tid%5B%5D=13 - ESP-IDF https://github.com/espressif/esp-idf.git 2.1.
2. Compilation and Download ! ! 2.3. The hello_world Example The esp-idf/examples/01_hello_world directory contains a sample code that can be run on the ESP32. 1. Using the command terminal, change the current directory to example/01_hello_world: cd examples/01_hello_world/ 2. Configure IDF_PATH: export IDF_PATH=/home/share/esp-idf-driver/esp-idf 3. Check the IDF_PATH configuration to make sure it is properly set. Failing to set the path will cause failure to the linking of dependent files later.
2. Compilation and Download ! 2.3.1. Using the ESP32 DOWNLOAD TOOL Execute the following command in the terminal to make the example project and generate executable BIN files: make Three BIN files need to be downloaded: example/01_hello_world/bootloader/ bootloader.bin, example/01_hello_world/partitions_singleapp.bin and example/ 01_hello_world/hello-world.bin. Then, users can flash these BIN files by using the ESP32 DOWNLOAD TOOL. Please follow the steps below: 1. Open the ESP32 DOWNLOAD TOOL. 2.
2. Compilation and Download ! 3. Open the serial port. Set the Port, Baud rate = 115200, Data bits = 8, and Stop bits = 1. If the log below is printed, then it shows that the firmware has been downloaded to the ESP32-DevKitC successfully. ! 2.3.2. Using esptool Users need to configure the serial port before compiling and downloading BIN files. Serial port configuration is not required if the Flash Download Tool is used to flash the BIN files on to the ESP32-DevKitC.
2. Compilation and Download ! 2. Select Serial flasher config to configure the serial port, as shown below: ! 3. Configure the serial port, as shown below: ! 4. Click “OK” and exit make menuconfig. 5. Flash BIN files directly via the command line below: make flash 📖 Notes: • Please configure the serial port according to actual situation. • Only DIO mode is supported currently. QIO mode would be supported afterwards. • For more information on ESP-IDF, please see ESP-IDF Getting Started Guide.
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 the use of information in this document, is disclaimed.
