Support for Matter Vacuum ServiceArea Cluster

[SeanXue9983]

Describe the enhancement

The Matter protocol integrated into ECOVACS Robotic Vacuum Cleaners supports Service Area Clusters. Can Home Assistant's vacuum devices support selected cleaning areas based on Service Area Clusters?
https://github.com/home-assistant/core/blob/dev/homeassistant/components/matter/vacuum.py

Device or feature details

device: ECOVACS DEEBOT X8 PRO OMNI

Use cases

Will allow users to specify areas to be cleaned.

Anything else?

ServiceArea Cluster data

Attribute values for cluster ServiceArea (16446929849116803808/1/336):

    clusterRevision (65533): 1
    featureMap (65532): {
  "selectWhileRunning": false,
  "progressReporting": true,
  "maps": true
}

    supportedAreas (0): [
  {
    "areaId": 10000,
    "mapId": 1409736026,
    "areaInfo": {
      "locationInfo": {
        "locationName": "Room",
        "floorNumber": 0,
        "areaType": 20
      },
      "landmarkInfo": null
    }
  },
  {
    "areaId": 10001,
    "mapId": 1409736026,
    "areaInfo": {
      "locationInfo": {
        "locationName": "Room1",
        "floorNumber": 0,
        "areaType": 20
      },
      "landmarkInfo": null
    }
  }
]
    supportedMaps (1): [
  {
    "mapId": 1409736026,
    "name": "map1"
  }
]
    selectedAreas (2): []
    currentArea (3): null
    progress (5): []

[lboue]

Could you post your diagnostic file?

[SeanXue9983]

matter-01J1VYQ0SAKJXG1JETDP9QA7P4-ecodeebot-1a01fdb1e79c29d87e0ecdd8cfab772d.json

[lboue]

Thanks

[lboue]

Describe the enhancement

The Matter protocol integrated into ECOVACS Robotic Vacuum Cleaners supports Service Area Clusters. Can Home Assistant's vacuum devices support selected cleaning areas based on Service Area Clusters?

This cannot be added graphically at this time because the front-end interface does not have a multi-selection drop-down list to select the areas to be cleaned.

[nitaybz]

+1 for making this happen

[TheRealSimon42]

Definitely +1

is it currently possible to send a Matter Vacuum to a Room at all? Maybe with a custom command?

[lboue]

Not yet.

[incline02]

What I do and it's annoying: it's create switches for scripts:

mop the bathroom:

• set to mop only
• select bathroom
• start

then I expose that switch to homekit and can order Siri accordingly. but that means total of switches = room * cleaning mode * routine (quick, deep, etc) so sort of super annoying. and at Stop, reset back to all room, vac + mop, otherwise the next time I just push "on", it'll pick up the previous parameters.

[curiousvibes]

This is a great idea! Adding support for Service Area Clusters would make the ECOVACS DEEBOT X8 PRO OMNI much more convenient for users who want more control over where their vacuum cleans. Being able to select specific rooms or zones directly in Home Assistant would save time and battery life, especially for larger homes where a full clean isn’t always necessary.

It reminds me of how tailored solutions work in other industries, just like this service focuses on customized solutions for specific needs, having the ability to choose exact cleaning areas would make the automation smarter and more efficient. Pulling data from supportedAreas and allowing users to run targeted cleanups would be a big step toward a more user-friendly experience.

[anthonymkz]

I don’t think this should be too hard to implement. I did some experimenting with the Home Assistant Matter add-on (both the Web UI and the Matter Server WebSocket API using wscat) and here’s what I found:

• The device exposes the ServiceArea cluster (0x0150), which lists all of my rooms under SupportedAreas.
• It also shows SelectedAreas and accepts the SetAreas command.
• The RVC Operational State cluster provides the normal Start, Pause, Stop, etc. commands.

The catch is that:

• Writing directly to SelectedAreas fails with UnsupportedWrite.
• The Matter server WebSocket only supports read_attribute and write_attribute, so I wasn’t able to invoke the SetAreas command directly.
• The HA Matter add-on GUI also doesn’t expose cluster commands, so there’s no easy way to actually send SetAreas.

I also tested by connecting the vacuum to iOS as a “secondary” Matter controller. In Apple Home the room/area functionality is fully exposed and works, which confirms the device is implementing the cluster correctly and that the information is there to be used.

So the functionality exists in Matter and is supported by the device, but the integration isn’t surfacing it yet. From my perspective, it looks like the missing piece is wiring up SetAreas as a service call and chaining it with Start. The lack of a multi-select in the frontend shouldn’t block this. Even if the frontend doesn’t expose a GUI interface for room/area selection, the backend can still implement it as a service that takes a list of areas as variables. Users could call that service from automations, scripts, or Developer Tools right away, and the UI could be implented later.

I’d love to dig deeper and try to contribute, but I’m pretty underqualified for this kind of work and unfortunately don’t have the time. Just wanted to drop what I discovered in case it helps the folks who can implement it.

[lboue]

We are working on it:

• Add Matter service actions for vacuum area core#151467

[vincedarley]

In case useful: in iOS 26, I've been able to add my Roborock Qrevo vacuum, via Matter, to both Home Assistant and Apple Home. Apple Home now supports both floors/maps and rooms. The floors are automatically listed with their correct names in the Home app. The rooms are for some reason not.

[AndreEriksenNLTG]

Weird, room names work for my Dreame via Matter integration to Home Assistant

[aav7fl]

I had this same issue with my Roborock that was connected over Matter to Home Assistant. Originally, I thought re-interviewing the device would fix this. But that alone did not resolve my issue.

I fixed it by going back in and making some edits to the rooms in the Roborock app and then forcing a re-interview.

I'm not sure which specific thing caused it to update correctly, but I did make the following changes:

• I renamed a few rooms to force them to be saved again.
• I noticed a single room didn't have a room type selected, so I selected a room type and put my old name back (possible this was causing a bug with Matter since there was no selected room type for Roborock's native voice command?).
• I had never updated any room names since enabling Matter, so updating any room name might have forced a re-sync.

After I made those changes, I re-interviewed the device from within Home Assistant and my room names were populated correctly.

Obviously your mileage may vary, and this is probably only the fix for Roborock devices.

[lboue]

I would like to add several other models to the Home Assistant Core test list.
Could you post your device diagnostic file?

[vwccvr6]

Do u still need diagnostic files? Just owned a Qrevo Master and saw that it's still not possible to select Rooms.

[lboue]

This is no longer necessary.
The prerequisites for adding this feature are not currently met.

[InstigatorX]

How do we get the prerequisites to be met? I see the PR was closed and the gui changes that are needed not being progressed. This basically makes matter supported vacuum control useless IMO. Otherwise vacuum just runs according to whatever it wants or is set in the app.

[Quentame]

The HA core vacuum platform require to support the clean_area action before the Matter integration supports it.

Vacuum platform clean_area action addition PR: home-assistant/core#149315

Architecture discussion: home-assistant/architecture#1284

---

To extract an integration diagnostic file: Settings -> Devices & services -> [Select your integration config] -> 3 dots on the "Device info" panel -> Download diagnostics
Matter exemple: https://www.home-assistant.io/blog/2024/02/07/release-20242/#matter-diagnostics-and-actions

[juliennnnn]

Hey! I would love to have it integreated for my Dreame D10 Plus. It would allow me to select a room to vacuum in HomeKit. Let me know how I can help :)

[lboue]

Could you post your device diagnostic file?

[juliennnnn]

Of course, how can I do that?

[lboue]

See this:
https://www.home-assistant.io/blog/2024/02/07/release-20242/#matter-diagnostics-and-actions

[incline02]

Hi

Same here for the Dreame aqua Pro. How can I help?

[incline02]

For the dreame , the Dreame integration from tesshack gets the rooms. Matrer bridge imports them successfully into HomeKit with the right UI.

So fixed on my end

[snokkie]

Would love to have this option for the Switchbot S20. Am I correct to assume this feature is planned to be implemented?
For this to work fully:

• The Matter over Wifi-device (your vacuum) needs to support area-segments;
  If so, then
• The matter integration in HA can get a list of rooms/area-segments from your vacuum and give the command to clean one;
  But first,
• The matter integration needs the core-vacuum entity of HA to have a function to clean those separate area's;
  And for this to work properly,
• The core-vacuum entity needs a front-end way to map the area-segments to areas as used in HA;

Will it help if I provide my matter-diagnostic file from my S20?

[snokkie]

Floor Cleaning Robot S20 (2041) by SwitchBot
Firmware: 1.1.088 (while the switchbot-app says V1.1.079)
Hardware: 8

matter-01KCYKBF49Z530DN80X9GQTHKD-Floor Cleaning Robot S20-db7d64c28cae360faec5b84ac4dc062a.json

I don't see options to choose how many runs it should do. The Clean modes are named differently than in the app:
Quick; (vacuum only)
Auto;
Deep Clean; (mop & vac)
Quiet;
Max Vac;
They also only map to "vacuum only" or "mop & vac". There is no option to "vacuum then mop".

[lboue]

I don't see options to choose how many runs it should do.

This is not covered in the Matter specifications.

[AndreEriksenNLTG]

I echo most of these comments. Would love room support for switchbot k11+

[AndreEriksenNLTG]

Ill try to add a diagnostic for k11+ after taking delivery

[lboue]

No need, I already have one at home.

[incline02]

For the dreame, the Dreame integration from tesshack gets the rooms right. Matter bridge imports them successfully into HomeKit.

[lboue]

Could you tell me what happens to your vacuum cleaner when you select rooms in Apple Home?
Do you have to press the start button to start it up?

[lboue]

No one can answer?

[hakong]

I have a roborock qrevo edge (added via matter), can describe the functionality in apple home briefly:

1. Open apple home on an iPad
2. Tap the roborock vacuum entity
3. Actions available: start, mode (vac, mop, vac+mop), rooms (all rooms selected by default).
4. Example: uncheck all rooms but one, tap the checkmark icon in the room selector (ok/apply), set mode to vac only (robot makes a "ding" sound when switching modes)
5. Nothing happens until I press start.

So no, it does not start automatically when selecting rooms. I have to press play/start for it to start.

Does this help?

[lboue]

I noticed the same thing with another manufacturer. Thank you for your reply.
The specifications are not binding on this point and leave the manufacturer free to choose.

[shanemcw]

iRobot Roomba (today's models) now is Matter-enabled, and room(s) selection is available in the Apple Home app via Apple Home Matter integration, but not yet in Home Assistant Matter integration. I am able to control a iRobot Roomba via Home Assistant's Matter integration and Home Assistant's REST API for e.g. start, stop, dock, but, unlike e.g. an LG TV or an Apple TV entity, which reports an enumerated list of valid inputs that can be selected (and can be selected), the Home Assistant .vacuum does not yet report the list of rooms it is configured, for user selection.

{
    'last_reported' => '2026-02-23T22:08:53.133463+00:00',
    'context' => {
      'parent_id' => undef,
      'user_id' => undef,
      'id' => '01KJ68RNCDWTNDW6KG589KEW7V'
    },
    'entity_id' => 'button.sunny_identify',
    'attributes' => {
      'friendly_name' => 'Sunny Identify',
      'device_class' => 'identify'
    },
    'state' => 'unknown',
    'last_changed' => '2026-02-23T22:08:53.133463+00:00',
    'last_updated' => '2026-02-23T22:08:53.133463+00:00'
  },
  {
    'last_changed' => '2026-02-23T22:08:53.134682+00:00',
    'last_updated' => '2026-02-23T22:08:53.134682+00:00',
    'state' => 'Auto',
    'attributes' => {
      'friendly_name' => 'Sunny Clean mode',
      'options' => [
        'Auto',
        'Quick',
        'Deep Clean'
      ]
    },
    'entity_id' => 'select.sunny_clean_mode',
    'context' => {
      'user_id' => undef,
      'parent_id' => undef,
      'id' => '01KJ68RNCEAYTV44PEDM7DJ2M2'
    },
    'last_reported' => '2026-02-23T22:08:53.134682+00:00'
  },
  {
    'entity_id' => 'sensor.sunny_battery',
    'context' => {
      'user_id' => undef,
      'parent_id' => undef,
      'id' => '01KJAJAX5WA7NRTPFNRBR3KE2D'
    },
    'last_reported' => '2026-02-25T14:13:05.852720+00:00',
    'attributes' => {
      'device_class' => 'battery',
      'friendly_name' => 'Sunny Battery',
      'unit_of_measurement' => '%',
      'state_class' => 'measurement'
    },
    'state' => '99',
    'last_updated' => '2026-02-25T14:13:05.852720+00:00',
    'last_changed' => '2026-02-25T14:13:05.852720+00:00'
  },
  {
    'last_updated' => '2026-02-24T14:57:15.050602+00:00',
    'last_changed' => '2026-02-24T14:57:15.050602+00:00',
    'attributes' => {
      'friendly_name' => 'Sunny Battery charge state',
      'options' => [
        'not_charging',
        'charging',
        'full_charge'
      ],
      'device_class' => 'enum'
    },
    'state' => 'full_charge',
    'last_reported' => '2026-02-24T14:57:15.050602+00:00',
    'entity_id' => 'sensor.sunny_battery_charge_state',
    'context' => {
      'id' => '01KJ82F19AZNHGDZQX4AD1G9ZP',
      'parent_id' => undef,
      'user_id' => undef
    }
  },
  {
    'attributes' => {
      'device_class' => 'enum',
      'options' => [
        'stopped',
        'running',
        'paused',
        'error',
        'seeking_charger',
        'charging',
        'docked',
        'wait_rvc_is_busy'
      ],
      'friendly_name' => 'Sunny Operational state'
    },
    'state' => 'docked',
    'last_updated' => '2026-02-25T14:13:49.836693+00:00',
    'last_changed' => '2026-02-25T14:13:49.836693+00:00',
    'entity_id' => 'sensor.sunny_operational_state',
    'context' => {
      'id' => '01KJAJC84CD3TCQZCN77Y5SGNY',
      'parent_id' => undef,
      'user_id' => undef
    },
    'last_reported' => '2026-02-25T14:13:49.836693+00:00'
  },
  {
    'last_reported' => '2026-02-25T14:13:49.836929+00:00',
    'entity_id' => 'vacuum.sunny',
    'context' => {
      'id' => '01KJAJC84CXJPJ165N4YDGJJGC',
      'parent_id' => undef,
      'user_id' => undef
    },
    'last_changed' => '2026-02-25T14:13:49.836929+00:00',
    'last_updated' => '2026-02-25T14:13:49.836929+00:00',
    'state' => 'docked',
    'attributes' => {
      'friendly_name' => 'Sunny',
      'supported_features' => 12828
    }
  },

Example with enumerated options, an LG TV:

  {
    'attributes' => {
      'supported_features' => 24509,
      'assumed_state' => $ha_states->[7]{'attributes'}{'editable'},
      'friendly_name' => 'Bedroom LG TV',
      'device_class' => 'tv',
      'sound_output' => 'tv_speaker',
      'source_list' => [
        'Amazon Alexa',
        'Apple Music',
        'Apple OTT',
        'Apple TV',
        'Apps',
        'Camera',
        'Copilot',
        'Disney+',
        'HBO Max',
        'HDMI 1',
        'HDMI 2',
        'HDMI 3',
        'Home Hub',
        'Hulu',
        'Just Dance Now',
        'LG Channels',
        'LG Fitness',
        'LG Gallery+',
        'LG Gaming Portal',
        'LG Radio+',
        'Live TV',
        'Media Player',
        'Multi View',
        'Netflix',
        'Paramount+',
        'Peacock',
        'Pluto TV',
        'Prime Video',
        'ShopTime',
        'Sling TV',
        'Sports',
        'Tubi: Free Movies & TV',
        'Web Browser',
        'Weekend Games - Song Quiz, Jeopardy! and CoComelon',
        'YouTube'
      ]
    },
    'state' => 'off',
    'last_updated' => '2026-02-25T10:31:42.349705+00:00',
    'last_changed' => '2026-02-25T10:31:42.349705+00:00',
    'last_reported' => '2026-02-25T10:31:55.381465+00:00',
    'entity_id' => 'media_player.lg_webos_tv_oled48c4pua',
    'context' => {
      'parent_id' => undef,
      'user_id' => '62bfdfb293f64916a6c063c1a3de5123',
      'id' => '01KJA5NER6Z8WYTCHE11VAKTAG'
    }
  },

[lboue]

You should try the new beta:
https://rc.home-assistant.io/latest-release-notes

[divergio]

Am I correct in concluding that the 2026.3 release requires mapping of segments to home assistant room areas in order to support cleaning specific rooms? My vacuum ServiceAreas do not cleanly map to my HA room areas. I would like to use the matter integration in scripts to send it to the same areas it exposes via matter to Apple Home, without having to first map them to specific HA room areas.

Many workarounds for deficiencies in robot vacuum software rely on creation of superfluous rooms, the current integration seems very opinionated about mapping segments to rooms, ending up being less customizable than the Apple interface.