Espressif Systems ESP32--C3--MINI--1 User manual

ESP32C3MINI1
User Manual
Pre-release v0.1
Espressif Systems
Copyright © 2021
www.espressif.com

About This Document
This user manual shows how to get started with the ESP32-C3-MINI-1 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 you updated on changes to technical documentation. Please sub-
scribe at www.espressif.com/en/subscribe.
Certification
Download certificates for Espressif products from www.espressif.com/en/certificates.

Contents
Contents
1 Overview 4
1.1 Module Overview 4
1.2 Pin Description 5
2 Get Started on ESP32C3MINI1 7
2.1 What You Need 7
2.2 Hardware Connection 7
2.3 Set up Development Environment 8
2.3.1 Install Prerequisites 8
2.3.2 Get ESP-IDF 8
2.3.3 Set up Tools 9
2.3.4 Set up Environment Variables 9
2.4 Create Your First Project 9
2.4.1 Start a Project 9
2.4.2 Connect Your Device 9
2.4.3 Configure 9
2.4.4 Build the Project 10
2.4.5 Flash onto the Device 11
2.4.6 Monitor 12
3 Learning Resources 14
3.1 Must-Read Documents 14
3.2 Important Resources 14
Revision History 15
Espressif Systems 3 ESP32-C3-MINI-1 User Manual v0.1

1 Overview
1 Overview
1.1 Module Overview
ESP32-C3-MINI-1 is a general-purpose Wi-Fi and Bluetooth LE module. The rich set of peripherals and a small
size make this module an ideal choice for smart homes, industrial automation, health care, consumer electronics,
etc.
Table 1: ESP32C3MINI1 Specifications
Categories Parameters Specifications
Wi-Fi Protocols 802.11 b/g/n (up to 150 Mbps)
Frequency range 2412 ~2462 MHz
Bluetooth®Protocols Bluetooth®LE: Bluetooth 5 and Bluetooth mesh
Radio Class-1, class-2 and class-3 transmitter
Hardware
Module interfaces
GPIO, SPI, UART, I2C, I2S, remote control peripheral,
LED PWM controller, general DMA controller, TWAI®
controller (compatible with ISO 11898-1), temperature
sensor, SAR ADC
Integrated crystal 40 MHz crystal
Operating voltage/Power supply 3.0 V ~3.6 V
Operating current Average: 80 mA
Minimum current delivered by power
supply 500 mA
Ambient temperature –40 °C ~+105 °C
Moisture sensitivity level (MSL) Level 3
Espressif Systems 4 ESP32-C3-MINI-1 User Manual v0.1

1 Overview
1.2 Pin Description
Pin 49
GND
GND GND GND
GNDGND
GND GND GND
Pin 1
Pin 2
Pin 3
Pin 4
Pin 6
Pin 5
Pin 7
Pin 8
Pin 9
Pin 10
Pin 11
Pin 53
GND
Pin 52
GND
Pin 12
Pin 13 Pin 14
Pin 15
Pin 16 Pin 17 Pin 18 Pin 19 Pin 20
Pin 21
Pin 22
Pin 23 Pin 24
Pin 25
Pin 51
GND
Pin 26
Pin 27
Pin 28
Pin 29
Pin 30
Pin 31
Pin 32
Pin 33
Pin 34
Pin 35
Pin 50
GND
Pin 36 Pin 37 Pin 38 Pin 39
Pin 40
Pin 41
Pin 42
Pin 43
Pin 44
Pin 45 Pin 46 Pin 47 Pin 48
GND
GND
3V3
NC
IO2
IO3
NC
EN
NC
NC
GND
IO0
IO1
GND
NC
IO10
NC
IO4
IO5
IO6 IO7
IO8 IO9
NC
NC
IO18
IO19
NC
NC
RXD0
TXD0
NC
NC
NC
NC
GND GND GND GND GND GND GND GND GND GND GND GND GND
Keepout Zone
Figure 1: Pin Layout (Top View)
The module has 53 pins. See pin definitions in Table 2.
For peripheral pin configurations, please refer to ESP32-C3 Family Datasheet .
Table 2: Pin Definitions
Name No. Type Function
GND 1, 2, 11, 14, 36-53 P Ground
3V3 3 P Power supply
NC 4 — NC
IO2 5 I/O/T GPIO2, ADC1_CH2, FSPIQ
IO3 6 I/O/T GPIO3, ADC1_CH3
NC 7 — NC
EN 8 I
High: on, enables the chip.
Low: off, the chip powers off.
Note: Do not leave the EN pin floating.
NC 9 — NC
NC 10 — NC
Cont’d on next page
Espressif Systems 5 ESP32-C3-MINI-1 User Manual v0.1

1 Overview
Table 2 – cont’d from previous page
Name No. Type Function
IO0 12 I/O/T GPIO0, ADC1_CH0, XTAL_32K_P
IO1 13 I/O/T GPIO1, ADC1_CH1, XTAL_32K_N
NC 15 — NC
IO10 16 I/O/T GPIO10, FSPICS0
NC 17 — NC
IO4 18 I/O/T GPIO4, ADC1_CH4, FSPIHD, MTMS
IO5 19 I/O/T GPIO5, ADC2_CH0, FSPIWP, MTDI
IO6 20 I/O/T GPIO6, FSPICLK, MTCK
IO7 21 I/O/T GPIO7, FSPID, MTDO
IO8 22 I/O/T GPIO8
IO9 23 I/O/T GPIO9
NC 24 — NC
NC 25 — NC
IO18 26 I/O/T GPIO18
IO19 27 I/O/T GPIO19
NC 28 — NC
NC 29 — NC
RXD0 30 I/O/T GPIO20, U0RXD,
TXD0 31 I/O/T GPIO21, U0TXD
NC 32 — NC
NC 33 — NC
NC 34 — NC
NC 35 — NC
Espressif Systems 6 ESP32-C3-MINI-1 User Manual v0.1

2 Get Started on ESP32-C3-MINI-1
2 Get Started on ESP32C3MINI1
2.1 What You Need
To develop applications for ESP32-C3-MINI-1 module you need:
• 1 x ESP32-C3-MINI-1 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. Solder the ESP32-C3-MINI-1 module to the RF testing board as shown in Figure 2.
Figure 2: Hardware Connection
2. Connect the RF testing board to the USB-to-Serial board via TXD, RXD, and GND.
3. Connect the USB-to-Serial board to the PC.
4. Connect the RF testing board to the PC or a power adapter to enable 5 V power supply, via the Micro-USB
cable.
5. During download, connect IO0 to GND via a jumper. Then, turn ”ON” the testing board.
6. Download firmware into flash. For details, see the sections below.
Espressif Systems 7 ESP32-C3-MINI-1 User Manual v0.1

2 Get Started on ESP32-C3-MINI-1
7. After download, remove the jumper on IO0 and GND.
8. Power up the RF testing board again. ESP32-C3-MINI-1 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 ESP32-C3-MINI-1, please refer to ESP32-C3-MINI-1 Datasheet.
2.3 Set up Development Environment
The Espressif IoT Development Framework (ESP-IDF for short) is a framework for developing applications based on
the Espressif chips. Users can develop applications with ESP chips in Windows/Linux/macOS based on ESP-IDF.
Here we take Linux operating system as an example.
2.3.1 Install Prerequisites
To compile with ESP-IDF you need to get the following packages:
• CentOS 7:
1sudo yum install git wget flex bison gperf python cmake ninja-build ccache dfu-
util
• Ubuntu and Debian (one command breaks into two lines):
1sudo apt-get install git wget flex bison gperf python python-pip python-
setuptools cmake
2ninja-build ccache libffi-dev libssl-dev dfu-util
• Arch:
1sudo pacman -S --needed gcc git make flex bison gperf python-pip cmake ninja
ccache dfu-util
Note:
• This guide uses the directory ~/esp on Linux as an installation folder for ESP-IDF.
• Keep in mind that ESP-IDF does not support spaces in paths.
2.3.2 Get ESPIDF
To build applications for ESP32-C3-MINI-1 module, you need the software libraries provided by Espressif in
ESP-IDF repository.
To get ESP-IDF, create an installation directory (~/esp) to download ESP-IDF to and clone the repository with ‘git
clone’:
1mkdir -p ~/esp
2cd ~/esp
3git clone --recursive https://github.com/espressif/esp-idf.git
Espressif Systems 8 ESP32-C3-MINI-1 User Manual v0.1

2 Get Started on ESP32-C3-MINI-1
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.
1cd ~/esp/esp-idf
2./install.sh
2.3.4 Set up Environment Variables
The installed tools are not yet added to the PATH environment variable. To make the tools usable from the command
line, some environment variables must be set. ESP-IDF provides another script ’export.sh’ which does that. In the
terminal where you are going to use ESP-IDF, run:
1. $HOME/esp/esp-idf/export.sh
Now everything is ready, you can build your first project on ESP32-C3-MINI-1 module.
2.4 Create Your First Project
2.4.1 Start a Project
Now you are ready to prepare your application for ESP32-C3-MINI-1 module. You can start with get-started/hello_world
project from examples directory in ESP-IDF.
Copy get-started/hello_world to ~/esp directory:
1cd ~/esp
2cp -r $IDF_PATH/examples/get-started/hello_world .
There is a range of example projects in the examples directory in ESP-IDF. You can copy any project in the same
way as presented above and run it. It is also possible to build examples in-place, without copying them first.
2.4.2 Connect Your Device
Now connect your ESP32-C3-MINI-1 module to the computer and check under what serial port the module is
visible. Serial ports in Linux start with ‘/dev/tty’ in their names. Run the command below two times, first with the
board unplugged, then with plugged in. The port which appears the second time is the one you need:
1ls /dev/tty*
Note:
Keep the port name handy as you will need it in the next steps.
2.4.3 Configure
Navigate to your ‘hello_world’ directory from Step 2.4.1. Start a Project, set ESP32-C3 as the target and run the
project configuration utility ‘menuconfig’.
Espressif Systems 9 ESP32-C3-MINI-1 User Manual v0.1

2 Get Started on ESP32-C3-MINI-1
1cd ~/esp/hello_world
2idf.py set-target esp32c3
3idf.py menuconfig
Setting the target with ‘idf.py set-target esp32c3’ should be done once, after opening a new project. If the project
contains some existing builds and configuration, they will be cleared and initialized. The target may be saved in
environment variable to skip this step at all. See Selecting the Target for additional information.
If the previous steps have been done correctly, the following menu appears:
Figure 3: Project Configuration  Home Window
The colors of the menu could be different in your terminal. You can change the appearance with the option ‘-�-style’�.
Please run ‘idf.py menuconfig -�-help’�for further information.
2.4.4 Build the Project
Build the project by running:
1idf.py build
This command will compile the application and all ESP-IDF components, then it will generate the bootloader,
partition table, and application binaries.
1$ idf.py build
2Running cmake in directory /path/to/hello_world/build
3Executing ”cmake -G Ninja --warn-uninitialized /path/to/hello_world”...
4Warn about uninitialized values.
5-- Found Git: /usr/bin/git (found version ”2.17.0”)
6-- Building empty aws_iot component due to configuration
7-- Component names: ...
8-- Component paths: ...
9
10 ... (more lines of build system output)
11
Espressif Systems 10 ESP32-C3-MINI-1 User Manual v0.1

2 Get Started on ESP32-C3-MINI-1
12 [527/527] Generating hello-world.bin
13 esptool.py v2.3.1
14
15 Project build complete. To flash, run this command:
16 ../../../components/esptool_py/esptool/esptool.py -p (PORT) -b 921600 write_flash --flash_
mode dio
17 --flash_size detect --flash_freq 40m 0x10000 build/hello-world.bin build 0x1000
18 build/bootloader/bootloader.bin 0x8000 build/partition_table/partition-table.bin
19 or run ’idf.py -p PORT flash’
If there are no errors, the build will finish by generating the firmware binary .bin file.
2.4.5 Flash onto the Device
Flash the binaries that you just built onto your ESP32-C3-MINI-1 module by running:
1idf.py -p PORT [-b BAUD] flash
Replace PORT with your module‘s serial port name from Step: Connect Your Device.
You can also change the flasher baud rate by replacing BAUD with the baud rate you need. The default baud rate
is 460800.
For more information on idf.py arguments, see idf.py.
Note:
The option ‘flash‘ automatically builds and flashes the project, so running ‘idf.py build‘ is not necessary.
1...
2esptool.py --chip esp32c3 -p /dev/ttyUSB0 -b 460800 --before=default_reset --after
=hard_reset write_flash --flash_mode dio --flash_freq 80m --flash_size 2MB 0x
8000 partition_table/partition-table.bin 0x0 bootloader/bootloader.bin 0x10000
hello-world.bin
3esptool.py v3.0
4Serial port /dev/ttyUSB0
5Connecting....
6Chip is ESP32-C3
7Features: Wi-Fi
8Crystal is 40MHz
9MAC: 7c:df:a1:40:02:a4
10 Uploading stub...
11 Running stub...
12 Stub running...
13 Changing baud rate to 460800
14 Changed.
15 Configuring flash size...
16 Compressed 3072 bytes to 103...
17 Writing at 0x00008000... (100 %)
18 Wrote 3072 bytes (103 compressed) at 0x00008000 in 0.0 seconds (effective 4238.1
kbit/s)...
19 Hash of data verified.
Espressif Systems 11 ESP32-C3-MINI-1 User Manual v0.1

2 Get Started on ESP32-C3-MINI-1
20 Compressed 18960 bytes to 11311...
21 Writing at 0x00000000... (100 %)
22 Wrote 18960 bytes (11311 compressed) at 0x00000000 in 0.3 seconds (effective 584.9
kbit/s)...
23 Hash of data verified.
24 Compressed 145520 bytes to 71984...
25 Writing at 0x00010000... (20 %)
26 Writing at 0x00014000... (40 %)
27 Writing at 0x00018000... (60 %)
28 Writing at 0x0001c000... (80 %)
29 Writing at 0x00020000... (100 %)
30 Wrote 145520 bytes (71984 compressed) at 0x00010000 in 2.3 seconds (effective
504.4 kbit/s)...
31 Hash of data verified.
32
33 Leaving...
34 Hard resetting via RTS pin...
35 Done
If everything goes well, the “hello_world” application starts running after you remove the jumper on IO0 and GND,
and re-power up the testing board.
2.4.6 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 IDF Monitor application:
1$ idf.py -p /dev/ttyUSB0 monitor
2Running idf_monitor in directory [...]/esp/hello_world/build
3Executing ”python [...]/esp-idf/tools/idf_monitor.py -b 115200 [...]/esp/hello_world/build
/hello-world.elf”...
4--- idf_monitor on /dev/ttyUSB0 115200 ---
5--- Quit: Ctrl+] | Menu: Ctrl+T | Help: Ctrl+T followed by Ctrl+H ---
6ets Jun 8 2016 00:22:57
7
8rst:0x1 (POWERON_RESET),boot:0x13 (SPI_FAST_FLASH_BOOT)
9ets Jun 8 2016 00:22:57
10 ...
After startup and diagnostic logs scroll up, you should see “Hello world!” printed out by the application.
1...
2Hello world!
3Restarting in 10 seconds...
4This is esp32c3 chip with 1 CPU core, WiFi/BLE, 4MB external flash
5Restarting in 9 seconds...
6Restarting in 8 seconds...
7Restarting in 7 seconds...
To exit IDF monitor use the shortcut Ctrl+].
Espressif Systems 12 ESP32-C3-MINI-1 User Manual v0.1

2 Get Started on ESP32-C3-MINI-1
That’s all what you need to get started with ESP32-C3-MINI-1 module! Now you are ready to try some other
examples in ESP-IDF, or go right to developing your own applications.
Espressif Systems 13 ESP32-C3-MINI-1 User Manual v0.1

3 Learning Resources
3 Learning Resources
3.1 MustRead Documents
Please familiarize yourself with the following documents:
•ESP32-C3 Family Datasheet
This is an introduction to the specifications of the ESP32-C3 hardware, including overview, pin definitions,
functional description, peripheral interface, electrical characteristics, etc.
•ESP-IDF Programming Guide
Extensive documentation for the ESP-IDF development framework, ranging from hardware guides to API
reference.
•ESP32-C3 Technical Reference Manual
Detailed information on how to use the ESP32-C3 memory and peripherals.
•Espressif Products Ordering Information
3.2 Important Resources
Here are the important ESP32-C3-related resources.
•ESP32 BBS
Engineer-to-Engineer (E2E) Community for Espressif products where you can post questions, share knowl-
edge, explore ideas, and help solve problems with fellow engineers.
Espressif Systems 14 ESP32-C3-MINI-1 User Manual v0.1

Revision History
Revision History
Date Version Release notes
2021-02-01 V0.1 Preliminary release
Espressif Systems 15 ESP32-C3-MINI-1 User Manual v0.1

www.espressif.com
Disclaimer and Copyright Notice
Information in this document, including URL references, is subject to change without notice.
ALL THIRD PARTY’S INFORMATION IN THIS DOCUMENT IS PROVIDED AS IS WITH NO
WARRANTIES TO ITS AUTHENTICITY AND ACCURACY.
NO WARRANTY IS PROVIDED TO THIS DOCUMENT FOR ITS MERCHANTABILITY, NON-
INFRINGEMENT, FITNESS FOR ANY PARTICULAR PURPOSE, NOR DOES 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. No licenses express or implied, by estoppel or otherwise, to any
intellectual property rights are granted herein.
The Wi-Fi Alliance Member logo is a trademark of the Wi-Fi Alliance. The Bluetooth logo is a
registered trademark of Bluetooth SIG.
All trade names, trademarks and registered trademarks mentioned in this document are property
of their respective owners, and are hereby acknowledged.
Copyright © 2021 Espressif Systems (Shanghai) Co., Ltd. All rights reserved.