Tuya Vacuum Maps

Hello,

I made a new integration for viewing the map from Tuya robot vacuums.
I have only tested it with the Lefant M1 vacuum, so help testing it out will be greatly appreciated.

You can find it here: GitHub - jaidenlabelle/tuya-vacuum-maps: šŸ  View Real-Time Vacuum Maps In Home Assistant

Thanks,
Jaiden Labelle

6 Likes

This could be interesting. I guess Iā€™ll be finding out if this works with a Lefant N3ā€¦

1 Like

Hi, is this supposed to work with Lidar devices only, or would ā€œmotion basedā€ maps be exposed with the same Tuya API? (Eufy G30 Edge user here).
Thanks!

Each type of robot vacuum handles map data differently, so Iā€™m not sure if gyroscope based robot vacuums would work with the API currently used. However, I do plan to add support for them as a short-medium term goal.

Will this work with the local tuya integrations? Iā€™m having issues with the Tuya Developer IOT Core license expiring, so I no longer see the map image in home assistant.

Youā€™re able to renew your license for free for up to 6 months at a time I believe. I donā€™t support local connectivity yet because of the unique and complicated way map data is transferred/stored, however it is in my queue.

OK, iā€™ve asked for a 6 month extension, hopefully it will come through. Thanks.

Looks like an interesting integration. I have just tried to add a Lubluelu vacuum but get ā€˜An unknown errorā€™ occured when trying to configure the integration- any advice?

2 Likes

Tested and working with lubluelu SL60D - might want to update your compatibility list on Github - I donā€™t have an account to post.

For anyone else who is totally in the dark with the Tuya IoT platform etc. This is what I did.

1- Install the Tuya Integration in HA (via HACS) and get it working - simple - uses same credentials as you use to log into the Smart Life App. Now the vac works in HA and you can add a card, with the custom Vacuum card (again , from HACS).

2- create an account on https://platform.tuya.com/
3 - click cloud, then create a cloud project, making sure your chosen server region matches the one you set up your Smart Life App with. Accept defaults for everything else apart from a name for your project.
4 - Devices, Link App Account, then follow the instructions (open teh app, Me, settings, hti the bar code scan icon top right). Your vac will be added as a device.
5 - whilst still in your Project go to the Service API Tab and ā€œGo to Authoriseā€ and add ā€œSweeping Robot Open Serviceā€ - this was crucial.
6 - in HA HACS install this Tuya Vacuum Maps" add on, restart as usual.
7 - in Devices add the integration for this card, and you then get the credentials asked for from Tuya platform in your cloud project tab - 2 from one tab, one from the device tab.
8 - finally, in your custom vacuum card, under optional ā€œvacuum cameraā€ select the new camera called ā€œvacuum cameraā€ or similar and bingo! your large robo vac graphic will be replaced with your room map.

Hello,
Iā€™m trying to configure your integration, but unfortunately Iā€™m getting ā€œunknown error occuredā€.

Logs:

2025-03-24 11:52:13.689 DEBUG (MainThread) [tuya_vacuum.tuya] Making 'GET' request to 'https://openapi.tuyaeu.com' at '/v1.0/users/sweepers/file/[REDACTED]/realtime-map'
2025-03-24 11:52:13.689 DEBUG (MainThread) [tuya_vacuum.tuya] Fetching access token
2025-03-24 11:52:13.689 DEBUG (MainThread) [tuya_vacuum.tuya] Making 'GET' request to 'https://openapi.tuyaeu.com' at '/v1.0/token?grant_type=1'
2025-03-24 11:52:14.069 ERROR (MainThread) [custom_components.tuya_vacuum_maps.config_flow] Error occurred while validating: 'NoneType' object is not subscriptable

Any suggestions?

Service API:

Best regards

1 Like

Same thing here