Tuya Vacuum Maps

Share your Projects! Custom Integrations
,
1

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.

output
output3280×2000 75.1 KB

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

Thanks,
Jaiden Labelle

6 Likes
2

This could be interesting. I guess I’ll be finding out if this works with a Lefant N3…

1 Like
3

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!

4

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.

5

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.

6

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.

7

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

8

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
9

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.

10

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:

image
image283×443 4.71 KB

Best regards

1 Like
11

Same thing here

12

Hello. The API for managing robot vacuum cleaners is not present in the “standard” list. To make it all work you need to go here:

At this point, in the “Authorized Projects” tab click on the “Add Authorization” button and connect the project created previously. At this point in the “My Subscriptions” tab you will find the new API called “Sweeping Robot Open Service” and you can finally configure the integration in HA.

13

Did that, same nonetype error. Prior to adding “Sweeping Robot” I just got the first error. After adding I got the 2nd error instead. My Tuya API logs show success on their end.

Error occurred while validating: Request failed, unknown error: {'code': 28841101, 'msg': 'No permissions. This API is not subscribed.', 'success': False, 't': REDACTED, 'tid': 'REDACTED'}

Error occurred while validating: 'NoneType' object is not subscriptable
1 Like
15

I’m trying to get this to work with my new b0bsweep vacuum. I supply the required items in the setup and receive an “Unknown Error” message. I check the logs and I see:

This error originated from a custom integration.

Logger: custom_components.tuya_vacuum_maps.config_flow
Source: custom_components/tuya_vacuum_maps/config_flow.py:68
integration: Tuya Vacuum Maps (documentation, issues)
First occurred: 2:20:16 PM (3 occurrences)
Last logged: 2:29:20 PM

Error occurred while validating: Request failed, unknown error: {‘code’: 28841101, ‘msg’: ‘No permissions. This API is not subscribed.’, ‘success’: False, ‘t’: 1760552416435, ‘tid’: ‘9963503aa9f311f0a48d8207bb2252ca’}
Error occurred while validating: ‘NoneType’ object is not subscriptable

I have ensured that the “Sweeping Robot Open Service” API has been authorized:

image
image1778×600 35.2 KB

Any assistance is appreciated.

16

Any news on that topic ? I am trying to integrate my L20 Ultra…

17

Anyone testing in ABIR X8?

18

Hi

Did anyone that reported the uknown error issue find a solution? I am seeing the same problem having tried to configure the integration with a Airrobo P20 vac.

Exact error

This error originated from a custom integration.

Logger: custom_components.tuya_vacuum_maps.config_flow
Source: custom_components/tuya_vacuum_maps/config_flow.py:68
integration: Tuya Vacuum Maps (documentation, issues)
First occurred: 2 January 2026 at 21:35:00 (3 occurrences)
Last logged: 07:13:36

Error occurred while validating: ‘NoneType’ object is not subscriptable

I have checked, and the Sweeping Robot Open Service API is configured in the Tuya Cloud App

Thanks in advance :slight_smile:

19

is this integration still activave and receive update ?
I see no update in 2 years and no answer to issue on git hub

Please inform the comunity, thanks in advance for your work