boards: add esp32-mh-et-live-minikit
This commit is contained in:
Schorcht
parent
6ed5e0565b
commit
c11a36ec6c
5
boards/esp32-mh-et-live-minikit/Makefile
Normal file
5
boards/esp32-mh-et-live-minikit/Makefile
Normal file
@ -0,0 +1,5 @@
|
||||
MODULE = board
|
||||
|
||||
DIRS = $(RIOTBOARD)/common/esp32
|
||||
|
||||
include $(RIOTBASE)/Makefile.base
|
||||
1
boards/esp32-mh-et-live-minikit/Makefile.dep
Normal file
1
boards/esp32-mh-et-live-minikit/Makefile.dep
Normal file
@ -0,0 +1 @@
|
||||
include $(RIOTBOARD)/common/esp32/Makefile.dep
|
||||
11
boards/esp32-mh-et-live-minikit/Makefile.features
Normal file
11
boards/esp32-mh-et-live-minikit/Makefile.features
Normal file
@ -0,0 +1,11 @@
|
||||
# common board and CPU features
|
||||
include $(RIOTBOARD)/common/esp32/Makefile.features
|
||||
|
||||
# additional features provided by the board
|
||||
FEATURES_PROVIDED += periph_adc
|
||||
FEATURES_PROVIDED += periph_dac
|
||||
FEATURES_PROVIDED += periph_i2c
|
||||
FEATURES_PROVIDED += periph_pwm
|
||||
FEATURES_PROVIDED += periph_spi
|
||||
|
||||
FEATURES_PROVIDED += arduino
|
||||
3
boards/esp32-mh-et-live-minikit/Makefile.include
Normal file
3
boards/esp32-mh-et-live-minikit/Makefile.include
Normal file
@ -0,0 +1,3 @@
|
||||
USEMODULE += boards_common_esp32
|
||||
|
||||
include $(RIOTBOARD)/common/esp32/Makefile.include
|
||||
173
boards/esp32-mh-et-live-minikit/doc.txt
Normal file
173
boards/esp32-mh-et-live-minikit/doc.txt
Normal file
@ -0,0 +1,173 @@
|
||||
/*
|
||||
* Copyright (C) 2018 Gunar Schorcht
|
||||
*
|
||||
* 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_esp32_mh-et-live-minikit MH-ET LIVE MiniKit
|
||||
* @ingroup boards_esp32
|
||||
* @brief Support for MH-ET LIVE MiniKit for ESP32
|
||||
* @author Gunar Schorcht <gunar@schorcht.net>
|
||||
|
||||
## <a name="toc"> Table of Contents </a>
|
||||
|
||||
1. [Overview](#overview)
|
||||
2. [Hardware](#hardware)
|
||||
1. [MCU](#mcu)
|
||||
2. [Board Configuration](#board_configuration)
|
||||
3. [Board Pinout](#pinout)
|
||||
4. [Optional Hardware Configurations](#optional_hardware)
|
||||
3. [Flashing the Device](#flashing)
|
||||
|
||||
## <a name="overview"> Overview </a> [[TOC](#toc)]
|
||||
|
||||
The MH-ET LIVE MiniKit for ESP32 uses the ESP32-WROOM-32 module. It is a very interesting development kit as it uses in the stackable Wemos D1 Mini format. Thus, all [shields for Wemos D1 mini](https://wiki.wemos.cc/products:d1_mini_shields) for ESP8266 can also be used with ESP32. Examples for such shields are:
|
||||
|
||||
- Micro SD-Card Shield
|
||||
- MRF24J40 IEEE 802.15.4 radio Shield
|
||||
- Button Shield
|
||||
- RGB LED Shield
|
||||
- ...
|
||||
|
||||
This makes it possible to create different hardware configurations without the need for a soldering iron or a breadboard.
|
||||
|
||||
MH-ET LIVE MiniKit for ESP32 belongs to the class of general purpose boards where most ESP32 pins are broken out for easier access.
|
||||
|
||||
\htmlonly<style>div.image img[src="https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp32/MH-ET_LIVE_D1_mini_ESP32_2.png?inline=false"]{width:250px;}</style>\endhtmlonly
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp32/MH-ET_LIVE_D1_mini_ESP32_2.png?inline=false" "MH-ET LIVE MiniKit for ESP32"
|
||||
|
||||
This stackable plattform was tested in an RIOT application with:
|
||||
|
||||
- [Micro SD-Card Shield](https://wiki.wemos.cc/products:d1_mini_shields:micro_sd_card_shield)
|
||||
- MRF24J40 IEEE 802.15.4 radio Shield (contact gunar@schorcht.net for more information)
|
||||
- BMP180 Pressure Sensor Shield
|
||||
|
||||
This application is a good example how easy it is with this board to create different hardware applications.
|
||||
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp32/MH-ET_LIVE_D1_mini_ESP32_5.png?inline=false" "RIOT application with SD-Card, MRF24J40 Radio, and BMP180 Pressure Sensor"
|
||||
|
||||
## <a name="hardware"> Hardware </a> [[TOC](#toc)]
|
||||
|
||||
This section describes
|
||||
|
||||
- the [MCU](#mcu),
|
||||
- the default [board configuration](#board_configuration),
|
||||
- [optional hardware configurations](#optional_hardware),
|
||||
- the [board pinout](#pinout).
|
||||
|
||||
### <a name="mcu"> MCU </a> [[TOC](#toc)]
|
||||
|
||||
Most features of the board are provided by the ESP32 SoC. The following table summarizes these features and gives an overview of which of these features are supported by RIOT. For detailed information about the ESP32, see section \ref esp32_mcu "MCU ESP32".
|
||||
|
||||
<center>
|
||||
MCU | ESP32 | Supported by RIOT
|
||||
------------|-----------|------------------
|
||||
Vendor | Espressif | |
|
||||
Cores | 1 or 2 x Tensilica Xtensa LX6 | 1 core
|
||||
FPU | yes (ULP - Ultra low power co-processor) | no
|
||||
RAM | 520 kByte SRAM <br> 16 kByte RTC SRAM | yes
|
||||
ROM | 520 kByte | yes
|
||||
Flash | 512 kByte ... 16 MByte | yes
|
||||
Frequency | 240 MHz, 160 MHz, 80 MHz | yes
|
||||
Power Consumption | 68 mA @ 240 MHz <br> 44 mA @ 160 MHz <br> 31 mA @ 80 MHz <br> 5 uA in deep sleep mode | yes <br> yes <br> yes <br> no
|
||||
Timers | 4 x 64 bit | yes
|
||||
ADCs | 2 x SAR-ADC with up to 18 x 12 bit channels total | yes
|
||||
DACs | 2 x DAC with 8 bit | yes
|
||||
GPIOs | 34 (6 of them are only inputs) | yes
|
||||
I2Cs | 2 | yes
|
||||
SPIs | 4 | yes
|
||||
UARTs | 3 | yes
|
||||
WiFi | IEEE 802.11 b/g/n built in | yes
|
||||
Bluetooth | v4.2 BR/EDR and BLE | no
|
||||
Ethernet | MAC interface with dedicated DMA and IEEE 1588 support | yes
|
||||
CAN | version 2.0 | no
|
||||
IR | up to 8 channels TX/RX | no
|
||||
Motor PWM | 2 devices x 6 channels | yes
|
||||
LED PWM | 16 channels | no
|
||||
Crypto | Hardware acceleration of AES, SHA-2, RSA, ECC, RNG | no
|
||||
Vcc | 2.5 - 3.6 V | |
|
||||
Documents | [Datasheet](https://www.espressif.com/sites/default/files/documentation/esp32_datasheet_en.pdf) <br> [Technical Reference](https://www.espressif.com/sites/default/files/documentation/esp32_technical_reference_manual_en.pdf) | |
|
||||
</center>
|
||||
|
||||
### <a name="board_configuration"> Board Configuration </a> [[TOC](#toc)]
|
||||
|
||||
The following table shows the default board configuration, which is sorted according to the defined functionality of GPIOs. This configuration can be overridden by an \ref esp32_app_spec_conf "application-specific configuration".
|
||||
|
||||
<center>
|
||||
\anchor esp32_mh-et-live-minikit_table_board_configuration
|
||||
Pin | Default Configuration<b>*</b> | Optional Modules<b>*</b> | Remarks / Prerequisites | Configuration
|
||||
:------|:-------------------------|:--------------------------|:--------|:------
|
||||
GPIO2 | PWM_DEV(0):0 / LED blue | | | \ref esp32_pwm_channels "PWM Channels"
|
||||
GPIO0 | PWM_DEV(0):1 | | | \ref esp32_pwm_channels "PWM Channels"
|
||||
GPIO4 | PWM_DEV(0):2 | | | \ref esp32_pwm_channels "PWM Channels"
|
||||
GPIO15 | PWM_DEV(0):3 | | | \ref esp32_pwm_channels "PWM Channels"
|
||||
GPIO22 | I2C_DEV(0):SCL | | | \ref esp32_i2c_interfaces "I2C Interfaces"
|
||||
GPIO21 | I2C_DEV(0):SDA | | | \ref esp32_i2c_interfaces "I2C Interfaces"
|
||||
GPIO18 | SPI_DEV(0):SCK | | | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||
GPIO19 | SPI_DEV(0):MISO | | | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||
GPIO23 | SPI_DEV(0):MOSI | | | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||
GPIO5 | SPI_DEV(0):CS0 | SD Card CS | when module [sdcard_spi](https://riot-os.org/api/group__drivers__sdcard__spi.html) is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||
GPIO1 | UART_DEV(0):TxD | | Console (configuration is fixed) | \ref esp32_uart_interfaces "UART interfaces"
|
||||
GPIO3 | UART_DEV(0):RxD | | Console (configuration is fixed) | \ref esp32_uart_interfaces "UART interfaces"
|
||||
GPIO9 | UART_DEV(1):TxD | | | \ref esp32_uart_interfaces "UART interfaces"
|
||||
GPIO10 | UART_DEV(1):RxD | | | \ref esp32_uart_interfaces "UART interfaces"
|
||||
GPIO34 | ADC_LINE(0) | | | \ref esp32_adc_channels "ADC Channels"
|
||||
GPIO35 | ADC_LINE(1) | | | \ref esp32_adc_channels "ADC Channels"
|
||||
GPIO36 | ADC_LINE(2) | | | \ref esp32_adc_channels "ADC Channels"
|
||||
GPIO39 | ADC_LINE(3) | | | \ref esp32_adc_channels "ADC Channels"
|
||||
GPIO25 | DAC_LINE(0) | | | \ref esp32_dac_channels "DAC Channels"
|
||||
GPIO13 | - | | | |
|
||||
GPIO12 | - | | | |
|
||||
GPIO14 | - | | | |
|
||||
GPIO16 | - | MRF24J40 RESET | when module [mrf24j40](https://riot-os.org/api/group__drivers__mrf24j40.html) is used | |
|
||||
GPIO17 | - | MRF24J40 INT | when module [mrf24j40](https://riot-os.org/api/group__drivers__mrf24j40.html) is used | |
|
||||
GPIO26 | - | MRF24J40 CS | when module [mrf24j40](https://riot-os.org/api/group__drivers__mrf24j40.html) is used | |
|
||||
GPIO27 | - | | | |
|
||||
GPIO32 | - | | | |
|
||||
GPIO33 | - | | | |
|
||||
</center>
|
||||
|
||||
<b>*</b> Default configuration cannot be used or is not available at all when the the optional hardware is used.
|
||||
|
||||
@note
|
||||
- GPIO9 and GIOP10 can only be used in **dout** and **dio** \ref esp32_flash_modes "flash modes".
|
||||
- The **RESET** signal of MRF24J40 shield can be connected to the RST **pin** of the board (see \ref esp32_mh-et-live-minikit "pinout") to keep the configured GPIO free for other purposes.
|
||||
|
||||
For detailed information about the configuration of ESP32 boards, see section \ref esp32_comm_periph "Common Peripherals".
|
||||
|
||||
### <a name="optional_hardware"> Optional Hardware Configurations </a> [[TOC](#toc)]
|
||||
|
||||
ENC28J60-based Ethernet network interface modules have been tested with the board. You could use the following code in your \ref esp32_app_spec_conf "application-specific configuration" to use such a module:
|
||||
|
||||
```
|
||||
#if MODULE_ENC28J80 && BOARD_ESP32_MH_ET_LIVE_MINIKIT
|
||||
#define ENC28J80_PARAM_CS GPIO14 /* ENC28J80 CS signal */
|
||||
#define ENC28J80_PARAM_INT GPIO33 /* ENC28J80 INT signal */
|
||||
#define ENC28J80_PARAM_RESET GPIO12 /* ENC28J80 RESET signal */
|
||||
#endif
|
||||
```
|
||||
For **ENC28J80_PARAM_SPI** the default parameter defined by the driver can be used.
|
||||
|
||||
@note The **RESET** signal of ENC28J60 based modules can also be connected to the **RST** pin of the board (see \ref esp32_mh-et-live-minikit "pinout") to keep the configured GPIO free for other purposes.
|
||||
|
||||
### <a name="pinout"> Board Pinout </a> [[TOC](#toc)]
|
||||
|
||||
The following picture shows the pinout of MH-ET LIVE MiniKit for ESP32 board as defined by the default board configuration. The light green GPIOs are not used by configured on-board hardware components and can be used for any purpose. However, if optional off-board hardware modules are used, these GPIOs may also be occupied, see \ref esp32_mh-et-live-minikit_table_board_configuration "optional functions" in table board configuration.
|
||||
|
||||
The corresponding board schematic can be found [here](https://i.imgur.com/EpE4dGj.jpg)
|
||||
|
||||
\anchor esp32_mh-et-live-minikit
|
||||
@image html "https://gitlab.com/gschorcht/RIOT.wiki-Images/raw/master/esp32/MH-ET_LIVE_D1_mini_ESP32_pinout.png?inline=false" "MH-ET LIVE MiniKit for ESP32 pinout"
|
||||
|
||||
## <a name="flashing"> Flashing the Device </a> [[TOC](#toc)]
|
||||
|
||||
Flashing RIOT is quite easy. The board has a Micro-USB connector with a reset/boot/flash logic. Just connect the board to your host computer using the programming port and type:
|
||||
```
|
||||
make flash BOARD=esp32-mh-et-live-minikit ...
|
||||
```
|
||||
For detailed information about ESP32 as well as configuring and compiling RIOT for ESP32 boards, see \ref esp32_riot.
|
||||
|
||||
*/
|
||||
82
boards/esp32-mh-et-live-minikit/include/arduino_board.h
Normal file
82
boards/esp32-mh-et-live-minikit/include/arduino_board.h
Normal file
@ -0,0 +1,82 @@
|
||||
/*
|
||||
* Copyright (C) 2018 Gunar Schorcht
|
||||
*
|
||||
* 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_esp32_mh-et-live-minikit
|
||||
* @{
|
||||
*
|
||||
* @file
|
||||
* @brief Board specific configuration for the Arduino API
|
||||
*
|
||||
* @author Gunar Schorcht <gunar@schorcht.net>
|
||||
*/
|
||||
|
||||
#ifndef ARDUINO_BOARD_H
|
||||
#define ARDUINO_BOARD_H
|
||||
|
||||
#include "periph/gpio.h"
|
||||
#include "periph/adc.h"
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief The on-board LED is connected to Arduino pin 3 on this board
|
||||
*/
|
||||
#define ARDUINO_LED (3)
|
||||
|
||||
/**
|
||||
* @brief Look-up table for the Arduino's digital pins
|
||||
*/
|
||||
static const gpio_t arduino_pinmap[] = {
|
||||
GPIO3, /* ARDUINO_PIN_0 (RxD) */
|
||||
GPIO1, /* ARDUINO_PIN_1 (TxD) */
|
||||
|
||||
GPIO32, /* ARDUINO_PIN_2 */
|
||||
GPIO2, /* ARDUINO_PIN_3 (PWM) */
|
||||
GPIO27, /* ARDUINO_PIN_4 */
|
||||
GPIO0, /* ARDUINO_PIN_5 (PWM) */
|
||||
GPIO4, /* ARDUINO_PIN_6 (PWM) */
|
||||
GPIO33, /* ARDUINO_PIN_7 */
|
||||
GPIO25, /* ARDUINO_PIN_8 */
|
||||
GPIO15, /* ARDUINO_PIN_9 (PWM) */
|
||||
|
||||
GPIO5, /* ARDUINO_PIN_10 (CS0 / PWM) */
|
||||
GPIO23, /* ARDUINO_PIN_11 (MOSI / PWM) */
|
||||
GPIO19, /* ARDUINO_PIN_12 (MISO) */
|
||||
GPIO18, /* ARDUINO_PIN_13 (SCK) */
|
||||
|
||||
GPIO34, /* ARDUINO_PIN_A0 */
|
||||
GPIO35, /* ARDUINO_PIN_A1 */
|
||||
GPIO36, /* ARDUINO_PIN_A2 */
|
||||
GPIO39, /* ARDUINO_PIN_A3 */
|
||||
|
||||
GPIO21, /* ARDUINO_PIN_A4 (SDA) */
|
||||
GPIO22, /* ARDUINO_PIN_A5 (SCL) */
|
||||
};
|
||||
|
||||
/**
|
||||
* @brief Look-up table for the Arduino's analog pins
|
||||
*/
|
||||
static const adc_t arduino_analog_map[] = {
|
||||
GPIO34, /* ARDUINO_PIN_A0 */
|
||||
GPIO35, /* ARDUINO_PIN_A1 */
|
||||
GPIO36, /* ARDUINO_PIN_A2 */
|
||||
GPIO39, /* ARDUINO_PIN_A3 */
|
||||
|
||||
GPIO13, /* ARDUINO_PIN_A4 (SDA) */
|
||||
GPIO26, /* ARDUINO_PIN_A5 (SCL) */
|
||||
};
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif /* ARDUINO_BOARD_H */
|
||||
/** @} */
|
||||
62
boards/esp32-mh-et-live-minikit/include/board.h
Normal file
62
boards/esp32-mh-et-live-minikit/include/board.h
Normal file
@ -0,0 +1,62 @@
|
||||
/*
|
||||
* Copyright (C) 2018 Gunar Schorcht
|
||||
*
|
||||
* 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_esp32_mh-et-live-minikit
|
||||
* @brief Board specific definitions for MH-ET LIVE MiniKit for ESP32
|
||||
* @{
|
||||
*
|
||||
* The MH-ET LIVE MiniKit for ESP32 uses the ESP32-WROOM-32 module. It is
|
||||
* a very interesting development kit as it is available in the stackable
|
||||
* Wemos D1 Mini format. Thus, all shields for Wemos D1 mini (ESP8266
|
||||
* platform) can also be used with ESP32. All GPIOs are broken out so that
|
||||
* it can be configured very flexibly.
|
||||
*
|
||||
* For detailed information about the configuration of ESP32 boards, see
|
||||
* section \ref esp32_comm_periph "Common Peripherals".
|
||||
*
|
||||
* @note
|
||||
* Most definitions can be overridden by an \ref esp32_app_spec_conf
|
||||
* "application-specific board configuration".
|
||||
*
|
||||
* @file
|
||||
* @author Gunar Schorcht <gunar@schorcht.net>
|
||||
*/
|
||||
|
||||
#ifndef BOARD_H
|
||||
#define BOARD_H
|
||||
|
||||
#include <stdint.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @name LED (on-board) configuration
|
||||
*
|
||||
* @{
|
||||
*/
|
||||
#define LED0_PIN GPIO2
|
||||
#define LED0_ACTIVE 1 /**< LED is high active */
|
||||
|
||||
#define LED_BLUE_PIN GPIO2
|
||||
/** @} */
|
||||
|
||||
#ifdef __cplusplus
|
||||
} /* end extern "C" */
|
||||
#endif
|
||||
|
||||
/* include common board definitions as last step */
|
||||
#include "board_common.h"
|
||||
|
||||
/* include definitions for optional hardware modules */
|
||||
#include "board_modules.h"
|
||||
|
||||
#endif /* BOARD_H */
|
||||
/** @} */
|
||||
96
boards/esp32-mh-et-live-minikit/include/board_modules.h
Normal file
96
boards/esp32-mh-et-live-minikit/include/board_modules.h
Normal file
@ -0,0 +1,96 @@
|
||||
/*
|
||||
* Copyright (C) 2018 Gunar Schorcht
|
||||
*
|
||||
* 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 BOARD_MODULES_H
|
||||
#define BOARD_MODULES_H
|
||||
|
||||
/**
|
||||
* @ingroup boards_esp32_mh-et-live-minikit
|
||||
* @brief Definitions for Wemos stackable hardware modules (shields)
|
||||
*
|
||||
* The board can be used with lots of optional stackable hardware modules.
|
||||
* This file contains the default configurations for those hardware modules
|
||||
* that have been tested. Most of these configurations can be overridden by an
|
||||
* \ref esp32_app_spec_conf "application-specific configuration".
|
||||
*
|
||||
* The configurations of the respective hardware modules only take place if
|
||||
* the corresponding driver modules are used.
|
||||
*
|
||||
* @file
|
||||
* @author Gunar Schorcht <gunar@schorcht.net>
|
||||
* @{
|
||||
*/
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
#if MODULE_MRF24J40 || DOXYGEN
|
||||
/**
|
||||
* @name MRF24J40 shield configuration
|
||||
*
|
||||
* Configuration for the MRF24J40 shield when module ```mrf24j40``` is used.
|
||||
*
|
||||
* MRF24J40 module uses SPI_DEV(0) and according pins on this board to be
|
||||
* compatible with the Wemos D1 mini MRF24J40 shield.
|
||||
*
|
||||
* @note To keep an additional GPIO free, the ENC28J60 RESET signal can
|
||||
* be connected to ESP32 Reset pin.
|
||||
* @{
|
||||
*/
|
||||
#define MRF24J40_PARAM_SPI SPI_DEV(0) /**< SPI_DEV(0) is used (fixed) */
|
||||
|
||||
#ifndef MRF24J40_PARAM_SPI_CLK
|
||||
#define MRF24J40_PARAM_SPI_CLK SPI_CLK_1MHZ /**< SPI bus speed used (can be overriden) */
|
||||
#endif
|
||||
#ifndef MRF24J40_PARAM_CS
|
||||
#define MRF24J40_PARAM_CS GPIO26 /**< MRF24J40 CS signal (can be overriden) */
|
||||
#endif
|
||||
#ifndef MRF24J40_PARAM_INT
|
||||
#define MRF24J40_PARAM_INT GPIO17 /**< MRF24J40 INT signal (can be overriden) */
|
||||
#endif
|
||||
#ifndef MRF24J40_PARAM_RESET
|
||||
#define MRF24J40_PARAM_RESET GPIO16 /**< MRF24J40 RESET signal (can be overriden) */
|
||||
#endif
|
||||
/** @} */
|
||||
#endif /* MODULE_MRF24J40 || DOXYGEN */
|
||||
|
||||
#if MODULE_SDCARD_SPI || DOXYGEN
|
||||
/**
|
||||
* @name SD-Card shield configuration
|
||||
*
|
||||
* Configuration of the SD-Card interface when module ```sdcard_spi``` is used.
|
||||
*
|
||||
* SD card interface uses SPI_DEV(0) on this board to be compatible with the
|
||||
* Wemos D1 mini micro SD card shield. The D8 pin (GPIO5) is used as default
|
||||
* CS signal.
|
||||
*
|
||||
* @note Please override the definition of CS pin by an by \ref
|
||||
* esp32_app_spec_conf "application-specific configurations" according to your
|
||||
* solder bride configuration.
|
||||
* @{
|
||||
*/
|
||||
#define SDCARD_SPI_PARAM_SPI SPI_DEV(0) /**< SPI_DEV(0) is used (fixed) */
|
||||
#define SDCARD_SPI_PARAM_CLK SPI0_SCK /**< SPI_DEV(0) SCK is used (fixed) */
|
||||
#define SDCARD_SPI_PARAM_MOSI SPI0_MOSI /**< SPI_DEV(0) MOSI is used (fixed) */
|
||||
#define SDCARD_SPI_PARAM_MISO SPI0_MISO /**< SPI_DEV(0) MISO is used (fixed) */
|
||||
#define SDCARD_SPI_PARAM_POWER GPIO_UNDEF /**< power control is not used (fixed) */
|
||||
|
||||
#ifndef SDCARD_SPI_PARAM_CS
|
||||
#define SDCARD_SPI_PARAM_CS SPI0_CS0 /**< SD-Card CS signal (overridde it) */
|
||||
#endif
|
||||
/** @} */
|
||||
#endif /* MODULE_SDCARD_SPI || DOXYGEN */
|
||||
|
||||
#ifdef __cplusplus
|
||||
} /* end extern "C" */
|
||||
#endif
|
||||
|
||||
/** @} */
|
||||
|
||||
#endif /* BOARD_MODULES_H */
|
||||
45
boards/esp32-mh-et-live-minikit/include/gpio_params.h
Normal file
45
boards/esp32-mh-et-live-minikit/include/gpio_params.h
Normal file
@ -0,0 +1,45 @@
|
||||
/*
|
||||
* Copyright (C) 2018 Gunar Schorcht
|
||||
*
|
||||
* 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_esp32_mh-et-live-minikit
|
||||
* @brief Board specific configuration of direct mapped GPIOs
|
||||
* @file
|
||||
* @author Gunar Schorcht <gunar@schorcht.net>
|
||||
* @{
|
||||
*/
|
||||
|
||||
#include "board.h"
|
||||
#include "saul/periph.h"
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief LED configuration
|
||||
*/
|
||||
static const saul_gpio_params_t saul_gpio_params[] =
|
||||
{
|
||||
{
|
||||
.name = "LED",
|
||||
.pin = LED0_PIN,
|
||||
.mode = GPIO_OUT,
|
||||
.flags = SAUL_GPIO_INIT_CLEAR
|
||||
}
|
||||
};
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif /* GPIO_PARAMS_H */
|
||||
/** @} */
|
||||
176
boards/esp32-mh-et-live-minikit/include/periph_conf.h
Normal file
176
boards/esp32-mh-et-live-minikit/include/periph_conf.h
Normal file
@ -0,0 +1,176 @@
|
||||
/*
|
||||
* Copyright (C) 2018 Gunar Schorcht
|
||||
*
|
||||
* 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_esp32_mh-et-live-minikit
|
||||
* @brief Peripheral MCU configuration for MH-ET LIVE MiniKit for ESP32
|
||||
* @{
|
||||
*
|
||||
* The MH-ET LIVE MiniKit for ESP32 uses the ESP32-WROOM-32 module. It is
|
||||
* a very interesting development kit as it is available in the stackable
|
||||
* Wemos D1 Mini format. Thus, all shields for Wemos D1 mini (ESP8266
|
||||
* platform) can also be used with ESP32. All GPIOs are broken out so that
|
||||
* it can be configured very flexibly.
|
||||
*
|
||||
* For detailed information about the configuration of ESP32 boards, see
|
||||
* section \ref esp32_comm_periph "Common Peripherals".
|
||||
*
|
||||
* @note
|
||||
* Most definitions can be overridden by an \ref esp32_app_spec_conf
|
||||
* "application-specific board configuration".
|
||||
*
|
||||
* @file
|
||||
* @author Gunar Schorcht <gunar@schorcht.net>
|
||||
*/
|
||||
|
||||
#ifndef PERIPH_CONF_H
|
||||
#define PERIPH_CONF_H
|
||||
|
||||
#include <stdint.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @name ADC and DAC channel configuration
|
||||
* @{
|
||||
*/
|
||||
|
||||
/**
|
||||
* @brief Declaration of GPIOs that can be used as ADC channels
|
||||
*
|
||||
* @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 { GPIO34, GPIO35, GPIO36, GPIO39 }
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief Declaration of GPIOs that can be used as DAC channels
|
||||
*
|
||||
* @note As long as the GPIOs listed in DAC_GPIOS are not initialized as DAC
|
||||
* channels with the ```dac_init``` function, they can be used for other
|
||||
* purposes.
|
||||
*/
|
||||
#ifndef DAC_GPIOS
|
||||
#define DAC_GPIOS { GPIO25 }
|
||||
#endif
|
||||
/** @} */
|
||||
|
||||
|
||||
/**
|
||||
* @name I2C configuration
|
||||
*
|
||||
* Only I2C interface I2C_DEV(0) is used.
|
||||
*
|
||||
* @note The GPIOs listed in the configuration are only initialized as I2C
|
||||
* signals when module ```perpih_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 GPIO22 /**< SCL signal of I2C_DEV(0) [UEXT1] */
|
||||
#endif
|
||||
#ifndef I2C0_SDA
|
||||
#define I2C0_SDA GPIO21 /**< SDA signal of I2C_DEV(0) [UEXT1] */
|
||||
#endif
|
||||
/** @} */
|
||||
|
||||
|
||||
/**
|
||||
* @name PWM channel configuration
|
||||
*
|
||||
* @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.
|
||||
*
|
||||
* @{
|
||||
*/
|
||||
/** PWM channels for device PWM_DEV(0) */
|
||||
#ifndef PWM0_GPIOS
|
||||
#define PWM0_GPIOS { GPIO2, GPIO0, GPIO4, GPIO15 }
|
||||
#endif
|
||||
|
||||
/** PWM_DEV(1) is not used */
|
||||
#ifndef PWM1_GPIOS
|
||||
#define PWM1_GPIOS { }
|
||||
#endif
|
||||
/** @} */
|
||||
|
||||
/**
|
||||
* @name SPI configuration
|
||||
*
|
||||
* @note The GPIOs listed in the configuration are first initialized as SPI
|
||||
* signals when 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_DEV
|
||||
#define SPI0_DEV VSPI /**< VSPI is used as SPI_DEV(0) */
|
||||
#endif
|
||||
#ifndef SPI0_SCK
|
||||
#define SPI0_SCK GPIO18 /**< VSPI SCK */
|
||||
#endif
|
||||
#ifndef SPI0_MISO
|
||||
#define SPI0_MISO GPIO19 /**< VSPI MISO */
|
||||
#endif
|
||||
#ifndef SPI0_MOSI
|
||||
#define SPI0_MOSI GPIO23 /**< VSPI MOSI */
|
||||
#endif
|
||||
#ifndef SPI0_CS0
|
||||
#define SPI0_CS0 GPIO5 /**< VSPI CS0 */
|
||||
#endif
|
||||
/** @} */
|
||||
|
||||
/**
|
||||
* @name UART configuration
|
||||
*
|
||||
* ESP32 provides 3 UART interaces at maximum:
|
||||
*
|
||||
* UART_DEV(0) uses fixed standard configuration.<br>
|
||||
* UART_DEV(1) is defined here.<br>
|
||||
* UART_DEV(2) is not used.<br>
|
||||
*
|
||||
* @{
|
||||
*/
|
||||
#define UART0_TXD GPIO10 /**< direct I/O pin for UART_DEV(0) TxD, can't be changed */
|
||||
#define UART0_RXD GPIO9 /**< direct I/O pin for UART_DEV(0) RxD, can't be changed */
|
||||
|
||||
#if FLASH_MODE_DOUT || FLASH_MODE_DIO || DOXYGEN
|
||||
#ifndef UART1_TXD
|
||||
#define UART1_TXD GPIO10 /**< direct I/O pin for UART_DEV(1) TxD */
|
||||
#endif
|
||||
#ifndef UART1_RXD
|
||||
#define UART1_RXD GPIO9 /**< direct I/O pin for UART_DEV(1) RxD */
|
||||
#endif
|
||||
#else
|
||||
#warning Configuration problem: Flash mode is qio or qout, \
|
||||
GPIO9 and GPIO10 are not available for UART1 as configured
|
||||
#endif
|
||||
/** @} */
|
||||
|
||||
|
||||
#ifdef __cplusplus
|
||||
} /* end extern "C" */
|
||||
#endif
|
||||
|
||||
/* include common board definitions as last step */
|
||||
#include "periph_conf_common.h"
|
||||
|
||||
#endif /* PERIPH_CONF_H */
|
||||
/** @} */
|
||||
Loading…
x
Reference in New Issue
Block a user