Lovelace Xiaomi Vacuum Map Card与Roborock设备集成配置指南

问题背景

在使用Lovelace Xiaomi Vacuum Map Card插件与Roborock S5 Max扫地机器人集成时，部分用户会遇到"Invalid calibration"错误提示。该问题通常出现在同时使用官方Roborock集成和第三方地图插件时，由于配置不当导致的地图校准失败。

核心问题分析

错误产生的根本原因在于地图数据源的配置冲突。当用户同时安装以下两种集成时：

1. 官方Roborock集成（提供基础控制功能）
2. 第三方RoborockCustomMap插件（提供高级地图功能）

系统会生成两个独立的地图图像实体：

• 官方集成生成的image.roborock_s5_max_map_0
• 第三方插件生成的独立地图实体

正确配置方案

配置步骤

1. 安装必备组件

   • 通过HACS安装RoborockCustomMap插件
   • 确保已启用官方Roborock集成

2. 配置YAML

type: custom:xiaomi-vacuum-map-card
map_source:
  camera: 第三方插件生成的地图实体名称
calibration_source:
  camera: true
entity: vacuum.roborock_s5_max
vacuum_platform: Roborock

关键注意事项

1. 必须使用RoborockCustomMap插件生成的地图实体，而非官方集成生成的地图
2. 实体名称通常在集成配置完成后自动生成，格式类似image.roborock_custom_map_[ID]
3. 配置前需确保：
   • 已清除浏览器缓存
   • 使用最新版插件
   • 检查Home Assistant日志是否有报错

技术原理

该卡片插件通过以下流程工作：

1. 获取地图原始数据（来自指定实体）
2. 应用校准参数（转换坐标系统）
3. 渲染交互式地图界面

当使用官方集成的地图数据时，由于数据格式和校准参数的差异，会导致卡片无法正确解析地图信息，从而触发校准错误。

最佳实践建议

1. 对于Roborock设备用户，推荐完整配置流程：

   • 先配置官方集成确保基础功能
   • 再添加CustomMap插件获取增强功能
   • 最后配置本卡片时选择CustomMap提供的地图源

2. 调试技巧：

   • 通过开发者工具检查实体状态
   • 对比不同地图实体的属性差异
   • 临时启用调试模式观察日志输出

总结

正确理解各集成组件的关系和数据流是解决此类问题的关键。通过区分官方和第三方插件提供的地图数据源，可以避免常见的校准错误，充分发挥Lovelace Xiaomi Vacuum Map Card的可视化优势。