Google Home Extension for VS Code

Device SDK

Google Home Extension for Visual Studio Code is designed and created for Google Home Platform developers. This extension gives you access to Google Assistant Simulator, Google Cloud Logging, Home Graph Viewer, and other tools to simplify your Matter and smart home development process.

Google Home Extension for VS Code

Google Home Extension Features

Google Assistant Simulator

To test whether your smart home devices work properly with the Google Home ecosystem, you can interact with Assistant Simulator at any time without leaving VS Code.

Similar to the existing Simulator provided in the Actions Console, Assistant Simulator enables you to easily control your devices by typing your queries, for example, "Turn on the light." Inside VS Code, Assistant Simulator responds back with text messages based on your commands, for example, "Alright, turning on the light." See Use Google Assistant Simulator for more details.

Batch Utterances

To test your Google Home integration like an automaton, you can send batch utterances to Google Assistant Simulator by running an utterance script. See Run Batch Utterances for more details.

Matter Logging Tools

Matter Logging Tools can collect all logs related to Matter debugging, including the Google Home app (GHA) logs and Google Play services (GMS Core) logs. The logs can be viewed on VS Code with filter and keyword searches. Logs can be downloaded with additional debug information such as Android and App version and be sent to Google for reporting issues.

Google Home Extension Matter Logging

Cloud Logging

Cloud Logging provides debugging information and key metrics to give you insights into your Action's usage. To simplify development, the Google Home Extension shows real-time Google Cloud Logging messages right next to your code during troubleshooting. See View Cloud Logging for more details.

Home Graph Viewer

Home Graph Viewer is now available directly in the Google Home Extension so that you can verify the state of the device in your Home Graph inside VS Code. See View Home Graph and Run Tests for more details.

Install Google Home Extension for VS Code

To install the Google Home Extension, follow these steps from within VS Code:

  1. Click the Extensions icon on the Activity Bar.
  2. Search for google home, then click Install.

    Google Home Extension Marketplace

You can also download the Google Home Extension directly from the VS Code Marketplace.

Download Google Home Extension

Set up Google Home Extension for VS Code

Once you've installed Google Home Extension and reloaded VS Code, you'll need to sign in and select a project before you can use Assistant Simulator and view Cloud Logging.

Sign in with Google and select a cloud project

You can sign in to your developer account from Google Home Extension, authorizing VS Code to communicate with Google services on your behalf.

  1. Click the Google Home icon on the Activity Bar to open Google Home Extension.

    Google Home Extension icon
  2. Click Sign in with Google to launch the login view in your browser.

    VS Code Google Sign in
  3. Select the account that is linked with your smart home devices.

  4. On the Sign in with Google authorization page, click Allow.

  5. A browser tab will open and an Open Visual Studio Code dialog box is displayed. Click Open Visual Studio Code to proceed.

    Open VS Code dialog box
  6. You will be redirected to VS Code, where your permission is required to allow Google Home Extension to open a URI. Click Open to finish the login process.

    Allow Google Home Extension to open a URI
  7. After signing-in, Google Home Extension will load your projects. Once done, click Select a project.

    Select a project
  8. In the Search and select a project drop-down window that appears, select your smart home project.

Install Android Debug Bridge (ADB) Tool

To view the Matter logs on an Android phone, you'll need to install ADB:

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

Install Matter Device SoC Tools

To view the debug logs from Matter devices:

  1. Most device SoC will export serial ports such as /dev/ttyUSBx on Linux or /dev/tty.SLAB_USBtoUART or /dev/tty.usbserial on MacOS. The LogViewer can read the log from the device directly.
  2. Some SoC types such as NXP or Silicon Labs may require external tools (for example, JLink) to be installed. See Supported devices for more information.

Use Google Home Extension for VS Code

View Developer Resources

Under HELP AND FEEDBACK, click Get Started & Resources to open the Resources page, where you can find helpful information for your development with Google Home ecosystem.

Resources for Google Home Ecosystem

Use Google Assistant Simulator

To open Assistant Simulator in VS Code, click GOOGLE ASSISTANT SIMULATOR on the Side Bar. In the Message box, type your query and press Enter.

You can view Assistant Simulator responses, and click the button after your query to Resend it.

Use Google Assistant Simulator

Run Batch Utterances

Mouse over to GOOGLE ASSISTANT SIMULATOR menu bar, and choose from the following options to set up scripts:

  • Click to open existing utterance scripts.

  • Click to save history into a *.utterance script.

    Batch Utterances Menu Icons

To start sending batch utterances, choose from the following options:

  • Click to select a utterance script from the drop-down window.
  • Directly open a *.utterance file and click .

    Batch Utterances Run Icon

View Cloud Logging

Under QUICK ACCESS, click Cloud Logs to open the Cloud Logs page, where you can find the logs belonging to your selected project.

Use Cloud Logging

Users can filter logs based on severity and time range.

Filter logs by severity and time

By default, the logs are limited to 50 rows. If the user would like to view more logs, scroll down to the bottom and click More to view more logs.

View more logs

View Home Graph and Run Tests

Under QUICK ACCESS click Home Graph Viewer to open the Home Graph Viewer panel, where you can find devices that belong to the selected project. You can also click Run Test to run tests for the device.

Home Graph Viewer

This will launch the test suite in your browser with your device selected and ready to test. Click Start and wait for the test results.

Google Home Test Suite

You can check out the test details and view the logs after all the tests are completed.

Test results

Use Google Home Extension for Matter Debugging

Android Logging

Under MATTER LOGGING TOOLS, click Android Logs to open the Android Logs page, select the Android phone you want to connect to and start to show logs.

Android Logging

After the Android phone is connected, you'll be able to see the logs line by line. Note that the logs are filtered which means that only logs related to the GHA and the Google Play services Matter module are displayed. You can also set Severity to filter logs or Search the keyword in logs.

Android Logging Filtered

Matter Device Logging

Under MATTER LOGGING TOOLS, click Device Logs to open the Resources page, select SoC Type first:

Matter device logging

Next, select the Matter Device:

Matter device logging select device

Then you can get all the device logs from the device and use filters such as Severity and Search to find your interested information.

Matter device filtered logging

Download all Matter Logs

Under QUICK ACCESS, click Download Logs to open the Download Logs dialog, select logs to be downloaded, and press OK.

Download Matter Logs

Select the folder to download logs and click Save:

Matter Log Save

Then the logs will be saved into the destination folder:

Matter Log Destination Folder

Extract the saved zip file, it will show device info and log files.

Matter Log Zipfile

The device info file will include all the version information needed to debug issues.

Matter Log Debug

Send feedback

To submit your thoughts or feedback on how we can improve the development experience with Google Home Extension, choose from the following options:

  • On the HELP AND FEEDBACK panel, click Give Feedback to give us suggestions.
  • On the HELP AND FEEDBACK panel, click Report Issue to report any problem you've found with Google Home Extension
Send Feedback Icon
  • We've also provided a feedback icon on the Resources page.