Text of developer.apple.com › forums › thread › 844646 as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

Home app rejects Matter device typ… | Apple Developer Forums

Home app rejects Matter device type 0x0042 (Water Valve) as "not supported" — which device types does Home accept? App & System Services Hardware Matter HomeKit You’re now watching this thread. If you’ve opted in to email or web notifications, you’ll be notified when there’s activity. Click again to stop watching or visit your profile to manage watched threads and notifications. You’ve stopped watching this thread and will no longer receive emails or web notifications when there’s activity.

Click again to start watching. masadh OP Created Sep ’26 Replies 5 Boosts 0 Views 879 Participants 2 I'm building a Matter irrigation system and I've hit a device-type wall in the Home app. This is not a commissioning or pairing problem - the accessory is found, setup proceeds, and then Home declines to create the accessory, reporting that the device is not supported. The controlled comparison, which is why I'm confident it is the device type and nothing else: Endpoint declares 0x0042 Water Valve (Matter 1.3) with cluster 0x0081 Valve Configuration and Control -> Home: NOT SUPPORTED, accessory is not created.

Endpoint declares 0x010A On/Off Plug-in Unit with cluster 0x0006 On/Off -> Home: created, works, valve opens and closes. Same hardware, same firmware image, same network, same iPhone. The only variable is the device type ID. Other Matter controllers accept the 0x0042 version and control it correctly. Water Valve (0x0042) - is this device type supported by the Home app in any current or announced iOS version? If not, is support planned?

Right now I ship the plug-in-unit substitution because it is the only thing Home will accept. It works, but it misrepresents the device: the user sees a row of "plugs" that are actually irrigation valves, with no valve semantics and nothing telling Home - or an automation the user writes - that switching this on releases water into a garden. Soil Sensor (Matter 1.5) - same question. Matter 1.5 added soil sensing (moisture, optionally temperature), explicitly positioned for irrigation paired with Matter water valves.

Is it supported or planned in Home? Today I publish soil moisture on a Relative Humidity Measurement endpoint (0x0405) because that is what Home renders, so garden soil moisture appears as air humidity and pollutes any humidity-based automation the user has. The general question, which is the one I actually want answered: is there an authoritative list of the Matter device type IDs the Home app accepts? The public support article describes categories in prose (lights, plugs, switches, thermostats, sensors...), but gives no device type IDs, so there is no way to check a design against it before building.

I would like to design to the list rather than discover at pairing time that Home will not create my accessory. A related composition question: my controller is a single accessory with seven independently controlled valve endpoints, and endpoints exist only for valves the installer has enabled. When a valve is disabled and its endpoint disappears, Home keeps showing it until the accessory is removed and re-added. Is there a supported way to make Home re-read a device's composition in place - and for seven valves, does Apple prefer one accessory with seven endpoints, or a Bridge (0x000E) exposing seven accessories?

Setup: Matter over Wi-Fi (2.4 GHz), esp-matter / connectedhomeip, test VID 0xFFF1 during development. iOS 17 and 18, iPhone 12, Home hub present. Happy to provide the full endpoint and cluster composition or logs if useful. Replies 5 Boosts 0 Views 879 Participants 2 DTS Engineer OP Apple Sep ’26 Water Valve (0x0042) - is this device type supported by the Home app in any current or announced iOS version? Here is the list of supported accessory types from our Matter support page: "The Home app currently supports these types of Matter accessories: air conditioners, bridges, lights, locks, outlets, switches, thermostats, blinds and shades, and sensors (motion, ambient light, contact, temperature, and humidity)." If not, is support planned?

I can't discuss our future plans, but if you'd like to support this, then please file a bug and the post the number back here. The general question, which is the one I actually want answered: is there an authoritative list of the Matter device type IDs the Home app accepts? No, not that I'm aware of. Is there a supported way to make Home re-read a device's composition in place - and for seven valves, does Apple prefer one accessory with seven endpoints, or a Bridge (0x000E) exposing seven accessories?

What are you doing when your configuration changes? I'm not that familiar with the full Matter specification, but I think HomeKit should pick up that your configuration has changed the next time it connects and rescans your overall configuration. However, what I could see being an issue here is that it probably won't "notice" any changes while it’s actively connected to the accessory. HAP (HomeKit Accessory Protocol) accessories have exactly the same issue, and what I suggest there is to either shutdown their network stack for "awhile" or, more practically, have the accessory reboot itself.

Either approach can work fine, but rebooting simplifies the flow a bit (you only read the configuration at startup). __ Kevin Elliott DTS Engineer, CoreOS/Hardware Add comment masadh OP Sep ’26 Thanks Kevin. Following up point by point, since several of my original questions weren't covered and a few new ones follow from your answer. Numbered so nothing gets lost. Soil Sensor (Matter 1.5). Not addressed in your reply.

Is the Matter 1.5 Soil Sensor device type supported in Home today? Your supported-types list names motion, ambient light, contact, temperature and humidity sensors, which implies no, but I would like that confirmed explicitly rather than inferred. Related: does any current developer seed or beta of iOS or iPadOS render the Matter 1.5 soil device types, or Water Valve 0x0042? If so I would like to test our firmware against it rather than wait for a release.

Are the substitutions sanctioned? This is my most important question. Until 0x0042 and Soil Sensor are supported, I am shipping valves as On/Off Plug-in Unit (0x010A) and soil moisture as Relative Humidity Measurement (0x0405). Both misrepresent the device. Is that acceptable to Apple, or does it create a problem at certification or Works with Apple Home review? I need this in writing before shipping. Rejection granularity.

If one endpoint declares an unsupported device type, does Home reject only that endpoint, or the entire accessory? If it is per-endpoint, I can declare 0x0042 natively and carry a compatibility endpoint alongside it. Multiple device types on one endpoint. Can a single endpoint declare both 0x0042 (Water Valve) and 0x010A (On/Off Plug-in Unit) in its Descriptor DeviceTypeList, so certified firmware stays native and Home renders it via the type it recognises?

Does Home pick the first supported type it finds, or reject the endpoint outright? Composition vs Bridge. Also not addressed: for a controller with seven independently controlled valves, does Apple prefer one accessory with seven endpoints, or a Bridge (0x000E) exposing seven accessories? Bridge is on your supported list, so does bridging change how Home treats child endpoints whose device types are not supported? Re-reading composition.

You suggested rebooting the accessory. To confirm the mechanism: is a change to the root Descriptor PartsList alone sufficient to trigger a re-scan on the next reconnect, or does Home only re-read composition after the subscription is fully torn down? And is there any state Home caches across a reboot that would keep showing a removed endpoint? Device type IDs behind the categories. You have confirmed no authoritative list exists.

Can you at least confirm the specific device type IDs behind "outlets", "switches" and the five supported sensor types? Prose categories are not something I can design

The rest of this page is on the live site.