Espressif ESP32 Manuel utilisateur
!
Version 0.1
Copyright © 2015
ESP32
User Guide
About This Guide
This guide describes the software, firmware environment and development recommendations
required to build an application around the ESP32 development board with build-in ESP32
chip.
This document is structured as follows:
Style Identifiers
This is a code input style.
This is a code output style.
Release Notes
Note：
This guide is only for SDK Verison 1.0.0. Refer to the “ESP32 System Description” for more details on
the ESP32 development board.
Chapter
Title
Subject
Chapter 1
Introduction
Introduces the ESP32 and software and hardware required.
Explains the software package with details on its architecture and
contents.
Chapter 2
Getting Started
Guides users how to build and upload an application firmware
provided by Espressif.
Appendix
Notices
FCC/CE compliance statement.
Code Input
Code output
Date
Version
Release notes
2015.12
V0.1
Confidential for internal use only.
Confidential
Table of Contents
1. Introduction 4 ...............................................................................................................................................
1.1. ESP32 4 .......................................................................................................................................................................
1.2. Requirements 4 .........................................................................................................................................................
1.2.1. Hardware 4 .........................................................................................................................................................
1.2.2. Software 6 ...........................................................................................................................................................
2. Getting Started 8 ..........................................................................................................................................
2.1. Getting Started to Use SDK 8 ................................................................................................................................
2.1.1. Process Overview 8 .........................................................................................................................................
2.1.2. Building Toolchain 8 ........................................................................................................................................
2.1.3. Building Firmware 11 ........................................................................................................................................
2.1.4. Uploading Firmware 12 ...................................................................................................................................
2.1.5. Running Application 15 ....................................................................................................................................
2.2. SSC Command Reference 15 ...................................................................................................................................
2.2.1. op 15 ......................................................................................................................................................................
2.2.2. sta 16 .....................................................................................................................................................................
2.2.3. ap 17 ......................................................................................................................................................................
2.2.4. mac 17 ...................................................................................................................................................................
2.2.5. dhcp 18 .................................................................................................................................................................
2.2.6. ip 18 .......................................................................................................................................................................
2.2.7. reboot 19 .............................................................................................................................................................
2.2.8. ram 19 ...................................................................................................................................................................
Appendix - Notices 20 ......................................................................................................................................
I. Federal Communications Commission (FCC) Declaration of Conformity 20 ..............................................
II. EC Declaration of Conformity 20..........................................................................................................................
Confidential
1. Introduction
1. Introduction
1.1. ESP32
ESP32 provides a Wi-Fi solution in the 2.4GHz band by using 40nm technology. It delivers
highly integrated Wi-Fi SoC solution to meet the continuous demands for efficient power
usage, compact design and reliable performance.
You can use ESP32 series hardware and software provided by Espressif to develop and
program some useful Wi-Fi and wearable electronics applications and products in Internet of
Things(IoT) industry.
1.2. Requirements
Before getting started to run and develop firmware applications on your ESP32, there are
some hardware and software requirements.
1.2.1. Hardware
•An ESP32 development board or ESP-WROOM-03(build-in ESP32).
•A USB TTL Serial cable or a Micro-USB cable.
•Debian GNU/Linux OS on an x86 machine.
Notes：
1. We assume to use the Debian or Ubuntu Linux OS. You may make some modifications for the
other Linux OS.
2. For more information about ESP-WROOM-03, refer to “ESP-WROOM-03 Specification".
Espressif
2015.12
Confidential
1. Introduction
1.2.2. Software
Development Platform
ESP32 RTOS SDK is a development platform provided for the users to develop their project.
•For the latest version, go to Download ESP32 RTOS SDK in Github.
•For the package components, refer to Figure 1-2.
Figure 1-2. Package Components
Bin files to be downloaded to the flash
Example codes of SDK applications
Header files required for compilation
Files for SDK compilation and link
Library files of SDK compilation
Library files of open source code
Compilation tools
Bin files for SSC
driver codes
Sample project template
Extra head files for compiling
Header files provided by Espressif
Header files of freeRTOS
Header files of Json library
Header files of LwIP library
Header files of SSL library
Espressif
2015.12
Confidential
1. Introduction
Serial Terminal Tool
We recommend using Minicom as a serial terminal tool to show the communication
information and debug code.
Uploading Tool
We recommend using Python 2.6 or 2.7 and esptool_ESP32.py to upload firmware to the
flash.
•For the latest version of Python, go to Download Python.
•esptool_ESP32.py file is in the ESP32 RTOS SDK > tools folder, refer to Figure 1-2.
Package Components.
•For the details of instructions, refer to 2.5.2 Uploading Files.
Espressif
2015.12
Confidential
2. Getting Started
2. Getting Started
2.1. Getting Started to Use SDK
2.1.1. Process Overview
2.1.2. Building Toolchain
We suggest to choose Crosstool-ng as the compiler toolchain. Follow the instructions below to
install Crosstool-ng.
1. Update the system.
sudo apt-get update
Figure 2-1. Process Overview
Start
Building
firmware
End
Uploading
firmware
Building
toolchain
Configuring
firmware
Note：
Your PC needs to connect to the Internet.
Espressif
2015.12
Confidential
2. Getting Started
2. Install the required toolchain packages.
sudo apt-get install git autoconf build-essential gperf bison flex
texinfo libtool libncurses5-dev wget gawk libc6 python-serial
libexpat-dev
2 upgraded, 37 newly installed, 0 to remove and 395 not upgraded.
Need to get 10.4 MB of archives.
After this operation, 48.7 MB of additional disk space will be used.
Do you want to continue? [Y/n]
y
Setting up texinfo (5.2.0.dfsg.1-2) ...
Setting up libwww-perl (6.05-2) ...
Setting up liblwp-protocol-https-perl (6.04-2ubuntu0.1) ...
Setting up libxml-parser-perl (2.41-1build3) ...
Setting up libxml-sax-expat-perl (0.40-2) ...
update-perl-sax-parsers: Registering Perl SAX parser XML::SAX::Expat
with priority 50...
update-perl-sax-parsers: Updating overall Perl SAX parser modules
info file...
Replacing config file /etc/perl/XML/SAX/ParserDetails.ini with new
version
3. Create a directory to store the toolchain.
sudo mkdir /opt/Espressif
4. Make the current user as the owner.
sudo chown $USER /opt/Espressif/
5. Download the latest toolchain installation file.
cd /opt/Espressif/
git clone -b esp108-1.21.0 git://github.com/jcmvbkbc/crosstool-NG.git
Cloning into 'crosstool-NG'...
remote: Counting objects: 28443, done.
remote: Total 28443 (delta 0), reused 0 (delta 0), pack-reused 28443
Receiving objects: 100% (28443/28443), 15.83 MiB | 71.00 KiB/s, done.
Resolving deltas: 100% (16473/16473), done.
Checking connectivity... done.
Espressif
2015.12
Confidential
2. Getting Started
6. Install toolchain.
cd crosstool-NG/
./bootstrap && ./configure --prefix=`pwd` && make && make install
For auto-completion, do not forget to install 'ct-ng.comp' into
your bash completion directory (usually /etc/bash_completion.d)
username:/opt/Espressif/crosstool-NG$
./ct-ng xtensa-esp108-elf
***********************************************************
WARNING! This sample may enable experimental features.
Please be sure to review the configuration prior
to building and using your toolchain!
Now, you have been warned!
***********************************************************
Now configured for "xtensa-esp108-elf"
username:/opt/Espressif/crosstool-NG$
./ct-ng build
[INFO ] Cleaning-up the toolchain's directory
[INFO ] Stripping all toolchain executables
[INFO ] Cleaning-up the toolchain's directory: done in 1.85s (at
24:28)
[INFO ] Build completed at 20151210.175153
[INFO ] (elapsed: 24:27.54)
[INFO ] Finishing installation (may take a few seconds)...
7. Set the PATH variable to point to the newly compiled toolchain.
export PATH=/opt/Espressif/crosstool-NG/builds/xtensa-esp108-elf/bin:
$PATH
Note：
It takes about dozens of minutes to build toolchain.
⚠ Notice：
Make sure you set the correct path, or it will occur a compile error.
Espressif
2015.12
Confidential
2. Getting Started
🔚
2.1.3. Building Firmware
1. Create a directory to store a new project.
mkdir ~/Workspace
cd ~/Workspace
2. Download the latest ESP32 RTOS SDK.
git clone https://github.com/espressif/ESP32_RTOS_SDK.git
3. Create a directory to store the.bin files compiled.
mkdir –p ~/Workspace/ESP32_BIN
4. Set the PATHs variable to point to the SDK and BIN files.
export SDK_PATH=~/Workspace/ESP32_RTOS_SDK
export BIN_PATH=~/Workspace/ESP32_BIN
5. Start to compile files.
cd ~/Workspace/project_template
make clean
make
🔚
Note：
You need to do Step 6 every time you open a new shell, or you can put it inside your .bashrc file.
Notes：
1. For the package components of the SDK, refer to “1.3 Package Components”.
2. You can build customized project according the ESP32_RTOS_SDK/examples/project_template.
⚠ Warning：
Make sure you set the correct paths, or it will occur a compile error.
Note：
You need to do Step 3 every time you open a new shell, or you can put it inside your .bashrc file.
Espressif
2015.12
Confidential
Autres manuels pour ESP32
3
Table des matières
Autres manuels Espressif Carte mère
Espressif
Espressif ESP32-Ethernet-Kit Manuel utilisateur
Espressif
Espressif ESP-EYE V2.1 Manuel utilisateur
Espressif
Espressif ESP32-DevKitC V4 Manuel utilisateur
Espressif
Espressif ESP-WROVER-KIT Manuel utilisateur
Espressif
Espressif ESP32-DevKitC Manuel utilisateur
Espressif
Espressif ESP32-C3-DevKitM-1 Manuel utilisateur
Espressif
Espressif ESP32-LyraTD-MSC Manuel utilisateur
Espressif
Espressif ESP32-LyraT Manuel de l'opérateur
Manuels Carte mère populaires d'autres marques
Telit Wireless Solutions
Telit Wireless Solutions SL869-3DR Manuel utilisateur
Gigabyte
Gigabyte GA-9IVDT Manuel utilisateur
Texas Instruments
Texas Instruments ADS8372EVM Manuel utilisateur
Commell
Commell MS-C73 Manuel utilisateur
IBT Technologies
IBT Technologies MB860 Manuel utilisateur
Nvidia
Nvidia TEGRA DG-04927-001_V01 Manuel utilisateur
