1ESP32-DevKitC V4 Getting Started Guide
2======================================
3
4:link_to_translation:`zh_CN:[中文]`
5
6This guide shows how to start using the ESP32-DevKitC V4 development board. For description of other versions of ESP32-DevKitC check :doc:`../../hw-reference/index`.
7
8
9What You Need
10-------------
11
12* ESP32-DevKitC V4 board
13* USB A / micro USB B cable
14* Computer running Windows, Linux, or macOS
15
16You can skip the introduction sections and go directly to Section `Start Application Development`_.
17
18
19.. _DevKitC-Overview:
20
21Overview
22--------
23
24ESP32-DevKitC V4 is a small-sized ESP32-based development board produced by `Espressif <https://espressif.com>`_. Most of the I/O pins are broken out to the pin headers on both sides for easy interfacing. Developers can either connect peripherals with jumper wires or mount ESP32-DevKitC V4 on a breadboard.
25
26To cover a wide range of user requirements, the following versions of ESP32-DevKitC V4 are available:
27
28- different ESP32 modules
29
30   - `ESP32-WROOM-32E <https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32e_esp32-wroom-32ue_datasheet_en.pdf>`_
31   - `ESP32-WROOM-32UE <https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32e_esp32-wroom-32ue_datasheet_en.pdf>`_
32   - `ESP32-WROOM-32D <https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32d_esp32-wroom-32u_datasheet_en.pdf>`_
33   - `ESP32-WROOM-32U <https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32d_esp32-wroom-32u_datasheet_en.pdf>`_
34   - `ESP32-SOLO-1 <https://www.espressif.com/sites/default/files/documentation/esp32-solo-1_datasheet_en.pdf>`_
35   - `ESP32-WROVER-E <https://www.espressif.com/sites/default/files/documentation/esp32-wrover-e_esp32-wrover-ie_datasheet_en.pdf>`_
36   - `ESP32-WROVER-IE <https://www.espressif.com/sites/default/files/documentation/esp32-wrover-e_esp32-wrover-ie_datasheet_en.pdf>`_
37
38- male or female pin headers.
39
40For details please refer to `Espressif Product Ordering Information`_.
41
42
43Functional Description
44----------------------
45
46The following figure and the table below describe the key components, interfaces and controls of the ESP32-DevKitC V4 board.
47
48.. _get-started-esp32-devkitc-board-front:
49
50.. figure:: ../../../_static/esp32-devkitc-functional-overview.jpg
51    :align: center
52    :alt: ESP32-DevKitC V4 with ESP-WROOM-32 module soldered
53    :figclass: align-center
54
55    ESP32-DevKitC V4 with ESP32-WROOM-32 module soldered
56
57
58+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
59| Key Component      | Description                                                                                                                                                                          |
60+====================+======================================================================================================================================================================================+
61| ESP32-WROOM-32     | A module with ESP32 at its core.                                                                                                                                                     |
62+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
63| EN                 | Reset button.                                                                                                                                                                        |
64+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
65| Boot               | Download button. Holding down **Boot** and then pressing **EN** initiates Firmware Download mode for downloading firmware through the serial port.                                   |
66+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
67| USB-to-UART Bridge | Single USB-UART bridge chip provides transfer rates of up to 3 Mbps.                                                                                                                 |
68+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
69| Micro USB Port     | USB interface. Power supply for the board as well as the communication interface between a computer and the ESP32 module.                                                            |
70+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
71| 5V Power On LED    | Turns on when the USB or an external 5V power supply is connected to the board. For details see the schematics in `Related Documents`_.                                              |
72+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
73| I/O                | Most of the pins on the ESP module are broken out to the pin headers on the board. You can program ESP32 to enable multiple functions such as PWM, ADC, DAC, I2C, I2S, SPI, etc.     |
74+--------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
75
76    .. note::
77
78        The pins D0, D1, D2, D3, CMD and CLK are used internally for communication between ESP32 and SPI flash memory. They are grouped on both sides near the USB connector. Avoid using these pins, as it may disrupt access to the SPI flash memory / SPI RAM.
79
80    .. note::
81
82        The pins GPIO16 and GPIO17 are available for use only on the boards with the modules ESP32-WROOM and ESP32-SOLO-1. The boards with ESP32-WROVER modules have the pins reserved for internal use.
83
84
85Power Supply Options
86--------------------
87
88There are three mutually exclusive ways to provide power to the board:
89
90* Micro USB port, default power supply
91* 5V / GND header pins
92* 3V3 / GND header pins
93
94.. warning::
95
96    The power supply must be provided using **one and only one of the options above**, otherwise the board and/or the power supply source can be damaged.
97
98
99Note on C15
100-----------
101
102The component C15 may cause the following issues on earlier ESP32-DevKitC V4 boards:
103
104* The board may boot into Download mode
105* If you output clock on GPIO0, C15 may impact the signal
106
107In case these issues occur, please remove the component. The figure below shows C15 highlighted in yellow.
108
109
110.. figure:: ../../../_static/esp32-devkitc-c15-location.png
111    :align: center
112    :alt: Location of C15 (colored yellow) on ESP32-DevKitC V4 board
113    :figclass: align-center
114    :width: 30%
115
116    Location of C15 (yellow) on ESP32-DevKitC V4 board
117
118
119Start Application Development
120------------------------------
121
122Before powering up your ESP32-DevKitC V4, please make sure that the board is in good condition with no obvious signs of damage.
123
124After that, proceed to :doc:`../../get-started/index`, where Section :ref:`get-started-step-by-step` will quickly help you set up the development environment and then flash an example project onto your board.
125
126
127Board Dimensions
128----------------
129
130.. figure:: ../../../_static/esp32-devkitc-dimensions-back.jpg
131    :align: center
132    :alt: ESP32 DevKitC board dimensions - back
133    :figclass: align-center
134
135    ESP32 DevKitC board dimensions - back
136
137
138Related Documents
139-----------------
140
141* `ESP32-DevKitC V4 schematics <https://dl.espressif.com/dl/schematics/esp32_devkitc_v4-sch.pdf>`_ (PDF)
142* `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF)
143* `ESP32-WROOM-32 Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_en.pdf>`_ (PDF)
144* `ESP32-WROOM-32D & ESP32-WROOM-32U Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-wroom-32d_esp32-wroom-32u_datasheet_en.pdf>`_ (PDF)
145* `ESP32-WROVER Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover_datasheet_en.pdf>`_ (PDF)
146* `ESP32-WROVER-B Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_en.pdf>`_ (PDF)
147* `Espressif Product Ordering Information <https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_en.pdf>`_ (PDF)
148
149.. toctree::
150    :hidden:
151
152    get-started-devkitc-v2
153