已发布项目

smart-home-panel-e58a9c56

Revision 3

1.0.1 真机验证更新：支持安装后通过 USB 保存私人桥接配置，增加设备输入及请求诊断，统一版本标识。六个按钮在设备端通过检查，真实 Home Assistant 联动仍待验证。

Smart Home Panel · 智能家居面板

把 ESP-Mosaico 变成触屏家居控制面板，通过 Wi-Fi 查看和控制已配置的 Home Assistant 灯光、窗帘、温度、空气质量和晚间场景。使用设备自带的 480 × 480 屏幕，无需扩展子板；联动功能需要 Home Assistant 和运行桥接程序的电脑。

智能家居面板真机画面

操作与 Home Assistant 配置

  • Living lights（客厅灯光）：切换已配置的灯或灯组。
  • Curtains（窗帘）：根据报告状态打开或关闭已配置的窗帘。
  • Temperature（温度）、Air quality（空气质量）：点击刷新读数。
  • Evening（晚间场景）：启动已配置的场景。
  • Lights off（关灯）：仅关闭已配置的灯或灯组。

读数会定期刷新，华氏温度会换算为摄氏度。在桥接电脑上设置以下环境变量：

变量 含义
HA_URL Home Assistant 基础地址
HA_TOKEN 私密的 Home Assistant 长期访问令牌
MOSAICO_LIGHT 灯或灯组的实体 ID
MOSAICO_COVER 窗帘实体 ID
MOSAICO_TEMPERATURE 温度传感器实体 ID
MOSAICO_AIR_QUALITY 空气质量传感器实体 ID
MOSAICO_SCENE 晚间场景实体 ID

使用前配置

当前为开发预览版。固件不包含私人桥接地址或令牌，可安装后通过 USB 保存配置，无需为个人凭据重新构建。 本版本仍需电脑运行桥接程序，屏幕内没有文字输入配置页。

  1. 安装提供的 1.0.1 Iris 固件，并在 Vibe Mode 中配置 Wi-Fi；应用复用已保存的网络。
  2. 在桥接电脑上安装 Python 3.10 或以上版本，通过环境变量 MOSAICO_BRIDGE_TOKEN 设置至少 24 个字符的随机私密令牌。
  3. 运行附件中的 python3 projects/ideas_common/bridge.py --bind 0.0.0.0 --port 8765。电脑和设备应位于能互相访问的局域网；电脑防火墙须允许桥接程序接收连接。程序默认仅监听本机，局域网访问需要显式指定监听地址。
  4. 在同一开发工作区，用 python3 mosaico.py iris device-status --project projects/smart_home --json 确认 USB 连接和 Device ID。
  5. 保持相同的 MOSAICO_BRIDGE_TOKEN 环境变量，执行 python3 projects/ideas_common/configure_device.py --project smart_home --device-id <Device-ID> --url https://<桥接地址>:8765。设置仅保存在板上的应用 NVS 中；配置程序会检查当前运行的应用和 USB 身份，响应不会返回令牌。
  6. HTTPS 可通过 bridge.py --cert <证书> --key <私钥> 启用；证书须受设备证书包信任，证书校验不会关闭。仅在可信局域网使用明文 HTTP 时，将 URL 改为 http://... 并显式添加 --allow-http。
  7. 清除配置时运行相同的配置命令并使用 --clear。不要公开令牌、个人构建配置或私密诊断日志。旧的 menuconfig 构建配置仍可使用，但不需要嵌入私人凭据来使用公开固件。

在使用固定 ESP-IDF 的工作区根目录执行：

python3 submodule/esp-mosaico-utils/mosaico-tools/skills/idf-low-noise-build/scripts/idf_low_noise_build.py --project projects/smart_home build
python3 projects/ideas_common/tests/check_bridge.py
python3 projects/ideas_common/tests/check_ui.py

提供的 1.0.1 Iris 包面向配备 16 MiB Flash、保留 Vibe Mode/Recovery 的 ESP32-S31，包含应用、分区表及界面数据。配置缺失、网络离线、认证失败和上游异常会显示在屏幕上；失败指令不会自动重发，出错后保留的读数会标注为上次结果。桥接服务的每个进程只保存一台遥控器的当前控制目标。

验证情况

1.0.1 已在 ESP32-S31 实机上安装，通过设备真实画面和 USB 注入触控检查所有六个按钮、请求路由、非法输入拒绝及同一启动期间的稳定性；应用崩溃计数为零。USB 配置保存、清除及输入校验已验证，公开固件仍不含私人配置。源代码逻辑检查、ESP-IDF 构建和原生模拟器检查也已通过。

真实 Home Assistant 设备联动尚未验证。USB 注入触控不等同于手指操作触摸控制器的验收。详情和安装过程限制见附件中的 projects/ideas_common/DEVICE_VALIDATION.md。

源码与资源许可

附件源码包不含凭据或带有个人配置的固件。将其中的 projects/ 解压到 ESP-Mosaico Vibe 开发工作区，保持本应用与 ideas_common 目录同级；构建依赖工作区已有的框架和工具，以及固定的 ESP-IDF 提交 7b9cc1ac79f865983f59bb8ff3ff43eb74ff1dbe。

界面使用 DejaVu 字体，详见字体许可。框架依赖保留各自许可证，本页面不新增整个仓库的授权条款。