tuya_cloud_map_extractor icon indicating copy to clipboard operation
tuya_cloud_map_extractor copied to clipboard

Tuya cloud vacuum map extractor for Home Assistant

"Buy Me A Coffee"

Tuya cloud vaccum map extractor

This integration extracts and exposes live maps from tuya laser vaccums into Home Assistant.

Disclaimer

This is my first Home Assistant integration, so if things go terribly wrong, please create an issue so i can learn from and fix it.

Installation

Using HACS

This integration is included in the HACS default repository. Just search for Tuya cloud map extractor and install!

Manually

To install this integration, manually add the contents of custom_components to your home assistant custom_components folder, and reboot.

Configuration

Prerequisites

  • A vacuum with Lidar support already added to the Tuya/Smart app.
  • A configured Tuya IoT development platform, including the following components:
    • A cloud project and linked device. (Need help? See the Tuya integration.)
    • The Tuya Sweeping Robot Open API added to the cloud platform (Main Menu -> Cloud -> Development - Service API and make sure to have Sweeping Robot Open Service added to the list of authorized services or the integration will not install and will return an "unknown" error).

Configuration in Home Assistant

After the installation of this integration into Home Assistant, the integration is configured via config flow. Add a new integration via the UI and choose "Tuya Vacuum Map Extractor". Then enter your Tuya IoT platform credentials.

Turn on and turn off

By default, the vacuum map camera is turned off. You have to manually call the service camera.turn_on and camera.turn_off. I would recommend this blueprint to automatically turn on and off camera updates depending on if the vacuum is docked or not.

Supported devices

Following is a list of currently supported devices (confirmed tested by individual users):

Feel free to test on your own devices, and add them here. For help, please create an issue!

Special thanks

This integration is largely based on Xiaomi Cloud Map Extractor. Thanks!