Fix Roborock Qrevo Plus Missing SmartPlan In Home Assistant

Aug 14, 2025 by Felix Dubois 60 views

Missing Mapping for Roborock Qrevo Plus in Home Assistant

Hey everyone! 👋 Today, we're diving into an issue some of you might be facing with the Roborock Qrevo Plus and its integration with Home Assistant. Specifically, we're talking about the missing SmartPlan mode and how to troubleshoot it. If you've recently set up your shiny new Roborock Qrevo Plus and are scratching your head because the SmartPlan mode isn't showing up in Home Assistant, you're in the right place. Let's get this sorted out together!

Understanding the Problem

So, you've got your Roborock Qrevo Plus all set up, it's happily cleaning your floors, and you've even integrated it into your Home Assistant setup. Awesome! But then, you go to tweak the settings and realize the SmartPlan mode is MIA. 😩 You check the mode list in Home Assistant, and it's just not there. This can be super frustrating, especially when you're trying to automate your cleaning routines. This usually means that the Roborock integration in Home Assistant is missing the correct mapping for this specific mode. Mappings are essentially the translations between the commands your robot understands and the commands Home Assistant sends. When a mapping is missing, Home Assistant doesn't know how to talk to your robot about that specific feature.

Why Does This Happen?

You might be wondering, "Why is this happening in the first place?" Well, there are a few reasons why a mapping might be missing:

New Features: Roborock, like any tech company, regularly releases updates and new features for their devices. If the SmartPlan mode is a relatively new addition to the Qrevo Plus, the Home Assistant integration might not have caught up yet.
Integration Updates: The Home Assistant integration for Roborock is maintained by a community of developers. They work hard to keep it up-to-date, but sometimes things slip through the cracks, or a new device model might not be fully supported immediately.
Communication Gaps: Occasionally, there might be a hiccup in the communication between your Roborock and Home Assistant. This could be due to network issues, software glitches, or other temporary problems.

Impact on Your Smart Home

Okay, so the SmartPlan mode is missing. What's the big deal? Well, if you're anything like me, you probably want to get the most out of your smart home devices. The SmartPlan mode likely offers some advanced cleaning features, like room-specific cleaning or customized schedules. Without it, you're missing out on a key piece of the puzzle. Imagine you want your robot to only clean the kitchen after dinner or vacuum the living room before guests arrive. Without SmartPlan mode, you might have to resort to manual controls, which kind of defeats the purpose of having a smart vacuum in the first place!

Investigating the Issue

Let's roll up our sleeves and dig into what might be causing this missing mapping. The first step is to gather some information. In this case, the user has already provided some valuable details, which is awesome! 🙌 We know they're running Home Assistant Core version 2025.8.1 on Home Assistant OS. They've also identified the Roborock integration as the culprit. This is a great start!

Checking the Logs

The user has also included some log snippets, which are like little breadcrumbs that can lead us to the solution. The logs show some warnings related to missing code mappings:

2025-08-14 14:00:22.135 WARNING (MainThread) [roborock.code_mappings] Missing RoborockFanSpeedS7MaxV code: 110 - defaulting to 105
2025-08-14 14:00:22.135 WARNING (MainThread) [roborock.code_mappings] Missing RoborockMopIntensityS7 code: 209 - defaulting to 200
2025-08-14 14:00:22.136 WARNING (MainThread) [roborock.code_mappings] Missing RoborockMopModeS7 code: 306 - defaulting to 300

These warnings are super helpful! They tell us that the Roborock integration is missing specific codes for fan speed, mop intensity, and mop mode. While these might not be directly related to the SmartPlan mode, they indicate a general issue with missing mappings. It's like finding a loose thread – pulling on it might unravel the whole problem!

Analyzing the Diagnostics Information

The user has also provided a diagnostics file (config_entry-roborock-01JYS6DDSS8CP37RF0CHB8BN26.json). This file contains a bunch of technical details about the Roborock integration and how it's configured in Home Assistant. It's like a behind-the-scenes look at how everything is connected. Analyzing this file can help us identify any misconfigurations or missing information that might be causing the issue.

YAML Snippet and Additional Information

In this case, the user hasn't provided a YAML snippet or any additional information. That's okay! Sometimes the logs and diagnostics are enough to get started. But if you're facing a similar issue, providing a YAML snippet of your Roborock configuration (if you have one) and any other relevant details can be super helpful for troubleshooting.

Troubleshooting Steps

Alright, let's get down to the nitty-gritty and try to fix this missing SmartPlan mode. Here are some steps you can take to troubleshoot the issue:

1. Restart Home Assistant

This might sound like a cliché, but it's often the first and easiest thing to try. Restarting Home Assistant can clear out any temporary glitches or cached data that might be causing the problem. It's like giving your smart home a fresh start. Just go to the Home Assistant UI, navigate to Configuration > Settings > System, and click the Restart button.

2. Update Home Assistant Core and Roborock Integration

Running the latest versions of Home Assistant and the Roborock integration is crucial for compatibility and bug fixes. New versions often include updated mappings and support for new features. To update Home Assistant Core, go to Configuration > Settings > System and check for updates. To update the Roborock integration, go to Configuration > Integrations, find the Roborock integration, and click the Configure button. If there's an update available, you'll see a prompt to install it.

3. Remove and Re-add the Roborock Integration

Sometimes, the integration might get stuck in a weird state. Removing and re-adding it can help clear out any corrupted data or misconfigurations. To do this, go to Configuration > Integrations, find the Roborock integration, and click the Delete button. Then, follow the steps to re-add the integration. This is like giving the integration a clean slate.

4. Check the Roborock Integration Documentation

The Home Assistant documentation for the Roborock integration is a goldmine of information. It often includes troubleshooting tips, known issues, and workarounds. You can find the documentation here. Take some time to read through it and see if there's anything relevant to your issue. The documentation is your friend! 🤓

5. Manually Add Missing Mappings (Advanced)

If you're feeling adventurous and comfortable with editing configuration files, you can try manually adding the missing mappings. This involves diving into the Roborock integration code and adding the necessary entries for the SmartPlan mode. This is an advanced step and should only be attempted if you know what you're doing. Incorrectly modifying the configuration files can break your Home Assistant setup. Proceed with caution! ⚠️

To manually add mappings, you'll need to:

Locate the Roborock integration files in your Home Assistant installation.
Identify the relevant mapping files (usually Python files).
Add the missing codes for the SmartPlan mode, using the existing mappings as a guide.
Restart Home Assistant for the changes to take effect.

6. Create a Custom Service (Advanced)

Another advanced option is to create a custom service in Home Assistant that directly sends the commands for the SmartPlan mode to your Roborock. This involves using the roborock Python library and writing some custom code. Again, this is an advanced step and requires some programming knowledge.

7. Report the Issue on the Home Assistant Forums or GitHub

If you've tried all the troubleshooting steps and are still stuck, it's time to reach out for help. The Home Assistant community is super active and helpful. Post your issue on the Home Assistant forums or create a new issue on the Roborock integration GitHub repository. Be sure to include all the relevant information, such as your Home Assistant version, Roborock model, logs, and diagnostics. The more information you provide, the easier it will be for someone to help you.

Analyzing the Specific Logs and Next Steps

Based on the logs provided, we know that there are some missing code mappings for fan speed, mop intensity, and mop mode. This suggests that the Roborock integration might not have full support for the Qrevo Plus model yet. The next step would be to:

Check the Roborock integration GitHub repository for existing issues related to the Qrevo Plus. Someone else might have already reported the same problem.
If there isn't an existing issue, create a new one, including the logs and diagnostics information. This will alert the integration maintainers to the problem.
Consider contributing to the integration by adding the missing mappings yourself (if you have the technical skills). This is a great way to give back to the Home Assistant community.

Conclusion

Dealing with missing mappings can be a bit of a pain, but don't worry, guys! 💪 By following these troubleshooting steps and reaching out to the Home Assistant community, you'll be well on your way to getting your Roborock Qrevo Plus fully integrated and enjoying all its smart features. Remember, the key is to be patient, persistent, and don't be afraid to ask for help. Happy automating! 🎉