简体中文
English
简体中文
日本語

Tab5 Home Assistant HMI

本案例展示 Tab5 作为 Home Assistant 触控面板的固定配置。Tab5 通过 LVGL 界面读取 Home Assistant 实体状态,并执行灯光、空调等实体操作。

1. 应用说明

项目 信息
硬件产品 Tab5Unit ENV-ProUnit NeoHEX
外部实体 Home Assistant 中已接入的空调实体
应用功能 触控显示环境数据,控制灯光、空调和其他 Home Assistant 实体
ESPHome 版本要求 2025.12.0 及以上
兼容性
案例配置基于 ESPHome 2025.12.0。2025 年 10 月 14 日之后生产、采用 ST723 LCD/触摸屏 IC 的 Tab5 硬件版本,当前配置暂不支持。

2. 完整配置

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 快速上手

3. 使用方法

添加设备

  1. 设备联网后,在 Home Assistant 的设备发现提示中点击 Add,完成 ESPHome 集成。
  1. 添加完成后,可在 Tab5 上查看环境数据和 Home Assistant 实体状态。

授权实体操作

Tab5 需要获得 Home Assistant 执行动作的权限,才能控制灯光、空调等实体。

  1. 在 Home Assistant 中打开 Settings,查看 ESPHome 集成提示。
  1. 打开提示详情。
  1. Settings -> Devices & services -> ESPHome 中找到 Tab5,打开设置并勾选 Allow the device to perform Home Assistant actions
  1. 点击 Submit 保存授权。

控制实体

  1. 在侧边栏打开 Light 页面,可切换灯光、调节亮度和修改 RGB 颜色。
  1. 在侧边栏打开 Climate 页面,可调节目标温度、运行模式和风速。

4. 相关链接

5. 相关视频

Page Tools
PDF
On This Page