halandroid 的安装和配置教程

项目基础介绍

halandroid 是一个为 Home Assistant 定制的开源项目，旨在为 Worx Landroid 草地机器人提供支持。这个项目允许用户通过 Home Assistant 控制 Landroid 草地机器人。主要使用的编程语言是 Python，这是 Home Assistant 所使用的语言，确保了良好的兼容性。

项目使用的关键技术和框架

• Home Assistant: 一个智能家居自动化平台，用户可以通过它来控制家中的智能设备。
• HACS (Home Assistant Community Store): Home Assistant 的一个社区插件商店，用于安装第三方组件。
• Landroid Cloud: Worx Landroid 草地机器人的云服务，本项目基于此服务进行开发。

项目安装和配置的准备工作

在开始安装之前，请确保您已经满足了以下条件：

• 安装了 Home Assistant 并且运行稳定。
• 有 Landroid Cloud 账号和相应的草地机器人。
• 安装了 HACS 插件以便于安装额外的组件。

安装步骤

1. 安装 Landroid Cloud 集成

   • 打开 Home Assistant。
   • 进入配置页面。
   • 搜索并安装 Landroid Cloud 集成。
   • 根据提示完成安装。

2. 安装 fold-entity-row 插件

   • 使用 HACS 安装 fold-entity-row 插件。
   • 如果需要，也安装 card-tools 插件。

3. 配置 Home Assistant

   • 打开 configuration.yaml 文件。
   • 在文件中添加以下内容：

     packages: !include_dir_named packages
     

   • 在 secrets.yaml 文件中添加您的 Landroid Cloud 邮箱和密码：

     mower_mail: YOUR_EMAIL_IN_MY_LANDROID
     mower_pass: YOUR_PASSWORD_IN_MY_LANDROID
     mower_ip: YOUR_LANDROID_IP_ADDRESS_IF_YOU_NEED_IT_OR ''
     

4. 复制项目文件

   • 将项目中的 www 和 packages 文件夹复制到 Home Assistant 配置文件夹中。

5. 配置语言文件

   • 从 lang 文件夹中选择对应语言的文件（例如 lang/landroid_de.yaml），复制到 packages 文件夹中，重命名为相应的语言代码（例如 landroid_de.yml）。

6. 配置 Lovelace 卡片

   • 在 Lovelace 中创建一个新的手动卡片。
   • 根据需要，将 lovelace/card.yaml 或相应语言文件的卡片内容复制到新卡片中。

7. 修改草地机器人名称

   • 在 packages/landroid.yaml 和相应语言文件中，以及在新的 Lovelace 卡片中，将 landroid_mower 替换为您的草地机器人的名称。

8. 对于 LandXCape 或 Kress 草地机器人

   • 在 landroid.yaml 文件中取消注释相关的行：

     landroid_cloud:
       email: !secret mower_mail
       password: !secret mower_pass
       #type: landxcape
       #type: kress
     

9. 配置 Google Assistant（如果需要）

   • 在 Google Assistant 集成中使用 switch.landroid_mowing：

     switch.landroid_mowing:
       name: Mähroboter
       room: Garten
       expose: true
     

10. 检查配置并重启 Home Assistant

    • 确保所有的配置都正确无误。
    • 重启 Home Assistant 以应用更改。

现在，您应该能够通过 Home Assistant 控制您的 Landroid 草地机器人了。祝您使用愉快！