upload user guide for development board: ESP32-PICO-KIT-1

Author: skywxFang

docs/_static/esp32-pico-kit-1-block.png

@@ -91,6 +91,7 @@ If you have one of {IDF_TARGET_NAME} development boards listed below, you can cl
         ESP32-PICO-KIT <../hw-reference/esp32/get-started-pico-kit>
         ESP32-Ethernet-Kit <../hw-reference/esp32/get-started-ethernet-kit>
         ESP32-DevKit-S(-R) <../hw-reference/esp32/user-guide-devkits-r-v1.1>
+        ESP32-PICO-KIT-1 <../hw-reference/esp32/get-started-pico-kit-1>
 
 .. only:: esp32s2
 

docs/_static/esp32-pico-kit-1-layout-front.png

@@ -0,0 +1,365 @@
+ESP32-PICO-KIT-1 
+*****************
+
+:link_to_translation:`zh_CN:[中文]`
+
+Overview
+===========
+
+ESP32-PICO-KIT-1 is an ESP32-based development board produced by `Espressif <https://espressif.com>`_.
+
+The core of this board is `ESP32-PICO-V3 <https://www.espressif.com/en/products/socs>`_ - a System-in-Package (SiP) module with complete Wi-Fi and Bluetooth functionalities. Compared to other ESP32 modules, ESP32-PICO-V3 integrates the following peripheral components in one single package, which otherwise would need to be installed separately:
+
+- 40 MHz crystal oscillator
+- 4 MB flash
+- Filter capacitors
+- RF matching network
+
+This 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.
+
+The development board features a USB-to-UART Bridge circuit which allows developers to connect the board to a computer's USB port for flashing and debugging.
+
+All the IO signals and system power on ESP32-PICO-V3 are led out to two rows of 18 x 0.1" header pads on both sides of the development board for easy access. For compatibility with Dupont wires, all header pads are populated with two rows of male pin headers. 
+
+.. note::
+
+    ESP32-PICO-KIT-1 comes with male headers by default.
+
+ESP32-PICO-KIT-1 provides the users with hardware for development of applications based on the ESP32, making it easier for users to explore ESP32 functionalities.
+
+.. figure:: ../../../_static/esp32-pico-kit-1-overview.png
+    :align: center
+    :scale: 70%
+    :alt: ESP32-PICO-KIT-1 (click to enlarge)
+    :figclass: align-center
+
+    ESP32-PICO-KIT-1 Overview (click to enlarge) 
+
+This guide covers:
+
+- `Getting Started`_: Provides an overview of the ESP32-PICO-KIT-1 and software setup instructions to get started.
+- `Contents and Packaging`_: Provides information about packaging and contents for retail and wholesale orders.
+- `Hardware Reference`_: Provides more detailed information about the ESP32-PICO-KIT-1’s hardware.
+- `Hardware Revision Details`_: Covers revision history, known issues, and links to user guides for previous versions of the ESP32-PICO-KIT-1.
+- `Related Documents`_: Gives links to related documentation.
+
+Getting Started
+================
+
+This section describes how to get started with the ESP32-PICO-KIT-1. It begins with a few introductory sections about the ESP32-PICO-KIT-1, then Section `Start Application Development`_ provides instructions on how to flash firmware onto the ESP32-PICO-KIT-1.
+
+.. _get-started-pico-kit-1-board-front:
+
+Description of Components
+--------------------------
+
+The following figure and the table below describe the key components, interfaces, and controls of the ESP32-PICO-KIT-1 board.
+
+.. figure:: ../../../_static/esp32-pico-kit-1-layout-front.png
+    :align: center
+    :scale: 90%
+    :alt: ESP32-PICO-KIT-1 (click to enlarge)
+    :figclass: align-center
+
+    ESP32-PICO-KIT-1 board layout - front (click to enlarge) 
+
+Below is the description of the items identified in the figure starting from the top left corner and going clockwise.
+
+==================  =================================================================================================================================
+Key Component       Description
+==================  =================================================================================================================================
+ESP32-PICO-V3       Standard ESP32-PICO-V3 module soldered to the ESP32-PICO-KIT-1 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.
+
+LDO                 5V-to-3.3V Low dropout voltage regulator (LDO).
+
+USB-to-UART bridge     CP2102N, single-chip USB-to-UART bridge that offers up to 3 Mbps transfers rates.
+
+Micro USB Port      USB interface. Power supply for the board as well as the communication interface between a computer and the board.
+
+5V Power On LED     This red LED turns on when power is supplied to the board. For details, see the schematic in `Related Documents`_.
+
+I/O Connector       All the pins on ESP32-PICO-V3 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`_.
+
+BOOT Button         Download button. Holding down **Boot** and then pressing **EN** initiates Firmware Download mode for downloading firmware through the serial port.
+
+EN Button           Reset button.
+==================  =================================================================================================================================
+
+Start Application Development
+-----------------------------
+
+Before powering up your ESP32-PICO-KIT-1, please make sure that the board is in good condition with no obvious signs of damage.
+
+Required Hardware
+"""""""""""""""""""
+
+- 1 x ESP32-PICO-KIT-1
+- 1 x USB 2.0 A to Micro B cable
+- 1 x Computer running Windows, Linux, or macOS
+
+.. _user-guide-pico-kit-1-software-setup:
+
+Software Setup
+""""""""""""""""
+
+Please proceed to :doc:`../../get-started/index`, where Section :ref:`get-started-step-by-step` will quickly help you set up the development environment.
+
+Contents and Packaging
+=======================
+
+Retail Orders
+---------------
+
+If you order one or several samples of the board, each ESP32-PICO-KIT-1 development board comes in an individual package.
+
+For retail orders, please go to https://www.espressif.com/en/company/contact/buy-a-sample.
+
+
+Wholesale Orders
+------------------
+
+If you order in bulk, the boards come in large cardboard boxes.
+
+For wholesale orders, please check `Espressif Product Ordering Information <https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_en.pdf>`_ (PDF)
+
+Hardware Reference
+===================
+
+Block Diagram
+--------------
+
+The block diagram below shows the main components of ESP32-PICO-KIT-1 and their interconnections.
+
+.. figure:: ../../../_static/esp32-pico-kit-1-block.png
+    :align: center
+    :scale: 70%
+    :alt: ESP32-PICO-KIT-1 (click to enlarge)
+    :figclass: align-center
+
+    ESP32-PICO-KIT-1 Block Diagram (click to enlarge) 
+
+Power Supply Options
+--------------------
+
+There are three mutually exclusive ways to provide power to the board:
+
+* Micro USB port, default power supply
+* 5V/GND header pins
+* 3V3/GND header pins
+
+.. warning::
+
+    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.
+
+
+Pin Descriptions
+----------------
+
+The 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-1-board-front`. The pin numbering and header names are the same as in the schematic given in `Related Documents`_.
+
+Header J2
+""""""""""""
+
+.. list-table:: 
+   :widths: 5 5 5 35
+   :header-rows: 1
+
+   * - No.
+     - Name
+     - Type
+     - Function
+   * - 1
+     - IO20
+     - I/O
+     - GPIO20
+   * - 2
+     - IO21
+     - I/O
+     - GPIO21, VSPIHD, EMAC_TX_EN
+   * - 3
+     - IO22
+     - I/O
+     - GPIO22, VSPIWP, U0RTS, EMAC_TXD1
+   * - 4
+     - IO19
+     - I/O
+     - GPIO19, VSPIQ, U0CTS, EMAC_TXD0
+   * - 5
+     - IO8
+     - I/O
+     - GPIO8, SD_DATA1, HS1_DATA1, U2CTS
+   * - 6
+     - IO7
+     - I/O
+     - GPIO7, SD_DATA0, HS1_DATA0, U2RTS
+   * - 7
+     - IO5
+     - I/O
+     - GPIO5, VSPICS0, HS1_DATA6, EMAC_RX_CLK
+   * - 8
+     - IO10
+     - I/O
+     - GPIO10, SD_DATA3, SPIWP, HS1_DATA3, U1TXD
+   * - 9
+     - IO9
+     - I/O
+     - GPIO9, SD_DATA2, SPIHD, HS1_DATA2, U1RXD
+   * - 10
+     - RXD0
+     - I/O
+     - GPIO3, U0RXD :ref:`(See 1) <get-started-pico-kit-1-pin-notes>`, CLK_OUT2
+   * - 11
+     - TXD0
+     - I/O
+     - GPIO1, U0TXD :ref:`(See 1) <get-started-pico-kit-1-pin-notes>`, CLK_OUT3, EMAC_RXD2
+   * - 12
+     - IO35
+     - I
+     - ADC1_CH7, RTC_GPIO5
+   * - 13
+     - IO34
+     - I
+     - ADC1_CH6, RTC_GPIO4
+   * - 14
+     - IO38
+     - I
+     - GPIO38, ADC1_CH2, RTC_GPIO2
+   * - 15
+     - IO37
+     - I
+     - GPIO37, ADC1_CH1, RTC_GPIO1
+   * - 16
+     - EN
+     - I
+     - CHIP_PU
+   * - 17
+     - GND
+     - P
+     - Ground
+   * - 18
+     - VDD33 (3V3)
+     - P
+     - 3.3 V power supply
+       
+
+Header J3
+"""""""""
+
+.. list-table:: 
+   :widths: 5 5 5 35
+   :header-rows: 1
+
+   * - No.
+     - Name
+     - Type
+     - Function
+   * - 1
+     - GND
+     - P
+     - Ground
+   * - 2
+     - SENSOR_VP (FSVP)
+     - I
+     - GPIO36, ADC1_CH0, RTC_GPIO0
+   * - 3
+     - SENSOR_VN (FSVN)
+     - I
+     - GPIO39, ADC1_CH3, RTC_GPIO3
+   * - 4
+     - IO25
+     - I/O
+     - GPIO25, DAC_1, ADC2_CH8, RTC_GPIO6, EMAC_RXD0
+   * - 5
+     - IO26
+     - I/O
+     - GPIO26, DAC_2, ADC2_CH9, RTC_GPIO7, EMAC_RXD1
+   * - 6
+     - IO32
+     - I/O
+     - 32K_XP :ref:`(See 2a) <get-started-pico-kit-1-pin-notes>`, ADC1_CH4, TOUCH9, RTC_GPIO9
+   * - 7
+     - IO33
+     - I/O
+     - 32K_XN :ref:`(See 2b) <get-started-pico-kit-1-pin-notes>`, ADC1_CH5, TOUCH8, RTC_GPIO8
+   * - 8
+     - IO27
+     - I/O
+     - GPIO27, ADC2_CH7, TOUCH7, RTC_GPIO17, EMAC_RX_DV
+   * - 9
+     - IO14
+     - I/O
+     - ADC2_CH6, TOUCH6, RTC_GPIO16, MTMS, HSPICLK, HS2_CLK, SD_CLK, EMAC_TXD2
+   * - 10
+     - IO12
+     - I/O
+     - ADC2_CH5, TOUCH5, RTC_GPIO15, MTDI :ref:`(See 3) <get-started-pico-kit-1-pin-notes>`, HSPIQ, HS2_DATA2, SD_DATA2, EMAC_TXD3
+   * - 11
+     - IO13
+     - I/O
+     - ADC2_CH4, TOUCH4, RTC_GPIO14, MTCK, HSPID, HS2_DATA3, SD_DATA3, EMAC_RX_ER
+   * - 12
+     - IO15
+     - I/O
+     - ADC2_CH3, TOUCH3, RTC_GPIO13, MTDO, HSPICS0, HS2_CMD, SD_CMD, EMAC_RXD3
+   * - 13
+     - IO2
+     - I/O
+     - ADC2_CH2, TOUCH2, RTC_GPIO12, HSPIWP, HS2_DATA0, SD_DATA0
+   * - 14
+     - IO4
+     - I/O
+     - ADC2_CH0, TOUCH0, RTC_GPIO10, HSPIHD, HS2_DATA1, SD_DATA1, EMAC_TX_ER
+   * - 15
+     - IO0
+     - I/O
+     - ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1, EMAC_TX_CLK
+   * - 16
+     - VDD33 (3V3)
+     - P
+     - 3.3V power supply
+   * - 17
+     - GND
+     - P
+     - Ground
+   * - 18
+     - EXT_5V (5V)
+     - P
+     - 5V power supply
+                          
+
+.. _get-started-pico-kit-1-pin-notes:
+
+The following notes give more information about the items in the tables above.
+
+    1. This pin is connected to the pin of the USB bridge chip on the board.
+    2. 32.768 kHz crystal oscillator:
+       a) input
+       b) output
+    3. The operating voltage of ESP32-PICO-KIT-1’s embedded SPI flash is 3.3 V. Therefore, the strapping pin MTDI should be pulled down during the module power-on reset. If connected, please make sure that this pin is not held up on reset.
+
+
+Pin Layout
+""""""""""""
+.. figure:: ../../../_static/esp32-pico-kit-1-pinout.png
+    :align: center
+    :scale: 50%
+    :alt: ESP32-PICO-KIT-1 (click to enlarge)
+    :figclass: align-center
+
+    ESP32-PICO-KIT-1 Pin Layout(click to enlarge)
+
+Hardware Revision Details
+=========================
+
+No previous versions available.
+
+Related Documents
+===================
+
+* `ESP32-PICO-V3 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-v3_datasheet_en.pdf>`_ (PDF)
+* `Espressif Product Ordering Information <https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_en.pdf>`_ (PDF) 
+* `ESP32-PICO-KIT-1 Schematic <https://dl.espressif.com/dl/schematics/SCH_ESP32-PICO-KIT-1_V1_0_20200811A.pdf>`_ (PDF)
+* `ESP32-PICO-KIT-1 PCB Layout <https://dl.espressif.com/dl/schematics/PCB_ESP32-PICO-KIT-1_V1.0_20200811.pdf>`_ (PDF)
+
+For other design documentation for the board, please contact us at [email protected].
+

docs/_static/esp32-pico-kit-1-overview.png

@@ -87,13 +87,14 @@
         ESP32-PICO-KIT <../hw-reference/esp32/get-started-pico-kit>
         ESP32-Ethernet-Kit <../hw-reference/esp32/get-started-ethernet-kit>
         ESP32-DevKit-S(-R) <../hw-reference/esp32/user-guide-devkits-r-v1.1>
+        ESP32-PICO-KIT-1 <../hw-reference/esp32/get-started-pico-kit-1>
 
 
 .. only:: esp32s2
 
     .. toctree::
         :maxdepth: 1
-        
+
         ESP32-S2-Saola-1 <../hw-reference/esp32s2/user-guide-saola-1-v1.2>
         ESP32-S2-DevKitM-1(U) <../hw-reference/esp32s2/user-guide-devkitm-1-v1>
         ESP32-S2-Kaluga-Kit <../hw-reference/esp32s2/user-guide-esp32-s2-kaluga-1-kit>