TTGO LoRa32-OLED
ESP32 board with built-in OLED and LoRa - perfect for long-range wireless projects with a visual interface.
TTGO LoRa32-OLED Pinout
18 pins · 2.54 mm pitch
| Pin | GPIO | Labels | Status | Capabilities | Notes |
|---|---|---|---|---|---|
| 1 | 16 | OLED RSTGPIO16 | safe | - | OLED Reset (V1.0 only) |
| 2 | 4 | OLED SDAGPIO4 | safe | 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
11 pins with no boot or system involvementFreely assignable - no strapping, flash, USB or JTAG duties. Ideal first picks for buttons, sensors and LEDs.
Fine - with a little care
7 pins · 5 things to knowOLED SCLGPIO15SDCard MOSIGPIO15 Bootstrapping pin; JTAG TDO; controls UART0 boot log output; also HSPICS0 (secondary SPI CS). Strapping
Keep HIGH during boot (internal PU); if LOW on reset, bootloader log is silenced and boot mode may change.
- OLED SCLBootstrapping pin; JTAG TDO; controls UART0 boot log output; also HSPICS0 (secondary SPI CS).
- SDCard MOSIBootstrapping pin; JTAG TDO; controls UART0 boot log output; also HSPICS0 (secondary SPI CS).
SDCard CSGPIO13 JTAG clock pin (TCK); also ADC2 channel 4 / Touch4 input. JTAG
Used for JTAG debugging (TCK); avoid using as GPIO if JTAG is needed.
SDCard MISOGPIO2 Bootstrapping pin (must be low or floating at reset); internal pull-down. Strapping
If driven HIGH on reset (while IO0 is LOW), selects an unsupported SDIO boot mode, causing boot failure.
SDCard SCLKGPIO14LORA RSTGPIO14 JTAG mode select pin (TMS); also HSPI CLK and PWM-capable GPIO. JTAG
Used for JTAG debugging (TMS); driving it as GPIO may interfere with JTAG or produce spurious signals at boot.
- SDCard SCLKJTAG mode select pin (TMS); also HSPI CLK and PWM-capable GPIO.
- LORA RSTJTAG mode select pin (TMS); also HSPI CLK and PWM-capable GPIO.
LORA SCLKGPIO5 Bootstrapping pin; internal pull-up; VSPI CS0 (default SPI chip-select); acts as FSPIWP (flash write-protect) on internal-flash variants. Strapping
Must be HIGH during boot; if pulled LOW at reset, alters SDIO slave timing and may prevent normal boot.
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 RST, OLED SDA, OLED SDA, OLED SCL and 7 more are free of any such role - the safest first picks. 7 of the exposed pins carry boot-time or system duties on the ESP32 (OLED SCL, SDCard CS, SDCard MOSI and 4 more).
Getting started
flash your first firmware in ~2 minutesBoard: ESP32 Dev Module Flash Size: 4MB (32Mb) Flash Mode: DIO Partition Scheme: Default 4MB with spiffs (1.2MB APP/1.5MB SPIFFS) Upload Speed: 921600
// toggle GPIO16 - wire an LED and resistor to it
void setup() {
pinMode(16, OUTPUT);
}
void loop() {
digitalWrite(16, HIGH); delay(500);
digitalWrite(16, LOW); delay(500);
}[env:ttgo-lora32]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600esp32dev - or type it after board =.esp32:
board: esp32dev
variant: esp32
framework:
type: esp-idf
# blink - GPIO16
output:
- platform: gpio
pin: 16
id: led_out
light:
- platform: binary
name: "LED"
output: led_outesp32dev (same ids as PlatformIO).esptool.py --chip esp32 --port /dev/ttyACM0 \
--baud 921600 write_flash 0x1000 firmware.bin--port = your /dev/tty* (macOS/Linux) or COMx (Windows).Specifications
ESP32 · 60 × 30 mm · vs other ESP32 chips →Dimensions
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 pricesResources
Similar boards
