diff --git a/docs/_static/esp32-c3-devkitc-02-v1-annotated-photo.png b/docs/_static/esp32-c3-devkitc-02-v1-annotated-photo.png new file mode 100644 index 0000000000..1da577f0ad Binary files /dev/null and b/docs/_static/esp32-c3-devkitc-02-v1-annotated-photo.png differ diff --git a/docs/_static/esp32-c3-devkitc-02-v1-block-diags.png b/docs/_static/esp32-c3-devkitc-02-v1-block-diags.png new file mode 100644 index 0000000000..d45410221b Binary files /dev/null and b/docs/_static/esp32-c3-devkitc-02-v1-block-diags.png differ diff --git a/docs/_static/esp32-c3-devkitc-02-v1-isometric.png b/docs/_static/esp32-c3-devkitc-02-v1-isometric.png new file mode 100644 index 0000000000..2463626582 Binary files /dev/null and b/docs/_static/esp32-c3-devkitc-02-v1-isometric.png differ diff --git a/docs/_static/esp32-c3-devkitc-02-v1-pinout.png b/docs/_static/esp32-c3-devkitc-02-v1-pinout.png new file mode 100644 index 0000000000..6049b2b6af Binary files /dev/null and b/docs/_static/esp32-c3-devkitc-02-v1-pinout.png differ diff --git a/docs/en/get-started/index.rst b/docs/en/get-started/index.rst index c407e29ec4..cb6982a61d 100644 --- a/docs/en/get-started/index.rst +++ b/docs/en/get-started/index.rst @@ -118,6 +118,7 @@ If you have one of {IDF_TARGET_NAME} development boards listed below, you can cl :maxdepth: 1 ESP32-C3-DevKitM-1 <../hw-reference/esp32c3/user-guide-devkitm-1> + ESP32-C3-DevKitC-02 <../hw-reference/esp32c3/user-guide-devkitc-02> .. _get-started-step-by-step: diff --git a/docs/en/hw-reference/esp32c3/user-guide-devkitc-02.rst b/docs/en/hw-reference/esp32c3/user-guide-devkitc-02.rst new file mode 100644 index 0000000000..569f796a20 --- /dev/null +++ b/docs/en/hw-reference/esp32c3/user-guide-devkitc-02.rst @@ -0,0 +1,213 @@ +=================== +ESP32-C3-DevKitC-02 +=================== + +:link_to_translation:`zh_CN:[中文]` + +This user guide will help you get started with ESP32-C3-DevKitC-02 and will also provide more in-depth information. + +ESP32-C3-DevKitC-02 is an entry-level development board based on `ESP32-C3-WROOM-02 `_, a general-purpose module with 4 MB SPI flash. This board integrates complete Wi-Fi and Bluetooth LE functions. + +Most of the I/O pins are broken out to the pin headers on both sides for easy interfacing. Developers can either connect peripherals with jumper wires or mount ESP32-C3-DevKitC-02 on a breadboard. + +.. figure:: ../../../_static/esp32-c3-devkitc-02-v1-isometric.png + :align: center + :alt: ESP32-C3-DevKitC-02 + :figclass: align-center + + ESP32-C3-DevKitC-02 + +The document consists of the following major sections: + +- `Getting Started`_: Overview of ESP32-C3-DevKitC-02 and hardware/software setup instructions to get started. +- `Hardware Reference`_: More detailed information about the ESP32-C3-DevKitC-02's hardware. +- `Hardware Revision Details`_: Revision history, known issues, and links to user guides for previous versions (if any) of ESP32-C3-DevKitC-02. +- `Related Documents`_: Links to related documentation. + +Getting Started +=============== + +This section provides a brief introduction of ESP32-C3-DevKitC-02, instructions on how to do the initial hardware setup and how to flash firmware onto it. + +Description of Components +------------------------- + +.. _user-guide-c3-devkitc-02-v1-board-front: + +.. figure:: ../../../_static/esp32-c3-devkitc-02-v1-annotated-photo.png + :align: center + :alt: ESP32-C3-DevKitC-02 - front + :figclass: align-center + + ESP32-C3-DevKitC-02 - front + +.. list-table:: + :widths: 30 70 + :header-rows: 1 + + * - Key Component + - Description + * - ESP32-C3-WROOM-02 + - ESP32-C3-WROOM-02 from Espressif is a powerful and general-purpose module that offers Wi-Fi and Bluetooth LE coexistence. It has a PCB antenna and a 4 MB SPI flash. + * - 5 V to 3.3 V LDO + - Power regulator that converts a 5 V supply into a 3.3 V output. + * - 5 V Power On LED + - Turns on when the USB power is connected to the board. + * - I/O Connector + - All available GPIO pins (except for the SPI bus for flash) are broken out to the pin headers on the board. For details, please see :ref:`user-guide-c3-devkitc-02-v1-header-blocks`. + * - Boot Button + - Download button. Holding down **Boot** and then pressing **Reset** initiates Firmware Download mode for downloading firmware through the serial port. + * - Micro-USB Port + - USB interface. Power supply for the board as well as the communication interface between a computer and the ESP32-C3 chip. + * - Reset Button + - Press this button to restart the system. + * - USB-to-UART Bridge + - Single USB-to-UART bridge chip provides transfer rates up to 3 Mbps. + * - RGB LED + - Addressable RGB LED, driven by GPIO8. + + +Start Application Development +----------------------------- + +Before powering up your ESP32-C3-DevKitC-02, please make sure that it is in good condition with no obvious signs of damage. + +Required Hardware +^^^^^^^^^^^^^^^^^ + +- ESP32-C3-DevKitC-02 +- USB 2.0 cable (Standard-A to Micro-B) +- Computer running Windows, Linux, or macOS + +.. note:: + + Be sure to use a good quality USB cable. Some cables are for charging only and do not provide the needed data lines nor work for programming the boards. + +Software Setup +^^^^^^^^^^^^^^ + +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 into your ESP32-C3-DevKitC-02. + +Contents and Packaging +---------------------- + +Retail orders +^^^^^^^^^^^^^ + +If you order a few samples, each ESP32-C3-DevKitC-02 comes in an individual package in either antistatic bag or any packaging depending on your retailer. + +For retail orders, please go to https://www.espressif.com/en/company/contact/buy-a-sample. + + +Wholesale Orders +^^^^^^^^^^^^^^^^ + +If you order in bulk, the boards come in large cardboard boxes. + +For wholesale orders, please check `Espressif Product Ordering Information `_ (PDF) + +Hardware Reference +================== + +Block Diagram +------------- + +The block diagram below shows the components of ESP32-C3-DevKitC-02 and their interconnections. + +.. figure:: ../../../_static/esp32-c3-devkitc-02-v1-block-diags.png + :align: center + :scale: 70% + :alt: ESP32-C3-DevKitC-02 (click to enlarge) + :figclass: align-center + + ESP32-C3-DevKitC-02 (click to enlarge) + +Power Supply Options +^^^^^^^^^^^^^^^^^^^^ + +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 + +It is recommended to use the first option: micro USB port. + +.. _user-guide-c3-devkitc-02-v1-header-blocks: + +Header Block +------------ + +The two tables below provide the **Name** and **Function** of I/O header pins on both sides of the board, as shown in :ref:`user-guide-c3-devkitc-02-v1-board-front`. The numbering and names are the same as in the `ESP32-C3-DevKitC-02 Schematic `_ (PDF). + +J1 +^^^ +=== ==== ========== =================================== +No. Name Type [#]_ Function +=== ==== ========== =================================== +1 G G Ground +2 3V3 P 3.3 V power supply +3 3V3 P 3.3 V power supply +4 RST I CHIP_PU +5 G G Ground +6 4 I/O/T GPIO4, ADC1_CH4, FSPIHD, MTMS +7 5 I/O/T GPIO5, ADC2_CH0, FSPIWP, MTDI +8 6 I/O/T GPIO6, FSPICLK, MTCK +9 7 I/O/T GPIO7, FSPID, MTDO +10 G G Ground +11 8 I/O/T GPIO8 [#]_ +12 9 I/O/T GPIO9 +13 5V P 5 V power supply +14 5V P 5 V power supply +15 G G Ground +=== ==== ========== =================================== + +J3 +^^^ +=== ==== ===== ==================================== +No. Name Type Function +=== ==== ===== ==================================== +1 G G Ground +2 0 I/O/T GPIO0, ADC1_CH0, XTAL_32K_P +3 1 I/O/T GPIO1, ADC1_CH1, XTAL_32K_N +4 2 I/O/T GPIO2, ADC1_CH2, FSPIQ +5 3 I/O/T GPIO3, ADC1_CH3 +6 G G Ground +7 10 I/O/T GPIO10, FSPICS0 +8 G G Ground +9 RX I/O/T GPIO20, U0RXD +10 TX I/O/T GPIO21, U0TXD +11 G G Ground +12 18 I/O/T GPIO18 +13 19 I/O/T GPIO19 +14 G G Ground +15 G G Ground +=== ==== ===== ==================================== + +.. [#] P: Power supply; I: Input; O: Output; T: High impedance. +.. [#] Used to drive the RGB LED. + +Pin Layout +^^^^^^^^^^^ +.. figure:: ../../../_static/esp32-c3-devkitc-02-v1-pinout.png + :align: center + :alt: ESP32-C3-DevKitC-02 + :figclass: align-center + + ESP32-C3-DevKitC-02 Pin Layout + +Hardware Revision Details +========================= + +No previous versions available. + +Related Documents +================= +* `ESP32-C3 Datasheet `_ (PDF) +* `ESP32-C3-WROOM-02 Datasheet `_ (PDF) +* `ESP32-C3-DevKitC-02 Schematic `_ (PDF) +* `ESP32-C3-DevKitC-02 PCB Layout `_ (PDF) +* `ESP32-C3-DevKitC-02 Dimensions `_ (PDF) +* `ESP32-C3-DevKitC-02 Dimensions source file `_ (DXF) - You can view it with `Autodesk Viewer `_ online + +For further design documentation for the board, please contact us at `sales@espressif.com `_. diff --git a/docs/zh_CN/get-started/index.rst b/docs/zh_CN/get-started/index.rst index 8823c73f63..583f223460 100644 --- a/docs/zh_CN/get-started/index.rst +++ b/docs/zh_CN/get-started/index.rst @@ -118,6 +118,7 @@ :maxdepth: 1 ESP32-C3-DevKitM-1 <../hw-reference/esp32c3/user-guide-devkitm-1> + ESP32-C3-DevKitC-02 <../hw-reference/esp32c3/user-guide-devkitc-02> .. _get-started-step-by-step: diff --git a/docs/zh_CN/hw-reference/esp32c3/user-guide-devkitc-02.rst b/docs/zh_CN/hw-reference/esp32c3/user-guide-devkitc-02.rst new file mode 100644 index 0000000000..42d4430a9c --- /dev/null +++ b/docs/zh_CN/hw-reference/esp32c3/user-guide-devkitc-02.rst @@ -0,0 +1,212 @@ +=================== +ESP32-C3-DevKitC-02 +=================== + +:link_to_translation:`en: [English]` + +本指南将帮助您快速上手 ESP32-C3-DevKitC-02，并提供该款开发板的详细信息。 + +ESP32-C3-DevKitC-02 是一款入门级开发板，使用以尺寸小而得名的 `ESP32-C3-WROOM-02 `_ 模组。该款开发板具备完整的 Wi-Fi 和低功耗蓝牙功能。 + +板上模组大部分管脚均已引出至两侧排针，开发人员可根据实际需求，轻松通过跳线连接多种外围设备，同时也可将开发板插在面包板上使用。 + +.. figure:: ../../../_static/esp32-c3-devkitc-02-v1-isometric.png + :align: center + :alt: ESP32-C3-DevKitC-02 + :figclass: align-center + + ESP32-C3-DevKitC-02 + +本指南包括如下内容： + +- `入门指南`_：简要介绍了 ESP32-C3-DevKitC-02 和硬件、软件设置指南。 +- `硬件参考`_：详细介绍了 ESP32-C3-DevKitC-02 的硬件。 +- `硬件版本`_：介绍硬件历史版本和已知问题，并提供链接至历史版本开发板的入门指南（如有）。 +- `相关文档`_：列出了相关文档的链接。 + +入门指南 +======== + +本小节将简要介绍 ESP32-C3-DevKitC-02，说明如何在 ESP32-C3-DevKitC-02 上烧录固件及相关准备工作。 + +组件介绍 +-------- + +.. _user-guide-c3-devkitc-02-v1-board-front: + +.. figure:: ../../../_static/esp32-c3-devkitc-02-v1-annotated-photo.png + :align: center + :alt: ESP32-C3-DevKitC-02 - 正面 + :figclass: align-center + + ESP32-C3-DevKitC-02 - 正面 + +.. list-table:: + :widths: 30 70 + :header-rows: 1 + + * - 主要组件 + - 介绍 + * - ESP32-C3-WROOM-02 + - ESP32-C3-WROOM-02 是乐鑫推出的一款通用型 Wi-Fi 和低功耗蓝牙双模模组，功能强大。该模组采用 PCB 板载天线，配置了 4 MB SPI flash。 + * - 5 V 转 3.3 V LDO + - 电源转换器，输入 5 V，输出 3.3 V。 + * - 5 V 电源指示灯 + - 开发板连接 USB 电源后，该指示灯亮起。 + * - I/O 连接器 + - 所有可用 GPIO 管脚（除 Flash 的 SPI 总线）均已引出至开发板的排针。请查看 :ref:`user-guide-c3-devkitc-02-v1-header-blocks` 获取更多信息。 + * - Boot 键。 + - 下载按键。按住 **Boot** 键的同时按一下 **Reset** 键进入“固件下载”模式，通过串口下载固件。 + * - Micro-USB 接口 + - USB 接口。可用作开发板的供电电源或 PC 和 ESP32-C3 芯片的通信接口。 + * - Reset 键。 + - 复位按键。 + * - USB 至 UART 桥接器 + - 单芯片 USB 至 UART 桥接器，可提供高达 3 Mbps 的传输速率。 + * - RGB LED + - 可寻址 RGB 发光二极管，由 GPIO8 驱动。 + +开始开发应用 +------------ + +通电前，请确保 ESP32-C3-DevKitC-02 完好无损。 + +必备硬件 +^^^^^^^^ + +- ESP32-C3-DevKitC-02 +- USB 2.0 数据线（标准 A 型转 Micro-B型） +- 电脑 （Windows、Linux 或 macOS） + +.. 注解:: + + 请确保使用优质 USB 数据线。部分数据线仅可用于充电，无法用于数据传输和编程。 + +软件设置 +^^^^^^^^ + +请前往 :doc:`../../get-started/index`，在 :ref:`get-started-step-by-step` 小节查看如何快速设置开发环境，将应用程序烧录至 ESP32-C3-DevKitC-02。 + +内含组件和包装 +-------------- + +零售订单 +^^^^^^^^ + +如购买样品，每个 ESP32-C3-DevKitC-02 底板将以防静电袋或零售商选择的其他方式包装。 + +零售订单请前往 https://www.espressif.com/zh-hans/company/contact/buy-a-sample。 + +批量订单 +^^^^^^^^ + +如批量购买，ESP32-C3-DevKitC-02 烧录底板将以大纸板箱包装。 + +批量订单请参考 `乐鑫产品订购信息 `__ (PDF)。 + +硬件参考 +======== + +功能框图 +-------- + +ESP32-C3-DevKitC-02 的主要组件和连接方式如下图所示。 + +.. figure:: ../../../_static/esp32-c3-devkitc-02-v1-block-diags.png + :align: center + :scale: 70% + :alt: ESP32-C3-DevKitC-02 （点击放大） + :figclass: align-center + + ESP32-C3-DevKitC-02 （点击放大） + +电源选项 +^^^^^^^^ + +您可从以下三种供电方式中任选其一给 ESP32-C3-DevKitC-02 供电： + +- Micro USB 接口供电（默认） +- 5V 和 GND 管脚供电 +- 3V3 和 GND 管脚供电 + +建议选择第一种供电方式：Micro USB 接口供电。 + +.. _user-guide-c3-devkitc-02-v1-header-blocks: + +排针 +---- + +下表列出了开发板两侧排针的 **名称** 和 **功能**，开发板排针图可前往 :ref:`user-guide-c3-devkitc-02-v1-board-front` 查看。表格中的序号和名称与 `ESP32-C3-DevKitC-02 原理图 `_ (PDF)一致。 + +J1 +^^^ +==== ==== ========== ================================ +序号 名称 类型 [#]_ 功能 +==== ==== ========== ================================ +1 G G 接地 +2 3V3 P 3.3 V 电源 +3 3V3 P 3.3 V 电源 +4 RST I CHIP_PU +5 G G 接地 +6 4 I/O/T GPIO4, ADC1_CH4, FSPIHD, MTMS +7 5 I/O/T GPIO5, ADC2_CH0, FSPIWP, MTDI +8 6 I/O/T GPIO6, FSPICLK, MTCK +9 7 I/O/T GPIO7, FSPID, MTDO +10 G G 接地 +11 8 I/O/T GPIO8 [#]_ +12 9 I/O/T GPIO9 +13 5V P 5 V 电源 +14 5V P 5 V 电源 +15 G G 接地 +==== ==== ========== ================================ + +J3 +^^^ +==== ==== ========== ================================ +序号 名称 类型 功能 +==== ==== ========== ================================ +1 G G 接地 +2 0 I/O/T GPIO0, ADC1_CH0, XTAL_32K_P +3 1 I/O/T GPIO1, ADC1_CH1, XTAL_32K_N +4 2 I/O/T GPIO2, ADC1_CH2, FSPIQ +5 3 I/O/T GPIO3, ADC1_CH3 +6 G G 接地 +7 10 I/O/T GPIO10, FSPICS0 +8 G G 接地 +9 RX I/O/T GPIO20, U0RXD +10 TX I/O/T GPIO21, U0TXD +11 G G 接地 +12 18 I/O/T GPIO18 +13 19 I/O/T GPIO19 +14 G G 接地 +15 G G 接地 +==== ==== ========== ================================ + + +.. [#] P：电源；I：输入；O：输出；T：可设置为高阻。 +.. [#] 用于驱动 RGB LED。 + +管脚布局 +^^^^^^^^ +.. figure:: ../../../_static/esp32-c3-devkitc-02-v1-pinout.png + :align: center + :alt: ESP32-C3-DevKitC-02 管脚布局 + :figclass: align-center + + ESP32-C3-DevKitC-02 管脚布局 + +硬件版本 +========== + +该开发板为最新硬件，尚未有历史版本。 + +相关文档 +======== +* `ESP32-C3 技术规格书 `_ (PDF) +* `ESP32-C3-WROOM-02 规格书 `_ (PDF) +* `ESP32-C3-DevKitC-02 原理图 `_ (PDF) +* `ESP32-C3-DevKitC-02 PCB 布局图 `_ (PDF) +* `ESP32-C3-DevKitC-02 尺寸图 `_ (PDF) +* `ESP32-C3-DevKitC-02 尺寸图源文件 `_ (DXF) - 可使用 `Autodesk Viewer `_ 查看 + +有关本开发板的更多设计文档，请联系我们的商务部门 `sales@espressif.com `_。