Is ST7789 240x240 Color IPS Display Compatible with Home Assistant (ESPHome)?

Verdict Badge

VERDICT: [ NATIVELY SUPPORTED ]

Protocol: SPI / 3.3V GPIO

Bridge Needed: NO

Hardware Safety & Verification Specs

Electrical parameters & logic voltage safety limits before powering ICs

🟢 3.3V Native Direct Hookup 🧪 Verified in Lab

Logic Voltage 3.3V Low-Power CMOS

Voltage Rating 3.0V - 3.3V DC Rail

Current Profile Peak Tx Current: ~180mA to ~250mA @ 3.3V

Environment Rating IP20 Indoor Climate Control

## Compatibility Overview

The ESP32-S3 paired with the ST7789 1.54 inch 240x240 IPS TFT display provides high-fps color dashboards in Home Assistant using native ESPHome display components.

Interactive Pinout & Wiring Diagram

Hover over any pin to view voltage limits and pull-up specifications

VCC

3.3V Power

GND

Ground Common

SDA / TX

Data Line (GPIO 21)

SCL / RX

Clock Line (GPIO 22)

CS / INT

Chip Select (GPIO 19)

## Technical Specification Matrix

Feature / Attribute	Specification / Status
Hardware Protocol	SPI / 3.3V GPIO
Bridge Required	NO
Border Router Needed	None
Exposed Entities	TFT Display Screen Backlight Dimmer Framebuffer
Pairing Complexity	Plug-and-Play
Factory Reset Instruction	Hold BOOT button while cycling EN button to enter USB serial flash mode.

## Step-by-Step Pairing Guide

Factory Reset Device

Hold BOOT button while cycling EN button to enter USB serial flash mode.

Initialize Pairing Mode on Home Assistant (ESPHome)

Open Home Assistant (ESPHome) administration console, navigate to Integrations / Add Device, and start pairing scanner.

Confirm Entity Binding & State Verification

Verify that primary entities (TFT Display Screen, Backlight Dimmer, Framebuffer) report live state changes inside Home Assistant (ESPHome).

Production Code Generator & Preset Toolkit

Pre-configured pinouts & drivers for ST7789 240x240 Color IPS Display

SDA Pin: SCL Pin:

Test in Wokwi Simulator ↗ | Real-time pin binding active

👥 Community Verified Database Continuous hardware testing updates

Report a Pinout Error or Submit Tested Code Snippets

Found a pin mapping quirk or built a custom ESPHome YAML driver for ST7789 240x240 Color IPS Display? Help us keep this matrix 100% accurate.

## Frequently Asked Questions

Does this device operate in Offline Mode?

Operates 100% locally over Wi-Fi via ESPHome native API.

What is the expected Battery Life & Power specification?

USB-C 5V input; 3.3V logic level SPI bus (SCL=GPIO12 SDA=GPIO11 CS=GPIO10 DC=GPIO9 RES=GPIO8).

How does Signal Mesh & Range Extension function?

Direct Wi-Fi 2.4GHz connection to Home Assistant network.

Related Compatibility Matrix Guides

Wi-Fi (Local)