1ESP32-PICO-KIT V4 / V4.1 Getting Started Guide
2==============================================
3:link_to_translation:`zh_CN:[中文]`
4
5This guide shows how to get started with the ESP32-PICO-KIT V4 / V4.1 mini development board. For the description of other ESP32-PICO-KIT versions, please check :doc:`../../hw-reference/index`.
6
7This particular description covers ESP32-PICO-KIT V4 and V4.1. The difference is the upgraded USB-UART bridge from CP2102 in V4 with up to 1 Mbps transfer rates to CP2102N in V4.1 with up to 3 Mbps transfer rates.
8
9
10What You Need
11-------------
12
13* :ref:`ESP32-PICO-KIT mini development board <get-started-pico-kit-v4-board-front>`
14* USB 2.0 A to Micro B cable
15* Computer running Windows, Linux, or macOS
16
17You can skip the introduction sections and go directly to Section `Start Application Development`_.
18
19
20Overview
21--------
22
23ESP32-PICO-KIT is an ESP32-based mini development board produced by `Espressif <https://espressif.com>`_.
24
25The core of this board is ESP32-PICO-D4 - a System-in-Package (SiP) module with complete Wi-Fi and Bluetooth functionalities. Compared to other ESP32 modules, ESP32-PICO-D4 integrates the following peripheral components in one single package, which otherwise would need to be installed separately:
26
27- 40 MHz crystal oscillator
28- 4 MB flash
29- Filter capacitors
30- RF matching links
31
32This setup reduces the costs of additional external components as well as the cost of assembly and testing and also increases the overall usability of the product.
33
34The development board features a USB-UART Bridge circuit which allows developers to connect the board to a computer's USB port for flashing and debugging.
35
36All the IO signals and system power on ESP32-PICO-D4 are led out to two rows of 20 x 0.1" header pads on both sides of the development board for easy access. For compatibility with Dupont wires, 2 x 17 header pads are populated with two rows of male pin headers. The remaining 2 x 3 header pads beside the antenna are not populated. These pads may be populated later by the user if required.
37
38.. note::
39
40    1. The 2 x 3 pads not populated with pin headers are connected to the flash memory embedded in the ESP32-PICO-D4 SiP module. For more details see module's datasheet in `Related Documents`_.
41    2. ESP32-PICO-KIT comes with male headers by default.
42
43Functionality Overview
44----------------------
45
46The block diagram below shows the main components of ESP32-PICO-KIT and their interconnections.
47
48.. figure:: ../../../_static/esp32-pico-kit-v4-functional-block-diagram.png
49    :align: center
50    :alt: ESP32-PICO-KIT functional block diagram
51    :figclass: align-center
52
53    ESP32-PICO-KIT block diagram
54
55
56Functional Description
57----------------------
58
59The following figure and the table below describe the key components, interfaces, and controls of the ESP32-PICO-KIT board.
60
61.. _get-started-pico-kit-v4-board-front:
62
63.. figure:: ../../../_static/esp32-pico-kit-v4.1-f-layout.jpeg
64    :align: center
65    :alt: ESP32-PICO-KIT board layout
66    :figclass: align-center
67
68    ESP32-PICO-KIT board layout
69
70Below is the description of the items identified in the figure starting from the top left corner and going clockwise.
71
72==================  =================================================================================================================================
73Key Component       Description
74==================  =================================================================================================================================
75ESP32-PICO-D4       Standard ESP32-PICO-D4 module soldered to the ESP32-PICO-KIT board. The complete ESP32 system on a chip (ESP32 SoC) has been integrated into the SiP module, requiring only an external antenna with LC matching network, decoupling capacitors, and a pull-up resistor for EN signals to function properly.
76
77LDO                 5V-to-3.3V Low dropout voltage regulator (LDO).
78
79USB-UART bridge     Single-chip USB-UART bridge: CP2102 in V4 provides up to 1 Mbps transfer rates and CP2102N in V4.1 offers up to 3 Mbps transfers rates.
80
81Micro USB Port      USB interface. Power supply for the board as well as the communication interface between a computer and the board.
82
835V Power On LED     This red LED turns on when power is supplied to the board. For details, see the schematics in `Related Documents`_.
84
85I/O                 All the pins on ESP32-PICO-D4 are broken out to pin headers. You can program ESP32 to enable multiple functions, such as PWM, ADC, DAC, I2C, I2S, SPI, etc. For details, please see Section `Pin Descriptions`_.
86
87BOOT Button         Download button. Holding down **Boot** and then pressing **EN** initiates Firmware Download mode for downloading firmware through the serial port.
88
89EN Button           Reset button.
90==================  =================================================================================================================================
91
92
93Power Supply Options
94--------------------
95
96There are three mutually exclusive ways to provide power to the board:
97
98* Micro USB port, default power supply
99* 5V / GND header pins
100* 3V3 / GND header pins
101
102.. warning::
103
104    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.
105
106
107Pin Descriptions
108----------------
109
110The two tables below provide the **Name** and **Function** of I/O header pins on both sides of the board, see :ref:`get-started-pico-kit-v4-board-front`. The pin numbering and header names are the same as in the schematic given in `Related Documents`_.
111
112
113Header J2
114"""""""""
115
116======  =================  ======  ======================================================
117No.     Name               Type    Function
118======  =================  ======  ======================================================
1191       FLASH_SD1 (FSD1)   I/O     | GPIO8, SD_DATA1, SPID, HS1_DATA1 :ref:`(See 1) <get-started-pico-kit-v4-pin-notes>` , U2CTS
1202       FLASH_SD3 (FSD3)   I/O     | GPIO7, SD_DATA0, SPIQ, HS1_DATA0 :ref:`(See 1) <get-started-pico-kit-v4-pin-notes>` , U2RTS
1213       FLASH_CLK (FCLK)   I/O     | GPIO6, SD_CLK, SPICLK, HS1_CLK :ref:`(See 1) <get-started-pico-kit-v4-pin-notes>` , U1CTS
1224       IO21               I/O     | GPIO21, VSPIHD, EMAC_TX_EN
1235       IO22               I/O     | GPIO22, VSPIWP, U0RTS, EMAC_TXD1
1246       IO19               I/O     | GPIO19, VSPIQ, U0CTS, EMAC_TXD0
1257       IO23               I/O     | GPIO23, VSPID, HS1_STROBE
1268       IO18               I/O     | GPIO18, VSPICLK, HS1_DATA7
1279       IO5                I/O     | GPIO5, VSPICS0, HS1_DATA6, EMAC_RX_CLK
12810      IO10               I/O     | GPIO10, SD_DATA3, SPIWP, HS1_DATA3, U1TXD
12911      IO9                I/O     | GPIO9, SD_DATA2, SPIHD, HS1_DATA2, U1RXD
13012      RXD0               I/O     | GPIO3, U0RXD :ref:`(See 3) <get-started-pico-kit-v4-pin-notes>` , CLK_OUT2
13113      TXD0               I/O     | GPIO1, U0TXD :ref:`(See 3) <get-started-pico-kit-v4-pin-notes>` , CLK_OUT3, EMAC_RXD2
13214      IO35               I       | ADC1_CH7, RTC_GPIO5
13315      IO34               I       | ADC1_CH6, RTC_GPIO4
13416      IO38               I       | GPIO38, ADC1_CH2, RTC_GPIO2
13517      IO37               I       | GPIO37, ADC1_CH1, RTC_GPIO1
13618      EN                 I       | CHIP_PU
13719      GND                P       | Ground
13820      VDD33 (3V3)        P       | 3.3V power supply
139======  =================  ======  ======================================================
140
141
142Header J3
143"""""""""
144
145======  =================  ======  ======================================================
146No.     Name               Type    Function
147======  =================  ======  ======================================================
1481       FLASH_CS (FCS)     I/O     | GPIO16, HS1_DATA4 :ref:`(See 1) <get-started-pico-kit-v4-pin-notes>` , U2RXD, EMAC_CLK_OUT
1492       FLASH_SD0 (FSD0)   I/O     | GPIO17, HS1_DATA5 :ref:`(See 1) <get-started-pico-kit-v4-pin-notes>` , U2TXD, EMAC_CLK_OUT_180
1503       FLASH_SD2 (FSD2)   I/O     | GPIO11, SD_CMD, SPICS0, HS1_CMD :ref:`(See 1) <get-started-pico-kit-v4-pin-notes>` , U1RTS
1514       SENSOR_VP (FSVP)   I       | GPIO36, ADC1_CH0, RTC_GPIO0
1525       SENSOR_VN (FSVN)   I       | GPIO39, ADC1_CH3, RTC_GPIO3
1536       IO25               I/O     | GPIO25, DAC_1, ADC2_CH8, RTC_GPIO6, EMAC_RXD0
1547       IO26               I/O     | GPIO26, DAC_2, ADC2_CH9, RTC_GPIO7, EMAC_RXD1
1558       IO32               I/O     | 32K_XP :ref:`(See 2a) <get-started-pico-kit-v4-pin-notes>` , ADC1_CH4, TOUCH9, RTC_GPIO9
1569       IO33               I/O     | 32K_XN :ref:`(See 2b) <get-started-pico-kit-v4-pin-notes>` , ADC1_CH5, TOUCH8, RTC_GPIO8
15710      IO27               I/O     | GPIO27, ADC2_CH7, TOUCH7, RTC_GPIO17
158                                   | EMAC_RX_DV
15911      IO14               I/O     | ADC2_CH6, TOUCH6, RTC_GPIO16, MTMS, HSPICLK,
160                                   | HS2_CLK, SD_CLK, EMAC_TXD2
16112      IO12               I/O     | ADC2_CH5, TOUCH5, RTC_GPIO15, MTDI :ref:`(See 4) <get-started-pico-kit-v4-pin-notes>` , HSPIQ,
162                                   | HS2_DATA2, SD_DATA2, EMAC_TXD3
16313      IO13               I/O     | ADC2_CH4, TOUCH4, RTC_GPIO14, MTCK, HSPID,
164                                   | HS2_DATA3, SD_DATA3, EMAC_RX_ER
16514      IO15               I/O     | ADC2_CH3, TOUCH3, RTC_GPIO13, MTDO, HSPICS0
166                                   | HS2_CMD, SD_CMD, EMAC_RXD3
16715      IO2                I/O     | ADC2_CH2, TOUCH2, RTC_GPIO12, HSPIWP,
168                                   | HS2_DATA0, SD_DATA0
16916      IO4                I/O     | ADC2_CH0, TOUCH0, RTC_GPIO10, HSPIHD,
170                                   | HS2_DATA1, SD_DATA1, EMAC_TX_ER
17117      IO0                I/O     | ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1
172                                   | EMAC_TX_CLK
17318      VDD33 (3V3)        P       | 3.3V power supply
17419      GND                P       | Ground
17520      EXT_5V (5V)        P       | 5V power supply
176======  =================  ======  ======================================================
177
178
179.. _get-started-pico-kit-v4-pin-notes:
180
181The following notes give more information about the items in the tables above.
182
183    1. This pin is connected to the flash pin of ESP32-PICO-D4.
184    2. 32.768 kHz crystal oscillator:
185       a) input
186       b) output
187    3. This pin is connected to the pin of the USB bridge chip on the board.
188    4. The operating voltage of ESP32-PICO-KIT’s embedded SPI flash is 3.3V. Therefore, the strapping pin MTDI should hold bit zero during the module power-on reset. If connected, please make sure that this pin is not held up on reset.
189
190
191Start Application Development
192-----------------------------
193
194Before powering up your ESP32-PICO-KIT, please make sure that the board is in good condition with no obvious signs of damage.
195
196After 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.
197
198
199Board Dimensions
200----------------
201
202The dimensions are 52 x 20.3 x 10 mm (2.1" x 0.8" x 0.4").
203
204.. figure:: ../../../_static/esp32-pico-kit-v4.1-dimensions-back.jpg
205    :align: center
206    :alt: ESP32-PICO-KIT dimensions - back
207    :figclass: align-center
208
209    ESP32-PICO-KIT dimensions - back
210
211.. figure:: ../../../_static/esp32-pico-kit-v4-dimensions-side.jpg
212    :align: center
213    :alt: ESP32-PICO-KIT V4 dimensions - side
214    :figclass: align-center
215
216    ESP32-PICO-KIT dimensions - side
217
218For the board physical construction details, please refer to its Reference Design listed below.
219
220
221Related Documents
222-----------------
223
224* `ESP32-PICO-KIT V4 schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4_schematic.pdf>`_ (PDF)
225* `ESP32-PICO-KIT V4.1 schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4.1_schematic.pdf>`_ (PDF)
226* `ESP32-PICO-KIT Reference Design <https://www.espressif.com/en/support/download/documents?keys=ESP32-PICO-KIT+Reference+Design>`_ containing OrCAD schematic, PCB layout, gerbers and BOM
227* `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF)
228* :doc:`../../hw-reference/index`
229
230
231.. toctree::
232    :hidden:
233
234    get-started-pico-kit-v3
235