===================
ESP32-DevKitM-1
===================
:link_to_translation:`en: [English]`
本指南将介绍如何使用 ESP32-DevKitM-1，并提供更多关于此开发板的信息。
ESP32-DevKitM-1 是乐鑫推出的一款基于 ESP32-MINI-1 模组的入门级开发板。板上模组大部分管脚均已引出至两侧排针，用户可根据实际需求，通过跳线轻松连接多种外围设备，同时也可将开发板插在面包板上使用。
+------------------------+-------------------------+
| |ESP32-DevKitM-1-正面| | |ESP32-DevKitM-1-侧面| |
+------------------------+-------------------------+
| ESP32-DevKitM-1-正面 | ESP32-DevKitM-1-侧面 |
+------------------------+-------------------------+
.. |ESP32-DevKitM-1-正面| image:: ../../../_static/esp32-DevKitM-1-front.png
.. |ESP32-DevKitM-1-侧面| image:: ../../../_static/esp32-DevKitM-1-isometric.png
本指南包括：
- `快速入门`_：提供 ESP32-DevKitM-1 的简要概述及必要的硬件和软件信息。
- `硬件参考`_：提供 ESP32-DevKitM-1 的详细硬件信息。
- `相关文档`_：提供相关文档的链接。
快速入门
===========
本节介绍如何开始使用 ESP32-DevKitM-1，主要包括三大部分：首先，介绍一些关于 ESP32-DevKitM-1 的基本信息，然后在 `应用程序开发`_ 章节介绍如何进行硬件初始化，最后介绍如何为 ESP32-DevKitM-1 烧录固件。
概述
-------
ESP32-DevKitM-1 开发板是一款小巧实用的开发板，具备以下特色功能：
- 集成了 `ESP32-MINI-1 <https://www.espressif.com/sites/default/files/documentation/esp32-mini-1_datasheet_cn.pdf>`_ 模组
- USB 转串口编程接口同时可为开发板供电
- 设有排针
- 设有重置按钮和固件下载模式激活按钮
- 以及其他组件
内含组件和包装
---------------
零售订单
^^^^^^^^^^^
如购买样品，每个 ESP32-DevKitM-1 底板将以防静电袋或零售商选择的其他方式包装。
零售订单请前往 https://www.espressif.com/zh-hans/company/contact/buy-a-sample。
批量订单
^^^^^^^^^^^
如批量购买，ESP32-DevKitM-1 烧录底板将以大纸板箱包装。
批量订单请参考 `乐鑫产品订购信息 <https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_cn.pdf>`__ (PDF)。
组件介绍
-----------
ESP32-DevKitM-1 开发板的主要组件、接口及控制方式见下。
.. figure:: ../../../_static/esp32-devkitm-1-v1-annotated-photo.png
:align: center
:alt: ESP32-DevKitM-1 - 正面
:figclass: align-center
ESP32-DevKitM-1 - 正面
.. list-table::
:widths: 25 75
:header-rows: 1
* - 主要组件
- 基本介绍
* - ESP32-MINI-1
- ESP32-MINI-1（4MB Flash，PCB Antenna）模组。更多详情，请见 `《ESP32-MINI-1 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32-mini-1_datasheet_cn.pdf>`_
* - 5 V 转 3.3 V LDO
- 电源转换器，输入 5 V，输出 3.3 V
* - Boot 键
- 下载按键。按下 **Boot** 键的同时按一下 **Reset** 键进入“固件下载”模式，通过串口下载固件
* - Reset 键
- 复位按键
* - Micro-USB 接口
- USB 接口，可用作开发板的供电电源或 PC 和 ESP32 芯片的通信接口
* - USB 至 UART 桥接器
- 单芯片 USB 至 UART 桥接器，可提供高达 3 Mbps 的传输速率
* - 3.3 V 电源指示灯
- 开发板连接 USB 电源后，该指示灯亮起。更多信息，请见 `相关文档`_ 中的原理图
* - I/O 连接器
- 所有可用 GPIO 管脚（除 Flash 的 SPI 总线）均已引出至开发板的排针。用户可对 ESP32 芯片编程，开发多种功能
应用程序开发
---------------
ESP32-DevKitM-1 上电前，请首先确认开发板完好无损。
硬件准备
^^^^^^^^^^^^
- ESP32-DevKitM-1 开发板
- USB A / micro USB B 数据线
- PC（Windows、Linux 或 Mac OS）
软件设置
^^^^^^^^^^^
现在，请前往 :doc:`../../get-started/index` 中的 :ref:`get-started-step-by-step` 章节，查看如何设置开发环境，并尝试将示例项目烧录至您的开发板。
硬件参考
===========
功能框图
----------
ESP32-DevKitM-1 的主要组件和连接方式如下图所示。
.. figure:: ../../../_static/esp32-DevKitM-1_v1_SystemBlock.png
:align: center
:alt: ESP32-DevKitM-1
:figclass: align-center
ESP32-DevKitM-1
电源选项
----------
开发板可从以下三种供电方式中任选其一：
* Micro USB 供电（默认）
* 5V / GND 管脚供电
* 3V3 / GND 管脚供电
.. warning::
- 上述供电模式 **不可同时连接**，否则可能会损坏开发板和/或电源。
- 建议选择第一种供电方式：Micro USB 端口供电。
管脚描述
----------
开发板两侧 I/O 管脚，其具体名称和功能见下表。外设管脚分配请参考 `《ESP32 技术规格书》`_。
.. list-table::
:header-rows: 1
:widths: 10 12 12 66
* - 编号
- 名称
- 类型
- 功能
* - 1
- GND
- P
- 接地
* - 2
- 3V3
- P
- 3.3 V 电源
* - 3
- I36
- I
- GPIO36, ADC1_CH0, RTC_GPIO0
* - 4
- I37
- I
- GPIO37, ADC1_CH1, RTC_GPIO1
* - 5
- I38
- I
- GPIO38, ADC1_CH2, RTC_GPIO2
* - 6
- I39
- I
- GPIO39, ADC1_CH3, RTC_GPIO3
* - 7
- RST
- I
- 复位；高电平：使能；低电平：关闭
* - 8
- I34
- I
- GPIO34, ADC1_CH6, RTC_GPIO4
* - 9
- I35
- I
- GPIO35, ADC1_CH7, RTC_GPIO5
* - 10
- IO32
- I/O
- GPIO32, XTAL_32K_P (32.768 kHz crystal oscillator input), ADC1_CH4, TOUCH9, RTC_GPIO9
* - 11
- IO33
- I/O
- GPIO33, XTAL_32K_N (32.768 kHz crystal oscillator output), ADC1_CH5, TOUCH8, RTC_GPIO8
* - 12
- IO25
- I/O
- GPIO25, DAC_1, ADC2_CH8, RTC_GPIO6, EMAC_RXD0
* - 13
- IO26
- I/O
- GPIO26, DAC_2, ADC2_CH9, RTC_GPIO7, EMAC_RXD1
* - 14
- IO27
- I/O
- GPIO27, ADC2_CH7, TOUCH7, RTC_GPIO17, EMAC_RX_DV
* - 15
- IO14
- I/O
- GPIO14, ADC2_CH6, TOUCH6, RTC_GPIO16, MTMS, HSPICLK, HS2_CLK, SD_CLK, EMAC_TXD2
* - 16
- 5V
- P
- 5 V 电源
* - 17
- IO12
- I/O
- GPIO12, ADC2_CH5, TOUCH5, RTC_GPIO15, MTDI, HSPIQ, HS2_DATA2, SD_DATA2, EMAC_TXD3
* - 18
- IO13
- I/O
- GPIO13, ADC2_CH4, TOUCH4, RTC_GPIO14, MTCK, HSPID, HS2_DATA3, SD_DATA3, EMAC_RX_ER
* - 19
- IO15
- I/O
- GPIO15, ADC2_CH3, TOUCH3, RTC_GPIO13, MTDO, HSPICS0, HS2_CMD, SD_CMD, EMAC_RXD3
* - 20
- IO2
- I/O
- GPIO2, ADC2_CH2, TOUCH2, RTC_GPIO12, HSPIWP, HS2_DATA0, SD_DATA0
* - 21
- IO0
- I/O
- GPIO0, ADC2_CH1, TOUCH1, RTC_GPIO11, CLK_OUT1, EMAC_TX_CLK
* - 22
- IO4
- I/O
- GPIO4, ADC2_CH0, TOUCH0, RTC_GPIO10, HSPIHD, HS2_DATA1, SD_DATA1, EMAC_TX_ER
* - 23
- IO9
- I/O
- GPIO9, HS1_DATA2, U1RXD, SD_DATA2
* - 24
- IO10
- I/O
- GPIO10, HS1_DATA3, U1TXD, SD_DATA3
* - 25
- IO5
- I/O
- GPIO5, HS1_DATA6, VSPICS0, EMAC_RX_CLK
* - 26
- IO18
- I/O
- GPIO18, HS1_DATA7, VSPICLK
* - 27
- IO23
- I/O
- GPIO23, HS1_STROBE, VSPID
* - 28
- IO19
- I/O
- GPIO19, VSPIQ, U0CTS, EMAC_TXD0
* - 29
- IO22
- I/O
- GPIO22, VSPIWP, U0RTS, EMAC_TXD1
* - 30
- IO21
- I/O
- GPIO21, VSPIHD, EMAC_TX_EN
* - 31
- TXD0
- I/O
- GPIO1, U0TXD, CLK_OUT3, EMAC_RXD2
* - 32
- RXD0
- I/O
- GPIO3, U0RXD, CLK_OUT2
硬件修订历史
===============
尚无版本升级历史。
相关文档
============
* `《ESP32-MINI-1 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32-mini-1_datasheet_cn.pdf>`_ (PDF)
* `ESP32-DevKitM-1 原理图 <https://dl.espressif.com/dl/schematics/SCH_ESP32-DEVKITM-1_V1_20200910A.pdf>`_ (PDF)
* `ESP32-DevKitM-1 PCB 布局图 <https://dl.espressif.com/dl/schematics/PCB_ESP32-DevKitM-1_V1_20200910AE.pdf>`_ (PDF)
* `ESP32-DevKitM-1 布局图 <https://dl.espressif.com/dl/schematics/ESP32-DevKitM-1_V1.dxf>`_ (DXF) - 可使用 `Autodesk Viewer <https://viewer.autodesk.com/>`_ 查看
* `乐鑫产品订购信息 <https://www.espressif.com/sites/default/files/documentation/espressif_products_ordering_information_cn.pdf>`_ (PDF)
* `《ESP32 技术规格书》 <https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_cn.pdf>`_ (PDF)
有关本开发板的更多设计文档，请联系我们的商务部门 sales@espressif.com。