Gardena Smart System 集成 Home Assistant 使用教程

hass-gardena-smart-system Home Assistant custom component integration for Gardena Smart System 项目地址: https://gitcode.com/gh_mirrors/ha/hass-gardena-smart-system

1. 项目介绍

Gardena Smart System 是一套智能家居系统，它允许用户通过智能设备控制园艺设备，如智能浇水控制器、割草机、传感器等。本项目是一个开源项目，旨在将 Gardena Smart System 与 Home Assistant 集成，使得用户可以通过 Home Assistant 统一管理 Gardena 设备。

2. 项目快速启动

环境要求

Home Assistant 版本 0.115.0 或更高版本

安装方法

通过 HACS 安装

如果尚未安装 HACS，请先访问 HACS 安装页面并按照说明进行安装和配置。
在 HACS 中找到 Gardena Smart System 集成并安装。
重启 Home Assistant。

手动安装

将本仓库的 /hass-gardena-smart-system/custom_components/gardena_smart_system 路径下的文件复制到你的 Home Assistant 安装目录下的 /config/custom_components/gardena_smart_system 路径。
或者，在你的 Home Assistant 系统的 SSH 终端中运行以下命令：

cd /config
git clone https://github.com/py-smart-gardena/hass-gardena-smart-system.git
# 如果 custom_components 文件夹不存在，则创建它：
mkdir custom_components
cd custom_components
ln -s ../hass-gardena-smart-system/custom_components/gardena_smart_system

配置

在 Home Assistant 的“集成”页面下搜索“Gardena Smart System”，输入你的应用密钥（Application Key / Client ID）和应用密钥（Application secret / Client Secret）。
获取 Gardena 应用密钥和密钥，请访问 Gardena 开发者平台，创建一个新应用并连接相应的 API。
配置完成后，你可能需要重启 Home Assistant 以使集成生效。

3. 应用案例和最佳实践

案例一：智能浇水

使用 Gardena Smart Irrigation Control，可以根据土壤湿度自动开启或关闭浇水阀，以实现智能浇水。

- id: ' irrigation_control'
  alias: '智能浇水控制'
  description: '根据土壤湿度自动控制浇水阀'
  trigger:
    - platform: state
      entity_id: sensor.soil_humidity
      below: '30'
  condition: []
  action:
    - service: switch.irrigation_control_valve_X
      data:
        entity_id: switch.irrigation_control_valve_X
        state: 'on'

案例二：割草机定时启动

设置割草机（Gardena Smart Mower）的定时启动，让其在特定时间自动开始割草。

- id: ' mower_start'
  alias: '割草机定时启动'
  description: '每天上午 10 点启动割草机'
  trigger:
    - platform: time
      at: '10:00:00'
  condition: []
  action:
    - service: lawn_mower.start_mowing
      data:
        entity_id: lawn_mower.your_mower_entity_id

4. 典型生态项目

Home Assistant: 智能家居自动化平台，可以集成多种智能家居设备。
Gardena Smart App: Gardena 官方应用程序，用于控制 Gardena 智能设备。
Node-RED: 一个用于连接不同设备和服务的可视化编程工具，可以与 Home Assistant 集成。

以上是基于 Gardena Smart System 集成 Home Assistant 的基本教程，你可以根据自己的需求进行扩展和定制。