Xiaomi Vacuum Map Card 地图控制功能失效问题解析

问题背景

在使用Xiaomi Vacuum Map Card（小米扫地机器人地图卡片）时，部分用户反馈地图控制功能无法正常工作。具体表现为：用户可以通过地图界面选择清洁区域或指定目标点，但命令无法成功发送至机器人设备。

问题现象

1. 用户能够正常显示地图界面
2. 可以在地图上选择区域或目标点
3. 操作后会显示"success"提示
4. 但实际命令未到达机器人
5. 非地图控制功能（如启动、暂停等）工作正常

问题原因

经过分析，该问题通常由以下原因导致：

1. MQTT主题配置错误：地图卡片需要正确配置MQTT通信主题才能与机器人进行通信
2. 大小写不匹配：MQTT主题名称对大小写敏感，配置时需确保完全一致
3. 平台类型选择错误：使用了不正确的vacuum_platform参数

解决方案

正确配置MQTT主题

对于使用Valetudo平台的用户，必须在卡片配置中添加topic参数，指向正确的MQTT主题。例如：

map_source:
  camera: camera.valetudo_s5_camera
entity: vacuum.valetudo_robot
vacuum_platform: Hypfer/Valetudo
topic: valetudo/rockrobo  # 必须与机器人实际使用的MQTT主题一致

检查大小写一致性

确保配置中的topic值与机器人实际使用的MQTT主题完全一致，包括大小写。例如：

• "valetudo/rockrobo" ≠ "Valetudo/Rockrobo"

验证平台类型

确认vacuum_platform参数设置正确：

• 对于Valetudo平台，应使用"Hypfer/Valetudo"
• 对于其他平台，需选择对应的平台类型

配置示例

以下是完整的工作配置示例：

type: custom:xiaomi-vacuum-map-card
map_source:
  camera: camera.valetudo_s5_camera
calibration_source:
  camera: true
entity: vacuum.valetudo_robot
vacuum_platform: Hypfer/Valetudo
topic: valetudo/rockrobo
map_locked: false
two_finger_pan: true

总结

地图控制功能失效通常是由于通信配置不当导致的。通过正确设置MQTT主题、确保大小写一致以及选择正确的平台类型，可以解决大多数地图控制问题。建议用户在遇到类似问题时，首先检查这些关键配置项。