TTGO T1

Classic ESP32 TTGO board with LiPo support and headers - great for basic wireless development and IoT builds.

Micro-USB
TTGO T1 board
ESP32
MCU
240MHz
clock
4MB
flash
520KB
SRAM
31· 16 ADC
GPIO
BLE 4.2+ WiFi
radio
On this page

TTGO T1 Pinout

36 pins
TTGO T1 pinout diagram
PinGPIOLabelsStatusCapabilitiesNotes
1-GNDground-Ground
223GPIO23MOSIsafespiVSPI MOSI
322GPIO22SCLsafei2cDefault I2C SCL, onboard LED (LED_BUILTIN)
41GPIO1TXuartuartUART0 TX
53GPIO3RXuartuartUART0 RX
621GPIO21SDAsafei2cDefault I2C SDA
7-5Vpower-5V from USB / power input
819GPIO19MISOsafespiVSPI MISO
918GPIO18SCKsafespiVSPI SCK
105GPIO5SSstrappingspiVSPI SS
1117GPIO17safe-General-purpose IO
1216GPIO16safe-General-purpose IO
134GPIO4safeadc · touchADC2_CH0, Touch0
140GPIO0strappingadc · touchADC2_CH1, Touch1
152GPIO2SD MISOstrappingadc · touch · spimicroSD MISO, ADC2_CH2, Touch2
1615GPIO15SD MOSIstrappingadc · touch · spimicroSD MOSI, ADC2_CH3, Touch3
178SD1GPIO8strapping-Flash pin - do not use
187SD0GPIO7strapping-Flash pin - do not use
19-3V33.3Vpower-3.3V regulated output
20-RSTENcontrol-Chip enable / reset (active LOW)
2136SVPGPIO36strappingadcADC1_CH0, input only
2239SVNGPIO39strappingadcADC1_CH3, input only
2334GPIO34strappingadcADC1_CH6, input only
2435GPIO35strappingadcADC1_CH7, input only
2532GPIO32safeadc · touchADC1_CH4, Touch9
2633GPIO33safeadc · touchADC1_CH5, Touch8
2725GPIO25safeadc · dacDAC1, ADC2_CH8
2826GPIO26safeadc · dacDAC2, ADC2_CH9
2927GPIO27safeadc · touchADC2_CH7, Touch7
3014GPIO14SD SCKstrappingadc · touch · spimicroSD SCK, ADC2_CH6, Touch6
3112GPIO12strappingadc · touchADC2_CH5, Touch5
32-GNDground-Ground
3313GPIO13SD CSstrappingadc · touch · spimicroSD CS, ADC2_CH4, Touch4
349SD2GPIO9strapping-Flash pin - do not use
3510SD3GPIO10strapping-Flash pin - do not use
3611CMDGPIO11strapping-Flash pin - do not use
31 GPIOs broken out 13 free · 13 need care · 5 to avoid

Start with these

13 pins with no boot or system involvement
GPIO23GPIO22GPIO21GPIO19GPIO18GPIO17GPIO16GPIO4GPIO32GPIO33GPIO25GPIO26GPIO27

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

Fine - with a little care

13 pins · 12 things to know
GPIO1 Default UART0 TX pin for USB-serial programming and console. UART

Connected to on-board USB-UART for uploading and logs; drives serial output at boot, so using as GPIO can disrupt programming or console.

GPIO3 Default UART0 RX pin for USB-serial programming (console input). UART

Used for receiving data from USB-UART (programming); also pulled HIGH at boot for console communication, so using as GPIO can disrupt uploads.

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

GPIO0 Bootstrapping pin (enter bootloader when low); internal pull-up. Strapping

Must be HIGH during boot for normal startup; if held LOW on reset, forces flash programming mode.

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

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

SVPGPIO36 Input-only GPIO (no output); ADC1 channel 0, Hall sensor VP. Other

Cannot be used as output; only suitable for input (e.g., analog read).

SVNGPIO39GPIO35 Input-only GPIOs with ADC1 channels - no output driver Other

Cannot be used as output; only suitable for input.

  • SVNInput-only GPIO (no output); ADC1 channel 3, Hall sensor VN.
  • GPIO35Input-only GPIO (no output driver); ADC1 channel 7.
GPIO34 Input-only GPIO (no output driver); ADC1 channel 6. Other

Cannot be used as output (no drive capability); only suitable for analog/digital input.

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

GPIO12 Bootstrapping pin; JTAG TDI; sets flash voltage (VDD_SDIO); also HSPIQ (flash data line). Strapping

Keep LOW during boot (internal PD); pulling HIGH at reset selects 1.8V flash mode, causing flash brownout if 3.3V flash is used.

GPIO13 JTAG clock pin (TCK); also ADC2 channel 4 / Touch4 input. JTAG

Used for JTAG debugging (TCK); avoid using as GPIO if JTAG is needed.

Only if you know the tricks

5 pins · 3 things to know
SD1GPIO8SD0GPIO7 SPI flash data lines SD0 and SD1 Flash

Used for internal flash/PSRAM data; not available for general GPIO.

  • SD1Connected to SPI flash data 1 (SD1).
  • SD0Connected to SPI flash data 0 (SD0).
SD2GPIO9SD3GPIO10 SPI flash/PSRAM data lines SD2 and SD3 (flash HOLD and WP) Flash

Used by internal flash/PSRAM; typically not exposed on modules, avoid using as GPIO.

  • SD2Connected to SPI flash/PSRAM data 2 (SD2, flash HOLD).
  • SD3Connected to SPI flash/PSRAM data 3 (SD3, flash WP).
CMDGPIO11 Connected to SPI flash command/CS (CMD/CS0). Flash

Used by internal flash (chip select/command); not available for general use.

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.

The TTGO T1 breaks out 36 pins in total: 31 GPIO for your project, with GND, 5V and 3V3 handling power.

For peripherals, I²C is mapped to SDA on GPIO21 and SCL on GPIO22; the SPI bus (MOSI, MISO, SCK, SS) is broken out in full; TX/RX on GPIO1 and GPIO3 cover serial logging and flashing.

On the analog side there are 16 ADC-capable pins for sensors and battery monitoring, 10 capacitive-touch inputs and 2 true DAC outputs.

If you want zero surprises, GPIO23, GPIO22, GPIO21, GPIO19 and 9 more are free of any such role - the safest first picks. 13 of the exposed pins carry boot-time or system duties on the ESP32 (GPIO1, GPIO3, GPIO5 and 10 more).

Getting started

flash your first firmware in ~2 minutes
Tool:
1
Connect over USB
Install your USB-serial driver (CH340 / CP210x) if no port appears. Not detected? Hold BOOT while plugging in.
2
Match & flash
Set the Tools options shown, then click Upload.
3
Verify it runs
GPIO23 toggles - wire an LED and resistor to it, or change the pin to your board's own LED.
Set these in Tools · leave everything else at default
Arduino IDE 2.x - Tools Copy
Board: "ESP32 Dev Module"▸
Flash Size: "4MB (32Mb)"▸
Flash Mode: "DIO"▸
Partition Scheme: "Default 4MB with spiffs (1.2MB APP/1.5MB SPIFFS)" (default)▸
Upload Speed: "921600"▸
▸ every other Tools option - leave at default
Board: 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
Find it: Tools ▸ Board ▸ ESP32 Arduino ▸ ESP32 Dev Module
blink.ino Copy
// toggle GPIO23 - wire an LED and resistor to it
void setup() {
  pinMode(23, OUTPUT);
}
void loop() {
  digitalWrite(23, HIGH); delay(500);
  digitalWrite(23, LOW);  delay(500);
}
board to selectesp32dev⧉ copy
platformio.ini Copy
[env:ttgo-t1]
platform = espressif32
board = esp32dev
framework = arduino
monitor_speed = 115200
upload_speed = 921600
Find it: PlatformIO Home ▸ Boards, search esp32dev - or type it after board =.
board to selectesp32dev⧉ copy
device.yaml Copy
esp32:
  board: esp32dev
  variant: esp32
  framework:
    type: esp-idf

# blink - GPIO23
output:
  - platform: gpio
    pin: 23
    id: led_out
light:
  - platform: binary
    name: "LED"
    output: led_out
Find it: search ESPHome's board list for esp32dev (same ids as PlatformIO).
esptool doesn't pick board settings - a prebuilt .bin already has them baked in. This is just the raw flash command.
terminal Copy
esptool.py --chip esp32 --port /dev/ttyACM0 \
  --baud 921600 write_flash 0x1000 firmware.bin
--port = your /dev/tty* (macOS/Linux) or COMx (Windows).
Build details: sketch space 1310720 B · data 327680 B · DIO

Specifications

ESP32 · vs other ESP32 chips →
Compute
MCU
ESP32
Clock
240 MHz
SRAM · Flash
520 KB · 4MB
Radio
Wi-Fi
802.11 b/g/n
Bluetooth
4.2 LE
Antenna
PCB
I/O
GPIO · ADC
31 · 16
UART · I²C · SPI
3 · 2 · 2
PWM
16 channels
Power
USB
Micro-USB
Serial
CH340C
Boot address
0x1000
Electrical
Input
5V USB · 3.7V LiPo
Consumption
-
Regulator
-
Flashing
Upload · OTA
esptool_py · esp_ota
Flash · Boot mode
DIO · DIO
Sketch · Data
1.25 MB · 320 KB
The TTGO T1 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 320 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 $7.00 - less than the ~$20 most ESP32 boards go for.

31 GPIO are broken out - more than most ESP32 boards, so the pin budget is rarely the constraint.

Onboard you'll find a microSD slot, battery charging via JST 1.25mm and Reset buttons.

  • Power on/off switch

Where to buy

prices are typical street prices
TTGO T1
TTGO T1
$7.00per unit, typical

Resources

Similar boards