OVMS3-idf/docs/en/hw-reference/esp32/user-guide-devkits-r-v1.1.rst
Wang Ning b85358e593 Updated index
components/esp_wifi/lib_esp32/
2020-03-11 06:43:31 +08:00

267 lines
10 KiB
ReStructuredText

=================
ESP32-DevKitS(-R)
=================
:link_to_translation:`zh_CN:[中文]`
This user guide provides information on ESP32-DevKitS(-R), an ESP32-based flashing board produced by Espressif.
ESP32-DevKitS(-R) is a combination of two board names: ESP32-DevKitS and ESP32-DevKitS-R. S stands for springs, and R stands for WROVER.
+-----------------+-------------------+
| |ESP32-DevKitS| | |ESP32-DevKitS-R| |
+-----------------+-------------------+
| ESP32-DevKitS | ESP32-DevKitS-R |
+-----------------+-------------------+
.. |ESP32-DevKitS| image:: ../../../_static/esp32-devkits-v1.1-layout-isometric-raw.png
.. |ESP32-DevKitS-R| image:: ../../../_static/esp32-devkits-r-v1.1-layout-isometric-raw.png
The document consists of the following major sections:
- `Getting Started`_: Provides an overview of ESP32-DevKitS(-R) and hardware/software setup instructions to get started.
- `Hardware Reference`_: Provides more detailed information about ESP32-DevKitS(-R)'s hardware.
- `Related Documents`_: Gives links to related documentation.
Getting Started
===============
This section describes how to get started with ESP32-DevKitS(-R). It begins with a few introductory sections about ESP32-DevKitS(-R), then Section `How to Flash a Board`_ provides instructions on how to mount a module onto ESP32-DevKitS(-R), get it ready, and flash firmware onto it.
Overview
--------
ESP32-DevKitS(-R) is Espressif's flashing board designed specifically for ESP32. It can be used to flash an ESP32 module without soldering the module to the power supply and signal lines. With a module mounted, ESP32-DevKitS(-R) can also be used as a mini development board like ESP32-DevKitC.
ESP32-DevKitS and ESP32-DevKitS-R boards vary only in layout of spring pins to fit the following ESP32 modules.
- ESP32-DevKitS:
- :ref:`esp-modules-and-boards-esp32-wroom-32`
- :ref:`ESP32-WROOM-32D <esp-modules-and-boards-esp32-wroom-32d-and-u>`
- :ref:`ESP32-WROOM-32U <esp-modules-and-boards-esp32-wroom-32d-and-u>`
- :ref:`esp-modules-and-boards-esp32-solo-1`
- `ESP32-WROOM-32E <https://www.espressif.com/en/products/hardware/modules>`_
- `ESP32-WROOM-32UE <https://www.espressif.com/en/products/hardware/modules>`_
- ESP32-DevKitS-R:
- :ref:`ESP32-WROVER (PCB & IPEX) <esp-modules-and-boards-esp32-wrover>`
- :ref:`ESP32-WROVER-B (PCB & IPEX) <esp-modules-and-boards-esp32-wrover>`
- `ESP32-WROVER-E <https://www.espressif.com/en/products/hardware/modules>`_
- `ESP32-WROVER-IE <https://www.espressif.com/en/products/hardware/modules>`_
Description of Components
-------------------------
.. figure:: ../../../_static/esp32-devkits-v1.1-layout-front.png
:align: center
:alt: ESP32-DevKitS - front
:figclass: align-center
ESP32-DevKitS - front
.. figure:: ../../../_static/esp32-devkits-r-v1.1-layout-front.png
:align: center
:alt: ESP32-DevKitS-R - front
:figclass: align-center
ESP32-DevKitS-R - front
.. list-table::
:widths: 30 70
:header-rows: 1
* - Key Component
- Description
* - Spring Pins
- Click the module in. The pins will fit into the module's castellated holes.
* - 2.54 mm Female Headers
- These female headers are connected to pins of the module mounted on this board. For description of female headers, please refer to `Header Blocks`_.
* - USB-to-UART Bridge
- Single-chip USB to UART bridge provides transfer rates of up to 3 Mbps.
* - LDO
- 5V-to-3.3V low-dropout voltage regulator (LDO).
* - Micro-USB Connector/Micro USB Port
- USB interface. Power supply for the board as well as the communication interface between a computer and the board.
* - EN Button
- Reset button.
* - Boot Button
- Download button. Holding down **Boot** and then pressing **EN** initiates Firmware Download mode for downloading firmware through the serial port.
* - Power On LED
- Turns on when the USB or power supply is connected to the board.
How to Flash a Board
--------------------
Before powering up your ESP32-DevKitS(-R), please make sure that it is in good condition with no obvious signs of damage.
Required Hardware
^^^^^^^^^^^^^^^^^
- An ESP32 module of your choice
- USB 2.0 cable (Standard-A to Micro-B)
- Computer running Windows, Linux, or macOS
Hardware Setup
^^^^^^^^^^^^^^
Please mount a module of your choice onto your ESP32-DevKitS(-R) according to the following steps:
- Gently put your module on the ESP32-DevKitS(-R) board. Make sure that castellated holes on your module are aligned with spring pins on the board.
- Press your module down into the board until it clicks.
- Check whether all spring pins are inserted into castellated holes. If there are some misaligned spring pins, place them into castellated holes with tweezers.
Software Setup
^^^^^^^^^^^^^^
Preferred Method
++++++++++++++++
The ESP-IDF development framework provides a preferred way of flashing binaries onto ESP32-DevKitS(-R). Please 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 application example onto your ESP32-DevKitS(-R).
Alternative Method
++++++++++++++++++
As an alternative, Windows users can flash binaries using the `Flash Download Tool <https://www.espressif.com/en/support/download/other-tools?keys=flash+download+tools>`_. Just download it, unzip it, and follow the instructions inside the *doc* folder.
.. note::
1. To flash binary files, ESP32 should be set to Firmware Download mode. This can be done either by the flash tool automatically, or by holding down the Boot button and tapping the EN button.
2. After flashing binary files, the Flash Download Tool restarts your ESP32 module and boots the flashed application by default.
Board Dimensions
----------------
.. figure:: ../../../_static/esp32-devkits-v1.1-dimensions-back.png
:align: center
:alt: ESP32-DevKitS
:figclass: align-center
ESP32-DevKitS board dimensions - back
.. figure:: ../../../_static/esp32-devkits-r-v1.1-dimensions-back.png
:align: center
:alt: ESP32-DevKitS-R
:figclass: align-center
ESP32-DevKitS-R board dimensions - back
Contents and Packaging
----------------------
Retail orders
^^^^^^^^^^^^^
If you order a few samples, each ESP32-DevKitS(-R) comes in an individual package in either antistatic bag or any packaging depending on a retailer.
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
-------------
A block diagram below shows the components of ESP32-DevKitS(-R) and their interconnections.
.. figure:: ../../../_static/esp32-devkits-r-v1.1-block_diagram.png
:align: center
:scale: 70%
:alt: ESP32-DevKitS(-R) - block diagram (click to enlarge)
:figclass: align-center
ESP32-DevKitS(-R) (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 and GND header pins
- 3V3 and GND header pins
It is advised to use the first option: micro USB port.
Header Blocks
-------------
======= ================ ======================================
. Label Signal
======= ================ ======================================
L1 3V3 VDD 3V3
L2 EN CHIP_PU
L3 VP SENSOR_VP
L4 VN SENSOR_VN
L5 34 GPIO34
L6 35 GPIO35
L7 32 GPIO32
L8 33 GPIO33
L9 25 GPIO25
L10 26 GPIO26
L11 27 GPIO27
L12 14 GPIO14
L13 12 GPIO12
L14 GND GND
L15 13 GPIO13
L16 D2 SD_DATA2
L17 D3 SD_DATA3
L18 CMD SD_CMD
L19 5V External 5V
R1 GND GND
R2 23 GPIO23
R3 22 GPIO22
R4 TX U0TXD
R5 RX U0RXD
R6 21 GPIO21
R7 GND GND
R8 19 GPIO19
R9 18 GPIO18
R10 5 GPIO5
R11 17 GPIO17
R12 16 GPIO16
R13 4 GPIO4
R14 0 GPIO0
R15 2 GPIO2
R16 15 GPIO15
R17 D1 SD_DATA1
R18 D0 SD_DATA0
R19 CLK SD_CLK
======= ================ ======================================
For the image of header blocks, please refer to `Description of Components`_.
Related Documents
=================
- `ESP32-DevKitS(-R) Schematics <https://dl.espressif.com/dl/ESP32_DEVKITS_20190621.pdf>`_ (PDF)
- `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF)
- `ESP32-WROOM-32 Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_en.pdf>`_ (PDF)
- `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)
- `ESP32-SOLO-1 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-solo-1_datasheet_en.pdf>`_ (PDF)
- `ESP32-WROVER Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover_datasheet_en.pdf>`_ (PDF)
- `ESP32-WROVER-B Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-wrover-b_datasheet_en.pdf>`_ (PDF)
- `Espressif Product Ordering Information <https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_en.pdf>`_ (PDF)