Résumer cet article :
一款自动割草机Mammotion，就像是一个自主的同事：只要我们让它通过官方应用在一旁工作，一切都很顺利……直到有一天我们想给它施加真正的生活规则。下雨时不外出，避免在孩子们在花园里玩的时候经过，利用太阳能的高峰期，或与家庭日程同步割草。这正是Home Assistant所能提供的：将LUBA或YUKA转变为完整的智能设备，配备可用传感器，随时可访问的命令，尤其是能够节省时间的自动化（并避免一些冷汗）。今天我将向您展示如何将您的Mammotion自动割草机集成到Home Assistant中，使割草终于融入您的家庭……而不是被禁锢在某个应用中。
Mammotion集成带来的具体好处
其意义在于将割草从“应用孤岛”中释放出来。一旦LUBA或YUKA进入Home Assistant，机器人就成为另一种智能设备：您可以获取传感器数据（电池状态、状态、GPS、卫星、工作区域、连接类型等）并触发动作（启动、暂停、停止、返回基座/停靠站）。
结果是：您的场景可以在机器人先行做出决策（或作为补充）。典型的例子是：在下雨来临时迅速停止割草，避免在酷暑时割草，利用太阳能过剩的时间段，或者在孩子们在外面玩耍时阻止割草……简而言之，切实可行，而非小玩意。
启动前的先决条件
首先请确认您的Home Assistant为最新版本：集成要求最低版本为Home Assistant 2025.3.0。
您还需要HACS（Home Assistant社区商店），因为我们在这里安装的是一个社区集成……它不在HACS的“默认”目录中，您需要将其添加为自定义库。
最后一个重要点：强烈建议创建一个专用的Mammotion第二账户用于Home Assistant。否则，使用主账户登录时，您可能会被移动应用断开连接，这会很麻烦 :)
步骤1：创建一个Mammotion第二账户
打开Mammotion应用，创建一个新账户（另一个电子邮件即可）。然后，重新登录到您的主账户，然后进入设备共享，以便将您的机器人共享到该第二账户。最后，重新登录到第二账户并接受共享：您将在Home Assistant中仅使用这个“次要”账户。
是的，这有点“行政工作”……但这可以避免之后的分歧（以及像“为什么我的应用会自动断开连接？！”这样的消息）。
步骤2：通过HACS安装Mammotion集成
在Home Assistant中，打开HACS，然后进入集成。在菜单（右上角的三个点）中，打开自定义库并添加库https://github.com/mikey0000/Mammotion-HA，选择集成类别。
接下来在HACS中搜索“Mammotion”，安装该集成，然后重新启动Home Assistant。
步骤3：在Home Assistant中添加集成
重启后，进入设置 → 设备与服务 → 添加集成，搜索“Mammotion”，然后启动配置。
此时，有两个概念确实很重要：
- 首先，连接。集成支持蓝牙（BLE）和Wi-Fi（包括通过SIM卡的4G，根据型号），并且有一个以控制、调度、区域等为重点的路线图。
- 然后，如果您选择使用蓝牙，而您的Home Assistant远离机器人，一个ESPHome蓝牙代理可能会非常有用（一个放在合适位置的小ESP32，Home Assistant“延伸”其BLE范围）。
这里我们将采用更简单的Wi-Fi连接，因为整个花园的覆盖面积都很好。
只需输入刚创建的第二个Mammotion账户的电子邮件和密码：
步骤4：检查上报的实体和传感器
一旦集成设置完成，您应该能看到您的机器人连同命令和许多传感器出现在界面中。这里我获取了最近测试的Luba Mini AWD Lidar。在有用信息方面，通常会包括电池电量、状态（割草、充电、空闲…）、连接类型、GPS位置、卫星数量、工作区域等。
步骤5：从Home Assistant启动割草
集成暴露了一个专门的动作mammotion.start_mow。为了快速测试，进入开发工具 → 动作，选择mammotion.start_mow，定位到您的割草机，然后填写您的型号支持的参数。
简单示例（根据您的实体/区域进行调整）：
action: mammotion.start_mow
data:
is_mow: true
speed: 0.3
border_mode: "1"
ultra_wave: "2"
areas: [switch.mower_1]
根据维基，有一些通用选项（割草顺序、速度、障碍物检测、轨迹模式等）、特定于YUKA的选项（收集/放置、边缘等），以及像割草高度等特定于LUBA的选项。
非常实用的自动化想法
从现在开始，可以创建各种自动化集成割草机。例如：
- 智能天气停割。如果您的气象站（Netatmo、Zigbee传感器或天气集成）报告高概率的降雨，Home Assistant可以在花园变成滑冰场之前将割草机送回基座。
- 防高温。如果外界温度超过某个阈值（例如30°C），您可以将割草推迟到晚上或第二天。这不仅仅是舒适：在某些干燥的地面上，强烈日光下割草可能效果也不太好。
- 利用太阳能余量割草。如果您在Home Assistant中监控光伏发电，当您在两个时间段（例如午后的短暂间隙）之间有剩余时，触发割草是个非常简单的技巧，以利用产生的太阳能为机器人充电。
- 花园“出入安全”。如果某个门户传感器被激活，摄像头检测到有人，或激活了“烧烤”模式，您可以自动暂停割草机（因为在草丛中默默无闻的机器人会悄悄躲藏……直到它出现在错误的地方时）。
- 根据家庭日程。如果已经将家庭的日历集成到Home Assistant中，很容易了解机器人在花园中走动时不会造成干扰的时段。
一个自定义仪表板
通过从机器人获取的所有信息，可以创建一个个性化的仪表板，集成您的Mammotion割草机器人。我已经创建了这个仪表板：
通过HA-Animated-Cards等技术，可以实现相当不错的效果（我还需要继续努力，但前两个卡片已经展示了个大概）。
快速故障排除
如果您遇到针对APIapi.link.aliyun.com的超时，库中提到需要检查您的网络或防火墙是否阻止了“托管在中国”的服务。这种细节如果不知道，往往会浪费一个小时。
如果添加账户时拒绝您的电子邮件，库指出有时“账户号码”比电子邮件地址更有效（是的，这很奇怪，但最好记下来）。
结论
总的来说，将Mammotion自动割草机（LUBA或YUKA）集成到Home Assistant并不仅仅是“再为仪表板添加一个小玩意”。更重要的是重新掌控割草，将其联接到日常生活的真实信息上：天气、花园中的活动、时间安排、太阳能发电、家庭生活方式。一旦实体设置就位，我们会迅速发现，最佳收益来自简单的自动化：避开不良时段，适时停止并在条件完全合适时开始割草。这就是Mammotion + Home Assistant的意义所在：一块维护良好的草坪，无需操心，也没有意外。
