OVMS3-idf/docs/en/hw-reference/modules-and-boards.rst

.. _esp-modules-and-boards:

************************************
{IDF_TARGET_NAME} Modules and Boards
************************************

:link_to_translation:`zh_CN:[中文]`

Espressif designs and manufactures different modules and development boards to help users evaluate the potential of the {IDF_TARGET_NAME} 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:

Modules
=======

This is a family of {IDF_TARGET_NAME}-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 {IDF_TARGET_NAME}'s functionality.

The key characteristics of these modules are summarized in the table below. Some additional details are covered in the following sections.

.. only:: esp32

    ===================  ============  ===========  =========  ====  ===============
    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 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, female 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
    - Female headers for a camera module
    - RGB LED 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