From: krzychb <krzychb@gazeta.pl>
Date: Mon, 2 Oct 2017 05:03:24 +0000 (+0200)
Subject: ESP32-PICO-KIT Getting Started Guide
X-Git-Tag: v3.1-dev~197^2
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=f7daaa9ebeed902da8711e8eb1a2631d9c41513b;p=esp-idf

ESP32-PICO-KIT Getting Started Guide
---

diff --git a/docs/_static/esp32-pico-kit-layout.jpg b/docs/_static/esp32-pico-kit-layout.jpg
new file mode 100644
index 0000000000..f912a8995a
Binary files /dev/null and b/docs/_static/esp32-pico-kit-layout.jpg differ
diff --git a/docs/get-started/establish-serial-connection.rst b/docs/get-started/establish-serial-connection.rst
index 47f736565a..f3e15250f1 100644
--- a/docs/get-started/establish-serial-connection.rst
+++ b/docs/get-started/establish-serial-connection.rst
@@ -9,13 +9,14 @@ Connect ESP32 to PC
 
 Connect the ESP32 board to the PC using the USB cable. If device driver does not install automatically, identify USB to serial converter chip on your ESP32 board (or external converter dongle), search for drivers in internet and install them.
 
-Below are the links to Windows and MacOS drivers for ESP32 boards produced by Espressif:
+Below are the links to drivers for ESP32 boards produced by Espressif:
 
-* ESP32 Core Board - `CP210x USB to UART Bridge VCP Drivers <https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers>`_
+* ESP32-PICO-KIT and ESP32-DevKitC - `CP210x USB to UART Bridge VCP Drivers <https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers>`_
 
-* ESP32 WROVER KIT and ESP32 Demo Board - `FTDI Virtual COM Port Drivers <http://www.ftdichip.com/Drivers/D2XX.htm>`_
+* ESP32-WROVER-KIT and ESP32 Demo Board - `FTDI Virtual COM Port Drivers <http://www.ftdichip.com/Drivers/D2XX.htm>`_
+
+Above drivers are primarily for reference. They should already be bundled with the operating system and installed automatically once one of listed boards is connected to the PC.
 
-For Linux, suitable drivers should already be bundled with the operating system.
 
 Check port on Windows
 ---------------------
diff --git a/docs/get-started/get-started-pico-kit.rst b/docs/get-started/get-started-pico-kit.rst
new file mode 100644
index 0000000000..236d7a1916
--- /dev/null
+++ b/docs/get-started/get-started-pico-kit.rst
@@ -0,0 +1,66 @@
+ESP32-PICO-KIT Getting Started Guide
+====================================
+
+This user guide shows how to get started with the ESP32-PICO-KIT mini development board.
+
+
+What You Need
+-------------
+
+* 1 × ESP32-PICO-KIT mini development board
+* 1 × USB A / Micro USB B cable
+* 1 × PC loaded with Windows, Linux or Mac OS
+
+
+Overview
+--------
+
+ESP32-PICO-KIT is a mini development board based on the ESP32-PICO-D4 SIP module produced by `Espressif <https://espressif.com>`_. All the IO signals and system power on ESP32-PICO-D4 are led out through two standard 20 pin x 0.1" pitch headers on both sides for easy interfacing. The development board integrates a USB-UART Bridge circuit, allowing the developers to connect the development board to a PC's USB port for downloads and debugging.
+
+
+Functional Description
+----------------------
+
+The following list and figure below describe key components, interfaces and controls of ESP32-PICO-KIT board.
+
+ESP32-PICO-D4
+    Standard ESP32-PICO-D4 module soldered to the ESP32-PICO-KIT board. The complete system of the ESP32 chip has been integrated into the SIP module, requiring only external antenna with LC matching network, decoupling capacitors and pull-up resistors for EN signals to function properly.
+USB-UART Bridge
+    A single chip USB-UART bridge provides up to 1 Mbps transfers rates.
+I/O
+    All the pins on ESP32-PICO-D4 are broken out to the pin headers on the board. Users can program ESP32 to enable multiple functions such as PWM, ADC, DAC, I2C, I2S, SPI, etc.
+Micro USB Port
+    USB interface. It functions as the power supply for the board and the communication interface between PC and ESP32-PICO-KIT.
+EN Button
+    Reset button; pressing this button resets the system.
+BOOT Button
+    Holding down the Boot button and pressing the EN button initiates the firmware download mode. Then user can download firmware through the serial port.
+
+.. figure:: ../_static/esp32-pico-kit-layout.jpg
+    :align: center
+    :alt: ESP32-PICO-KIT board layout
+    :figclass: align-center
+
+    ESP32-PICO-KIT board layout
+
+
+Start Application Development
+------------------------------
+
+Before powering up the ESP32-PICO-KIT, please make sure that the board has been received in good condition with no obvious signs of damage.
+
+To start development of applications, proceed to section :doc:`index`, that will walk you through the following steps:
+
+* :ref:`get-started-setup-toolchain` in your PC to develop applications for ESP32 in C language
+* :ref:`get-started-connect` the module to the PC and verify if it is accessible
+* :ref:`get-started-build-flash` an example application to the ESP32
+* :ref:`get-started-build-monitor` instantly what the application is doing
+
+
+Related Documents
+-----------------
+
+* `ESP32-PICO-KIT schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit_schematic.pdf>`_ (PDF)
+* `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF)
+
+.. * `ESP32-PICO-KIT Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-kit_datasheet_en.pdf>`_ (PDF)
diff --git a/docs/get-started/index.rst b/docs/get-started/index.rst
index a19b805e3d..de1caa84c2 100644
--- a/docs/get-started/index.rst
+++ b/docs/get-started/index.rst
@@ -59,6 +59,7 @@ If you have one of ESP32 development boards listed below, click on provided link
 
     ESP32 DevKitC <get-started-devkitc>
     ESP-WROVER-KIT <get-started-wrover-kit>
+    ESP32-PICO-KIT <get-started-pico-kit>
 
 If you have different board, move to sections below.