HELP WANTED - Device specific functionality

[Lash-L]

For each of the devices supported by the roborock app I am trying to get the specific functionality it supports so that I can build a matrix for it.

If your model is missing from the below table, please comment below with the functionality it has.

If it isn't even a column please let me know so I can confirm that your vacuum is supported and then give me the vacuum model result by enable debug logging and reloading the integration.

Model	Fan Codes	Mop Codes	Mop Intensity Codes
ROBOROCK_G10
ROBOROCK_Q5
ROBOROCK_Q7
ROBOROCK_Q7_MAX	Q7 Max	N/A	V2
ROBOROCK_S4
ROBOROCK_S5_MAX	S6 Pure	N/A	V2
ROBOROCK_S6	S6_PURE	N/A	N/A
ROBOROCK_S6_MAXV	E2	N/A	V2
ROBOROCK_S6_PURE	S6_PURE	N/A	N/A
ROBOROCK_S7_MAXV	S7 MaxV	S7	S7
ROBOROCK_S8_PRO_ULTRA	S7 MaxV	S7	S8 Pro Ultra
ROBOROCK_S8	S7 MaxV	S7	S8 Pro Ultra
ROBOROCK_S4_MAX	S6 Pure	S7	S7
ROBOROCK_S7	S7	S7	S7

Mop intensity Types:

V2	S7
off	off
low	mild
medium	moderate
high	intense
custom	custom

Fan Speed Types:

V1	V2	V3	E2	S7	S7 MaxV	S6_PURE	Q7 Max
silent	silent	silent	gentle	off	off	gentle	quiet
standard	balanced	standard	silent	silent	quiet	quiet	balanced
medium	turbo	medium	standard	standard	balanced	balanced	turbo
turbo	max	turbo	medium	medium	turbo	turbo	max
	gentle		turbo	turbo	max	max
	auto				max_plus

Mop Mode codes

s7:
standard
deep
custom
deep_plus

[Dis90]

These are from Roborock app.

ROBOROCK_S6_PURE:
Fan speeds: Gentle, Quiet, Balanced, Turbo, Max

I can't find anything for mopping. Does mop need to be attached?

[Lash-L]

@Dis90 - I'm not sure. I guess if you can detach the mop - perhaps it hides the mop related settings?

[Dis90]

I will try tomorrow if there’s settings available while mopping.

[Lash-L]

@tomassj9 - can you give me the information for the Q7 Max Plus? As well as can you enable debug logging and then reload the integration and find where it says "Got home data" and then tell me what it says for model? It should say something like roborock.vacuum.a...

[Lash-L]

@Maxi2509 with your 7 vacuums could you help fill this out further? Thanks!

[Dis90]

@Lash-L S6 Pure doesn't have any settings for mop. Only fan speed settings are available when mopping. Integration sensors reports following:

Mop Attached: Disconnected
Water box attached: Disconnected
Water shortage: Unknown

Entity attributes:
WaterBoxStatus 0
Mop mode Tuntematon
Mop intensity Tuntematon

Tuntematon = Unknown

Edit. I just googled and because S6 Pure doesn't have water pump there's no way to control anything related to mopping.

[Lash-L]

Edit. I just googled and because S6 Pure doesn't have water pump there's no way to control anything related to mopping.

That makes sense - it is physical control only. Thanks!

[tomassanjuann]

Find where it says "Got home data" and then tell me what it says for model?

023-04-30 17:45:26.148 DEBUG (MainThread) [custom_components.roborock] Got home data HomeData *** other info *** model='roborock.vacuum.a38' *** more info ***

@tomassj9 - can you give me the information for the Q7 Max Plus?

Sure! I tried my best, if needed anything more specific, ask me for it without problem!

ROBOROCK_Q7_MAX (roborock.vacuum.a38)

Fan Speed Types:

HA	Roborock App
Silent	Quiet
Balanced	Balanced
Turbo	Turbo
Max	Max

Mop Intensity Types // In my case it's Water Flow:

HA	Roborock App
Off	Off
Mild	Low
Moderate	Medium
Intense	High
Custom	Custom (Slider from 1 to 30)

Mop Codes:
None, not supported. The mop is detachable, but no modes available. It doesn't have the vibration like S7 MaxV

Other functions:
Dock with dust collection only. Mop detachable manually.

Other data which I think can help:

2023-04-30 18:02:07.366 DEBUG (MainThread) [roborock.local_api] id=98169 Response from get_status: {'msg_ver': 2, 'msg_seq': 1922, 'state': 8, 'battery': 100, 'clean_time': 2002, 'clean_area': 31505000, 'error_code': 0, 'map_present': 1, 'in_cleaning': 0, 'in_returning': 0, 'in_fresh_state': 1, 'lab_status': 1, 'water_box_status': 1, 'fan_power': 106, 'dnd_enabled': 0, 'map_status': 3, 'is_locating': 0, 'lock_status': 0, 'water_box_mode': 204, 'distance_off': 0, 'water_box_carriage_status': 0, 'mop_forbidden_enable': 0, 'adbumper_status': [0, 0, 0], 'dock_type': 5, 'dust_collection_status': 0, 'auto_dust_collection': 1, 'debug_mode': 0, 'switch_map_mode': 0, 'dock_error_status': 0, 'charge_status': 0}

[Lash-L]

Thanks @tomassj9 - do your fan options have an "off' mode? or just the 4 modes you listed

[tomassanjuann]

Not really, only the 4 modes listed above. You cannot select "only mop" on the app like other models.

[shbatm]

Roborock S5 Max - roborock.vacuum.s5e

Fan Speed Types:

HA	Roborock App
Off	-
--	Gentile
Silent	Quiet
Balanced	Balanced
Turbo	Turbo
Max	Max
Max_Plus	--
Custom	--

Mop Intensity:

HA	Roborock App
Off	Off
Mild	Low
Moderate	Medium
Intense	High
Custom	Custom - Extreme (Can set 1-30 in app)

Mop Mode:

HA	Roborock App
Standard	-
Deep	-
Deep+	-
Custom	-

• need to find the map to see what these options are in the app.

[Lash-L]

Perfect @shbatm

You may not have mop modes. It's only a available for select devices

[Lash-L]

@tomassj9 - I need you to help me get the codes for the Q7 Max. Can you do the following:

enable debug logging.

Then one at a time for each of the 4 vacuum modes, change the vacuum mode in your app, then in HA go to developer settings - services Vacuum: Send command, select your vacuum as the entity, and then put in "get_status" Then send me what hte fanpower code is in your logs next to get_status.

If you could do that for all of your fan modes that would be super helpful. I can guess what the codes are - but they could be incorrect.

@Dis90 if you could do the same for your vacuum speeds, that would be very helpful

[Dis90]

S6 Pure

Gentle: 105
Quiet: 101
Balanced: 102
Turbo: 103
Max: 104

[Lash-L]

Thank you @Dis90 !

I don't actually need yours anymore @tomassj9, thank you!

[nilsi]

I got a S7 and using the following to control it with scripts:

config_mopping_mode:
  off: 200
  low: 201
  medium: 202
  high: 203
  custom: 204
  
config_mopping_route:
  standard: 300
  deep: 301
  custom: 302
  deep_plus: 303
  
config_vacuum_mode:
  silent: 101
  balanced: 102
  turbo: 103
  max: 104
  off: 105
  custom: 106

Thank you for this integration! I'm super happy with it. Really great that I can use both app and integration now at the same time. Also like that the map works out of the box. 👍🏼 I hope there will eventually be a way to change mopping modes and spot cleaning directly some the UI but I guess that's someone else's task.

[cryptk]

ROBOROCK_S8_PRO_ULTRA: (roborock.vacuum.a70)

Fan Speed Codes:

Home Assistant	Roborock App
off	--
silent	Quiet
balanced	Balanced
turbo	Turbo
max	Max
max_plus	Max+
custom	--

Fan Route Codes: My roborock app allows selecting either "fast" or "standard" for my vacuum route. These are reported in Home Assistant under the "mop_mode" attribute. It appears that this attribute is not just for mopping, but rather for "route" selection. While the vacuum settings only allow "fast" and "standard", when configuring a mop only run, there are the other options mentioned under "mop codes". The "fast" and "standard" options are also available for a Vac & Mop run as well, but not the other mop only specific codes such as Deep and Deep+.

Home Assistant	Roborock App
see note above	Fast
see note above	Standard

Mop Codes: It appears that the "fast" mop code is not (yet) supported in the integration?

Home Assistant	Roborock App
null	Fast
standard	Standard
deep	Deep
deep_plus	Deep+
custom	--

Mop Intensity Codes:

Home Assistant	Roborock App
off	--
mild	Mild
moderate	Moderate
intense	Intense

The "Fast" route option has some info that indicates that it works differently than the other route options.

--- Quote from Roborock App ---
Fast-Cleaning Mode for better efficiency.

The robot learns the environment and adjusts its route accordingly for more efficient cleaning. Room boundaries will be skipped and certain spots may be missed. This function is intended for occasional use.
--- End Quote ---

[Lash-L]

@cryptk Can you enable debug logging, change the mop_mode to fast and then call get_status in the services panel in HA?

Then in the debug logs in get_status can you tell me what 'mop_mode' is?

The same with deep plus, my guess is deep plus is 303.

[cryptk]

@Lash-L I don't see any kind of get_status service in my Dev Tools > Services panel in HA

[Lash-L]

@cryptk Sorry that's my bad - I sent that message quickly without giving all the info I should have.

Open dev tools, services, then for service enter "Vacuum: Send Command" Then for entity select your vacuum, and then under command enter in "get_status"

[Lash-L]

Also if you are able to just mop - you should have an off mode as well. Ar eyou able to just mop, or does your vacuum always have to vacuum to work?

[cryptk]

mop_mode for fast is 304
mop_mode for deep_plus is 303

I do have the ability to only mop, and to only vacuum with it, there just isn't an "Off" mode in the mode selector window, "Off" is implied for the vacuum by bringing up the mop only menu and the same for "Off" being implied for the mop by bringing up the vacuum only menu.

Home Assistant does properly report "off" for both the vacuum and mop depending on which mode you have selected.

[Lash-L]

Perfect, thanks @cryptk

[The-Croz]

S4 Max (a19) Vacuum Speeds: Gentle, Quiet, Balanced, Turbo, Max
S7 (a15) Vacuum Speeds: Quiet, Balanced, Turbo, Max
S7 S7 (a15) Mop Modes: Mild, Moderate, Intense
S7 S7 (a15) Mop Routes: Standard, Deep, Deep+

[neonsp]

For S6 its the same as S6_PURE:

Gentle, Quiet, Balanced, Turbo, Max

[Lash-L]

@neonsp does S6 have mopping?

[neonsp]

@neonsp does S6 have mopping?

It does, but there is no water flow control. So you either attach the mop or not.

Usually others integrations show a boolean sensor named something like isMopAttached

[mang1985]

G10S Pro(a26) is the Chinese version of S7 MaxV.
fan_speed_list:

• 'off'
• silent
• balanced
• turbo
• max
• max_plus
• custom
  mop_mode_list:
• standard
• deep
• deep_plus
• custom
  mop_intensity_list:
• 'off'
• mild
• moderate
• intense
• custom

[stickpin]

Roborock S8 (roborock.vacuum.a51)

Fan Speed Types:

Home Assistant	Roborock App
off	--
silent	Quiet
balanced	Balanced
turbo	Turbo
max	Max
max_plus	Max+
custom	--

Mop Codes:

Home Assistant	Roborock App
null	Fast
standard	Standard
deep	Deep
deep_plus	Deep+
custom	--

Mop Intensity Codes:

Home Assistant	Roborock App
off	--
mild	Mild
moderate	Moderate
intense	Intense
custom	--

Please let me know if you need more details.

[Lash-L]

@stickpin The s8 can do mop only/ vacuum only, correct?

And you can set custom clean modes per each room in the app as well, right?

[stickpin]

@Lash-L yes, it can do vacuum only and mop only.
Yes, I can set custom clean modes per each room in the app as well.

[Maxi2509]

@Lash-L sorry for my late reply.
yes i have a few ones but all of them are the same ...S7 max V with docking/cleaning station.

Therefore i will add you my information:

S7 maxV - roborock.vacuum.a27

Fan speed types:

Home Assistant	Roborock App
off	-- na
silent	Quiet
balanced	Balanced
turbo	Turbo
max	Max
max_plus	Max+
custom	-- na

mop types (scrub intensity):

Home Assistant	Roborock App
off	-- na
mild	Mild
moderate	Moderate
intense	Intense
custom	--

Mop Route:

Home Assistant	Roborock App
null	-- na
standard	Standard
deep	Deep
deep_plus	Deep+
custom	-- na

Dock options:

• empty dust bin
• wash mop

one big opportunity to have integrated is when you could enable the reset of the Maintenance options like Sensors, water filter, high -speed maintenance brush, ect.
For now i need to go into the app to reset the counter.

S7maxV has following maintenance options:

• Filter

• Main Brush

• Side Brush

• Sensors

• Mop (no counter - only information)

• Water Filter

• High-speed maintenance brush

• Dust bag (no counter - only information)

if you need more information please contact me.

[mang1985]

@Maxi2509 @Lash-L
Previously, when using the Mi app (Miio integration), the corresponding values obtained when sending the "get_consumable" command were as follows:

strainer_work_times: Water Filter
cleaning_brush_work_times: High-speed maintenance brush
dust_collection_work_times: Dust bag
From what I remember, when "dust_collection_work_times" exceeds 60, the Mi app will remind me to replace the Dust Bag.

Currently, whether using the Mi app or the Roborock app (integration), we can send the following commands:

"app_start_collect_dust": to empty the dust bin
"app_start_wash": to wash the mop
"reset_consumable" command with the params "strainer_work_times","cleaning_brush_work_times", and "dust_collection_work_times" to reset the corresponding counters.
However, the Roborock integration needs to be updated in order to provide the corresponding sensor entities.

[smartmatic]

Hi,

i will also extend this topic with the S6 maxV types

Fan Speed types

Home Assistant	Roborock App
gentle	gentle
silent	quiet
standard	balanced
medium	turbo
turbo	max

Mop Intensity types

Home Assistant	Roborock App
off	close
low	low
medium	medium
high	high
custom	custom

If additional informations are required i can update the post

[klonwar]

Hi, got info about Roborock Q7 (not Max)

Model: roborock.vacuum.a40

Fan Speed Types:

HA	Roborock App
Silent	Quiet
Balanced	Balanced
Turbo	Turbo
Max	Max

Mop Codes: N/A

Mop Intensity Codes: N/A

The Roborock Q7 Max has an electronic water tank, while the Roborock Q7 has a gravity-fed water tank.
The Q7 Max applies consistent mopping pressure, but the Q7 does not have this feature.

get_status info:

2023-08-03 09:47:02.152 DEBUG (MainThread) [roborock.cloud_api] id=23467 Response from get_status: {'msg_ver': 2, 'msg_seq': 386, 'state': 8, 'battery': 100, 'clean_time': 11, 'clean_area': 0, 'error_code': 0, 'map_present': 1, 'in_cleaning': 0, 'in_returning': 0, 'in_fresh_state': 1, 'lab_status': 1, 'fan_power': 103, 'dnd_enabled': 1, 'map_status': 3, 'is_locating': 0, 'lock_status': 0, 'adbumper_status': [0, 0, 0], 'dock_type': 5, 'dust_collection_status': 0, 'auto_dust_collection': 1, 'debug_mode': 0, 'switch_map_mode': 0, 'dock_error_status': 0, 'charge_status': 1}

[z-master42]

I have an S7+, i.e. the S7 with the dock which automatically vacuums the Roborock's dust container after cleaning. I have already managed to manually trigger this vacuuming in Home Assistant. What I am still missing is a sensor in Home Assistant that shows the "fill level" of the dust container of the dock.

Oh yes: In the app there is an error message when the container of the dock is full and vacuuming the Roborock is therefore no longer feasible. This error message does not (yet) exist in the integration.

[arne182]

I would also like this fon my, S8 pro Ultra.

[ralfhanke]

I would also like to have the status of the dust container on my S7 MaxV Plus.

[Jezza34000]

Hello,

ROBOROCK_P10 or Q REVO
roborock.vacuum.a75

Fan Speed (fan_power)
silent 101
standard 102
turbo 103
max 104
max_plus 108

Mop Speed (water_box_mode)
Low 201
Medium 202
High 203
Personnalised 207 [slider 1->30]