Deebot 扫地机与 Home Assistant 集成配置教程

配置参数详解

在配置流程中，您需要提供以下关键信息：

必填参数：

• username：Ecovacs 账号用户名
• password：Ecovacs 账号密码
• country：所在国家代码
• continent：所在大洲代码

可选参数：

• client_device_id：客户端设备 ID（用于多设备管理）
• verify_ssl：SSL 证书验证（默认开启）

区域清洁配置

实现精准的区域清洁控制：

# 在自动化中调用区域清洁
service: vacuum.send_command
target:
  entity_id: vacuum.deebot_xxx
data:
  command: clean_area
  params:
    rooms: ["卧室", "客厅"]
    cleanings: 2

自动化场景示例

工作日自动清洁：

alias: "工作日自动清洁"
description: "工作日上班后自动启动清洁"
trigger:
  - platform: time
    at: "09:00:00"
condition:
  - condition: time
    weekday:
      - mon
      - tue
      - wed
      - thu
      - fri
action:
  - service: vacuum.start
    target:
      entity_id: vacuum.deebot_xxx

电池低电量提醒：

alias: "低电量提醒"
description: "电池电量低于 20% 时发送通知"
trigger:
  - platform: numeric_state
    entity_id: sensor.deebot_battery
    below: 20
action:
  - service: notify.mobile_app_phone
    data:
      message: "Deebot 电池电量低，请及时充电"

常见问题解决方案

连接失败问题

症状：设备显示"不可用"状态

解决方案：

1. 检查网络连接稳定性
2. 验证 Ecovacs 账号密码是否正确
3. 确认国家/地区代码设置准确
4. 检查 Home Assistant 日志获取详细错误信息

地图不显示问题

症状：实时地图无法加载或显示空白

解决方案：

1. 确认设备支持地图功能
2. 检查设备固件是否为最新版本
3. 尝试重新启动 Home Assistant 服务
4. 使用刷新服务更新地图数据

设备离线问题

症状：设备频繁离线

解决方案：

1. 优化 WiFi 信号覆盖
2. 检查路由器防火墙设置
3. 确认 Ecovacs 服务器状态

性能优化建议

网络优化

• 确保 Deebot 设备与路由器信号强度良好
• 使用 2.4GHz WiFi 网络（部分设备不支持 5GHz）
• 避免网络地址转换 (NAT) 问题

资源管理

• 定期清理 Home Assistant 日志
• 监控集成性能表现
• 及时更新到最新版本

版本兼容性说明

支持的 Home Assistant 版本

• 最低要求：2024.1.0
• 推荐版本：2024.2.0 及以上

支持的 Deebot 型号

本集成支持大多数 Ecovacs Deebot 系列设备，包括但不限于：

• Deebot N8 系列
• Deebot T8 系列
• Deebot X1 系列

安全注意事项

账号安全

• 使用强密码保护 Ecovacs 账号
• 定期更改账号密码
• 不要在公共网络中存储敏感信息

数据隐私

• 所有设备数据仅存储在本地网络中
• 集成采用云端轮询方式，不持续保持连接
• 支持自签名证书验证选项

通过本指南，您已经掌握了 Deebot 与 Home Assistant 集成的完整流程。从基础安装到高级自动化，您现在可以充分利用智能扫地机的全部功能，打造更加智能、便捷的家居清洁体验。记住，良好的配置是智能家居成功的关键，定期检查和优化您的设置将确保最佳性能。