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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 literal 0 HcmV?d00001 diff --git a/docs/get-started/get-started-pico-kit-v3.rst b/docs/get-started/get-started-pico-kit-v3.rst new file mode 100644 index 0000000000..334c22fadc --- /dev/null +++ b/docs/get-started/get-started-pico-kit-v3.rst @@ -0,0 +1,66 @@ +ESP32-PICO-KIT V3 Getting Started Guide +======================================= + +This user guide shows how to get started with the ESP32-PICO-KIT V3 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 V3 mini development board +* 1 × USB A / Micro USB B cable +* 1 × PC loaded with Windows, Linux or Mac OS + + +Overview +-------- + +ESP32-PICO-KIT V3 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. + + +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 236d7a1916..1ae2bd2fb6 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 271b405214..5319827a04 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 9f70fecad6..89effa95d2 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 8c2e660ef4..dad6fefc32 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 0000000000..95a9688041 --- /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 0b0cf0053c..4143e68650 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