Support for generic ESP32-C3 boards. More...
Support for generic ESP32-C3 boards.
The Espressif ESP32-C3-DevKit boards are a couple of boards that use one of the following modules:
Since the number of GPIOs and their possible uses on the ESP32-C3 are quite limited, the ESP32-C3-DevKit should also work for most other ESP32-C3 boards. Any modifications required for specific applications could be overridden by application-specific board configuration.
This section describes
Most features of the board are provided by the ESP32-C3 SoC. For detailed information about the ESP32-C3 variant (family) and ESP32x SoCs, see section ESP32 SoC Series.
ESP32-C3-DevKit boards have no special hardware on board with the exception of a single pin RGB-LED that uses a special bit-oriented protocol to control the RGB-LED by 24-bit RGB values which is not supported yet.
All GPIOs are simply broken out for flexibility. Therefore, the board configuration is the most flexible one which provides:
Since all GPIOs have broken out, GPIOs can be used for different purposes in different applications. For flexibility, GPIOs can be listed in multiple peripheral configurations, but they can only be used for one peripheral at a time. For example, GPIO4 is used in the ADC channel definition, the PWM channel definition and the definition of the SCL signal for I2C_DEV(0).
This is possible because GPIOs are only used for a specific peripheral interface when either
That is, the purpose for which a GPIO is used depends on which module or function is used first.
For example, if module
periph_i2c is not used, the GPIOs listed in I2C configuration can be used for the other purposes, that is, GPIO4 can be used as ADC channel or PWM channel.
The following table shows the default board configuration, which is sorted according to the defined functionality of GPIOs. This configuration can be overridden by application-specific configurations.
|ADC||GPIO0, GPIO1, GPIO2, GPIO3, GPIO4, GPIO5||see ADC Channels|
|PWM_DEV(0)||GPIO3, GPIO4||-||PWM Channels|
|SPI_DEV(0):CLK||GPIO6||SPI2_HOST (FSPI) is used||SPI Interfaces|
|SPI_DEV(0):MISO||GPIO2||SPI2_HOST (FSPI) is used||SPI Interfaces|
|SPI_DEV(0):MOSI||GPIO7||SPI2_HOST (FSPI) is used||SPI Interfaces|
|SPI_DEV(0):CS0||GPIO10||SPI2_HOST (FSPI) is used||SPI Interfaces|
|UART_DEV(0):TxD||GPIO21||Console (configuration is fixed)||UART interfaces|
|UART_DEV(0):RxD||GPIO20||Console (configuration is fixed)||UART interfaces|
For detailed information about the peripheral configurations of ESP32-C3 boards, see section Common Peripherals.
The following figures show the pinouts as configured by default board definition.
The corresponding board schematics can be found:
Flashing RIOT is quite easy. The board has a Micro-USB connector with reset/boot/flash logic. Just connect the board to your host computer and type using the programming port:
For detailed information about ESP32-C3 as well as configuring and compiling RIOT for ESP32-C3 boards, see RIOT-OS on ESP32 SoC Series Boards.
|Board specific configuration for the Arduino API. |
|Mapping from MCU pins to Arduino pins. |
|Board definitions for ESP32-C3-DevKit boards. |
|Board specific configuration of direct mapped GPIOs. |
|Peripheral configurations for ESP32-C3-DevKit boards. |