# Ecovacs Deebot X1: reconstructing local map and control interfaces

> Ecovacs Deebot X1 Local Control Research documents the robot's map format, ROS messages, state stream, and control services for local operation. The repository includes captured message definitions, scripts for querying and calling the ROS graph, and deployment notes for a separate Valetudo fork. The author reports working map, cleaning, and settings control on an X1 device.

- Type: Case study
- Targets: Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-08
- Original resource: <https://github.com/GrahamKowalski/ecovacs-x1-research>
- Primary source: <https://github.com/GrahamKowalski/ecovacs-x1-research/blob/9c42325642d7e4d902994b2f3875138b46b330c3/README.md>
- Catalog page: <https://awesomerea.org/resources/ecovacs-x1-local-control-case/>
- Record JSON: <https://awesomerea.org/resources/ecovacs-x1-local-control-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/ecovacs-x1-local-control-case/index.md)

## Requirements & limits

- **Prerequisites:** An Ecovacs Deebot X1 device with an accessible local ROS interface is required for live investigation.
- **Prerequisites:** The README identifies rooting and unlocking as prerequisites based on earlier public guides.
- **Limits:** The status notes report observations on an X1 Plus; X1 Turbo behavior is not separately verified.
- **License:** MIT license applies to original research documentation and scripts.

## Primary sources

1. <https://github.com/GrahamKowalski/ecovacs-x1-research/blob/9c42325642d7e4d902994b2f3875138b46b330c3/README.md>
2. <https://github.com/GrahamKowalski/ecovacs-x1-research/blob/9c42325642d7e4d902994b2f3875138b46b330c3/research/control-findings-2026-10-26.md>

## More in Protocols

- [MyEnergy Dashboard: reconstructing INFINITY 1000 Bluetooth controls](https://awesomerea.org/resources/myenergy-dashboard-case/index.md) · Case study
- [sk700v-linux: a Linux display client for the Sudokoo SK700V](https://awesomerea.org/resources/sk700v-linux-case/index.md) · Case study
- [OpenNoiseRep: a BLE client for the Noise REP fitness band](https://awesomerea.org/resources/opennoiserep-case/index.md) · Case study
- [rtchair: local control of the Rotai RT7709S massage chair](https://awesomerea.org/resources/rtchair-case/index.md) · Case study
- [zte-cpe-sms: reconstructing ZTE CPE SMS API access](https://awesomerea.org/resources/zte-cpe-sms-case/index.md) · Case study
- [gs5-rgb: Creative Sound Blaster GS5 lighting protocol](https://awesomerea.org/resources/gs5-rgb-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.