English
English
简体中文
日本語

Tab5 Home Assistant HMI

This example shows Tab5 configured as a Home Assistant touchscreen panel. Tab5 uses an LVGL interface to read Home Assistant entity states and control entities such as lights and climate devices.

1. Application

Item Information
Hardware Tab5, Unit ENV-Pro, Unit NeoHEX
External entities Climate entities already integrated in Home Assistant
Application features Display environmental data by touch and control lights, climate devices, and other Home Assistant entities
ESPHome version 2025.12.0 or later
Compatibility
This example is based on ESPHome 2025.12.0. The current configuration does not support Tab5 hardware produced after October 14, 2025 with an ST723 LCD/touchscreen IC.

2. Complete Configuration

The Tab5 HMI configuration includes the main configuration, LVGL interface, and interaction scripts. Import the complete configuration with packages:

packages:
  remote_package_files:
    url: https://github.com/m5stack/esphome-yaml
    files: [common/tab5-ha-hmi.yaml]
    ref: main
    refresh: 1d

Complete YAML files and their dependencies:

Before using the configuration, enter the actual network credentials in the YAML wifi section. For device configuration, validation, and deployment, see ESPHome Quick Start.

3. Usage

Add the Device

  1. After the device connects to the network, click Add in the Home Assistant discovery prompt to complete the ESPHome integration.
  1. After the device is added, view environmental data and Home Assistant entity states on Tab5.

Authorize Entity Actions

Tab5 must be authorized to perform Home Assistant actions before it can control entities such as lights and climate devices.

  1. Open Settings in Home Assistant and view the ESPHome integration notification.
  1. Open the notification details.
  1. Go to Settings -> Devices & services -> ESPHome, locate Tab5, open its settings, and enable Allow the device to perform Home Assistant actions.
  1. Click Submit to save the authorization.

Control Entities

  1. Open the Light page from the sidebar to toggle lights, adjust brightness, and change RGB colors.
  1. Open the Climate page from the sidebar to adjust the target temperature, operating mode, and fan speed.
Page Tools
PDF
On This Page