myPyllant Home Assistant 组件使用教程
项目介绍
myPyllant
是一个 Home Assistant 组件,用于通过 myVAILLANT API 控制 Vaillant 设备,如 aroTHERM 热泵和 ecoTEC 锅炉。该组件还支持 Saunier Duval 和 Bulex 等品牌的应用程序。此集成并非由 Vaillant 官方开发,开发者不承担因使用此库而导致的任何设备问题。
项目快速启动
安装步骤
-
安装 HACS: 确保你已经安装了 Home Assistant Community Store (HACS)。
-
在 HACS 中搜索 myVAILLANT: 在 HACS 的 Integrations 部分搜索
myVAILLANT
,并下载它。 -
重启 Home Assistant: 下载完成后,重启 Home Assistant。
-
添加 myVaillant 集成: 进入 Home Assistant 的设置 -> 设备与服务 -> 添加集成,选择
myVaillant
,并使用你在 myVAILLANT 应用中使用的邮箱和密码登录。
配置代码示例
# configuration.yaml
myvaillant:
email: your_email@example.com
password: your_password
应用案例和最佳实践
案例一:控制 aroTHERM 热泵
通过 myPyllant
组件,你可以轻松控制 aroTHERM 热泵的温度和运行模式。以下是一个简单的自动化示例,当室内温度低于 20°C 时自动开启热泵:
automation:
- alias: Turn on heatpump when temperature is low
trigger:
- platform: numeric_state
entity_id: sensor.indoor_temperature
below: 20
action:
- service: climate.set_temperature
target:
entity_id: climate.arotherm_heatpump
data:
temperature: 22
案例二:监控 ecoTEC 锅炉状态
你可以使用 myPyllant
组件监控 ecoTEC 锅炉的状态,并在出现问题时发送通知:
automation:
- alias: Notify when boiler status is not OK
trigger:
- platform: state
entity_id: sensor.boiler_status
to: 'not_ok'
action:
- service: notify.pushbullet
data:
message: "Boiler status is not OK, please check!"
典型生态项目
Home Assistant
myPyllant
组件是 Home Assistant 生态系统的一部分,Home Assistant 是一个开源的家庭自动化平台,允许用户集成和控制各种智能设备。
HACS (Home Assistant Community Store)
HACS 是一个社区驱动的存储库,提供各种自定义组件和插件,方便用户扩展 Home Assistant 的功能。
myPyllant Python 库
myPyllant
组件依赖于 myPyllant Python 库,该库提供了与 myVAILLANT API 交互的底层功能。
通过以上教程,你可以快速上手并充分利用 myPyllant
组件,实现对 Vaillant 设备的智能控制和监控。