雅图伴侣 Home Assistant 集成组件

本组件实现雅图伴侣运行数据 在Home Assistant 中展示。

安装

安装有两种方式，一种是手动安装，另一种是通过HACS安装，我们建议采用HACS安装，略微简单一些。

手动安装：

在 Home Assistant 的 custom_components 目录下新建一个 airtub_udp 目录，然后将本项目custom_components目录下所有文件复制到新建的 airtub_udp 目录下。

HACS安装：

打开HACS，选择【集成】，点击右上角【三个点】，选择【自定义存储库】，在弹出的对话框中，填入以下信息：

存储库填写 zenz/airtub_ha_reader
类别选择 集成

然后点击【添加】，在弹出的对话框中，选择【安装】即可。

配置

配置也有两种方式，一种是手动编辑配置，一种是通过配置服务来添加。

手动编辑配置

在 configuration.yaml 中添加如下配置：

airtub_udp:
    multicast_group: "224.0.1.3"
    multicast_port: 4211
    device: "your_device_serial"
    secret: !secret airtub_password

climate:
  - platform: airtub_udp
    operate: auto

其中 device 为注册壁挂炉序列号，secret 为注册壁挂炉密钥。operate为操作模式，可选值为auto、manual，auto为自动室温模式，manual为手动水温模式。

在 secrets.yaml 中添加如下配置：

airtub_password: "your_device_password"

配置服务添加

从菜单栏选择【配置】【设备与服务】【添加集成】，找到airtub_udp，点击添加，按照提示填写设备号，密码等信息，确认即可。

重启

无论是那种方式安装配置的，完成后都需要重启 Home Assistant。只有重启后，自定义集成组件才能使用。

使用

重启 Home Assistant 后，可以在【配置】- 【设备与服务】-【实体】中找到 sensor.boiler_[device]_xxx 的实体，其中 device 为配置中的 device 值。

_xxx 的各项解释如下：

"flt": 故障状态 0-无故障 其它故障见雅图伴侣小程序的故障帮助
"fst": 火焰状态 0-未点火、1-点火
"mod": 当前燃气比例阀开度 0-100%
"cct": 当前采暖水温度
"cdt": 当前生活热水温度
"ccm": 当前采暖状态 0-未开启、1-开启
"cdm": 当前生活热水状态 0-未开启、1-开启
"tct": 目标采暖水温度 [可修改]
"tdt": 目标生活热水温度 [可修改]
"tcm": 目标采暖水模式 0-未开启、1-开启 [可修改]
"tdm": 目标生活热水模式 0-未开启、1-开启 [可修改]
"atm": 自动室温调节模式 0-未开启、1-开启 [可修改]
"odt": 当前室外温度
"coe": 当前采用的室外温度补偿系数 [可修改]
"crt": 当前室温
"trt": 目标室温 [可修改]
"sch": 自动任务状态 0-未开启、1-开启 [可修改]
"vir": 屏蔽高温杀菌模式 0-未开启、1-开启(仅系统炉) [可修改]
"tdf": 生活水启停温差(仅系统炉) [可修改]

提供的服务

service: airtub_udp.sender
data:
  cmd: '{"tdm": 1, "tdt": 45}'

注意，只能接收json格式指令，可以多个指令一起发送。