{
  "added_at": "2026-11-09",
  "additional_evidence_urls": [
    "https://github.com/hannes813/tesvor-x500-pro-esphome-vacuum/blob/f81ef302639cd7db97056dca190a89da681d232b/docs/PROTOCOL_LEADS.md",
    "https://github.com/hannes813/tesvor-x500-pro-esphome-vacuum/blob/f81ef302639cd7db97056dca190a89da681d232b/LICENSE"
  ],
  "category": "reconstruction-cases",
  "class": "hardware",
  "description_en": "The Tesvor X500/X500 Pro project reconstructs the robot vacuum's local UART control and path-point messages for its ESP8266/ESP-12S module. ESPHome firmware exposes cleaning commands to Home Assistant and publishes path data over MQTT for a Python writer and map viewer.",
  "description_zh": "Tesvor X500/X500 Pro 项目重建扫地机器人的本地 UART 控制与路径点消息，并在原有 ESP8266/ESP-12S 模块上运行 ESPHome。固件向 Home Assistant 提供清扫指令，经 MQTT 发送路径数据供 Python 写入器和地图页面使用。",
  "entry_url": "https://awesomerea.org/resources/tesvor-x500-uart-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/tesvor-x500-uart-case/",
  "evidence_url": "https://github.com/hannes813/tesvor-x500-pro-esphome-vacuum/blob/f81ef302639cd7db97056dca190a89da681d232b/README.md",
  "group": "cases",
  "id": "tesvor-x500-uart-case",
  "json_url": "https://awesomerea.org/resources/tesvor-x500-uart-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/tesvor-x500-uart-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/tesvor-x500-uart-case/index.md",
  "name": "Tesvor X500: reconstructing local UART control and path data",
  "name_zh": "Tesvor X500：重建本地 UART 控制与路径数据",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "prerequisites",
    "limits",
    "license"
  ],
  "requirements": [
    "The documented setup uses a Tesvor X500/X500 Pro with an ESP-12S module and an MQTT broker; it was tested with ESPHome 2025.7.x.",
    "Back up the original 4 MB firmware before flashing; mop-cleaning and fan controls are experimental.",
    "MIT license."
  ],
  "requirements_zh": [
    "文中的配置使用配备 ESP-12S 模块的 Tesvor X500/X500 Pro 和 MQTT broker；项目在 ESPHome 2025.7.x 上测试。",
    "刷写前须备份原有 4 MB 固件；拖地清扫和风扇控制仍属实验功能。",
    "采用 MIT 许可证。"
  ],
  "targets": [
    "protocol"
  ],
  "url": "https://github.com/hannes813/tesvor-x500-pro-esphome-vacuum",
  "verification": "source-reviewed",
  "verified_at": "2026-11-08"
}
