From 4d882c1fb771fe56a2ba4b4c06c4f626619f8ad4 Mon Sep 17 00:00:00 2001 From: krzychb Date: Tue, 17 Oct 2017 21:42:36 +0300 Subject: [PATCH] ESP32-PICO-KIT V4 Getting Started Guide --- ...ayout.jpg => esp32-pico-kit-v3-layout.jpg} | Bin docs/_static/esp32-pico-kit-v4-layout.jpg | Bin 0 -> 78738 bytes docs/get-started/get-started-pico-kit-v3.rst | 66 ++++++++ docs/get-started/get-started-pico-kit.rst | 38 +++-- .../get-started/get-started-wrover-kit-v2.rst | 5 +- docs/get-started/get-started-wrover-kit.rst | 4 +- docs/hw-reference/index.rst | 2 + .../modules-and-boards-previous.rst | 115 ++++++++++++++ docs/hw-reference/modules-and-boards.rst | 149 ++++++++---------- 9 files changed, 280 insertions(+), 99 deletions(-) rename docs/_static/{esp32-pico-kit-layout.jpg => esp32-pico-kit-v3-layout.jpg} (100%) create mode 100644 docs/_static/esp32-pico-kit-v4-layout.jpg create mode 100644 docs/get-started/get-started-pico-kit-v3.rst create mode 100644 docs/hw-reference/modules-and-boards-previous.rst diff --git a/docs/_static/esp32-pico-kit-layout.jpg b/docs/_static/esp32-pico-kit-v3-layout.jpg similarity index 100% rename from docs/_static/esp32-pico-kit-layout.jpg rename to docs/_static/esp32-pico-kit-v3-layout.jpg diff --git a/docs/_static/esp32-pico-kit-v4-layout.jpg b/docs/_static/esp32-pico-kit-v4-layout.jpg new file mode 100644 index 0000000000000000000000000000000000000000..25dca043785bf1db5a78dcb8c7456eed45d831b3 GIT binary patch literal 78738 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. 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 V3 board. + +ESP32-PICO-D4 + Standard ESP32-PICO-D4 module soldered to the ESP32-PICO-KIT V3 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 V3. +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-v3-layout.jpg + :align: center + :alt: ESP32-PICO-KIT V3 board layout + :figclass: align-center + + ESP32-PICO-KIT V3 board layout + + +Start Application Development +------------------------------ + +Before powering up the ESP32-PICO-KIT V3, 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 V3 schematic `_ (PDF) +* `ESP32-PICO-D4 Datasheet `_ (PDF) +* :doc:`../hw-reference/index` + diff --git a/docs/get-started/get-started-pico-kit.rst b/docs/get-started/get-started-pico-kit.rst index 236d7a191..1ae2bd2fb 100644 --- a/docs/get-started/get-started-pico-kit.rst +++ b/docs/get-started/get-started-pico-kit.rst @@ -1,13 +1,13 @@ -ESP32-PICO-KIT Getting Started Guide -==================================== +ESP32-PICO-KIT V4 Getting Started Guide +======================================= -This user guide shows how to get started with the ESP32-PICO-KIT mini development board. +This user guide shows how to get started with the ESP32-PICO-KIT V4 mini development board. For description of other versions of the ESP32-PICO-KIT check :doc:`../hw-reference/index`. What You Need ------------- -* 1 × ESP32-PICO-KIT mini development board +* 1 × ESP32-PICO-KIT V4 mini development board * 1 × USB A / Micro USB B cable * 1 × PC loaded with Windows, Linux or Mac OS @@ -15,39 +15,43 @@ What You Need Overview -------- -ESP32-PICO-KIT is a mini development board based on the ESP32-PICO-D4 SIP module produced by `Espressif `_. 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. +ESP32-PICO-KIT V4 is a mini development board based on the ESP32-PICO-D4 SIP module produced by `Espressif `_. For easy interfacing, all the IO signals and system power on ESP32-PICO-D4 are led out through two 20 x 0.1" pitch header pads on both sides of the development board. To make the ESP32-PICO-KIT V4 fit into mini breadboards, the header pads are populated with two 17 pin headers. Remaining 2 x 3 pads grouped on one side of the board besides the antenna are not populated. If required, the additional 2 x 3 pin headers may be soldered later by the user. The development board integrates a USB-UART Bridge circuit, allowing the developers to connect the board to a PC's USB port for downloads and debugging. + +.. note:: + + The 2 x 3 pads not populated with pin headers are internally connected to the flash memory embedded in the ESP32-PICO-D4 SIP module. For more details see module's datasheet in :ref:`get-started-pico-kit-v4-related-documents`. Functional Description ---------------------- -The following list and figure below describe key components, interfaces and controls of ESP32-PICO-KIT board. +The following list and figure below describe key components, interfaces and controls of ESP32-PICO-KIT V4 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. + Standard ESP32-PICO-D4 module soldered to the ESP32-PICO-KIT V4 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. + USB interface. It functions as the power supply for the board and the communication interface between PC and ESP32-PICO-KIT V4. 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 +.. figure:: ../_static/esp32-pico-kit-v4-layout.jpg :align: center - :alt: ESP32-PICO-KIT board layout + :alt: ESP32-PICO-KIT V4 board layout :figclass: align-center - ESP32-PICO-KIT board layout + ESP32-PICO-KIT V4 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. +Before powering up the ESP32-PICO-KIT V4, 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: @@ -57,10 +61,18 @@ To start development of applications, proceed to section :doc:`index`, that will * :ref:`get-started-build-monitor` instantly what the application is doing +.. _get-started-pico-kit-v4-related-documents: + Related Documents ----------------- -* `ESP32-PICO-KIT schematic `_ (PDF) +* `ESP32-PICO-KIT V4 schematic `_ (PDF) * `ESP32-PICO-D4 Datasheet `_ (PDF) +* :doc:`../hw-reference/index` .. * `ESP32-PICO-KIT Datasheet `_ (PDF) + +.. toctree:: + :hidden: + + get-started-pico-kit-v3 diff --git a/docs/get-started/get-started-wrover-kit-v2.rst b/docs/get-started/get-started-wrover-kit-v2.rst index 271b40521..5319827a0 100644 --- a/docs/get-started/get-started-wrover-kit-v2.rst +++ b/docs/get-started/get-started-wrover-kit-v2.rst @@ -1,7 +1,7 @@ ESP-WROVER-KIT V2 Getting Started Guide ======================================= -This user guide shows how to get started with ESP-WROVER-KIT V2 development board including description of its functionality and configuration options. You can find out what version you have in section :ref:`esp-modules-and-boards-esp-wrover-kit`. +This user guide shows how to get started with ESP-WROVER-KIT V2 development board including description of its functionality and configuration options. For description of other versions of the ESP-WROVER-KIT check :doc:`../hw-reference/index`. If you like to start using this board right now, go directly to section :ref:`esp-wrover-kit-v2-start-development`. @@ -177,8 +177,7 @@ Related Documents * `ESP-WROOM-32 Datasheet `_ (PDF) * `ESP32-WROVER Datasheet `_ (PDF) * :doc:`../api-guides/jtag-debugging/index` -* :doc:`../hw-reference/modules-and-boards` - +* :doc:`../hw-reference/index` .. |jp1-sd_io2| image:: ../_static/wrover-jp1-sd_io2.png diff --git a/docs/get-started/get-started-wrover-kit.rst b/docs/get-started/get-started-wrover-kit.rst index 9f70fecad..89effa95d 100644 --- a/docs/get-started/get-started-wrover-kit.rst +++ b/docs/get-started/get-started-wrover-kit.rst @@ -1,7 +1,7 @@ ESP-WROVER-KIT V3 Getting Started Guide ======================================= -This user guide shows how to get started with ESP-WROVER-KIT V3 development board including description of its functionality and configuration options. You can find out what version you have in section :ref:`esp-modules-and-boards-esp-wrover-kit`. +This user guide shows how to get started with ESP-WROVER-KIT V3 development board including description of its functionality and configuration options. For description of other versions of the ESP-WROVER-KIT check :doc:`../hw-reference/index`. If you like to start using this board right now, go directly to section :ref:`esp-wrover-kit-start-development`. @@ -328,7 +328,7 @@ Related Documents * `ESP32-WROVER Datasheet `_ (PDF) * `ESP-WROOM-32 Datasheet `_ (PDF) * :doc:`../api-guides/jtag-debugging/index` -* :doc:`../hw-reference/modules-and-boards` +* :doc:`../hw-reference/index` .. |jp1-sd_io2| image:: ../_static/wrover-jp1-sd_io2.png diff --git a/docs/hw-reference/index.rst b/docs/hw-reference/index.rst index 8c2e660ef..dad6fefc3 100644 --- a/docs/hw-reference/index.rst +++ b/docs/hw-reference/index.rst @@ -3,9 +3,11 @@ ESP32 Hardware Reference ************************ .. toctree:: + :maxdepth: 2 Technical Reference Manual (PDF) Datasheet (PDF) Hardware Design Guidelines (PDF) Silicon Errata (PDF) Modules and Boards + Previous Versions of Modules and Boards diff --git a/docs/hw-reference/modules-and-boards-previous.rst b/docs/hw-reference/modules-and-boards-previous.rst new file mode 100644 index 000000000..95a968804 --- /dev/null +++ b/docs/hw-reference/modules-and-boards-previous.rst @@ -0,0 +1,115 @@ +.. _esp-modules-and-boards-previous: + +Previous Versions of ESP32 Modules and Boards +============================================= + +This sections contains overview and links to documentation of previous version ESP32 Modules and Boards that have been replaced with newer versions or discontinued. It is maintained for convenience of users as several of these boards are still in use and some may still be available for purchase. + +To see the latest development boards, please refer to section :ref:`esp-modules-and-boards`. + + +.. _esp-modules-and-boards-esp32-pico-pit-v3: + +ESP32-PICO-KIT V3 +----------------- + +The first public release of Espressif's ESP32-PICO-D4 chip on a mini development board. The board has a USB port for programming and debugging and two rows of 20 pin headers to plug into a breadboard. The ESP32-PICO-D4 chip itself is small and requires only a few external components. Besides two core CPUs it integrates 4MB flash memory, a crystal oscillator and antenna matching components in one single 7 x 7 mm package. As a result the chip and all the components making the complete development board fit into 20 x 52 mm PCB. + +.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-pico-kit-v3.jpeg + :align: center + :alt: ESP32-PICO-KIT V3 board + :width: 50% + + ESP32-PICO-KIT V3 board + +Documentation +""""""""""""" + +* :doc:`../get-started/get-started-pico-kit-v3` +* `ESP32-PICO-KIT V3 Schematic `_ (PDF) +* `ESP32-PICO-D4 Datasheet `_ (PDF) + + +.. _esp-modules-and-boards-esp-wrover-kit-v1: + +ESP-WROVER-KIT V1 / ESP32 DevKitJ V1 +------------------------------------ + +The first version of ESP-WROVER-KIT development board. Shipped with ESP-WROOM-32 on board. + +ESP-WROVER-KIT has dual port USB to serial converter for programming and JTAG interface for debugging. Power supply is provided by USB interface or from standard 5 mm power supply jack. Power supply selection is done with a jumper and may be put on/off with a separate switch. The board has MicroSD card slot, 3.2” SPI LCD screen and dedicated header to connect a camera. It provides RGB diode for diagnostics. Includes 32.768 kHz XTAL for internal RTC to operate it in low power modes. + +All versions of ESP-WROVER-KIT are ready to accommodate an :ref:`esp-modules-and-boards-esp-wroom-32` or :ref:`esp-modules-and-boards-esp32-wrover` module. + + +.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-devkitj-v1.jpg + :align: center + :alt: ESP-WROVER-KIT V1 / ESP32 DevKitJ V1 board + :width: 90% + + ESP-WROVER-KIT V1 / ESP32 DevKitJ V1 board + +The board has red soldermask. + +Documentation +""""""""""""" + +* `ESP-WROVER-KIT V1 Schematic `__ (PDF) +* :doc:`../api-guides/jtag-debugging/index` +* `FTDI Virtual COM Port Drivers`_ + + +.. _esp-modules-and-boards-esp-wrover-kit-v2: + +ESP-WROVER-KIT V2 +----------------- + +This is updated version of ESP32 DevKitJ V1 described above with design improvements identified when DevKitJ was in use, e.g. improved support for SD card. By default board has ESP-WROOM-32 module installed. + +.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-wrover-kit-v2.jpg + :align: center + :alt: ESP-WROVER-KIT V2 board + :width: 90% + + ESP-WROVER-KIT V2 board + +Comparing to previous version, this board has a shiny black finish and a male camera header. + +Documentation +""""""""""""" + +* :doc:`../get-started/get-started-wrover-kit-v2` +* `ESP-WROVER-KIT V2 Schematic `__ (PDF) +* :doc:`../api-guides/jtag-debugging/index` +* `FTDI Virtual COM Port Drivers`_ + + +.. _esp-modules-and-boards-esp32-demo-board-v2: + +ESP32 Demo Board V2 +------------------- + +One of first feature rich evaluation boards that contains several pin headers, dip switches, USB to serial programming interface, reset and boot mode press buttons, power switch, 10 touch pads and separate header to connect LCD screen. + +.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-demo-board-v2.jpg + :align: center + :alt: ESP32 Demo Board V2 + + ESP32 Demo Board V2 + +Production of this board is discontinued. + +Documentation +""""""""""""" + +* `ESP32 Demo Board V2 Schematic `__ (PDF) +* `FTDI Virtual COM Port Drivers`_ + + +Related Documents +----------------- + +* :doc:`modules-and-boards` + + +.. _FTDI Virtual COM Port Drivers: http://www.ftdichip.com/Drivers/D2XX.htm diff --git a/docs/hw-reference/modules-and-boards.rst b/docs/hw-reference/modules-and-boards.rst index 0b0cf0053..4143e6865 100644 --- a/docs/hw-reference/modules-and-boards.rst +++ b/docs/hw-reference/modules-and-boards.rst @@ -3,10 +3,14 @@ ESP32 Modules and Boards ======================== -Espressif designed and manufactured several development modules and boards to help users evaluate functionality of ESP32 chip. Development boards, depending on intended functionality, have exposed GPIO pins headers, provide USB programming interface, JTAG interface as well as peripherals like touch pads, LCD screen, SD card slot, camera module header, etc. +Espressif designed and manufactured several development modules and boards to help users evaluate functionality of the ESP32 family of chips. Development boards, depending on intended functionality, have exposed GPIO pins headers, provide USB programming interface, JTAG interface as well as peripherals like touch pads, LCD screen, SD card slot, camera module header, etc. For details please refer to documentation below, provided together with description of particular boards. +.. note:: + + This section describes the latest versions of boards. Previous versions of boards, including these not produced anymore, are described in section :ref:`esp-modules-and-boards-previous`. + .. _esp-modules-and-boards-esp-wroom-32: @@ -22,8 +26,8 @@ The smallest module intended for installation in final products. Can be also use ESP-WROOM-32 module (front and back) -* `Schematic `__ (PDF) -* `Datasheet `__ (PDF) +* `ESP-WROOM-32 Schematic `__ (PDF) +* `ESP-WROOM-32 Datasheet `__ (PDF) * `ESP32 Module Reference Design `_ (ZIP) containing OrCAD schematic, PCB layout, gerbers and BOM @@ -41,10 +45,43 @@ A step upgrade of ESP-WROOM-32 described above with an additional 4 MB SPI PSRAM ESP32-WROVER module (front and back) -* `Datasheet `__ (PDF) +Documentation +""""""""""""" + +* `ESP32-WROVER Datasheet `__ (PDF) * `ESP-PSRAM32 Datasheet `__ (PDF) +.. _esp-modules-and-boards-esp32-pico-pit-v4: + +ESP32-PICO-KIT V4 +----------------- + +The smallest ESP32 development board with all the components required to connect it directly to a PC USB port, and pin headers to plug into a mini breadboard. It is equipped with ESP32-PICO-D4 chip that integrates 4MB flash memory, a crystal oscillator, filter capacitors and RF matching circuit in one single package. As result the fully functional development board requires only a few external components that can easy fit on a 20 x 52 mm PCB including antenna, LDO, USB-UART bridge and two buttons to reset it and put into download mode. + +.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-pico-kit-v4.jpeg + :align: center + :alt: ESP32-PICO-KIT V4 board + :width: 50% + + ESP32-PICO-KIT V4 board + +Comparing to ESP32-PICO-KIT V3, this version has revised printout and reduced number of exposed pins. Instead of 20, only 17 header pins are populated, so V4 can fit into a mini breadboard. + + +Documentation +""""""""""""" + +* :doc:`../get-started/get-started-pico-kit` +* `ESP32-PICO-KIT V4 Schematic `_ (PDF) +* `ESP32-PICO-D4 Datasheet `_ (PDF) + +Previous Versions +""""""""""""""""" + +* :ref:`esp-modules-and-boards-esp32-pico-pit-v3` + + .. _esp-modules-and-boards-esp32-devkitc: ESP32 Core Board V2 / ESP32 DevKitC @@ -59,90 +96,25 @@ Small and convenient development board with ESP-WROOM-32 module installed, break ESP32 Core Board V2 / ESP32 DevKitC board -* `Schematic `__ (PDF) -* `ESP32 Development Board Reference Design `_ (ZIP) containing OrCAD schematic, PCB layout, gerbers and BOM +Documentation +""""""""""""" + * :doc:`../get-started/get-started-devkitc` +* `ESP32 DevKitC Schematic `__ (PDF) +* `ESP32 Development Board Reference Design `_ (ZIP) containing OrCAD schematic, PCB layout, gerbers and BOM * `CP210x USB to UART Bridge VCP Drivers `_ -.. _esp-modules-and-boards-esp32-demo-board-v2: - -ESP32 Demo Board V2 -------------------- - -One of first feature rich evaluation boards that contains several pin headers, dip switches, USB to serial programming interface, reset and boot mode press buttons, power switch, 10 touch pads and separate header to connect LCD screen. - -.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-demo-board-v2.jpg - :align: center - :alt: ESP32 Demo Board V2 - - ESP32 Demo Board V2 - -* `Schematic `__ (PDF) -* `FTDI Virtual COM Port Drivers`_ - - -.. _esp-modules-and-boards-esp-wrover-kit: - -ESP-WROVER-KIT --------------- - -This section describes several revisions of ESP-WROVER-KIT development board. - -All versions of ESP-WROVER-KIT are ready to accommodate an :ref:`esp-modules-and-boards-esp-wroom-32` or :ref:`esp-modules-and-boards-esp32-wrover` module. - -ESP-WROVER-KIT has dual port USB to serial converter for programming and JTAG interface for debugging. Power supply is provided by USB interface or from standard 5 mm power supply jack. Power supply selection is done with a jumper and may be put on/off with a separate switch. The board has MicroSD card slot, 3.2” SPI LCD screen and dedicated header to connect a camera. It provides RGB diode for diagnostics. Includes 32.768 kHz XTAL for internal RTC to operate it in low power modes. - - -.. _esp-modules-and-boards-esp-wrover-kit-v1: - -ESP-WROVER-KIT V1 / ESP32 DevKitJ V1 -"""""""""""""""""""""""""""""""""""" - -First version of ESP-WROVER-KIT. Shipped with ESP-WROOM-32 on board. - -.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp32-devkitj-v1.jpg - :align: center - :alt: ESP-WROVER-KIT V1 / ESP32 DevKitJ V1 board - :width: 90% - - ESP-WROVER-KIT V1 / ESP32 DevKitJ V1 board - -The board has red soldermask. - -* `Schematic `__ (PDF) -* :doc:`../api-guides/jtag-debugging/index` -* `FTDI Virtual COM Port Drivers`_ - - -.. _esp-modules-and-boards-esp-wrover-kit-v2: - -ESP-WROVER-KIT V2 -""""""""""""""""" - -This is updated version of ESP32 DevKitJ V1 described above with design improvements identified when DevKitJ was in use, e.g. improved support for SD card. By default board has ESP-WROOM-32 module installed. - -.. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-wrover-kit-v2.jpg - :align: center - :alt: ESP-WROVER-KIT V2 board - :width: 90% - - ESP-WROVER-KIT V2 board - -Comparing to previous version, this board has a shiny black finish and a male camera header. - -* `Schematic V2 `__ (PDF) -* :doc:`../get-started/get-started-wrover-kit-v2` -* :doc:`../api-guides/jtag-debugging/index` -* `FTDI Virtual COM Port Drivers`_ - - .. _esp-modules-and-boards-esp-wrover-kit-v3: ESP-WROVER-KIT V3 -""""""""""""""""" +----------------- -The first release of ESP-WROVER-KIT shipped with ESP32-WROVER module installed by default. This release also introduced several design changes to conditioning and interlocking of signals to the bootstrapping pins. Also, a zero Ohm resistor (R166) has been added between WROVER/WROOM module and VDD33 net, which can be desoldered, or replaced with a shunt resistor, for current measurement. This is intended to facilitate power consumption analysis in various operation modes of ESP32. Refer to schematic - the changes are enclosed in green border. +The ESP-WROVER-KIT V3 development board has dual port USB to serial converter for programming and JTAG interface for debugging. Power supply is provided by USB interface or from standard 5 mm power supply jack. Power supply selection is done with a jumper and may be put on/off with a separate switch. This board has MicroSD card slot, 3.2” SPI LCD screen and dedicated header to connect a camera. It provides RGB diode for diagnostics. Includes 32.768 kHz XTAL for internal RTC to operate it in low power modes. + +As all previous version of ESP-WROVER-KIT boards, it is ready to accommodate an :ref:`esp-modules-and-boards-esp-wroom-32` or :ref:`esp-modules-and-boards-esp32-wrover` module. + +This is the first release of ESP-WROVER-KIT shipped with ESP32-WROVER module installed by default. This release also introduced several design changes to conditioning and interlocking of signals to the bootstrapping pins. Also, a zero Ohm resistor (R166) has been added between WROVER/WROOM module and VDD33 net, which can be desoldered, or replaced with a shunt resistor, for current measurement. This is intended to facilitate power consumption analysis in various operation modes of ESP32. Refer to schematic - the changes are enclosed in green border. .. figure:: https://dl.espressif.com/dl/schematics/pictures/esp-wrover-kit-v3.jpg :align: center @@ -153,10 +125,25 @@ The first release of ESP-WROVER-KIT shipped with ESP32-WROVER module installed b The camera header has been changed from male back to female. The board soldermask is matte black. The board on picture above has ESP32-WROVER is installed. -* `Schematic V3 `__ (PDF) +Documentation +""""""""""""" + * :doc:`../get-started/get-started-wrover-kit` +* `ESP-WROVER-KIT V3 Schematic `__ (PDF) * :doc:`../api-guides/jtag-debugging/index` * `FTDI Virtual COM Port Drivers`_ +Previous Versions +""""""""""""""""" + +* :ref:`esp-modules-and-boards-esp-wrover-kit-v1` +* :ref:`esp-modules-and-boards-esp-wrover-kit-v2` + + +Related Documents +----------------- + +* :doc:`modules-and-boards-previous` + .. _FTDI Virtual COM Port Drivers: http://www.ftdichip.com/Drivers/D2XX.htm