esp-idf/docs/en/hw-reference/esp32/user-guide-devkitm-1.rst

336 lines
11 KiB
ReStructuredText
Raw Normal View History

===============
ESP32-DevKitM-1
===============
2021-01-04 23:32:08 -05:00
:link_to_translation:`zh_CN:[中文]`
This user guide will help you get started with ESP32-DevKitM-1 and will also provide more in-depth information.
2023-10-13 15:55:41 -04:00
ESP32-DevKitM-1 is an ESP32-MINI-1/1U-based development board produced by Espressif. Most of the I/O pins are broken out to the pin headers on both sides for easy interfacing. Users can either connect peripherals with jumper wires or mount ESP32-DevKitM-1 on a breadboard.
2021-01-04 23:32:08 -05:00
+---------------------------+-------------------------------+
2022-04-28 02:34:20 -04:00
| |ESP32-DevKitM-1 - front| | |ESP32-DevKitM-1 - isometric| |
2021-01-04 23:32:08 -05:00
+---------------------------+-------------------------------+
2022-04-28 02:34:20 -04:00
| ESP32-DevKitM-1 - front | ESP32-DevKitM-1 - isometric |
2021-01-04 23:32:08 -05:00
+---------------------------+-------------------------------+
.. |ESP32-DevKitM-1 - front| image:: ../../../_static/esp32-DevKitM-1-front.png
.. |ESP32-DevKitM-1 - isometric| image:: ../../../_static/esp32-DevKitM-1-isometric.png
The document consists of the following major sections:
- `Getting started`_: Provides an overview of the ESP32-DevKitM-1 and hardware/software setup instructions to get started.
- `Hardware reference`_: Provides more detailed information about the ESP32-DevKitM-1's hardware.
- `Related Documents`_: Gives links to related documentaiton.
2022-01-07 03:11:01 -05:00
2022-04-28 02:34:20 -04:00
Getting Started
===============
2021-01-04 23:32:08 -05:00
This section describes how to get started with ESP32-DevKitM-1. It begins with a few introductory sections about the ESP32-DevKitM-1, then Section `Start Application Development`_ provides instructions on how to do the initial hardware setup and then how to flash firmware onto the ESP32-DevKitM-1.
2022-04-28 02:34:20 -04:00
Overview
--------
2021-01-04 23:32:08 -05:00
This is a small and convenient development board that features:
- `ESP32-MINI-1, or ESP32-MINI-1U module <https://www.espressif.com/sites/default/files/documentation/esp32-mini-1_datasheet_en.pdf>`_
2021-01-04 23:32:08 -05:00
- 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
2022-04-28 02:34:20 -04:00
Contents and Packaging
----------------------
2021-01-04 23:32:08 -05:00
Retail Orders
^^^^^^^^^^^^^
2021-01-04 23:32:08 -05:00
If you order a few samples, each ESP32-DevKitM-1 comes in an individual package in either antistatic bag or any packaging depending on your retailer.
2022-04-28 02:34:20 -04:00
For retail orders, please go to https://www.espressif.com/en/contact-us/get-samples.
2021-01-04 23:32:08 -05:00
2022-04-28 02:34:20 -04:00
Wholesale Orders
^^^^^^^^^^^^^^^^
2021-01-04 23:32:08 -05:00
If you order in bulk, the boards come in large cardboard boxes.
For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.
2021-01-04 23:32:08 -05:00
2022-04-28 02:34:20 -04:00
Description of Components
-------------------------
2021-01-04 23:32:08 -05:00
The following figure and the table below describe the key components, interfaces and controls of the ESP32-DevKitM-1 board. We take the board with a ESP32-MINI-1 module as an example in the following sections.
2021-01-04 23:32:08 -05:00
.. figure:: ../../../_static/esp32-devkitm-1-v1-annotated-photo.png
:align: center
:alt: ESP32-DevKitM-1 - front
:figclass: align-center
ESP32-DevKitM-1 - front
.. list-table::
:widths: 25 75
:header-rows: 1
* - Key Component
- Description
* - On-board module
2022-04-28 02:34:20 -04:00
- ESP32-MINI-1 module or ESP32-MINI-1U module. ESP32-MINI-1 comes with an on-board PCB antenna. ESP32-MINI-1U comes with an external antenna connector. The two modules both have a 4 MB flash in chip package. For details, please see `ESP32-MINI-1 & ESP32-MINI-1U Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-mini-1_datasheet_en.pdf>`_.
2021-01-04 23:32:08 -05:00
* - 5 V to 3.3 V LDO
- Power regulator converts 5 V to 3.3 V.
* - Boot Button
- Download button. Holding down **Boot** and then pressing **Reset** initiates Firmware Download mode for downloading firmware through the serial port.
* - Reset Button
- Reset Button
* - Micro-USB Port
- USB interface. Power supply for the board as well as the communication interface between a computer and the ESP32 chip.
* - USB-to-UART Bridge
- Single USB-UART bridge chip provides transfer rates up to 3 Mbps.
* - 3.3 V Power On LED
- Turns on when the USB is connected to the board. For details, please see the schematics in `Related Documents`_.
* - I/O Connector
- All available GPIO pins (except for the SPI bus for flash) are broken out to the pin headers on the board. Users can program ESP32 chip to enable multiple functions.
2022-04-28 02:34:20 -04:00
Start Application Development
-----------------------------
2021-01-04 23:32:08 -05:00
Before powering up your ESP32-DevKitM-1, please make sure that it is in good condition with no obvious signs of damage.
2022-04-28 02:34:20 -04:00
Required Hardware
^^^^^^^^^^^^^^^^^
2021-01-04 23:32:08 -05:00
2022-04-28 02:34:20 -04:00
- ESP32-DevKitM-1
- USB 2.0 cable (Standard-A to Micro-B)
- Computer running Windows, Linux, or macOS
2021-01-04 23:32:08 -05:00
2022-04-28 02:34:20 -04:00
Software Setup
^^^^^^^^^^^^^^
2021-01-04 23:32:08 -05:00
Please proceed to :doc:`../../get-started/index`, where Section :ref:`get-started-step-by-step` will quickly help you set up the development environment and then flash an application example onto your ESP32-DevKitM-1.
.. attention::
2022-07-20 22:11:20 -04:00
ESP32-DevKitM-1 boards manufactured before December 2, 2021 have a single core module installed. To verify what module you have, please check module marking information in `PCN-2021-021 <https://www.espressif.com/sites/default/files/pcn_downloads/PCN-2021-021%20ESP32-U4WDH%20%E5%8D%87%E7%BA%A7%E4%B8%BA%E5%8F%8C%E6%A0%B8%E5%A4%84%E7%90%86%E5%99%A8%E4%BA%A7%E5%93%81.pdf>`_ . If your board has a single core module installed, please enable single core mode (:ref:`CONFIG_FREERTOS_UNICORE`) in :ref:`menuconfig <get-started-configure>` before flashing your applications.
2021-01-04 23:32:08 -05:00
2022-04-28 02:34:20 -04:00
Hardware Reference
==================
2021-01-04 23:32:08 -05:00
2022-04-28 02:34:20 -04:00
Block Diagram
-------------
2021-01-04 23:32:08 -05:00
A block diagram below shows the components of ESP32-DevKitM-1 and their interconnections.
.. figure:: ../../../_static/esp32-DevKitM-1_v1_SystemBlock.png
:align: center
2022-04-28 02:34:20 -04:00
:alt: ESP32-DevKitM-1
2021-01-04 23:32:08 -05:00
:figclass: align-center
2022-04-28 02:34:20 -04:00
ESP32-DevKitM-1
2021-01-04 23:32:08 -05:00
2022-04-28 02:34:20 -04:00
Power Source Select
-------------------
2021-01-04 23:32:08 -05:00
There are three mutually exclusive ways to provide power to the board:
* Micro USB port, default power supply
* 5V and GND header pins
* 3V3 and GND header pins
.. warning::
- The power supply must be provided using **one and only one of the options above**, otherwise the board and/or the power supply source can be damaged.
- Power supply by micro USB port is recommended.
Pin Descriptions
----------------
2021-01-04 23:32:08 -05:00
The table below provides the Name and Function of pins on both sides of the board. For peripheral pin configurations, please refer to `ESP32 Datasheet`_.
2022-04-28 02:34:20 -04:00
.. list-table::
:header-rows: 1
:widths: 10 12 12 66
2021-01-04 23:32:08 -05:00
* - No.
2022-04-28 02:34:20 -04:00
- Name
2022-08-11 07:11:02 -04:00
- Type [1]_
2022-04-28 02:34:20 -04:00
- Function
2021-01-04 23:32:08 -05:00
* - 1
2022-04-28 02:34:20 -04:00
- GND
- P
- Ground
2021-01-04 23:32:08 -05:00
* - 2
2022-04-28 02:34:20 -04:00
- 3V3
- P
- 3.3 V power supply
2021-01-04 23:32:08 -05:00
* - 3
2022-04-28 02:34:20 -04:00
- I36
- I
- GPIO36, ADC1_CH0, RTC_GPIO0
2021-01-04 23:32:08 -05:00
* - 4
2022-04-28 02:34:20 -04:00
- I37
- I
- GPIO37, ADC1_CH1, RTC_GPIO1
2021-01-04 23:32:08 -05:00
* - 5
2022-04-28 02:34:20 -04:00
- I38
- I
- GPIO38, ADC1_CH2, RTC_GPIO2
2021-01-04 23:32:08 -05:00
* - 6
2022-04-28 02:34:20 -04:00
- I39
- I
- GPIO39, ADC1_CH3, RTC_GPIO3
2021-01-04 23:32:08 -05:00
* - 7
- RST
- I
2022-04-28 02:34:20 -04:00
- Reset; High: enable; Low: powers off
2021-01-04 23:32:08 -05:00
* - 8
2022-04-28 02:34:20 -04:00
- I34
- I
- GPIO34, ADC1_CH6, RTC_GPIO4
2021-01-04 23:32:08 -05:00
* - 9
2022-04-28 02:34:20 -04:00
- I35
- I
- GPIO35, ADC1_CH7, RTC_GPIO5
2021-01-04 23:32:08 -05:00
* - 10
2022-04-28 02:34:20 -04:00
- IO32
- I/O
- GPIO32, XTAL_32K_P (32.768 kHz crystal oscillator input), ADC1_CH4, TOUCH9, RTC_GPIO9
2021-01-04 23:32:08 -05:00
* - 11
2022-04-28 02:34:20 -04:00
- IO33
- I/O
- GPIO33, XTAL_32K_N (32.768 kHz crystal oscillator output), ADC1_CH5, TOUCH8, RTC_GPIO8
2021-01-04 23:32:08 -05:00
* - 12
2022-04-28 02:34:20 -04:00
- IO25
- I/O
- GPIO25, DAC_1, ADC2_CH8, RTC_GPIO6, EMAC_RXD0
2021-01-04 23:32:08 -05:00
* - 13
2022-04-28 02:34:20 -04:00
- IO26
- I/O
- GPIO26, DAC_2, ADC2_CH9, RTC_GPIO7, EMAC_RXD1
2021-01-04 23:32:08 -05:00
* - 14
2022-04-28 02:34:20 -04:00
- IO27
- I/O
- GPIO27, ADC2_CH7, TOUCH7, RTC_GPIO17, EMAC_RX_DV
2021-01-04 23:32:08 -05:00
* - 15
2022-04-28 02:34:20 -04:00
- IO14
- I/O
- GPIO14, ADC2_CH6, TOUCH6, RTC_GPIO16, MTMS, HSPICLK, HS2_CLK, SD_CLK, EMAC_TXD2
2021-01-04 23:32:08 -05:00
* - 16
- 5V
2022-04-28 02:34:20 -04:00
- P
- 5 V power supply
2021-01-04 23:32:08 -05:00
* - 17
2022-04-28 02:34:20 -04:00
- IO12
- I/O
2022-08-11 07:11:02 -04:00
- GPIO12, ADC2_CH5, TOUCH5, RTC_GPIO15, MTDI [2]_, HSPIQ, HS2_DATA2, SD_DATA2, EMAC_TXD3
2021-01-04 23:32:08 -05:00
* - 18
2022-04-28 02:34:20 -04:00
- IO13
- I/O
- GPIO13, ADC2_CH4, TOUCH4, RTC_GPIO14, MTCK, HSPID, HS2_DATA3, SD_DATA3, EMAC_RX_ER
2021-01-04 23:32:08 -05:00
* - 19
2022-04-28 02:34:20 -04:00
- IO15
- I/O
2022-08-11 07:11:02 -04:00
- GPIO15, ADC2_CH3, TOUCH3, RTC_GPIO13, MTDO [2]_, HSPICS0, HS2_CMD, SD_CMD, EMAC_RXD3
2021-01-04 23:32:08 -05:00
* - 20
2022-04-28 02:34:20 -04:00
- IO2
- I/O
2022-08-11 07:11:02 -04:00
- GPIO2 [2]_, ADC2_CH2, TOUCH2, RTC_GPIO12, HSPIWP, HS2_DATA0, SD_DATA0
2021-01-04 23:32:08 -05:00
* - 21
2022-04-28 02:34:20 -04:00
- IO0
- I/O
2022-08-11 07:11:02 -04:00
- GPIO0 [2]_, ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1, EMAC_TX_CLK
2021-01-04 23:32:08 -05:00
* - 22
2022-04-28 02:34:20 -04:00
- IO4
- I/O
- GPIO4, ADC2_CH0, TOUCH0, RTC_GPIO10, HSPIHD, HS2_DATA1, SD_DATA1, EMAC_TX_ER
2021-01-04 23:32:08 -05:00
* - 23
2022-04-28 02:34:20 -04:00
- IO9
- I/O
- GPIO9, HS1_DATA2, U1RXD, SD_DATA2
2021-01-04 23:32:08 -05:00
* - 24
2022-04-28 02:34:20 -04:00
- IO10
- I/O
- GPIO10, HS1_DATA3, U1TXD, SD_DATA3
2021-01-04 23:32:08 -05:00
* - 25
2022-04-28 02:34:20 -04:00
- IO5
- I/O
2022-08-11 07:11:02 -04:00
- GPIO5 [2]_, HS1_DATA6, VSPICS0, EMAC_RX_CLK
2021-01-04 23:32:08 -05:00
* - 26
2022-04-28 02:34:20 -04:00
- IO18
- I/O
- GPIO18, HS1_DATA7, VSPICLK
2021-01-04 23:32:08 -05:00
* - 27
2022-04-28 02:34:20 -04:00
- IO23
- I/O
- GPIO23, HS1_STROBE, VSPID
2021-01-04 23:32:08 -05:00
* - 28
2022-04-28 02:34:20 -04:00
- IO19
- I/O
- GPIO19, VSPIQ, U0CTS, EMAC_TXD0
2021-01-04 23:32:08 -05:00
* - 29
2022-04-28 02:34:20 -04:00
- IO22
- I/O
- GPIO22, VSPIWP, U0RTS, EMAC_TXD1
2021-01-04 23:32:08 -05:00
* - 30
2022-04-28 02:34:20 -04:00
- IO21
- I/O
- GPIO21, VSPIHD, EMAC_TX_EN
2021-01-04 23:32:08 -05:00
* - 31
2022-04-28 02:34:20 -04:00
- TXD0
- I/O
- GPIO1, U0TXD, CLK_OUT3, EMAC_RXD2
2021-01-04 23:32:08 -05:00
* - 32
2022-04-28 02:34:20 -04:00
- RXD0
- I/O
- GPIO3, U0RXD, CLK_OUT2
2021-01-04 23:32:08 -05:00
2022-08-11 07:11:02 -04:00
.. [1] P: Power supply; I: Input; O: Output.
.. [2] MTDI, GPIO0, GPIO2, MTDO, and GPIO5 are strapping pins. These pins are used to control several chip functions depending on binary voltage values applied to the pins during chip power-up or system reset. For description and application of the strapping pins, please refer to `ESP32 Datasheet`_ > Section *Strapping Pins*.
2022-08-11 07:11:02 -04:00
Pin Layout
^^^^^^^^^^
2022-08-11 07:11:02 -04:00
.. figure:: ../../../_static/ESP32_DevKitM-1_pinlayout.png
:align: center
:scale: 43%
:alt: ESP32-DevKitM-1 (click to enlarge)
:figclass: align-center
ESP32-DevKitM-1 (click to enlarge)
2021-01-04 23:32:08 -05:00
2021-01-04 23:32:08 -05:00
Hardware Revision Details
=========================
2021-01-04 23:32:08 -05:00
No previous versions available.
2022-04-28 02:34:20 -04:00
Related Documents
=================
2021-01-04 23:32:08 -05:00
2022-04-28 02:34:20 -04:00
* `ESP32-MINI-1 & ESP32-MINI-1U Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32-mini-1_datasheet_en.pdf>`_ (PDF)
2021-01-04 23:32:08 -05:00
* `ESP32-DevKitM-1 Schematics <https://dl.espressif.com/dl/schematics/SCH_ESP32-DEVKITM-1_V1_20200910A.pdf>`_ (PDF)
* `ESP32-DevKitM-1 PCB layout <https://dl.espressif.com/dl/schematics/PCB_ESP32-DevKitM-1_V1_20200910AE.pdf>`_ (PDF)
* `ESP32-DevKitM-1 layout <https://dl.espressif.com/dl/schematics/ESP32-DevKitM-1_V1.dxf>`_ (DXF) - You can view it with `Autodesk Viewer <https://viewer.autodesk.com/>`_ online
* `ESP32 Datasheet <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf>`_ (PDF)
* `ESP Product Selector <https://products.espressif.com/#/product-selector?names=>`_
2021-01-04 23:32:08 -05:00
For other design documentation for the board, please contact us at sales@espressif.com.