From d34f432e40e6e448d54e18b05cd946ff798eaf48 Mon Sep 17 00:00:00 2001 From: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> Date: Mon, 4 Mar 2024 13:30:39 +0100 Subject: [PATCH] Matter on Android: add troubleshooting information (#31726) * Matter on Android: add troubleshooting information - Adding a Matter device via Home Assistant Companion app on Android: - Add troubleshooting information on what to do when the Matter modules are unavailable - Addresses feedback from #31700 * Add description * Implement review feedback --- source/_integrations/matter.markdown | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) diff --git a/source/_integrations/matter.markdown b/source/_integrations/matter.markdown index aa85c307aa1..7a2616135a3 100644 --- a/source/_integrations/matter.markdown +++ b/source/_integrations/matter.markdown @@ -80,7 +80,6 @@ One of the great features of Matter is the so-called _Multi Fabric_ feature: you For devices where Home Assistant provides a native integration (with local API), Matter may not be the best option. Matter, being a universal standard, might not have the nitty-gritty features that come with a product-specific protocol. A good example is Philips Hue: the communication over Matter only provides the basic controls over lights, while the official [Hue integration](/integrations/hue) brings all Hue unique features like (dynamic) scenes, entertainment mode, etc. - ## Supported installation types It is recommended to run the Matter add-on on Home Assistant OS. This is currently the only supported option. Other installation types are without support and at your own risk. @@ -180,6 +179,23 @@ This guide describes how to add a new device. This will use the Bluetooth connec +### Troubleshooting the installation + +Check these steps if you are experiencing issues when trying to add a Matter device using the Home Assistant Companion app on your Android phone. + +#### Symptom + +While trying to add the Matter device, I get an error stating that *Matter is currently unavailable*. + +#### Remedy + +This could mean that not all required Matter modules that are needed by the Home Assistant Companion App have been downloaded yet. Try the following steps: + +1. Wait up to 24 hours for the Google Play services to download the necessary Matter modules. +2. If this did not work, try reinstalling the Home Assistant Companion app. +3. If this did not work, try installing the Google Home app. Technically this is not required, but it might trigger another installation attempt of the Matter modules. +4. Refer to this [Troubleshooting Guide from Google](https://developers.home.google.com/matter/verify-services). + ## Sharing a device from another platform with Home Assistant Use one of these methods if your Matter device was added to Apple Home or Google Home and you want to control it from both Apple or Google Home and Home Assistant.