mirror of
https://github.com/RIOT-OS/RIOT.git
synced 2025-12-16 18:13:49 +01:00
boards/seeedstudio-xiao-esp32c3: add support
Port the Seeed Studio Xiao ESP32C3 to RIOT.
This commit is contained in:
David Picard
parent
685acb9a35
commit
daf854b89a
16
boards/seeedstudio-xiao-esp32c3/Kconfig
Normal file
16
boards/seeedstudio-xiao-esp32c3/Kconfig
Normal file
@ -0,0 +1,16 @@
|
|||||||
|
# Copyright (c) 2025 David Picard
|
||||||
|
#
|
||||||
|
# This file is subject to the terms and conditions of the GNU Lesser
|
||||||
|
# General Public License v2.1. See the file LICENSE in the top level
|
||||||
|
# directory for more details.
|
||||||
|
|
||||||
|
config BOARD
|
||||||
|
default "seeedstudio-xiao-esp32c3" if BOARD_SEEEDSTUDIO_XIAO_ESP32C3
|
||||||
|
|
||||||
|
config BOARD_SEEEDSTUDIO_XIAO_ESP32C3
|
||||||
|
bool
|
||||||
|
default y
|
||||||
|
select BOARD_COMMON_ESP32C3
|
||||||
|
select CPU_MODEL_ESP32C3_FH4
|
||||||
|
|
||||||
|
source "$(RIOTBOARD)/common/esp32c3/Kconfig"
|
||||||
5
boards/seeedstudio-xiao-esp32c3/Makefile
Normal file
5
boards/seeedstudio-xiao-esp32c3/Makefile
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
MODULE = board
|
||||||
|
|
||||||
|
DIRS = $(RIOTBOARD)/common/esp32c3
|
||||||
|
|
||||||
|
include $(RIOTBASE)/Makefile.base
|
||||||
9
boards/seeedstudio-xiao-esp32c3/Makefile.dep
Normal file
9
boards/seeedstudio-xiao-esp32c3/Makefile.dep
Normal file
@ -0,0 +1,9 @@
|
|||||||
|
ifeq (,$(filter stdio_% slipdev_stdio,$(USEMODULE)))
|
||||||
|
USEMODULE += stdio_usb_serial_jtag
|
||||||
|
endif
|
||||||
|
|
||||||
|
ifneq (,$(filter saul_default,$(USEMODULE)))
|
||||||
|
USEMODULE += saul_gpio
|
||||||
|
endif
|
||||||
|
|
||||||
|
include $(RIOTBOARD)/common/esp32c3/Makefile.dep
|
||||||
17
boards/seeedstudio-xiao-esp32c3/Makefile.features
Normal file
17
boards/seeedstudio-xiao-esp32c3/Makefile.features
Normal file
@ -0,0 +1,17 @@
|
|||||||
|
CPU_MODEL = esp32c3_fh4
|
||||||
|
|
||||||
|
# common board and CPU features
|
||||||
|
include $(RIOTBOARD)/common/esp32c3/Makefile.features
|
||||||
|
|
||||||
|
# additional features provided by the board
|
||||||
|
FEATURES_PROVIDED += periph_adc
|
||||||
|
FEATURES_PROVIDED += periph_i2c
|
||||||
|
FEATURES_PROVIDED += periph_pwm
|
||||||
|
FEATURES_PROVIDED += periph_spi
|
||||||
|
|
||||||
|
# unique features provided by the board
|
||||||
|
FEATURES_PROVIDED += esp_jtag
|
||||||
|
|
||||||
|
# Various other features (if any)
|
||||||
|
FEATURES_PROVIDED += arduino_pins
|
||||||
|
FEATURES_PROVIDED += xiao_shield
|
||||||
3
boards/seeedstudio-xiao-esp32c3/Makefile.include
Normal file
3
boards/seeedstudio-xiao-esp32c3/Makefile.include
Normal file
@ -0,0 +1,3 @@
|
|||||||
|
PORT_LINUX ?= /dev/ttyACM0
|
||||||
|
|
||||||
|
include $(RIOTBOARD)/common/esp32c3/Makefile.include
|
||||||
164
boards/seeedstudio-xiao-esp32c3/doc.md
Normal file
164
boards/seeedstudio-xiao-esp32c3/doc.md
Normal file
@ -0,0 +1,164 @@
|
|||||||
|
<!--
|
||||||
|
Copyright (C) 2025 David Picard
|
||||||
|
|
||||||
|
This file is subject to the terms and conditions of the GNU Lesser
|
||||||
|
General Public License v2.1. See the file LICENSE in the top level
|
||||||
|
directory for more details.
|
||||||
|
-->
|
||||||
|
|
||||||
|
@defgroup boards_seeedstudio-xiao-esp32c3 Seeed Studio Xiao ESP32C3
|
||||||
|
@ingroup boards_esp32c3
|
||||||
|
@brief Support for the Seeed Studio Xiao ESP32-C3 board
|
||||||
|
@author David Picard
|
||||||
|
|
||||||
|
\section seeedstudio-xiao-esp32c3 Seeed Studio Xiao ESP32C3
|
||||||
|
|
||||||
|
## Table of Contents {#seeedstudio-xiao-esp32c3_toc}
|
||||||
|
|
||||||
|
1. [Overview](#seeedstudio-xiao-esp32c3_overview)
|
||||||
|
2. [Hardware](#seeedstudio-xiao-esp32c3_hardware)
|
||||||
|
1. [MCU](#seeedstudio-xiao-esp32c3_mcu)
|
||||||
|
2. [Board Configuration](#seeedstudio-xiao-esp32c3_board_configuration)
|
||||||
|
3. [Board Pinout](#seeedstudio-xiao-esp32c3_pinout)
|
||||||
|
4. [Board documentation](#seeedstudio-xiao-esp32c3_documentation)
|
||||||
|
3. [Flashing the Device](#seeedstudio-xiao-esp32c3_flashing)
|
||||||
|
|
||||||
|
## Overview {#seeedstudio-xiao-esp32c3_overview}
|
||||||
|
|
||||||
|
Seeed Studio Xiao ESP32C3 is an IoT mini development board based on the Espressif ESP32-C3
|
||||||
|
WiFi/Bluetooth dual-mode chip, featuring a single core 32-bit RISC-V CPU that operates at up to 160 MHz.
|
||||||
|
|
||||||
|
- Wi-Fi
|
||||||
|
- Bluetooth
|
||||||
|
- Battery charging chip: Supports lithium battery charge and discharge management
|
||||||
|
- Memory: 400KB of SRAM, and 4MB of on-board flash memory
|
||||||
|
- Small size: 21 x 17.8mm
|
||||||
|
- Ultra-Low Power: Deep sleep power consumption is about 43μA
|
||||||
|
- Battery charge indicator red LED
|
||||||
|
|
||||||
|
@image html https://files.seeedstudio.com/wiki/XIAO_WiFi/board-pic.png "Seeed Studio EPS32-C3 Xiao" width=200pix
|
||||||
|
|
||||||
|
[Back to table of contents](#seeedstudio-xiao-esp32c3_toc)
|
||||||
|
|
||||||
|
## Hardware {#seeedstudio-xiao-esp32c3_hardware}
|
||||||
|
|
||||||
|
This section describes
|
||||||
|
|
||||||
|
- the [MCU](#seeedstudio-xiao-esp32c3_mcu),
|
||||||
|
- the default [board configuration](#seeedstudio-xiao-esp32c3_board_configuration),
|
||||||
|
- the [board pinout](#seeedstudio-xiao-esp32c3_pinout).
|
||||||
|
|
||||||
|
[Back to table of contents](#seeedstudio-xiao-esp32c3_toc)
|
||||||
|
|
||||||
|
### MCU {#seeedstudio-xiao-esp32c3_mcu}
|
||||||
|
|
||||||
|
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 \ref esp32_mcu_esp32 "ESP32 SoC Series".
|
||||||
|
|
||||||
|
[Back to table of contents](#seeedstudio-xiao-esp32c3_toc)
|
||||||
|
|
||||||
|
### Board Configuration {#seeedstudio-xiao-esp32c3_board_configuration}
|
||||||
|
|
||||||
|
The Seeed Studio EPS32-C3 Xiao board has a reset button and a bootloader button,
|
||||||
|
but no LED.
|
||||||
|
After reset, the bootloader button may be used by the application.
|
||||||
|
|
||||||
|
To select the board, add the following to the make command line:
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
BOARD=seeedstudio-xiao-esp32c3 make ...
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
GPIO overview:
|
||||||
|
- 3 x ADC channels at maximum
|
||||||
|
- 1 x SPI
|
||||||
|
- 1 x I2C
|
||||||
|
- 1 x UART
|
||||||
|
- 11 x PWM channels (only 4 defined by default)
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
The following table shows the default board configuration.
|
||||||
|
This configuration can be overridden by \ref esp32_application_specific_configurations
|
||||||
|
"application-specific configurations".
|
||||||
|
|
||||||
|
<center>
|
||||||
|
Function | Pin | Configuration
|
||||||
|
:---------------|:----------------------|:-------------
|
||||||
|
BUTTON0 | GPIO9 | GPIO9 is a [strapping pin](https://docs.espressif.com/projects/esptool/en/latest/esp32c3/advanced-topics/boot-mode-selection.html)
|
||||||
|
ADC | GPIO2, GPIO3, GPIO4 | \ref esp32_adc_channels "ADC Channels"
|
||||||
|
I2C_DEV(0):SCL | GPIO7 | \ref esp32_i2c_interfaces "I2C Interfaces"
|
||||||
|
I2C_DEV(0):SDA | GPIO6 | \ref esp32_i2c_interfaces "I2C Interfaces"
|
||||||
|
PWM_DEV(0) | GPIO2, GPIO3, GPIO4, GPIO5 | \ref esp32_pwm_channels "PWM Channels"
|
||||||
|
SPI_DEV(0):SCK | GPIO8 | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||||
|
SPI_DEV(0):MISO | GPIO9 | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||||
|
SPI_DEV(0):MOSI | GPIO10 | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||||
|
SPI_DEV(0):CS0 | GPIO5 | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||||
|
UART_DEV(0):TxD | GPIO21 | \ref esp32_uart_interfaces "UART interfaces"
|
||||||
|
UART_DEV(0):RxD | GPIO20 | \ref esp32_uart_interfaces "UART interfaces"
|
||||||
|
</center>
|
||||||
|
\n
|
||||||
|
@note The configuration of ADC channels contains all ESP32-C3 GPIOs that could
|
||||||
|
be used as ADC channels.
|
||||||
|
|
||||||
|
For detailed information about the peripheral configurations of ESP32-C3
|
||||||
|
boards, see section \ref esp32_peripherals "Common Peripherals".
|
||||||
|
|
||||||
|
[Back to table of contents](#seeedstudio-xiao-esp32c3_toc)
|
||||||
|
|
||||||
|
### Board Pinout {#seeedstudio-xiao-esp32c3_pinout}
|
||||||
|
|
||||||
|
The following figures show the pinouts as configured by default board
|
||||||
|
definition.
|
||||||
|
|
||||||
|
@image html https://files.seeedstudio.com/wiki/XIAO_WiFi/pin_map-2.png "Seeed Studio EPS32-C3 Xiao Pinout" width=800
|
||||||
|
|
||||||
|
[Back to table of contents](#seeedstudio-xiao-esp32c3_toc)
|
||||||
|
|
||||||
|
### Board documentation {#seeedstudio-xiao-esp32c3_documentation}
|
||||||
|
|
||||||
|
- [schematic](https://files.seeedstudio.com/wiki/XIAO_WiFi/Resources/Seeeduino-XIAO-ESP32C3-SCH.pdf) (PDF)
|
||||||
|
- [pinout](https://files.seeedstudio.com/wiki/XIAO_WiFi/Resources/XIAO-ESP32C3-pinout_sheet.xlsx) (XLSX)
|
||||||
|
- [ESP32-C3 datasheet](https://files.seeedstudio.com/wiki/Seeed-Studio-XIAO-ESP32/esp32-c3_datasheet.pdf) (PDF)
|
||||||
|
- [ESP32-C3 Technical Reference Manual](https://www.espressif.com/sites/default/files/documentation/esp32-c3_technical_reference_manual_en.pdf) (PDF)
|
||||||
|
- [power consumption report](https://files.seeedstudio.com/wiki/Seeed-Studio-XIAO-ESP32/Low_Power_Consumption.pdf) (PDF)
|
||||||
|
- [product page](https://www.seeedstudio.com/Seeed-XIAO-ESP32C3-p-5431.html?qid=eyJjX3NlYXJjaF9xdWVyeSI6InhpYW8gZXNwMzJjMyIsImNfc2VhcmNoX3Jlc3VsdF9wb3MiOjQsImNfdG90YWxfcmVzdWx0cyI6ODcsImNfc2VhcmNoX3Jlc3VsdF90eXBlIjoiUHJvZHVjdCIsImNfc2VhcmNoX2ZpbHRlcnMiOiJzdG9yZUNvZGU6W3JldGFpbGVyXSJ9)
|
||||||
|
- [wiki page](https://wiki.seeedstudio.com/XIAO_ESP32C3_Getting_Started/)
|
||||||
|
|
||||||
|
[Back to table of contents](#seeedstudio-xiao-esp32c3_toc)
|
||||||
|
|
||||||
|
## Flashing the Device {#seeedstudio-xiao-esp32c3_flashing}
|
||||||
|
|
||||||
|
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:
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
make flash BOARD=seeedstudio-xiao-esp32c3 ...
|
||||||
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
|
||||||
|
The make utility will normally restart the board in download mode in order
|
||||||
|
to flash it.
|
||||||
|
But, on occasion, this reset doesn't work.
|
||||||
|
The programmer can't connect to the board and the flashing operation is
|
||||||
|
aborted with a timeout error:
|
||||||
|
```
|
||||||
|
Serial port /dev/ttyACM0
|
||||||
|
Connecting...
|
||||||
|
...
|
||||||
|
serial.serialutil.SerialTimeoutException: Write timeout
|
||||||
|
```
|
||||||
|
In this situation, restart the board manually in download mode:
|
||||||
|
1. hold down the BOOT button
|
||||||
|
2. press and release the RESET button
|
||||||
|
3. release the BOOT button.
|
||||||
|
|
||||||
|
After flashing the board, it will still be in download mode. You have to press
|
||||||
|
the RESET button to start your application.
|
||||||
|
|
||||||
|
For detailed information about ESP32-C3 as well as configuring and compiling
|
||||||
|
RIOT for ESP32-C3 boards, see \ref esp32_riot.
|
||||||
|
|
||||||
|
[Back to table of contents](#seeedstudio-xiao-esp32c3_toc)
|
||||||
62
boards/seeedstudio-xiao-esp32c3/include/arduino_iomap.h
Normal file
62
boards/seeedstudio-xiao-esp32c3/include/arduino_iomap.h
Normal file
@ -0,0 +1,62 @@
|
|||||||
|
/*
|
||||||
|
* Copyright (C) 2025 David Picard
|
||||||
|
*
|
||||||
|
* This file is subject to the terms and conditions of the GNU Lesser
|
||||||
|
* General Public License v2.1. See the file LICENSE in the top level
|
||||||
|
* directory for more details.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup boards_seeedstudio-xiao-esp32c3
|
||||||
|
* @{
|
||||||
|
*
|
||||||
|
* @file
|
||||||
|
* @brief Mapping from MCU pins to Arduino pins
|
||||||
|
*
|
||||||
|
* @author David Picard
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifndef ARDUINO_IOMAP_H
|
||||||
|
#define ARDUINO_IOMAP_H
|
||||||
|
|
||||||
|
#include "periph/gpio.h"
|
||||||
|
#include "periph/adc.h"
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @name Mapping of MCU pins to Arduino pins
|
||||||
|
* @{
|
||||||
|
*/
|
||||||
|
#define ARDUINO_PIN_0 GPIO2 /**< Arduino pin 0 */
|
||||||
|
#define ARDUINO_PIN_1 GPIO3 /**< Arduino pin 1 */
|
||||||
|
#define ARDUINO_PIN_2 GPIO4 /**< Arduino pin 2 */
|
||||||
|
#define ARDUINO_PIN_3 GPIO5 /**< Arduino pin 3 */
|
||||||
|
#define ARDUINO_PIN_4 GPIO6 /**< Arduino pin 4 (I2C SDA) */
|
||||||
|
#define ARDUINO_PIN_5 GPIO7 /**< Arduino pin 5 (I2C SCL) */
|
||||||
|
#define ARDUINO_PIN_6 GPIO21 /**< Arduino pin 1 (TxD) */
|
||||||
|
#define ARDUINO_PIN_7 GPIO20 /**< Arduino pin 0 (RxD) */
|
||||||
|
#define ARDUINO_PIN_8 GPIO8 /**< Arduino pin 8 (SPI SCK) */
|
||||||
|
#define ARDUINO_PIN_9 GPIO9 /**< Arduino pin 0 (SPI MISO)*/
|
||||||
|
#define ARDUINO_PIN_10 GPIO10 /**< Arduino pin 0 (SPI MOSI) */
|
||||||
|
|
||||||
|
#define ARDUINO_PIN_LAST 10
|
||||||
|
/** @} */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @name Aliases for analog pins
|
||||||
|
* @{
|
||||||
|
*/
|
||||||
|
#define ARDUINO_PIN_A0 ARDUINO_PIN_0
|
||||||
|
#define ARDUINO_PIN_A1 ARDUINO_PIN_1
|
||||||
|
#define ARDUINO_PIN_A2 ARDUINO_PIN_2
|
||||||
|
/** @} */
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif /* ARDUINO_IOMAP_H */
|
||||||
|
/** @} */
|
||||||
75
boards/seeedstudio-xiao-esp32c3/include/board.h
Normal file
75
boards/seeedstudio-xiao-esp32c3/include/board.h
Normal file
@ -0,0 +1,75 @@
|
|||||||
|
/*
|
||||||
|
* Copyright (C) 2025 David Picard
|
||||||
|
*
|
||||||
|
* This file is subject to the terms and conditions of the GNU Lesser
|
||||||
|
* General Public License v2.1. See the file LICENSE in the top level
|
||||||
|
* directory for more details.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup boards_seeedstudio-xiao-esp32c3
|
||||||
|
* @brief Board definitions for the Seeed Studio Xiao ESP32-C3 board
|
||||||
|
* @{
|
||||||
|
*
|
||||||
|
* @file board.h
|
||||||
|
* @author David Picard
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifndef BOARD_H
|
||||||
|
#define BOARD_H
|
||||||
|
|
||||||
|
#include <stdint.h>
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @name Button pin definitions
|
||||||
|
* @{
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Default button GPIO pin definition
|
||||||
|
*
|
||||||
|
* Pressing the button will give a low signal.
|
||||||
|
*
|
||||||
|
* @note GPIO9 is a strapping pin that must be pulled up a boot time
|
||||||
|
* in order to boot the user application.
|
||||||
|
* After boot, it can be used as user button.
|
||||||
|
*/
|
||||||
|
#define BTN0_PIN GPIO9
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Default button GPIO mode definition
|
||||||
|
*
|
||||||
|
* The pîn is actually pulled up by an external resistor on the board.
|
||||||
|
* As a consequence, the pin mode should be #GPIO_IN.
|
||||||
|
* The internal pull-up resistor is not enabled on purpose
|
||||||
|
* because it would decrease the total pull-up resistor value.
|
||||||
|
*/
|
||||||
|
#define BTN0_MODE GPIO_IN
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Default interrupt flank definition for the button GPIO
|
||||||
|
*/
|
||||||
|
#ifndef BTN0_INT_FLANK
|
||||||
|
#define BTN0_INT_FLANK GPIO_FALLING
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Definition for compatibility with previous versions
|
||||||
|
*/
|
||||||
|
#define BUTTON0_PIN BTN0_PIN
|
||||||
|
|
||||||
|
/** @} */
|
||||||
|
|
||||||
|
/* include common board definitions as last step */
|
||||||
|
#include "board_common.h"
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
} /* end extern "C" */
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif /* BOARD_H */
|
||||||
|
/** @} */
|
||||||
45
boards/seeedstudio-xiao-esp32c3/include/gpio_params.h
Normal file
45
boards/seeedstudio-xiao-esp32c3/include/gpio_params.h
Normal file
@ -0,0 +1,45 @@
|
|||||||
|
/*
|
||||||
|
* Copyright (C) 2025 David Picard
|
||||||
|
*
|
||||||
|
* This file is subject to the terms and conditions of the GNU Lesser
|
||||||
|
* General Public License v2.1. See the file LICENSE in the top level
|
||||||
|
* directory for more details.
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifndef GPIO_PARAMS_H
|
||||||
|
#define GPIO_PARAMS_H
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup boards_seeedstudio-xiao-esp32c3
|
||||||
|
* @brief Board specific configuration of direct mapped GPIOs
|
||||||
|
* @file
|
||||||
|
* @author David Picard
|
||||||
|
* @{
|
||||||
|
*/
|
||||||
|
|
||||||
|
#include "board.h"
|
||||||
|
#include "saul/periph.h"
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief LED and Button configuration
|
||||||
|
*/
|
||||||
|
static const saul_gpio_params_t saul_gpio_params[] =
|
||||||
|
{
|
||||||
|
{
|
||||||
|
.name = "BOOT",
|
||||||
|
.pin = BTN0_PIN,
|
||||||
|
.mode = BTN0_MODE,
|
||||||
|
.flags = SAUL_GPIO_INVERTED
|
||||||
|
},
|
||||||
|
};
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
}
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#endif /* GPIO_PARAMS_H */
|
||||||
|
/** @} */
|
||||||
158
boards/seeedstudio-xiao-esp32c3/include/periph_conf.h
Normal file
158
boards/seeedstudio-xiao-esp32c3/include/periph_conf.h
Normal file
@ -0,0 +1,158 @@
|
|||||||
|
/*
|
||||||
|
* Copyright (C) 2025 David Picard
|
||||||
|
*
|
||||||
|
* This file is subject to the terms and conditions of the GNU Lesser
|
||||||
|
* General Public License v2.1. See the file LICENSE in the top level
|
||||||
|
* directory for more details.
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup boards_seeedstudio-xiao-esp32c3
|
||||||
|
* @brief Peripheral configurations for the Seeed Studio ESP32-C3 Xiao board
|
||||||
|
* @{
|
||||||
|
*
|
||||||
|
* For detailed information about the peripheral configuration for ESP32-C3
|
||||||
|
* boards, see section \ref esp32_peripherals "Common Peripherals".
|
||||||
|
*
|
||||||
|
* To specify the board, add the following to the make command line:
|
||||||
|
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
* BOARD=seeedstudio-xiao-esp32c3 make ...
|
||||||
|
* ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
||||||
|
*
|
||||||
|
* @note
|
||||||
|
* Most definitions can be overridden by an \ref esp32_application_specific_configurations
|
||||||
|
* "application-specific board configuration" if necessary.
|
||||||
|
*
|
||||||
|
* @file
|
||||||
|
* @author David Picard
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifndef PERIPH_CONF_H
|
||||||
|
#define PERIPH_CONF_H
|
||||||
|
|
||||||
|
#include <stdint.h>
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
extern "C" {
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @name ADC channel configuration
|
||||||
|
* @{
|
||||||
|
*/
|
||||||
|
/**
|
||||||
|
* @brief Declaration of GPIOs that can be used as ADC channels
|
||||||
|
*
|
||||||
|
* On this board, only three pins can be used as ADC channels.
|
||||||
|
* Note that GPIO5 is linked to ADC2, which _"does not work properly"_,
|
||||||
|
* and therefore can't be used as an ADC channel.
|
||||||
|
*
|
||||||
|
* @note As long as the GPIOs listed in ADC_GPIOS are not initialized as ADC
|
||||||
|
* channels with the `adc_init` function, they can be used for other
|
||||||
|
* purposes.
|
||||||
|
*/
|
||||||
|
#ifndef ADC_GPIOS
|
||||||
|
#define ADC_GPIOS { GPIO2, GPIO3, GPIO4 }
|
||||||
|
#endif
|
||||||
|
/** @} */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @name I2C configuration
|
||||||
|
*
|
||||||
|
* The ESP32C3 has one I2C interface I2C_DEV(0).
|
||||||
|
*
|
||||||
|
* The GPIOs listed in the configuration are only initialized as I2C signals
|
||||||
|
* when module `periph_i2c` is used. Otherwise they are not allocated and
|
||||||
|
* can be used for other purposes.
|
||||||
|
*
|
||||||
|
* @{
|
||||||
|
*/
|
||||||
|
#ifndef I2C0_SPEED
|
||||||
|
#define I2C0_SPEED I2C_SPEED_FAST /**< I2C bus speed of I2C_DEV(0) */
|
||||||
|
#endif
|
||||||
|
#ifndef I2C0_SCL
|
||||||
|
#define I2C0_SCL GPIO7 /**< SCL signal of I2C_DEV(0) */
|
||||||
|
#endif
|
||||||
|
#ifndef I2C0_SDA
|
||||||
|
#define I2C0_SDA GPIO6 /**< SDA signal of I2C_DEV(0) */
|
||||||
|
#endif
|
||||||
|
/** @} */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @name PWM channel configuration
|
||||||
|
*
|
||||||
|
* The ESP32C3 has one LED PWM device.
|
||||||
|
* Pins that are not defined as I2C, SPI or UART are listed
|
||||||
|
* as PWM channels.
|
||||||
|
* Generally, all outputs pins could be used as PWM channels.
|
||||||
|
*
|
||||||
|
* @note As long as the according PWM device is not initialized with
|
||||||
|
* the `pwm_init`, the GPIOs declared for this device can be used
|
||||||
|
* for other purposes.
|
||||||
|
*
|
||||||
|
* @{
|
||||||
|
*/
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @brief Declaration of the channels for device PWM_DEV(0),
|
||||||
|
* at maximum PWM_CHANNEL_NUM_DEV_MAX.
|
||||||
|
*/
|
||||||
|
#ifndef PWM0_GPIOS
|
||||||
|
#define PWM0_GPIOS { GPIO2, GPIO3, GPIO4, GPIO5 }
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/** @} */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @name SPI configuration
|
||||||
|
*
|
||||||
|
* @note
|
||||||
|
* The GPIOs listed in the configuration are not initialized as SPI
|
||||||
|
* signals until the corresponding SPI interface is used for the first time
|
||||||
|
* by either calling the `spi_init_cs` function or the `spi_acquire`
|
||||||
|
* function. That is, they are not allocated as SPI signals before and can
|
||||||
|
* be used for other purposes as long as the SPI interface is not used.
|
||||||
|
*
|
||||||
|
* @{
|
||||||
|
*/
|
||||||
|
#ifndef SPI0_CTRL
|
||||||
|
#define SPI0_CTRL FSPI /**< FSPI is used as SPI_DEV(0) */
|
||||||
|
#endif
|
||||||
|
#ifndef SPI0_SCK
|
||||||
|
#define SPI0_SCK GPIO8 /**< FSPI SCK signal routed to GPIO8 in GPIO matrix */
|
||||||
|
#endif
|
||||||
|
#ifndef SPI0_MISO
|
||||||
|
#define SPI0_MISO GPIO9 /**< FSPI SCK signal routed to GPIO9 in GPIO matrix */
|
||||||
|
#endif
|
||||||
|
#ifndef SPI0_MOSI
|
||||||
|
#define SPI0_MOSI GPIO10 /**< FSPI SCK signal routed to GPIO10 in GPIO matrix */
|
||||||
|
#endif
|
||||||
|
#ifndef SPI0_CS0
|
||||||
|
#define SPI0_CS0 GPIO5 /**< CS pin controlled in software */
|
||||||
|
#endif
|
||||||
|
/** @} */
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @name UART configuration
|
||||||
|
*
|
||||||
|
* ESP32-C3 provides 2 UART interfaces at maximum:
|
||||||
|
*
|
||||||
|
* UART_DEV(0) uses fixed standard configuration.<br>
|
||||||
|
* UART_DEV(1) is not used.<br>
|
||||||
|
*
|
||||||
|
* @{
|
||||||
|
*/
|
||||||
|
#define UART0_TXD GPIO21 /**< direct I/O pin for UART_DEV(0) TxD, can't be changed */
|
||||||
|
#define UART0_RXD GPIO20 /**< direct I/O pin for UART_DEV(0) RxD, can't be changed */
|
||||||
|
|
||||||
|
/** @} */
|
||||||
|
|
||||||
|
#ifdef __cplusplus
|
||||||
|
} /* end extern "C" */
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* include common peripheral definitions as last step */
|
||||||
|
#include "periph_conf_common.h"
|
||||||
|
|
||||||
|
#endif /* PERIPH_CONF_H */
|
||||||
|
/** @} */
|
||||||
Loading…
x
Reference in New Issue
Block a user