Verify Matter Modules & Services

Before attempting to setup and pair a Matter device in the Google Home ecosystem, verify your mobile device has all the required Matter modules downloaded.

Check the Android settings

Your Android mobile device should get all modules automatically, but sometimes it can be delayed.

To verify, on your mobile device, go to Settings > Google > Devices & sharing.

  • If the Matter devices option is listed, you have what you need. Jump to Pair a Matter device to continue.

  • If the Matter devices option is NOT listed, you will need to force the download if you want it right away (otherwise simply wait for it to roll out on its own) using one or more of the options below.

Update Google Play services

Google Play services should be version 22.36.15 or higher. To check, on your mobile device, go to Settings > Apps > See all apps > Google Play services. Scroll to the bottom, where the version is listed.

If the version is not at least 22.36.15, force an update:

  1. On your mobile device, navigate to https://play.google.com/store/apps/details?id=com.google.android.gms or use the QR code below:

    image

  2. If this page shows an Update button, tap it to ensure you get the required Matter module.

  3. You may have to wait 24 hours for the Matter modules to download. Ensure your device is powered on and charging during this time, so the download isn't delayed. If you haven't received the modules within 24 hours, you can try a factory data reset of the device to force the modules to download.

After a successful update, check for the Matter devices option again.

Uninstall and reinstall Google Home app

A reinstallation of the GHA should trigger module downloads. This is enforced by module dependencies in the app's Android manifest, as described in Ensure module delivery.

  1. On the Android home screen:
    1. Long press the Home icon and select App info. or,
    2. Go to Settings > Apps > See all apps > Home.
  2. On the App info screen, select Uninstall. Tap OK to proceed.
  3. After a successful uninstall, on your mobile device, navigate to https://play.google.com/store/apps/details?id=com.google.android.apps.chromecast.app or use the QR code below:

    image

Once you have successfully installed the GHA, check for the Matter devices option again.

Troubleshooting

Verify your phone is compatible

All Android O (8.1, API level 27) and later devices are compatible with Matter. Follow the steps below to check if your phone has the necessary modules.

Set up Android Debug Bridge setup

Android Debug Bridge (adb) should be set up prior to troubleshooting. To set it up:

  1. Install "adb" on your computer.
  2. Turn on Developer Options and USB Debugging on your Android phone.

Verify your Google Play Services (GPS) Matter modules

To check if you have the Play services Matter modules, do the following:

  1. Set up Android Debug Bridge.
  2. Use a USB cable to connect your Android phone to your computer.
  3. Run this command in a terminal to verify that the necessary Matter modules are installed:
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.home"
      
    
    If you see output similar to the below, you have the Matter modules installed:
    com.google.android.gms.home [v222110900]
    Note that the version number above may be different from your device.
  4. Run this command in a terminal to verify that the necessary Thread modules are installed:
      adb shell dumpsys activity provider com.google.android.gms.chimera.container.GmsModuleProvider | grep "com.google.android.gms.threadnetwork"
      
    
    If you see output similar to that in the following example, you have the Thread modules installed:
    com.google.android.gms.threadnetwork [v222106301]
    Note that the version number on your device may be different.

If the modules are not listed, it means that either:

  1. You have an outdated Android version. Make sure it's Android O (8.1) or above.
  2. The Matter modules have not been downloaded yet. Wait at least 24 hours for them to download. Ensure your device is powered on and charging during this time, so the download isn't delayed. If you haven't received the modules within 24 hours, you can try a factory data reset of the device to force the modules to download.