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