OVMS3-idf/docs/en/hw-reference/modules-and-boards.rst
Wang Fang b24341a664 Merge make-related documents:
1. Moved get-started files, 7 documents in total, from get-started-cmake folder to hw-reference folder;
2. Deleted get-started files, 7 documents in total, in get-started folder;
3. Updated links in get-started-cmake/index.rst and in get-started/index.rst;
4. Modified descriptions for build system in these files.
2019-07-04 13:16:18 +08:00

311 lines
13 KiB
ReStructuredText
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

.. _esp-modules-and-boards:
************************
ESP32 Modules and Boards
************************
Espressif designs and manufactures different modules and development boards to help users evaluate the potential of the ESP32 family of chips.
This document provides description of modules and development boards currently available from Espressif.
.. note::
For description of previous versions of modules and development boards as well as for description of discontinued ones, please go to Section :ref:`esp-modules-and-boards-previous`.
.. _esp-wroom-solo-wrover-modules:
WROOM, SOLO, WROVER, and PICO Modules
=====================================
This is a family of ESP32-based modules with some integrated key components, including a crystal oscillator and an antenna matching circuit. The modules constitute ready-made solutions for integration into final products. If combined with a few extra components, such as a programming interface, bootstrapping resistors, and pin headers, these modules can also be used for evaluation of ESP32's functionality.
The key characteristics of these modules are summarized in the table below. Some additional details are covered in the following sections.
=================== ============ =========== ========= ==== ===============
Key Components
------------------- ------------------------------------------ ---------------
Module Chip Flash, MB PSRAM, MB Ant. Dimensions, mm
=================== ============ =========== ========= ==== ===============
ESP32-WROOM-32 ESP32-D0WDQ6 4 -- MIFA 18 × 25.5 × 3.1
ESP32-WROOM-32D ESP32-D0WD 4, 8, or 16 -- MIFA 18 × 25.5 × 3.1
ESP32-WROOM-32U ESP32-D0WD 4, 8, or 16 -- U.FL 18 × 19.2 × 3.1
ESP32-SOLO-1 ESP32-S0WD 4 -- MIFA 18 × 25.5 × 3.1
ESP32-WROVER (PCB) ESP32-D0WDQ6 4 8 MIFA 18 × 31.4 × 3.3
ESP32-WROVER (IPEX) ESP32-D0WDQ6 4 8 U.FL 18 × 31.4 × 3.3
ESP32-WROVER-B ESP32-D0WD 4, 8, or 16 8 MIFA 18 × 31.4 × 3.3
ESP32-WROVER-IB ESP32-D0WD 4, 8, or 16 8 U.FL 18 × 31.4 × 3.3
=================== ============ =========== ========= ==== ===============
* ESP32-**D**.. identifies a dual-core chip, ESP32-**S**.. identifies a single-core chip
* MIFA - Meandered Inverted-F Antenna
* U.FL - U.FL / IPEX antenna connector
* ESP32-WROOM-32x, ESP32-WROVER-B and ESP32-WROVER-IB modules come with 4 MB flash by default but also available with custom flash sizes of 8 MB and 16 MB, see `Espressif Products Ordering Information`_ (PDF)
* `ESP32 Chip Datasheet <https://espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`__ (PDF)
* Initial release of the ESP32-WROVER module had 4 MB of PSRAM
* *ESP32-WROOM-32* was previously called *ESP-WROOM-32*
.. _esp-modules-and-boards-esp32-wroom-32:
ESP32-WROOM-32
--------------
This is a basic and commonly adopted ESP32 module with the ESP32-D0WDQ6 chip on board. It was the first module of the WROOM / WROVER family released to the market.
For key characteristics, see the table in Section :ref:`esp-wroom-solo-wrover-modules`, `Espressif Products Ordering Information`_.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32-front-back.jpg
:align: center
:alt: ESP32-WROOM-32 module (front and back)
:width: 45%
ESP32-WROOM-32 module (front and back)
Documentation
^^^^^^^^^^^^^
* `ESP32-WROOM-32 Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wroom-32_datasheet_en.pdf>`__ (PDF)
* `ESP32-WROOM-32 Reference Design <https://www.espressif.com/en/support/download/documents?keys=+ESP32-WROOM-32+Reference>`_ containing OrCAD schematic, PCB layout, gerber and BOM files
.. _esp-modules-and-boards-esp32-wroom-32d-and-u:
ESP32-WROOM-32D / ESP32-WROOM-32U
---------------------------------
Both modules integrate the ESP32-D0WD chip which has a smaller footprint than the chip ESP32-D0WDQ6 installed in :ref:`esp-modules-and-boards-esp32-wroom-32`.
For key characteristics, see the table in Section :ref:`esp-wroom-solo-wrover-modules` and `Espressif Products Ordering Information`_.
ESP32-WROOM-32U is the smallest representative of the whole WROOM / WROVER family of modules.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32d-front-back.jpg
:align: center
:alt: ESP32-WROOM-32D module (front and back)
:width: 45%
ESP32-WROOM-32D module (front and back)
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wroom-32u-front-back.jpg
:align: center
:alt: ESP32-WROOM-32U module (front and back)
:width: 45%
ESP32-WROOM-32U module (front and back)
Documentation
^^^^^^^^^^^^^
* `ESP32-WROOM-32D / ESP32-WROOM-32U Datasheet <http://espressif.com/sites/default/files/documentation/esp32-wroom-32d_esp32-wroom-32u_datasheet_en.pdf>`__ (PDF)
.. _esp-modules-and-boards-esp32-solo-1:
ESP32-SOLO-1
------------
This is a simplified version of the ESP32-WROOM-32D module. It contains a single-core ESP32 chip that supports a clock frequency of up to 160 MHz.
For key characteristics, see the table in Section :ref:`esp-wroom-solo-wrover-modules` and `Espressif Products Ordering Information`_.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-solo-1-front-back.jpg
:align: center
:alt: ESP32-SOLO-1 module (front and back)
:width: 45%
ESP32-SOLO-1 module (front and back)
Documentation
^^^^^^^^^^^^^
* `ESP32-SOLO-1 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-solo-1_datasheet_en.pdf>`__ (PDF)
.. _esp-modules-and-boards-esp32-wrover:
ESP32-WROVER series
-------------------
This series consists of a few modifications of ESP32-WROOM-32x modules, which among other upgrades include additional 8 MB SPI PSRAM (pseudo static RAM).
For details, see the table in Section :ref:`esp-wroom-solo-wrover-modules` and `Espressif Products Ordering Information`_.
* **ESP32-WROVER (PCB)** and **ESP32-WROVER (IPEX)** have PSRAM that operates at 1.8 V and supports up to 144 MHz clock rate.
* **ESP32-WROVER-B** and **ESP32-WROVER-IB** have PSRAM that operates at 3.3 V and can supports up to 133 MHz clock rate.
The picture below shows an ESP32-WROVER module with a PCB antenna.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-wrover.jpg
:align: center
:alt: ESP32-WROVER module (front and back)
:width: 40%
ESP32-WROVER module (front and back)
Documentation
^^^^^^^^^^^^^
* `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)
* `ESP-PSRAM64 & ESP-PSRAM64H Datasheet <https://www.espressif.com/sites/default/files/documentation/esp-psram64_esp-psram64h_datasheet_en.pdf>`__ (PDF)
* `ESP32-WROVER Reference Design <https://www.espressif.com/en/support/download/documents?keys=ESP32-WROVER+Reference+Design>`_ containing OrCAD schematic, PCB layout, gerber and BOM files
ESP32-PICO-D4
-------------
ESP32-PICO-D4 is a System-in-Package (SiP) module, integrating all peripheral components seamlessly, including the following:
- 4 MB flash memory
- crystal oscillator
- filter capacitors
- RF matching circuit
For key characteristics, see `Espressif Products Ordering Information`_.
Documentation
^^^^^^^^^^^^^
* `ESP32-PICO-D4 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`__ (PDF)
Development Boards
==================
Depending on the intended functionality, different development boards feature:
- Access to different ESP32 GPIO pins.
- Different interfaces: USB, JTAG.
- Different peripherals: touchpads, LCD screens, SD card slots, headers for camera modules, etc.
.. _esp-modules-and-boards-esp32-pico-kit:
ESP32-PICO-KIT V4.1
-------------------
This is the smallest available ESP32-based development board. It features all the components for direct connection to a computer's USB port as well as pin headers for plugging into a mini breadboard.
The board is equipped with the `ESP32-PICO-D4`_ module. With such a module, the creation of a fully functional development board required only a few external components that fit on a PCB as small as 20 x 52 mm. The external components include antenna, LDO, USB-UART bridge, and two buttons for reset and activation of Firmware Download mode.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-pico-kit-v4.1.jpg
:align: center
:alt: ESP32-PICO-KIT V4.1 board
:width: 50%
ESP32-PICO-KIT V4.1 board
Comparing to ESP32-PICO-KIT V4, this version features the CP2102N USB-UART bridge that provides faster transfer rates of up to 3 Mbps.
Documentation
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-pico-kit`
* `ESP32-PICO-KIT V4.1 Schematic <https://dl.espressif.com/dl/schematics/esp32-pico-kit-v4.1_schematic.pdf>`_ (PDF)
* `ESP32-PICO-KIT Reference Design <https://www.espressif.com/en/support/download/documents?keys=ESP32-PICO-KIT+Reference+Design>`_ containing OrCAD schematic, PCB layout, gerber and BOM files
* `ESP32-PICO-D4 Datasheet <http://espressif.com/sites/default/files/documentation/esp32-pico-d4_datasheet_en.pdf>`_ (PDF)
Previous Versions
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp32-pico-kit-v4`
* :ref:`esp-modules-and-boards-esp32-pico-kit-v3`
.. _esp-modules-and-boards-esp32-devkitc:
ESP32 DevKitC V4
----------------
This is a small and convenient development board that features:
- :ref:`esp-modules-and-boards-esp32-wroom-32` module
- USB-to-serial programming interface that also provides power supply for the board
- pin headers
- pushbuttons for reset and activation of Firmware Download mode
- a few other components
Comparing to the previous :ref:`esp-modules-and-boards-esp32-devkitc-v2`, this version can integrate :ref:`esp-modules-and-boards-esp32-wrover` module instead of ESP32-WROOM-32 and has the CP2102N chip that supports faster baud rates.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-devkitc-v4-front.jpg
:align: center
:alt: ESP32 DevKitC V4 board
:width: 50%
ESP32 DevKitC V4 board
Documentation
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-devkitc`
* `ESP32-DevKitC schematic <https://dl.espressif.com/dl/schematics/esp32_devkitc_v4-sch-20180607a.pdf>`_ (PDF)
* `ESP32-DevKitC Reference Design <https://www.espressif.com/en/support/download/documents?keys=ESP32-DevKitC-V4+Reference+Design>`_ containing OrCAD schematic, PCB layout, gerber and BOM files
* `CP210x USB to UART Bridge VCP Drivers <https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers>`_
Previous Versions
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp32-devkitc-v2`
.. _esp-modules-and-boards-esp-wrover-kit:
ESP-WROVER-KIT V4.1
-------------------
This board features:
- dual port USB-to-serial converter for programming
- JTAG interface for debugging
- MicroSD card slot
- 3.2” SPI LCD screen
- header for a camera module
- RGB diode for diagnostics
- 32.768 kHz XTAL for internal RTC to operate it in low power modes
Power can be supplied either via USB or via a standard 5 mm power supply jack. A power source can be selected with a jumper and can be turned on/off with a separate switch.
This version of the ESP-WROVER-KIT board integrates the ESP-WROVER-B module that has 8 MB PSRAM for flexible extended storage and data processing capabilities. The board can accommodate other versions of ESP modules described in :ref:`esp-wroom-solo-wrover-modules`.
Comparing to :ref:`esp-modules-and-boards-esp-wrover-kit-v3`, this board has the following design changes:
- JP8, JP11, and JP13 have been combined into a single JP2.
- USB connector has been changed to DIP type and moved to the lower right corner of the board.
- R61 has been changed to a Zero-ohm resistor.
- Some components have been replaced with functional equivalents based on test results and sourcing options, e.g., the EN and Boot buttons.
.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-wrover-kit-v4.1-front.jpg
:align: center
:alt: ESP-WROVER-KIT V4.1 board
:width: 90%
ESP-WROVER-KIT V4.1 board
The board in the picture above integrates the ESP32-WROVER-B module.
Documentation
^^^^^^^^^^^^^
* :doc:`../hw-reference/get-started-wrover-kit`
* `ESP-WROVER-KIT V4.1 Schematic <https://dl.espressif.com/dl/schematics/ESP-WROVER-KIT_V4_1.pdf>`__ (PDF)
* :doc:`../api-guides/jtag-debugging/index`
* `FTDI Virtual COM Port Drivers`_
Previous Versions
^^^^^^^^^^^^^^^^^
* :ref:`esp-modules-and-boards-esp-wrover-kit-v3`
* :ref:`esp-modules-and-boards-esp-wrover-kit-v2`
* :ref:`esp-modules-and-boards-esp-wrover-kit-v1`
Related Documents
=================
* :doc:`modules-and-boards-previous`
.. _FTDI Virtual COM Port Drivers: http://www.ftdichip.com/Drivers/VCP.htm
.. _Espressif Products Ordering Information: https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_en.pdf