Eufy Robovac Data Logger

Shout out to the people behind the code that I used to make this work.

The integration would not be possible without the code and work by both https://github.com/jeppesens/eufy-clean & https://github.com/martijnpoppen/eufy-clean. Their code makes this integration work, Login, talk to the correct Eufy servers, Access the api server to get the current DPS data for this integration to log. Without these people this would not be possible. Thank you martijnpoppen & jeppesens. I just expanded upon their work to try and enhance the Eufy Robovac comminity and users.

A simple Home Assistant custom component that logs Eufy Robovac API data to JSON files for external analysis.

🎯 What This Integration Does

This integration connects to your Eufy Robovac via MQTT and dumps all protobuf data (keys 150-180) to JSON files whenever your press the log button. Perfect for researchers and developers who want to analyze Eufy's data structure. Eufy decided to tweak the login and authentication by including a "Gtoken" authentication code. O how much joy this was to decode and update the integration to now include the illusive "Gtoken" not to worry, its sorted in the latest code. Due to the latest firmware and app updates the Robovac now seems to go into a DEEP idle sleep. it tells the eufy server its sleeping/idle and all comminication mqtt data related to the dps keys and accessory data keys seems to stop dead No matter what I try I just can not "NUDGE" the mqtt data stream back to life. I think only the app can do it via a different server or rest command that we do not have access to. The integration now loggs EVERY mqtt command that it finds into a log file /config/logs/eufy_mqtt_XXXXXX.log the XXXXXX is a 24hour date stamped log and will grow massive.. 10,000 lines + in an hour Be Warned

Core Features

• MQTT Data Collection: Uses proven Eufy API to fetch device data
• Automatic Data Dumping: Saves keys 150-180 to JSON files every minute
• Simple Sensors: Shows battery level and clean speed in Home Assistant
• Clean JSON Output: Structured data ready for external protobuf analysis

📊 Data Collection

The integration dumps all data from keys 150-180, which includes:

• Simple Values: Battery (163), Clean Speed (158), etc.
• Protobuf Data: Base64 encoded data in keys like 152, 153, 154, 157, 162, 164, 165, 166, 167, 168, 169, and more

Output Format

Files are saved to: /config/eufy_robovac_dumps/YOUR_DEVICE_ID/

Example JSON structure:

{
  "timestamp": "2025-01-15T10:30:00",
  "device_id": "YOUR_DEVICE_ID",
  "device_name": "Your Robovac Name",
  "device_model": "T2351",
  "update_count": 1,
  "keys": {
    "150": null,
    "151": true,
    "152": "BAgYEGg=",
    "153": "DBADGgIQAXICIgB6AA==",
    "158": "3",
    "163": "100",
    "167": "base64_protobuf_data...",
    "168": "base64_protobuf_data...",
    "180": "base64_protobuf_data..."
  }
}