ESP-WROOM-32D User Guide Version 1.
About This Guide This document is intended to help users set up the basic software development environment for developing applications using hardware based on the ESP-WROOM-32D. Through a simple example, this document illustrates how to use ESP-IDF (Espressif IoT Development Framework), including the menu based configuration wizard, compiling the ESP-IDF and firmware download to the ESP32 module. Release Notes Date Version Release notes 2017.11 V1.0 First release.
Table of Contents 1. Introduction............................................................................................................................. 1 1.1. ESP-WROOM-32D .....................................................................................................................1 1.2. ESP-IDF .....................................................................................................................................1 1.3. Preparation ................................................
1. Introduction ! 1. Introduction 1.1. ESP-WROOM-32D ESP-WROOM-32D is a powerful, generic Wi-Fi+BT+BLE 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. At the core of this module is the ESP32-D0WD chip*.
2. Get Started on ESP-WROOM-32D ! 2. Get Started on ESPWROOM-32D 2.1. Standard Setup of Toolchain for Linux The quickest way to start development with ESP32 is by installing a prebuilt toolchain. Pick up your OS below and follow provided instructions. 2.1.1.
2. Get Started on ESP-WROOM-32D ! Alternatively, you may create an alias for the above command. This way you can get the toolchain only when you need it. To do this, add different line to your ~/.bash_profile file: alias get_esp32="export PATH=$PATH:$HOME/esp/xtensa-esp32-elf/bin" Then when you need the toolchain you can type get_esp32 on the command line and the toolchain will be added to your PATH. 2.2.
3. Start a Project ! 3. Start a Project Now you are ready to prepare your application for ESP32. To start off quickly, we will use :example:`get-started/hello_world project from :idf:`examples` directory in IDF. Copy :example:`get-started/hello_world` to ~/esp directory: cd ~/esp cp -r $IDF_PATH/examples/get-started/hello_world . You can also find a range of example projects under the :idf:`examples` directory in ESPIDF.
4. Connect ! 4. Connect You are almost there. To be able to proceed further, connect ESP32 board to PC, check under what serial port the board is visible and verify if serial communication works. If you are not sure how to do it, check instructions in section :doc:`establish-serial-connection`. Note the port number, as it will be required in the next step. Espressif ! /!8 5 2017.
4. Configure ! 5. Configure Being in terminal window, go to directory of hello_world application by typing cd ~/esp/ hello_world. Then start project configuration utility menuconfig: cd ~/esp/hello_world make menuconfig If previous steps have been done correctly, the following menu will be displayed: ! In the menu, navigate to Serial flasher config > Default serial port to configure the serial port, where project will be loaded to.
5. Build and Flash ! 6. Build and Flash 6.1. Build and Flash Now you can build and flash the application. Run: make flash 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 board. esptool.py v2.0-beta2 Flashing binaries to serial port /dev/ttyUSB0 (app at offset 0x10000)... esptool.py v2.0-beta2 Connecting........___ Uploading stub... Running stub... Stub running...
5. Build and Flash ! If there are no issues, at the end of build process, you should see messages describing progress of loading process. Finally, the end module will be reset and “hello_world” application will start. If you'd like to use the Eclipse IDE instead of running make, check out the :doc:`Eclipse guide `. 6.2. Monitor To see if “hello_world” application is indeed running, type make monitor.
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.
FCC Label: The FCC ID is on the front of the device. It is easily visible. The device FCC ID is 2AC7Z‐ESPWROOM32D. A label with the following statements must be attached to the host end product: This device contains FCC ID: 2AC7Z‐ESPWROOM32D. The manual provides guidance to the host manufacturer will be included in the documentation that will be provided to the OEM. The module is limited to installation in mobile or fixed applications.
FCC RF Exposure Requirements This device complies with FCC RF radiation exposure limits set forth for an uncontrolled enviroment. The antenna(s) used for this transmitter must not be co‐located or operating in conjunction with any other antenna or transmitter and must be installed to provide a separation distance of at least 20cm from all persons. FCC Regulations This device complies with part 15 of the FCC Rules.