TTGO T-Beam

Caution

This page is automatically generated from RIOT doxygen documentation. If you find any issues or have suggestions for improvement, please report them on Github.

View Doxygen Documentation View this board's documentation as generated by Doxygen.

View on GitHub View this board's source code on GitHub.

Tip

When using this board with RIOT, set the BOARD variable to esp32-ttgo-t-beam in your Makefile. If you follow the standard RIOT project structure, your Makefile should look like this:

./Makefile

# name of your application
APPLICATION = hello-world

# Change this to your board if you want to build for a different board
BOARD ?= esp32-ttgo-t-beam

# This has to be the absolute path to the RIOT base directory:
RIOTBASE ?= $(CURDIR)/RIOT

include $(RIOTBASE)/Makefile.include

Support for TTGO T-Beam boards @author Yegor Yefremov yegorslists@googlemail.com

\section esp32_ttgo_t_beam TTGO T-Beam

Table of Contents

1. Overview
2. Hardware
   1. MCU
   2. Board Configuration
   3. Board Pinout
   4. Optional Hardware Configurations
3. Flashing the Device

Overview

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

Back to table of contents

Hardware

This section describes

• the MCU,
• the default board configuration,
• optional hardware configurations,
• the board pinout.

Back to table of contents

MCU

Most features of the board are provided by the ESP32 SoC. For detailed information about the ESP32, see section esp32_mcu_esp32 “MCU ESP32”.

Back to table of contents

Board Configuration

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 SX1278 for LoRaWAN communication in the 433 MHz band
• SemTech SX1276 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 ADC_GPIOS and the PWM channel definition 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., adc_init, dac_init and pwm_init, or
• the corresponding peripheral interface is used for the first time, e.g., 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 esp32_application_specific_configurations “application-specific configurations”.

TTGO- T-Beam rev1

Function | GPIOs | Remarks |Configuration :---------------|:-------|:--------|:---------------------------------- BUTTON0 | GPIO39 | low active | | LED0 | GPIO14 | high active | | ADC | GPIO0, GPIO2, GPIO4, GPIO13,\n GPIO25, GPIO32, GPIO33, GPIO35,\n GPIO36, GPIO34 | | esp32_adc_channels "ADC Channels" DAC | GPIO25 | | esp32_dac_channels "DAC Channels" PWM_DEV(0) | GPIO14, GPIO0, GPIO2, GPIO25 | | esp32_pwm_channels "PWM Channels" I2C_DEV(0):SDA | GPIO21 | | esp32_i2c_interfaces "I2C Interfaces" I2C_DEV(0):SCL | GPIO22 | I2C_SPEED_FAST is used | esp32_i2c_interfaces "I2C Interfaces" SPI_DEV(0):CLK | GPIO5 | VSPI is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(0):MISO | GPIO19 | VSPI is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(0):MOSI | GPIO27 | VSPI is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(0):CS0 | GPIO18 | VSPI is used | esp32_spi_interfaces "SPI Interfaces" UART_DEV(0):TxD | GPIO1 | Console (configuration is fixed) | esp32_uart_interfaces "UART interfaces" UART_DEV(0):RxD | GPIO3 | Console (configuration is fixed) | esp32_uart_interfaces "UART interfaces" UART_DEV(1):TxD | GPIO15 | GPS (configuration is fixed) | esp32_uart_interfaces "UART interfaces" UART_DEV(1):RxD | GPIO12 | GPS (configuration is fixed) | esp32_uart_interfaces "UART interfaces"

TTGO- T-Beam V1.0

Function | GPIOs | Remarks |Configuration :---------------|:-------|:--------|:---------------------------------- BUTTON0 | GPIO38 | low active | | ADC | GPIO0, GPIO2, GPIO4, GPIO13,\n GPIO25, GPIO32, GPIO33, GPIO35,\n GPIO36, GPIO39 | | esp32_adc_channels "ADC Channels" DAC | GPIO25 | | esp32_dac_channels "DAC Channels" PWM_DEV(0) | GPIO14, GPIO0, GPIO2, GPIO25 | | esp32_pwm_channels "PWM Channels" I2C_DEV(0):SDA | GPIO21 | | esp32_i2c_interfaces "I2C Interfaces" I2C_DEV(0):SCL | GPIO22 | I2C_SPEED_FAST is used | esp32_i2c_interfaces "I2C Interfaces" SPI_DEV(0):CLK | GPIO5 | VSPI is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(0):MISO | GPIO19 | VSPI is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(0):MOSI | GPIO27 | VSPI is used | esp32_spi_interfaces "SPI Interfaces" SPI_DEV(0):CS0 | GPIO18 | VSPI is used | esp32_spi_interfaces "SPI Interfaces" UART_DEV(0):TxD | GPIO1 | Console (configuration is fixed) | esp32_uart_interfaces "UART interfaces" UART_DEV(0):RxD | GPIO3 | Console (configuration is fixed) | esp32_uart_interfaces "UART interfaces" UART_DEV(1):TxD | GPIO34 | GPS (configuration is fixed) | esp32_uart_interfaces "UART interfaces" UART_DEV(1):RxD | GPIO12 | GPS (configuration is fixed) | esp32_uart_interfaces "UART interfaces" \n

@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 esp32_peripherals “Common Peripherals”.

Back to table of contents

Board Pinout

The following figures show the pinout of the defined default configurations for TTGO T-Beam boards.

The corresponding board schematics can be found on TinyMicros.com for TTGO T-Beam rev0 and GitHub for TTGO T-Beam V1.0

Back to table of contents

Flashing the Device

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 esp32_riot.

Back to table of contents