将菲斯曼设备接入 Home Assistant

发表于 分类于 阅读次数： Disqus： 本文字数： 444 阅读时长 ≈ 2 分钟

在文章将公牛智家设备接入 Home Assistant 中，笔者介绍了通过抓包分析将公牛智能开关接入 Home Assistant 的方法。最近，家里的菲斯曼（Viessmann）壁炉也需要接入智能家居系统，以便更灵活地控制暖气和热水温度。虽然菲斯曼官方提供了 ViCare App，但其对第三方集成的支持主要集中在欧洲服务器，而中国区的设备使用的是独立的服务器和 API，现有的开源插件无法直接使用。因此，笔者再次通过抓包分析，实现了对菲斯曼中国区设备的接入。

经过分析，菲斯曼中国区 API 主要包括以下几个部分：

  • /idass/user/login，提交手机号和密码进行登录，获取access_token。
  • /api/home/familyDevices/v2，获取家庭设备列表，包括壁炉的physicsId等关键信息。
  • /api/device/detail，获取设备的详细运行状态，如当前模式、故障代码等。
  • /api/device/scanStatus，获取设备的实时传感器数据，如出水温度、燃烧状态等。
  • /api/3/sendToDevice/setChsetTemp 等控制接口，用于设置暖气温度、热水温度和运行模式。

通过这些 API，我们可以在 Home Assistant 中实现以下功能：

  1. 暖气控制：调节暖气目标温度，切换制热 / 防冻模式。
  2. 热水控制：调节生活热水目标温度。
  3. 状态监测：实时查看壁炉是否在燃烧、出水温度以及是否有故障报警。

全部代码已开源至hass-viessmann-cn，可以直接在 Home Assistant 中使用。安装方法非常简单，支持 HACS 一键安装，配置时只需输入菲斯曼 App 的账号密码即可。