Shellies Discovery 教程
项目介绍
Shellies Discovery 是一个开源脚本,专为 Home Assistant 用户设计,旨在自动发现和支持第二代(Gen2)及第三代(Gen3)Shelly 设备的MQTT发现功能。通过此脚本,Home Assistant 可以无缝集成这些设备,大大简化了智能家居配置过程。它支持广泛的小贝壳设备家族,从基础的开关到复杂的环境传感器,确保您的Shelly设备能够高效地与Home Assistant协同工作。
项目快速启动
环境准备
确保您已安装并配置好以下组件:
- Home Assistant:最新版本。
- MQTT:因为该脚本依赖于MQTT协议来实现设备的发现和服务发布。
安装步骤
-
在你的Home Assistant配置目录中创建或找到
python_scripts
文件夹。 -
使用Git克隆脚本仓库到本地:
git clone https://github.com/bieniu/ha-shellies-discovery.git <your_home_assistant_config>/python_scripts/ha-shellies-discovery
-
更新自动化配置。在Home Assistant的
configuration.yaml
中添加以下自动化以触发设备发现:automation: - alias: 'Shellies Discover' trigger: platform: homeassistant event: start action: service: mqtt.publish data: topic: "shellies/command" payload: "announce"
-
重启Home Assistant,让自动化生效,并等待Shelly设备被自动发现。
应用案例和最佳实践
-
自动化照明控制:利用Shelly Dimmer Gen2与Home Assistant结合,根据时间或者环境光线自动调整家庭照明的亮度。
-
配置示例:
automation: - alias: 'Sunset Lighting' trigger: platform: sun event: sunset condition: condition: state entity_id: binary_sensor.outside_light state: 'off' action: service: light.turn_on entity_id: light.living_room data: brightness_pct: 50
-
-
环境监控:将Shelly H&T Gen3连接至Home Assistant,自动记录室内温湿度,并设置警报系统。
典型生态项目
Shellies Discovery项目是更广泛智能家居生态系统的一部分,与其他如Home Assistant的插件、自定义组件以及各种MQTT客户端一起工作,形成了强大而灵活的家庭自动化解决方案。特别是在物联网(IoT)社区中,这样的工具促进了设备间的数据共享和智能联动,使得用户可以轻松构建定制化的场景和逻辑,提升家居生活体验。
例如,配合使用Home Assistant的Zones功能,您可以基于Shelly设备的位置信息来实施更为精细的区域化管理,或者结合IFTTT等服务进一步扩展功能,比如当Shelly设备检测到门窗开启时,自动发送通知到手机。
请注意,实际部署前,请仔细阅读项目的最新文档和更新日志,确保兼容性和安全性。随着项目的发展,上述步骤可能会有所变化。