Hello Google Home Community Team,
We are currently working on Matter integration for an Air Purifier and have encountered an issue related to the Fan Control cluster UI in Google Home.
Issue description:
The fan modes (Auto, Low, Medium, High) are not displayed in the Google Home UI.
To cross-check, we tested the same Matter configuration with Home Assistant, where the fan modes are shown correctly.
Fan Control cluster configuration (Endpoint 1 – Server):
/* Endpoint: 1, Cluster: Fan Control (server) */
{ ZAP_MIN_MAX_DEFAULTS_INDEX(0), 0x00000000, 1, ZAP_TYPE(ENUM8), ZAP_ATTRIBUTE_MASK(MIN_MAX) | ZAP_ATTRIBUTE_MASK(WRITABLE) }, /* FanMode */
{ ZAP_SIMPLE_DEFAULT(2), 0x00000001, 1, ZAP_TYPE(ENUM8), 0 }, /* FanModeSequence */
{ ZAP_MIN_MAX_DEFAULTS_INDEX(1), 0x00000002, 1, ZAP_TYPE(PERCENT), ZAP_ATTRIBUTE_MASK(MIN_MAX) | ZAP_ATTRIBUTE_MASK(WRITABLE) | ZAP_ATTRIBUTE_MASK(NULLABLE) }, /* PercentSetting */
{ ZAP_EMPTY_DEFAULT(), 0x00000003, 1, ZAP_TYPE(PERCENT), 0 }, /* PercentCurrent */
{ ZAP_SIMPLE_DEFAULT(2), 0x0000FFFC, 4, ZAP_TYPE(BITMAP32), 0 }, /* FeatureMap */
{ ZAP_SIMPLE_DEFAULT(5), 0x0000FFFD, 2, ZAP_TYPE(INT16U), 0 }, /* ClusterRevision */Observation:
Home Assistant correctly displays fan modes using this configuration.
Google Home does not show the fan mode options in the UI.
For reference, I have attached screenshots from Home Assistant and Google Home for comparison.
Goolge Home UI
Home Assistant UI
Please let us know if there are any additional requirements, constraints, or known limitations for displaying fan modes in Google Home for Matter-based air purifiers.
Thank you for your support.
Looking forward to your guidance.
Best regards,
Chintan Patel
