Shellies Discovery 教程

Shellies Discovery 教程

ha-shellies-discoveryScript that adds MQTT discovery support for Shellies devices项目地址:https://gitcode.com/gh_mirrors/ha/ha-shellies-discovery

---

项目介绍

Shellies Discovery 是一个开源脚本，专为 Home Assistant 用户设计，旨在自动发现和支持第二代（Gen2）及第三代（Gen3）Shelly 设备的MQTT发现功能。通过此脚本，Home Assistant 可以无缝集成这些设备，大大简化了智能家居配置过程。它支持广泛的小贝壳设备家族，从基础的开关到复杂的环境传感器，确保您的Shelly设备能够高效地与Home Assistant协同工作。

---

项目快速启动

环境准备

确保您已安装并配置好以下组件：

• Home Assistant：最新版本。
• MQTT：因为该脚本依赖于MQTT协议来实现设备的发现和服务发布。

安装步骤

1. 在你的Home Assistant配置目录中创建或找到python_scripts文件夹。

2. 使用Git克隆脚本仓库到本地：

   git clone https://github.com/bieniu/ha-shellies-discovery.git <your_home_assistant_config>/python_scripts/ha-shellies-discovery
   

3. 更新自动化配置。在Home Assistant的configuration.yaml中添加以下自动化以触发设备发现：

   automation:
     - alias: 'Shellies Discover'
       trigger:
         platform: homeassistant
         event: start
       action:
         service: mqtt.publish
         data:
           topic: "shellies/command"
           payload: "announce"
   

4. 重启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设备检测到门窗开启时，自动发送通知到手机。

---

请注意，实际部署前，请仔细阅读项目的最新文档和更新日志，确保兼容性和安全性。随着项目的发展，上述步骤可能会有所变化。

ha-shellies-discoveryScript that adds MQTT discovery support for Shellies devices项目地址:https://gitcode.com/gh_mirrors/ha/ha-shellies-discovery