Create a Matter integration

Stay organized with collections Save and categorize content based on your preferences.

To create a new Matter integration, you must first have a project as described in Create a developer project. Once your project is set up, go to the Google Home Developer Console:

Go to the Developer Console

  1. From the list of projects, click Open next to the project you want to work with.

  2. Click Add Matter integration.

    If this is the first time you're creating a Matter integration, you are taken to the Matter resources page, where you can view Matter development documentation and read about some tools.

    When you're ready to continue, click Next: Develop, which displays the Matter checklist page. Click Next: Matter setup.

    If this is not the first time you're creating a Matter integration, you'll find yourself at the Matter setup page.

  3. On the Matter setup page, enter your Product name.

  4. Click Select device type and select the device type from the dropdown menu.

  5. In the Configuration page, enter a Vendor ID.

    Matter integration configuration
dialog

    By default, you can use one of the VIDs allocated by the CSA for testing purposes. Select one of the following: 0xFFF1, 0xFFF2, 0xFFF3, 0xFFF4.

    To use a Production VID so that your integration can be certified and launched, you must first have it verified by Google to ensure that it has been issued to you by the CSA.

    This VID should be implemented in your device's firmware.

    To submit for verification, select CSA-issued vendor ID (to certify) and click on the link for the Vendor ID verification form and fill it out. Once verified, your Production VID will be accepted. Any attempt to save a non-test VID without verification results in an error.

  6. Optionally, add a Product ID.

    Information about the device is read using the Matter Descriptor clusters, rather than the Product ID. You may assign any Product ID during development, according to your company's numbering scheme—as long as it matches the Product ID of your Matter integration, if specified.

  7. Click Submit, which saves the Matter integration configuration.

You may now set up your Matter devices with the new project configuration on the Google Home app (GHA). The Matter integration configuration is updated automatically whenever you make a change to it in the Developer Console.

Troubleshooting

Verify the credentials for your device

When you use your own CSA-assigned VID, ensure that you have the correct credentials on the device:

  • Certification Declaration (CD).
  • Device Attestation Certificate (DAC) and its certificate chain.

For more information, see Create Matter device test certificates.