本案例展示 Tab5 作为 Home Assistant 触控面板的固定配置。Tab5 通过 LVGL 界面读取 Home Assistant 实体状态,并执行灯光、空调等实体操作。
| 项目 | 信息 |
|---|---|
| 硬件产品 | Tab5、Unit ENV-Pro、Unit NeoHEX |
| 外部实体 | Home Assistant 中已接入的空调实体 |
| 应用功能 | 触控显示环境数据,控制灯光、空调和其他 Home Assistant 实体 |
| ESPHome 版本要求 | 2025.12.0 及以上 |
2025.12.0。2025 年 10 月 14 日之后生产、采用 ST723 LCD/触摸屏 IC 的 Tab5 硬件版本,当前配置暂不支持。Tab5 HMI 配置包含主配置、LVGL 界面和交互脚本,完整配置可通过 packages 引入:
packages:
remote_package_files:
url: https://github.com/m5stack/esphome-yaml
files: [common/tab5-ha-hmi.yaml]
ref: main
refresh: 1d 完整 YAML 及其依赖文件:
使用配置前,在 YAML 的 wifi 部分填写实际网络信息。设备配置、校验和部署方式请参考 ESPHome 快速上手。
Add,完成 ESPHome 集成。

Tab5 需要获得 Home Assistant 执行动作的权限,才能控制灯光、空调等实体。
Settings,查看 ESPHome 集成提示。
Settings -> Devices & services -> ESPHome 中找到 Tab5,打开设置并勾选 Allow the device to perform Home Assistant actions。
Submit 保存授权。
Light 页面,可切换灯光、调节亮度和修改 RGB 颜色。
Climate 页面,可调节目标温度、运行模式和风速。