Support for generic ESP32-C3 boards. More...
Support for generic ESP32-C3 boards.
The Wemos ESP32-C3 mini board is an interesting development kit as it uses in the stackable Wemos LOLIN D1 Mini format. Thus, all shields for Wemos D1 mini for ESP8266 can also be used with ESP32-C3. Examples for such shields are:
This makes it possible to create different hardware configurations without the need for a soldering iron or a breadboard.
This stackable platform was tested in an RIOT application with:
This application is a good example how easy it is with this board to create different hardware applications.
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.
The Wemos ESP32-C3 mini board has no special hardware on board with the exception of a single pin RGB-LED.
There are two board versions available on the market with a different pinout of the ADC channels and the SPI interface. Which version is used is determined by activating a pseudo module for the corresponding version:
To specify which board version is used, simply add the variable definition
USEMODULE=... to the make command line, for example:
If the board version is not specified, version v2.1.0 is used by default.
Almost all GPIOs are broken out and can be used for different peripherals:
However, since the number of GPIOs of the ESP32-C3 SoC is very limited, some GPIOs are used in multiple peripheral configurations but can only be used for one peripheral at a time. For example, GPIO4 is used in the ADC channel configuration and in the MOSI signal configuration for SPI_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_spi is not used, the GPIOs listed in SPI configuration can be used for other purposes, that is, GPIO4 can be used as ADC channel.
The following table shows the default board configuration depending on used board version, which is sorted according to the defined functionality of GPIOs. This configuration can be overridden by application-specific configurations.
|ADC||GPIO0 ... GPIO5||GPIO0 ... GPIO5||see ADC Channels|
|PWM_DEV(0)||GPIO1, GPIO6, GPIO7||GPIO2, GPIO6||PWM Channels|
|RGB-LED||-||GPIO7||supported by driver module |
|SPI_DEV(0):CLK||GPIO2||GPIO1||SPI2_HOST (FSPI) is used||SPI Interfaces|
|SPI_DEV(0):MISO||GPIO3||GPIO0||SPI2_HOST (FSPI) is used||SPI Interfaces|
|SPI_DEV(0):MOSI||GPIO4||GPIO4||SPI2_HOST (FSPI) is used||SPI Interfaces|
|SPI_DEV(0):CS0||GPIO5||GPIO5||SPI2_HOST (FSPI) is used||SPI Interfaces|
|UART_DEV(0):TxD||GPIO21||GPIO21||Console (configuration is fixed)||UART interfaces|
|UART_DEV(0):RxD||GPIO20||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:
The USB-C connector of the board is directly connected to the USB Serial/JTAG interface of the ESP32-C3 SoC. It can be used to program the board and to debug the application. Just connect the board to your host computer and use the following command:
The make system will resets the board to restart the board into download mode. In some special cases this reset does not work so that the programmer cannot connect to the board and the flashing is aborted with a timeout:
In this case, restart the board manually in download mode by pressing and releasing the RESET button while holding down the BOOT button.
After flashing the board, it will still be in download mode. You have to press the reset button (RST) to start your application.
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.
|Mapping from MCU pins to Arduino pins. |
|Board definitions for the Wemos ESP32-C3 mini board. |
|Board specific configuration of direct mapped GPIOs. |
|Peripheral configurations for the Wemos ESP32-C3 mini board. |