TTGO LoRa32-OLED

by LilyGo

ESP32 board with built-in OLED and LoRa - perfect for long-range wireless projects with a visual interface.

Micro-USB

Buy on Amazon · $17.80 More sellers Pinout Datasheet ↗

60 × 30 mm

ESP32

MCU

240MHz

clock

4MB

flash

520KB

SRAM

14· Two 12-bit, 18 Channels ADC

GPIO

BLE 4.2+ WiFi

radio

Pinout

18 pins · 2.54 mm pitch

View:

Pin	GPIO	Labels	Status	Capabilities	Notes
1	16	OLED RSTGPIO16	strapping	-	OLED Reset (V1.0 only)
2	4	OLED SDAGPIO4	strapping	i2c	I2C Data Line (V1.0 only)
3	21	OLED SDAGPIO21	safe	i2c	I2C Data Line (V1.2+ only)
4	15	OLED SCLGPIO15	strapping	i2c	I2C Clock Line (V1.0 only)
5	22	OLED SCLGPIO22	safe	i2c	I2C Clock Line (V1.2+ only)
6	13	SDCard CSGPIO13	strapping	spi	SPI Chip Select (V1.6+)
7	15	SDCard MOSIGPIO15	strapping	spi	SPI Master Out Slave In (V1.6+)
8	2	SDCard MISOGPIO2	strapping	spi	SPI Master In Slave Out (V1.6+)
9	14	SDCard SCLKGPIO14	strapping	spi	SPI Clock Line (V1.6+)
10	21	DS3231 SDAGPIO21	safe	i2c	I2C Data Line (V1.2 T-Fox only)
11	22	DS3231 SCLGPIO22	safe	i2c	I2C Clock Line (V1.2 T-Fox only)
12	27	LORA MOSIGPIO27	safe	spi	SPI Master Out Slave In
13	19	LORA MISOGPIO19	safe	spi	SPI Master In Slave Out
14	5	LORA SCLKGPIO5	strapping	spi	SPI Clock Line
15	18	LORA CSGPIO18	safe	spi	SPI Chip Select
16	14	LORA RSTGPIO14	strapping	-	LoRa Reset (V1.0 only)
17	23	LORA RSTGPIO23	safe	-	LoRa Reset (V1.2+ only)
18	26	LORA DIO0GPIO26	safe	-	LoRa Interrupt Pin

Start with these

9 pins with no boot or system involvement

OLED SDAGPIO21OLED SCLGPIO22DS3231 SDAGPIO21DS3231 SCLGPIO22LORA MOSIGPIO27LORA MISOGPIO19LORA CSGPIO18LORA RSTGPIO23LORA DIO0GPIO26

Freely assignable - no strapping, flash, USB or JTAG duties. Ideal first picks for buttons, sensors and LEDs.

Fine - with a little care

sampled at boot or shared with debug/serial

Pin	Label	What to know	Role
OLED SDA	GPIO4	Sampled at reset for boot config; should not be driven at boot (affects boot mode timing).	Strapping
OLED SCL	MTDO (GPIO15)	Keep HIGH during boot (internal PU); if LOW on reset, bootloader log is silenced and boot mode may change.	Strapping
SDCard CS	MTCK (GPIO13)	Used for JTAG debugging (TCK); avoid using as GPIO if JTAG is needed.	Other
SDCard MOSI	MTDO (GPIO15)	Keep HIGH during boot (internal PU); if LOW on reset, bootloader log is silenced and boot mode may change.	Strapping
SDCard MISO	GPIO2	If driven HIGH on reset (while IO0 is LOW), selects an unsupported SDIO boot mode, causing boot failure.	Strapping
SDCard SCLK	MTMS (GPIO14)	Used for JTAG debugging (TMS); driving it as GPIO may interfere with JTAG or produce spurious signals at boot.	Other
LORA SCLK	GPIO5	Must be HIGH during boot; if pulled LOW at reset, alters SDIO slave timing and may prevent normal boot.	Strapping
LORA RST	MTMS (GPIO14)	Used for JTAG debugging (TMS); driving it as GPIO may interfere with JTAG or produce spurious signals at boot.	Other

Only if you know the tricks

wired to flash or USB - expect a fight

Pin	Label	What to know	Role
OLED RST	GPIO16	Connected to internal PSRAM on PSRAM-enabled modules; not usable as GPIO on those modules.	Flash

These are recommendations, not hard rules - with the right pull-ups, timing and boot-state awareness most pins can be made to work. When in doubt, start green.

Pinout notes The TTGO LoRa32-OLED pinout brings out 18 GPIO pins at a 2.54 mm pitch - every one of them usable in your project. If you want zero surprises, OLED SDA , OLED…

The TTGO LoRa32-OLED pinout brings out 18 GPIO pins at a 2.54 mm pitch - every one of them usable in your project.

If you want zero surprises, OLED SDA, OLED SCL, DS3231 SDA, DS3231 SCL and 5 more are free of any such role - the safest first picks. 8 of the exposed pins carry boot-time or system duties on the ESP32 (OLED SDA, OLED SCL, SDCard CS and 5 more).

Getting started

flash your first firmware in ~2 minutes

Tool:

Connect over USB

Serial chip: CH9102. Not detected? Hold BOOT while plugging in.

Flash with your tool

Arduino IDE, PlatformIO, ESPHome or esptool - copy the settings on the right.

Verify it runs

The blink example uses GPIO21 - swap for your board's LED pin if different.

Tools → Board settings Copy

Board:            Ttgo Lora32
Flash Size:       4MB · DIO
Upload Speed:     921600

// blink
pinMode(21, OUTPUT);
digitalWrite(21, LOW);   // on (often inverted)

platformio.ini Copy

[env:ttgo-lora32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600

device.yaml Copy

esp32:
  board: esp32dev
  variant: 
  framework:
    type: esp-idf

# blink - GPIO21
output:
  - platform: gpio
    pin: 21
    id: led_out
light:
  - platform: binary
    name: "LED"
    output: led_out

shell Copy

esptool.py --chip esp32 --port /dev/ttyACM0 \
  write_flash 0x0 firmware.bin

Build details: sketch space 1310720 B · data 294912 B · DIO

Specifications

ESP32 · 60 × 30 mm

Compute

MCU

ESP32

Clock

240 MHz

SRAM · Flash

520 KB · 4MB

Radio

Wi-Fi

802.11 b/g/n

Bluetooth

4.2 LE

Antenna

External

I/O

GPIO · ADC

14 · Two 12-bit, 18 Channels

UART · I²C · SPI

3 · 2 · 4

PWM

16 channels

Power

USB

Micro-USB

Serial

CH9102

Boot address

0x1000

Display

Screen

OLED · 0.96" · 128x64

Driver

SSD1306

Touch

Flashing

Upload · OTA

esptool_py · esp_ota

Flash · Boot mode

DIO · DIO

Sketch · Data

1.25 MB · 288 KB

60 × 30 mm · pin pitch 2.54 mm

The TTGO LoRa32-OLED uses esptool_py for firmware uploads, esp_ota for over-the-air (OTA) updates. Flash mode is DIO with DIO boot mode. The maximum sketch size is 1.25 MB with 288 KB available for data.

About this board

At its core is the ESP32 - a dual-core Xtensa with both Bluetooth Classic and BLE.

Expect to pay about $17.80 - in line with other ESP32 boards.

Only 14 GPIO are broken out, where most ESP32 boards manage about 24 - worth checking the pinout covers what you need.

Onboard you'll find an OLED 0.96" 128x64 display, a microSD slot, LoRa (SX1276), battery charging (TP4054) via JST-GH 1.25mm and Reset buttons.

OLED Screen
LoRa frequency variants (433 / 868 / 915 MHz)

Where to buy

prices are typical street prices

TTGO LoRa32-OLED

$17.80per unit, typical

AMZAmazon.com↗ DEAmazon.de↗ ALIAliExpress↗

As an Amazon Associate, ESPboards earns from qualifying purchases.

Resources

Board datasheet lilygo.cc↗ ESP32 datasheet espressif.com↗ LilyGo T3 LoRa32 Product Page lilygo.cc↗LilyGO/TTGO-LORA32 GitHub Repository github.com↗Meshtastic - LilyGo TTGO LoRa Devices meshtastic.org↗Random Nerd Tutorials - TTGO LoRa32 SX1276 randomnerdtutorials.com↗

Similar boards

Adafruit ESP32 Feather Feather-format ESP32 board with LiPo charging - great for wireless projects… ESP32 · 4MB

Adafruit Feather ESP32 V2 Updated Feather ESP32 with improved power handling and USB-C - great for… ESP32 · 8MB

Adafruit ItsyBitsy ESP32 Small ESP32 board in ItsyBitsy format - ideal for low-power wireless projects… ESP32 · 8MB