# Tesvor X500: reconstructing local UART control and path data

> 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.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-08
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/hannes813/tesvor-x500-pro-esphome-vacuum>
- Primary source: <https://github.com/hannes813/tesvor-x500-pro-esphome-vacuum/blob/f81ef302639cd7db97056dca190a89da681d232b/README.md>
- Catalog page: <https://awesomerea.org/resources/tesvor-x500-uart-case/>
- Record JSON: <https://awesomerea.org/resources/tesvor-x500-uart-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/tesvor-x500-uart-case/index.md)

## Requirements & limits

- **Prerequisites:** 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.
- **Limits:** Back up the original 4 MB firmware before flashing; mop-cleaning and fan controls are experimental.
- **License:** MIT license.

## Primary sources

1. <https://github.com/hannes813/tesvor-x500-pro-esphome-vacuum/blob/f81ef302639cd7db97056dca190a89da681d232b/README.md>
2. <https://github.com/hannes813/tesvor-x500-pro-esphome-vacuum/blob/f81ef302639cd7db97056dca190a89da681d232b/docs/PROTOCOL_LEADS.md>
3. <https://github.com/hannes813/tesvor-x500-pro-esphome-vacuum/blob/f81ef302639cd7db97056dca190a89da681d232b/LICENSE>

## More in Protocols

- [Bambu Lab P2S: reconstructing LAN printer control](https://awesomerea.org/resources/bambu-p2s-lan-case/index.md) · Case study
- [Beurer BM59 Unlocked: reconstructing direct BLE measurement transfer](https://awesomerea.org/resources/beurer-bm59-unlocked-case/index.md) · Case study
- [PiBuddyCam: reconstructing Buddy3D camera cloud behavior](https://awesomerea.org/resources/pibuddycam-case/index.md) · Case study
- [AirDrop for Windows: investigating iPhone discovery and AWDL reception](https://awesomerea.org/resources/airdrop-windows-case/index.md) · Case study
- [PSA VAN-CAN protocol bridge: translating vehicle bus generations](https://awesomerea.org/resources/psa-van-can-protocol-bridge-case/index.md) · Case study
- [aioharmony: Logitech Harmony Hub protocol notes and client](https://awesomerea.org/resources/aioharmony-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.