Skip to content

HomeTiles

Tile-based firmware that turns ESP32-P4 and ESP32-S3 touch displays into Home Assistant control panels — configured entirely in the browser, updated over the air, connected via MQTT.

Buy Me a Coffee

HomeTiles dashboard on the Waveshare 8 inch display HomeTiles screensaver with clock and sensor tiles

Demo

New Here? Four Steps

  1. Flashing the Firmware

    Install or update HomeTiles directly here in the browser. Select the exact device, then choose Update to keep its settings or First install / factory reset for a clean installation.

    Flashing the Firmware

  2. Connect everything

    Set up the MQTT broker, install the bridge integration, and pair the display with Home Assistant.

    Home Assistant Setup

  3. Build your dashboard

    Open the display's admin panel in your browser: click a cell, pick a tile type, done. Drag & drop, folders, everything saves automatically.

    Web Admin Panel

  4. Use the display

    Control lights with a color wheel, check sensor history, energy statistics, weather, and media — all in touch popups on the device.

    On-Device UI

Looking for something specific? Tile Types · Local Hardware I/O · Screensaver · Firmware Updates · FAQ & Troubleshooting · GitHub

New In v0.6.8

HomeTiles v0.6.8 stabilizes Camera presentation on native ESP32-P4 DSI displays, records a persistent diagnostic before a controlled display-pipeline restart, and distinguishes a missing Camera response from an outdated Bridge. It also fixes Waveshare 7B/7B-C startup and publishes two explicit installer entries for ESP32-P4 before v3.0 (revisions 1–199) and exact ESP32-P4 v3.1. The exact-v3.1 entry is experimental and has not been hardware-verified; v3.2 or newer is unsupported and must not be flashed.

The Waveshare 10.1-inch and Guition JC1060 V2 now start in their reported working orientation, and the 10.1-inch brightness controls keep a readable 2% minimum. HomeTiles Bridge v0.6.37 remains recommended; no new Bridge protocol is required.

Read the v0.6.8 release notes

Device Support

HomeTiles running on three ESP32-P4 displays

Hardware-confirmed

Device Display Status
M5Stack Tab5 5" 1280×720 Supported
Waveshare ESP32-P4-WIFI6-Touch-LCD-4B 4" 720×720 Supported
Waveshare ESP32-P4-86-Panel-ETH-2RO 4" 720×720 Supported, native Ethernet; uses the 4B firmware
Waveshare ESP32-P4-WIFI6-Touch-LCD-8 8" 1280×800 Supported
Guition JC8012P4A1C_I_W_Y 10.1" 1280×800 Supported V1 panel; no V2 suffix
Guition ESP32-4848S040C_I 4" 480×480 Supported ESP32-S3 target; no Camera tiles

Hardware validation notes

Exact device Display Test status
Waveshare ESP32-P4-WIFI6-Touch-LCD-7 7" 1280×720 Testing requested in #7
Waveshare ESP32-P4-WIFI6-Touch-LCD-7B / 7B-C 7" 1024×600 Explicit pre-v3 revisions 1–199 and experimental exact-v3.1 EK79007 images; exact-v3.1 hardware is unverified and testing is requested in #7
Waveshare ESP32-P4-WIFI6-Touch-LCD-10.1 10.1" 1280×800 Core display/touch/network/OTA reported working; corrected defaults, SD and Camera checks remain in #7
Guition JC8012P4A1 V2 (SKU:10153002-V2) 10.1" 1280×800 Separate V2 image; release/OTA testing tracked in #18
Guition JC1060P470C_I_W_Y V1 7" 1024×600 _I_W_Y only; testing requested in #8
Guition JC1060P470C V2 / New Panel 7" 1024×600 Basic operation reported working; corrected orientation and full release/OTA validation tracked in issue #27
Waveshare ESP32-S3-Touch-LCD-4B 4" 480×480 Separate ESP32-S3 profile without microSD; validation tracked in issue #26

Every release provides factory and OTA images for 13 explicit installer/release profiles covering twelve physical device profiles. The Waveshare 7B/7B-C has separate pre-v3 revisions 1–199 and exact-v3.1 entries, so the release contains 13 builds and 26 firmware files. Other current P4 profiles use vendor-listed P4NRW32/pre-v3 modules and are also guarded to revisions 1–199. HomeTiles' browser, Web Admin, and OTA paths enforce these ranges; v3.2 or newer is not supported. The notes above identify profiles whose complete hardware checklist still needs confirmation.

How It Works

Display ← MQTT → MQTT Broker ← MQTT → Bridge IntegrationHome Assistant

The display never talks to Home Assistant directly. The bridge integration pushes entity states, icons, weather, history, and energy data over MQTT — and executes the commands the display sends back. Firmware and bridge are MIT-licensed and developed together.