OVMS3-idf/docs/get-started/get-started-devkitc.rst

113 lines
4.8 KiB
ReStructuredText
Raw Normal View History

2017-03-26 22:01:52 +00:00
ESP32-DevKitC Getting Started Guide
===================================
This user guide shows how to get started with ESP32-DevKitC development board.
What You Need
-------------
2017-10-30 05:27:40 +00:00
* 1 × :ref:`ESP32-DevKitC board <get-started-esp32-devkitc-board-front>`
* 1 × USB A / micro USB B cable
* 1 × PC loaded with Windows, Linux or Mac OS
2017-03-26 22:01:52 +00:00
Overview
--------
2018-01-25 21:33:00 +00:00
ESP32-DevKitC is a small-sized ESP32-based development board produced by `Espressif <https://espressif.com>`_. Most of the I/O pins are broken out to the pin headers on both sides for easy interfacing. Developers can connect these pins to peripherals as needed. Standard headers also make development easy and convenient when using a breadboard.
The board comes in two versions, either with :ref:`esp-modules-and-boards-esp-wroom-32` or :ref:`esp-modules-and-boards-esp32-wrover` module soldered.
2017-03-26 22:01:52 +00:00
Functional Description
----------------------
The following list and figure below describe key components, interfaces and controls of ESP32-DevKitC board.
ESP-WROOM-32
2018-01-25 21:33:00 +00:00
:ref:`esp-modules-and-boards-esp-wroom-32` module soldered to the ESP32-DevKitC board.
ESP32-WROVER
Optionally :ref:`esp-modules-and-boards-esp32-wrover` module may be soldered instead of the ESP-WROOM-32.
USB-UART Bridge
A single chip USB-UART bridge provides up to 3 Mbps transfers rates.
2017-03-26 22:01:52 +00:00
Boot
Download 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.
2018-01-25 21:33:00 +00:00
Micro USB Port
USB interface. It functions as the power supply for the board and the communication interface between PC and the ESP module.
5V Power On LED
This LED lights when the USB or an external 5V power supply is applied to the board. For details see schematic in `Related Documents`_.
EN
Reset button: pressing this button resets the system.
2017-03-26 22:01:52 +00:00
I/O
2018-01-25 21:33:00 +00:00
Most of the pins on the ESP module 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.
.. note::
Some of broken out pins are used internally be the ESP32 module to communicate with SPI memory. They are grouped on one side of the board besides the USB connector and labeled D0, D1, D2, D3, CMD and CLK. In general these pins should be left unconnected or access to the SPI flash memory / SPI RAM may be disturbed.
.. note::
GPIO16 and 17 are used internally by the ESP32-WROVER module. They are broken out and avialable for use only for boards that have the ESP-WROOM-32 module installed.
2017-03-26 22:01:52 +00:00
2017-10-30 05:27:40 +00:00
.. _get-started-esp32-devkitc-board-front:
2018-01-25 21:33:00 +00:00
.. figure:: ../_static/esp32-devkitc-functional-overview.jpg
2017-03-26 22:01:52 +00:00
:align: center
2018-01-25 21:33:00 +00:00
:alt: ESP32-DevKitC with ESP-WROOM-32 module soldered
2017-03-26 22:01:52 +00:00
:figclass: align-center
2018-01-25 21:33:00 +00:00
ESP32-DevKitC with ESP-WROOM-32 module soldered
2017-03-26 22:01:52 +00:00
2017-10-30 05:27:40 +00:00
Power Supply Options
--------------------
2018-01-25 21:33:00 +00:00
There following options are available to provide power supply to this board:
2017-10-30 05:27:40 +00:00
1. Micro USB port, this is default power supply connection
2. 5V / GND header pins
3. 3V3 / GND header pins
.. warning::
Above options are mutually exclusive, i.e. the power supply may be provided using only one of the above options. Attempt to power the board using more than one connection at a time may damage the board and/or the power supply source.
2017-03-26 22:01:52 +00:00
Start Application Development
------------------------------
Before powering up the ESP32-DevKitC, 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
2017-03-26 22:01:52 +00:00
* :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
2018-01-25 21:33:00 +00:00
Board Dimensions
----------------
.. figure:: ../_static/esp32-devkitc-dimensions-back.jpg
:align: center
:alt: ESP32 DevKitC board dimensions - back
:figclass: align-center
ESP32 DevKitC board dimensions - back
2017-03-26 22:01:52 +00:00
Related Documents
-----------------
2018-01-25 21:33:00 +00:00
* `ESP32-DevKitC schematic <https://dl.espressif.com/dl/schematics/esp32_devkitc_v4-sch.pdf>`_ (PDF)
* `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF)
* `ESP-WROOM-32 Datasheet <https://espressif.com/sites/default/files/documentation/esp-wroom-32_datasheet_en.pdf>`_ (PDF)
2018-01-25 21:33:00 +00:00
* `ESP32-WROVER Datasheet <https://espressif.com/sites/default/files/documentation/esp32-wrover_datasheet_en.pdf>`_ (PDF)
.. toctree::
:hidden:
get-started-devkitc-v2