boards/esp32: add TTGO T-Beam board definition
Signed-off-by: Yegor Yefremov <yegorslists@googlemail.com>
This commit is contained in:
Yegor Yefremov
parent
0b1a1d13ff
commit
8101f52e3f
5
boards/esp32-ttgo-t-beam/Makefile
Normal file
5
boards/esp32-ttgo-t-beam/Makefile
Normal file
@ -0,0 +1,5 @@
|
||||
MODULE = board
|
||||
|
||||
DIRS = $(RIOTBOARD)/common/esp32
|
||||
|
||||
include $(RIOTBASE)/Makefile.base
|
||||
1
boards/esp32-ttgo-t-beam/Makefile.dep
Normal file
1
boards/esp32-ttgo-t-beam/Makefile.dep
Normal file
@ -0,0 +1 @@
|
||||
include $(RIOTBOARD)/common/esp32/Makefile.dep
|
||||
15
boards/esp32-ttgo-t-beam/Makefile.features
Normal file
15
boards/esp32-ttgo-t-beam/Makefile.features
Normal file
@ -0,0 +1,15 @@
|
||||
# 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 += periph_uart
|
||||
|
||||
FEATURES_PROVIDED += arduino
|
||||
|
||||
# unique features provided by the board
|
||||
FEATURES_PROVIDED += esp_spi_ram
|
||||
5
boards/esp32-ttgo-t-beam/Makefile.include
Normal file
5
boards/esp32-ttgo-t-beam/Makefile.include
Normal file
@ -0,0 +1,5 @@
|
||||
PSEUDOMODULES += esp32_ttgo_t_beam_v1_0
|
||||
|
||||
USEMODULE += boards_common_esp32
|
||||
|
||||
include $(RIOTBOARD)/common/esp32/Makefile.include
|
||||
197
boards/esp32-ttgo-t-beam/doc.txt
Normal file
197
boards/esp32-ttgo-t-beam/doc.txt
Normal file
@ -0,0 +1,197 @@
|
||||
/*
|
||||
* Copyright (C) 2019 Yegor Yefremov
|
||||
*
|
||||
* 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_ttgo-t-beam TTGO T-Beam
|
||||
* @ingroup boards_esp32
|
||||
* @brief Support for TTGO T-Beam boards
|
||||
* @author Yegor Yefremov <yegorslists@googlemail.com>
|
||||
|
||||
## <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)]
|
||||
|
||||
TTGO T-Beam is an ESP32 development board with 4 MB Flash that uses
|
||||
the EPS32 chip directly. It integrates:
|
||||
|
||||
- a SemTech SX1276 or SX1278 for LoRaWAN communication
|
||||
- a U-Blox Neo-6M GPS receiver
|
||||
|
||||
There are at least three board types: rev0, rev1, and V1.0. Versions
|
||||
rev0 and rev1 are very similar, the only difference is that rev1 has
|
||||
an additional LED connected to GPIO14. The pinout of V1.0 has more
|
||||
changes thus it is necessary to add the following line to the makefile
|
||||
of the application to use the according configuration for TTGO T-Beam V1.0:
|
||||
```
|
||||
USEMODULE += esp32_ttgo_t_beam_v1_0
|
||||
```
|
||||
|
||||
## <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 | 448 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 | yes
|
||||
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)]
|
||||
|
||||
TTGO T-Beam has the following on-board components:
|
||||
|
||||
- SemTech SX1276 or SX1278 for LoRaWAN communication
|
||||
- U-Blox Neo-6M GPS receiver
|
||||
|
||||
There are two hardware versions of the board:
|
||||
|
||||
- SemTech SX1276 for LoRaWAN communication in the 433 MHz band
|
||||
- SemTech SX1278 for LoRaWAN communication in the 868/915 MHz band
|
||||
|
||||
Since many GPIOs are broken out, they can be used for different purposes
|
||||
in different applications. For flexibility, some GPIOs might be listed in
|
||||
various peripheral configurations. For example, GPIO0 is used in the ADC
|
||||
channel definition \ref ADC_GPIOS and the PWM channel definition \ref PWM0_GPIOS.
|
||||
|
||||
This is possible because GPIOs are only used for a specific peripheral
|
||||
interface when
|
||||
|
||||
- the corresponding peripheral module is used, e.g., module `periph_i2c`, or
|
||||
- a corresponding init function is called e.g., \ref adc_init, \ref dac_init
|
||||
and \ref pwm_init, or
|
||||
- the corresponding peripheral interface is used for the first time, e.g.,
|
||||
\ref spi_acquire.
|
||||
|
||||
That is, the purpose for which a GPIO is actually used depends on which module
|
||||
or function is used first.
|
||||
|
||||
@note GPIOs 5, 12, 15, 16, 17, 18, 19, 26, and 27 are
|
||||
used for board control functions and should not be used for other purposes
|
||||
unless you exactly know what you are doing.
|
||||
|
||||
The following table shows the default board configuration, which is sorted
|
||||
according to the defined functionality of GPIOs. This configuration can be
|
||||
overridden by \ref esp32_app_spec_conf "application-specific configurations".
|
||||
|
||||
TTGO- T-Beam rev1
|
||||
|
||||
<center>
|
||||
\anchor esp32_ttgo_t_beam_rev1_table_board_configuration
|
||||
Function | GPIOs | Remarks |Configuration
|
||||
:---------------|:-------|:--------|:----------------------------------
|
||||
BUTTON0 | GPIO39 | low active | |
|
||||
LED0 | GPIO14 | high active | |
|
||||
ADC | GPIO0, GPIO2, GPIO4, GPIO13,<br>GPIO25, GPIO32, GPIO33, GPIO34,<br>GPIO35 | | \ref esp32_adc_channels "ADC Channels"
|
||||
DAC | GPIO25 | | \ref esp32_dac_channels "DAC Channels"
|
||||
PWM_DEV(0) | GPIO0, GPIO2, GPIO25 | | \ref esp32_pwm_channels "PWM Channels"
|
||||
I2C_DEV(0):SDA | GPIO21 | | \ref esp32_i2c_interfaces "I2C Interfaces"
|
||||
I2C_DEV(0):SCL | GPIO22 | I2C_SPEED_FAST is used | \ref esp32_i2c_interfaces "I2C Interfaces"
|
||||
SPI_DEV(0):CLK | GPIO5 | VSPI is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||
SPI_DEV(0):MISO | GPIO19 | VSPI is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||
SPI_DEV(0):MOSI | GPIO27 | VSPI is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||
SPI_DEV(0):CS0 | GPIO18 | VSPI is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||
UART_DEV(0):TxD | GPIO1 | Console (configuration is fixed) | \ref esp32_uart_interfaces "UART interfaces"
|
||||
UART_DEV(0):RxD | GPIO3 | Console (configuration is fixed) | \ref esp32_uart_interfaces "UART interfaces"
|
||||
UART_DEV(1):TxD | GPIO15 | GPS (configuration is fixed) | \ref esp32_uart_interfaces "UART interfaces"
|
||||
UART_DEV(1):RxD | GPIO12 | GPS (configuration is fixed) | \ref esp32_uart_interfaces "UART interfaces"
|
||||
</center>
|
||||
|
||||
TTGO- T-Beam V1.0
|
||||
|
||||
<center>
|
||||
\anchor esp32_ttgo_t_beam_v1_0_table_board_configuration
|
||||
Function | GPIOs | Remarks |Configuration
|
||||
:---------------|:-------|:--------|:----------------------------------
|
||||
BUTTON0 | GPIO38 | low active | |
|
||||
ADC | GPIO0, GPIO2, GPIO4, GPIO13,<br>GPIO25, GPIO32, GPIO33, GPIO35 | | \ref esp32_adc_channels "ADC Channels"
|
||||
DAC | GPIO25 | | \ref esp32_dac_channels "DAC Channels"
|
||||
PWM_DEV(0) | GPIO0, GPIO2, GPIO25 | | \ref esp32_pwm_channels "PWM Channels"
|
||||
I2C_DEV(0):SDA | GPIO21 | | \ref esp32_i2c_interfaces "I2C Interfaces"
|
||||
I2C_DEV(0):SCL | GPIO22 | I2C_SPEED_FAST is used | \ref esp32_i2c_interfaces "I2C Interfaces"
|
||||
SPI_DEV(0):CLK | GPIO5 | VSPI is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||
SPI_DEV(0):MISO | GPIO19 | VSPI is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||
SPI_DEV(0):MOSI | GPIO27 | VSPI is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||
SPI_DEV(0):CS0 | GPIO18 | VSPI is used | \ref esp32_spi_interfaces "SPI Interfaces"
|
||||
UART_DEV(0):TxD | GPIO1 | Console (configuration is fixed) | \ref esp32_uart_interfaces "UART interfaces"
|
||||
UART_DEV(0):RxD | GPIO3 | Console (configuration is fixed) | \ref esp32_uart_interfaces "UART interfaces"
|
||||
UART_DEV(1):TxD | GPIO34 | GPS (configuration is fixed) | \ref esp32_uart_interfaces "UART interfaces"
|
||||
UART_DEV(1):RxD | GPIO12 | GPS (configuration is fixed) | \ref esp32_uart_interfaces "UART interfaces"
|
||||
</center>
|
||||
|
||||
<br>
|
||||
@note
|
||||
- The configuration of ADC channels contains all ESP32 GPIOs that can be used
|
||||
as ADC channels.
|
||||
|
||||
For detailed information about the configuration of ESP32 boards, see
|
||||
section \ref esp32_comm_periph "Common Peripherals".
|
||||
|
||||
### <a name="pinout"> Board Pinout </a> [[TOC](#toc)]
|
||||
|
||||
The following figures show the pinout of the defined default configurations for TTGO T-Beam boards.
|
||||
|
||||
\anchor esp32_ttgo_t_beam_rev1_pinout
|
||||
@image html "https://ae01.alicdn.com/kf/HTB1OhPmXtzvK1RkSnfoq6zMwVXah.jpg" "TTGO T-Beam rev1 Pintout Diagram"
|
||||
|
||||
\anchor esp32_ttgo_t_beam_v1_0_pinout
|
||||
@image html "https://ae01.alicdn.com/kf/Hee7e9a85bb294351952a073325e6b2f96.jpg" "TTGO T-Beam V1.0 Pintout Diagram"
|
||||
|
||||
The corresponding board schematics can be found on TinyMicros.com for [TTGO T-Beam rev0](http://tinymicros.com/mediawiki/images/b/b9/TTGO_T-Beam_Schematic.pdf) and GitHub for [TTGO T-Beam V1.0](https://github.com/Xinyuan-LilyGO/TTGO-T-Beam/raw/master/schematic/T_BeamV1.0.pdf)
|
||||
|
||||
## <a name="flashing"> Flashing the Device </a> [[TOC](#toc)]
|
||||
|
||||
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:
|
||||
```
|
||||
make flash BOARD=esp32-ttgo-t-beam ...
|
||||
```
|
||||
For detailed information about ESP32 as well as configuring and compiling RIOT for ESP32 boards, see \ref esp32_riot.
|
||||
*/
|
||||
40
boards/esp32-ttgo-t-beam/include/arduino_board.h
Normal file
40
boards/esp32-ttgo-t-beam/include/arduino_board.h
Normal file
@ -0,0 +1,40 @@
|
||||
/*
|
||||
* Copyright (C) 2019 Yegor Yefremov
|
||||
*
|
||||
* 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_ttgo-t-beam
|
||||
* @{
|
||||
*
|
||||
* @file
|
||||
* @brief Board specific configuration for the Arduino API
|
||||
*
|
||||
* @author Yegor Yefremov <yegorslists@googlemail.com>
|
||||
*/
|
||||
|
||||
#ifndef ARDUINO_BOARD_H
|
||||
#define ARDUINO_BOARD_H
|
||||
|
||||
#include "arduino_board_common.h"
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief The on-board LED is connected to Arduino pin 3 on this board
|
||||
*/
|
||||
#ifndef MODULE_ESP32_TTGO_T_BEAM_V1_0
|
||||
#define ARDUINO_LED (3)
|
||||
#endif
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif /* ARDUINO_BOARD_H */
|
||||
/** @} */
|
||||
60
boards/esp32-ttgo-t-beam/include/arduino_pinmap.h
Normal file
60
boards/esp32-ttgo-t-beam/include/arduino_pinmap.h
Normal file
@ -0,0 +1,60 @@
|
||||
/*
|
||||
* Copyright (C) 2019 Yegor Yefremov
|
||||
*
|
||||
* 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_ttgo-t-beam
|
||||
* @{
|
||||
*
|
||||
* @file
|
||||
* @brief Mapping from MCU pins to Arduino pins
|
||||
*
|
||||
* @author Yegor Yefremov <yegorslists@googlemail.com>
|
||||
*/
|
||||
|
||||
#ifndef ARDUINO_PINMAP_H
|
||||
#define ARDUINO_PINMAP_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 GPIO3 /**< Arduino Uno pin 0 (RxD) */
|
||||
#define ARDUINO_PIN_1 GPIO1 /**< Arduino Uno pin 1 (TxD) */
|
||||
#define ARDUINO_PIN_2 GPIO0 /**< Arduino Uno pin 2 */
|
||||
#define ARDUINO_PIN_3 GPIO2 /**< Arduino Uno pin 3 (PWM) */
|
||||
#define ARDUINO_PIN_4 GPIO4 /**< Arduino Uno pin 4 */
|
||||
#define ARDUINO_PIN_5 GPIO13 /**< Arduino Uno pin 5 (PWM) */
|
||||
#define ARDUINO_PIN_6 GPIO15 /**< Arduino Uno pin 6 (PWM) */
|
||||
#define ARDUINO_PIN_7 GPIO21 /**< Arduino Uno pin 7 */
|
||||
#define ARDUINO_PIN_8 GPIO22 /**< Arduino Uno pin 8 */
|
||||
#define ARDUINO_PIN_9 GPIO23 /**< Arduino Uno pin 9 (PWM) */
|
||||
#define ARDUINO_PIN_10 GPIO_UNDEF /**< Arduino Uno pin 10 (CS0 / PWM) */
|
||||
#define ARDUINO_PIN_11 GPIO_UNDEF /**< Arduino Uno pin 11 (MOSI / PWM) */
|
||||
#define ARDUINO_PIN_12 GPIO_UNDEF /**< Arduino Uno pin 12 (MISO) */
|
||||
#define ARDUINO_PIN_13 GPIO14 /**< Arduino Uno pin 13 (LED) */
|
||||
#define ARDUINO_PIN_A0 GPIO25 /**< Arduino Uno pin A0 */
|
||||
#define ARDUINO_PIN_A1 GPIO32 /**< Arduino Uno pin A1 */
|
||||
#define ARDUINO_PIN_A2 GPIO33 /**< Arduino Uno pin A2 */
|
||||
#define ARDUINO_PIN_A3 GPIO35 /**< Arduino Uno pin A3 */
|
||||
#define ARDUINO_PIN_A4 GPIO36 /**< Arduino Uno pin A4 (SDA) */
|
||||
#define ARDUINO_PIN_A5 GPIO39 /**< Arduino Uno pin A5 (SCL) */
|
||||
/** @ */
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif /* ARDUINO_PINMAP_H */
|
||||
/** @} */
|
||||
83
boards/esp32-ttgo-t-beam/include/board.h
Normal file
83
boards/esp32-ttgo-t-beam/include/board.h
Normal file
@ -0,0 +1,83 @@
|
||||
/*
|
||||
* Copyright (C) 2019 Yegor Yefremov
|
||||
*
|
||||
* 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_ttgo-t-beam
|
||||
* @brief Board specific definitions for TTGO T-Beam board
|
||||
* @{
|
||||
*
|
||||
* TTGO T-Beam is an ESP32 development board with 8 MB Flash that
|
||||
* uses the EPS32 chip directly. It integrates a SemTech SX1276 or SX1278 for
|
||||
* LoRaWAN communication in the 433 MHz or the 868/915 MHz band, respectively.
|
||||
* Additionally, it has an OLED display connected via I2C on board.
|
||||
*
|
||||
* 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 Yegor Yefremov <yegorslists@googlemail.com>
|
||||
*/
|
||||
|
||||
#ifndef BOARD_H
|
||||
#define BOARD_H
|
||||
|
||||
#include <stdint.h>
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @name Button pin definitions
|
||||
* @{
|
||||
*/
|
||||
#if MODULE_ESP32_TTGO_T_BEAM_V1_0
|
||||
#define BUTTON0_PIN GPIO38
|
||||
#else
|
||||
#define BUTTON0_PIN GPIO39
|
||||
#endif
|
||||
/** @} */
|
||||
|
||||
/**
|
||||
* @name LED (on-board) configuration
|
||||
*
|
||||
* @{
|
||||
*/
|
||||
#ifndef MODULE_ESP32_TTGO_T_BEAM_V1_0
|
||||
#define LED0_PIN GPIO14
|
||||
#define LED0_ACTIVE (1) /**< LED is high active */
|
||||
#endif
|
||||
/** @} */
|
||||
|
||||
#ifdef __cplusplus
|
||||
} /* end extern "C" */
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @name SX127X
|
||||
*
|
||||
* SX127X configuration.
|
||||
* @{
|
||||
*/
|
||||
#define SX127X_PARAM_SPI_NSS GPIO18
|
||||
#define SX127X_PARAM_RESET GPIO23
|
||||
#define SX127X_PARAM_DIO0 GPIO26
|
||||
#define SX127X_PARAM_DIO1 GPIO_UNDEF /* Pin is not connected to the LoRa chip directly */
|
||||
#define SX127X_PARAM_DIO2 GPIO_UNDEF /* Pin is not connected to the LoRa chip directly */
|
||||
#define SX127X_PARAM_DIO3 GPIO_UNDEF
|
||||
/** @} */
|
||||
|
||||
/* include common board definitions as last step */
|
||||
#include "board_common.h"
|
||||
|
||||
#endif /* BOARD_H */
|
||||
/** @} */
|
||||
53
boards/esp32-ttgo-t-beam/include/gpio_params.h
Normal file
53
boards/esp32-ttgo-t-beam/include/gpio_params.h
Normal file
@ -0,0 +1,53 @@
|
||||
/*
|
||||
* Copyright (C) 2019 Yegor Yefremov
|
||||
*
|
||||
* 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_ttgo-t-beam
|
||||
* @brief Board specific configuration of direct mapped GPIOs
|
||||
* @file
|
||||
* @author Yegor Yefremov <yegorslists@googlemail.com>
|
||||
* @{
|
||||
*/
|
||||
|
||||
#include "board.h"
|
||||
#include "saul/periph.h"
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C" {
|
||||
#endif
|
||||
|
||||
/**
|
||||
* @brief LED configuration
|
||||
*/
|
||||
static const saul_gpio_params_t saul_gpio_params[] =
|
||||
{
|
||||
#ifndef MODULE_ESP32_TTGO_T_BEAM_V1_0
|
||||
{
|
||||
.name = "LED",
|
||||
.pin = LED0_PIN,
|
||||
.mode = GPIO_OUT,
|
||||
.flags = SAUL_GPIO_INIT_CLEAR
|
||||
},
|
||||
#endif
|
||||
{
|
||||
.name = "PRG",
|
||||
.pin = BUTTON0_PIN,
|
||||
.mode = GPIO_IN,
|
||||
.flags = SAUL_GPIO_INVERTED
|
||||
},
|
||||
};
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif /* GPIO_PARAMS_H */
|
||||
/** @} */
|
||||
182
boards/esp32-ttgo-t-beam/include/periph_conf.h
Normal file
182
boards/esp32-ttgo-t-beam/include/periph_conf.h
Normal file
@ -0,0 +1,182 @@
|
||||
/*
|
||||
* Copyright (C) 2019 Yegor Yefremov
|
||||
*
|
||||
* 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_ttgo-t-beam
|
||||
* @brief Peripheral MCU configuration for TTGO T-Beam board
|
||||
* @{
|
||||
*
|
||||
* TTGO T-Beam is an ESP32 development board with 4 MB Flash that
|
||||
* uses the EPS32 chip directly. It integrates a SemTech SX1276 or SX1278 for
|
||||
* LoRaWAN communication in the 433 MHz or the 868/915 MHz band, respectively.
|
||||
* Additionally, it has an GPS receiver connected via UART on board.
|
||||
*
|
||||
* 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 Yegor Yefremov <yegorslists@googlemail.com>
|
||||
*/
|
||||
|
||||
#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 \ref adc_init function, they can be used for other
|
||||
* purposes.
|
||||
*/
|
||||
#ifndef ADC_GPIOS
|
||||
#if MODULE_ESP32_TTGO_T_BEAM_V1_0
|
||||
#define ADC_GPIOS { GPIO0, GPIO2, GPIO4, GPIO13, GPIO25, \
|
||||
GPIO32, GPIO33, GPIO35 }
|
||||
#else
|
||||
#define ADC_GPIOS { GPIO0, GPIO2, GPIO4, GPIO13, GPIO25, \
|
||||
GPIO32, GPIO33, GPIO34, GPIO35 }
|
||||
#endif
|
||||
#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 \ref dac_init function, they can be used for other
|
||||
* purposes.
|
||||
*
|
||||
* Since all DAC GPIOs are used for board control functions, there are no
|
||||
* GPIOs left that can be used as DAC channels.
|
||||
*/
|
||||
#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) */
|
||||
#endif
|
||||
#ifndef I2C0_SDA
|
||||
#define I2C0_SDA GPIO21 /**< SDA signal of I2C_DEV(0) */
|
||||
#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 { GPIO14, GPIO0, GPIO2, GPIO25 }
|
||||
#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_CTRL
|
||||
#define SPI0_CTRL VSPI /**< VSPI is used as SPI_DEV(0) */
|
||||
#endif
|
||||
#ifndef SPI0_SCK
|
||||
#define SPI0_SCK GPIO5 /**< VSPI SCK */
|
||||
#endif
|
||||
#ifndef SPI0_MISO
|
||||
#define SPI0_MISO GPIO19 /**< VSPI MISO */
|
||||
#endif
|
||||
#ifndef SPI0_MOSI
|
||||
#define SPI0_MOSI GPIO27 /**< VSPI MOSI */
|
||||
#endif
|
||||
#ifndef SPI0_CS0
|
||||
#define SPI0_CS0 GPIO18 /**< VSPI CS0 */
|
||||
#endif
|
||||
/** @} */
|
||||
|
||||
/**
|
||||
* @name UART configuration
|
||||
*
|
||||
* ESP32 provides 3 UART interfaces 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 GPIO1 /**< direct I/O pin for UART_DEV(0) TxD, can't be changed */
|
||||
#define UART0_RXD GPIO3 /**< direct I/O pin for UART_DEV(0) RxD, can't be changed */
|
||||
|
||||
#ifndef UART1_TXD
|
||||
#if MODULE_ESP32_TTGO_T_BEAM_V1_0
|
||||
#define UART1_TXD GPIO12 /**< direct I/O pin for UART_DEV(1) TxD */
|
||||
#else
|
||||
#define UART1_TXD GPIO15 /**< direct I/O pin for UART_DEV(1) TxD */
|
||||
#endif /* MODULE_ESP32_TTGO_T_BEAM_V1_0 */
|
||||
#endif
|
||||
#ifndef UART1_RXD
|
||||
#if MODULE_ESP32_TTGO_T_BEAM_V1_0
|
||||
#define UART1_RXD GPIO34 /**< direct I/O pin for UART_DEV(1) RxD */
|
||||
#else
|
||||
#define UART1_RXD GPIO12 /**< direct I/O pin for UART_DEV(1) RxD */
|
||||
#endif /* MODULE_ESP32_TTGO_T_BEAM_V1_0 */
|
||||
#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