Skip to content

Add support for Roborock Qrevo MaxV code mappings #385

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 8 commits into from
Jun 30, 2025

Conversation

barneyonline
Copy link
Contributor

Tested on personal device.
Plus minor spelling corrections and ruff compliance

@Kranzes
Copy link
Contributor

Kranzes commented Jun 11, 2025

Hey, i also want to add support for my device, I was wondering how you find the right codes for each mode?

@barneyonline
Copy link
Contributor Author

@Kranzes Since I already have my device connected via Home Assistant, I followed the below steps.
If you haven't got your device in Home Assistant, I believe there are other ways to connect directly via python-miio and get a readout, but I didn't need to look into this method too much.

  1. In Home Assistant, navigate to Settings > Devices & Services > Roborock
  2. Click the option "Enable debug logging"
  3. Navigate to Settings > System > Logs
  4. Click the 3 dots menu and select "Show raw logs"
  5. Periodically you will get a readout of all states of the vacuum, including the model name (e.g. roborock.vacuum.a87)
  6. In the Roborock mobile app, select the vacuum and click the 3 dots Settings menu
  7. Select "Pin n Go" and move the vacuum out of the dock and to the middle of the room (note: this step is probably optional)
  8. Cycle through the different modes:
  • FanPower - From the map screen, set the mode to 'Vacuum' and cycle through the "Suction Power" options. Each time the option changes, a log entry will appear in the Home Assistant logs which will display the corresponding code. Note this down and repeat for all options.
  • MopMode - From the map screen, click the 3 dots Settings menu, then open Dock Settings > Washing Mode. Cycle through the "Water Volume for Mop Washing" options. Each time the option changes, a log entry will appear in the Home Assistant logs which will display the corresponding code. Note this down and repeat for all options.
  • ModeIntensity - From the map screen, set the mode to 'Mop' and cycle through the "Water Flow" options (including Custom). Each time the option changes, a log entry will appear in the Home Assistant logs which will display the corresponding code. Note this down and repeat for all options.
  • SmartPlan - this is a bit different to the above, as there can be some hidden "Smart" options that aren't available in the specific menu. Instead, you need to set the mode to 'SmartPlan' from the map screen and observe the reported codes that are reported in the periodic readout

Hope that helps!

@Kranzes
Copy link
Contributor

Kranzes commented Jun 11, 2025

I do have it in home-assistant, I just don't have the right modes and missing a lot of options (compared to the Roborock app).

@barneyonline
Copy link
Contributor Author

@Lash-L Any chance you could review this one?

@allenporter allenporter requested a review from Lash-L June 30, 2025 01:02
@Lash-L
Copy link
Collaborator

Lash-L commented Jun 30, 2025

Hey @barneyonline sorry for the delay.

I have a newborn at home which takes up all my time - I completely forgot about this PR. Thank you for your contribution!

@allenporter You may have a few small conflicts, but I figure it's easier for you to quickly change them than to do it here.

@Lash-L Lash-L merged commit 8d4902b into Python-roborock:main Jun 30, 2025
6 checks passed
@barneyonline
Copy link
Contributor Author

@Lash-L Very understandable, no problem at all mate. Appreciate all your work on this repo!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants