ISY Portal Google Home Integration

From Universal Devices, Inc. Wiki
Jump to: navigation, search

Prerequisites

1) The user must be subscribed to the UDI Portal service, and approve the portal in ISY's Admin console.

Portal Google Home Integration

  • Note: The user must configure the ISY Portal prior to linking the Google Home mobile application to UDI in order for the system to work.

1) Log into the ISY Portal using valid login credentials at "https://my.isy.io/".

2) Select the “Select Tool” for the ISY you wish to add Google Home to.

GoogleHome ss small 1.jpg


3) Select “Amazon Echo/Google Home” under “Connectivity”.

GoogleHome ss small 2.jpg


4) Select “Device” from the “Spoken device list”.

GoogleHome ss small 3.jpg


5) Select the dropdown arrow to reveal devices.

GoogleHome ss small 4.jpg


6) Select a device to be added.

GoogleHome ss small 5.jpg


7) Enter a “Spoken” name for each device, and “Alternate Spokens” and select “Save”.

  • Note: The text in “Spoken” will be announced by Google Home as the device name. The text in “Spoken” will also be the name that the Google Home mobile application uses as the device name.

GoogleHome ss small 6.jpg


8) When a device “Spokens” have been added, they will appear in red in the “Spoken mapping” dropdown.

GoogleHome ss small 7.jpg


9) When a “Device” has been added successfully it will appear in the “Spoken device list”.

GoogleHome ss small 8.jpg


10) Once all devices have been added they will appear in the “Spoken device list”. The setup required in ISY Portal is now complete.

  • Note: Scenes and Programs may be added in this same way. Programs will run the “Then” when commanded “On” verbally. Programs will run “Else” when commanded “off” verbally.


GoogleHome ss small 9.jpg

Google Home Application

1) Download the Application “Google Home” by Google

GoogleHomeapp ss small 1.jpg


2) Launch “Google Home” and select “main menu”.

GoogleHomeapp ss small 3.jpg


3) Select “Sign In” to sign in to “Google Home” mobile application.

GoogleHomeapp ss small 2.jpg


4) Enter valid login credentials and select “Next”.

GoogleHomeapp ss small 4.jpg GoogleHomeapp ss small 5.jpg


5) Select “main menu”.

GoogleHomeapp ss small 6.jpg


6) The “main menu” should now look like the image below once the user is logged into the “Google Home” mobile application.

GoogleHomeapp ss small 7.jpg


7) Select “Devices” to setup the “Google Home” device.

GoogleHomeapp ss small 8.jpg


8) Select the “add new device” button. “Google Home” mobile application will look for any “Google Home” devices that are available.

  • Note: Make sure that the Google Home device is powered on, and that WiFi and Bluetooth are enabled on the mobile device being used.

GoogleHomeapp ss small 9.jpg


9) Select the “Sign in” button once the “Google Home” mobile application has discovered the “Google Home” device you wish to add.

  • Note: The user MUST use the SAME Google login credentials for the “Google Home” device and the “Google Home” mobile application for the system to work. Use the credentials used in step 4.


GoogleHomeapp ss small 10.jpg GoogleHomeapp ss small 11.jpg


10) Select the “Continue as …” button.

GoogleHomeapp ss small 12.jpg


11) The user may set the location of the “Google Home” device.

GoogleHomeapp ss small 13.jpg


12) The user may add music services to the “Google Home” device, and select continue.

  • Note: Free 2 week “Google Music” preview for purchasing “Google Home” device.


GoogleHomeapp ss small 14.jpg


13) The “Google Home” device setup is now complete. Select “Continue”.

GoogleHomeapp ss small 15.jpg


14) Your “Google Home Devices” window should now look like the image below. Select the “Back arrow” to return to the main menu.

GoogleHomeapp ss small 16.jpg


15) Select “Home Control” from the main menu.

GoogleHomeapp ss small 17.jpg


16) Select the “+” button to add devices, scenes, and programs (“Spokens”) from the UDI Portal.

GoogleHomeapp ss small 18.jpg


17) Select “Universal Devices” from the list of accounts that can be added.

GoogleHomeapp ss small 19.jpg


18) Login to the UDI Portal using valid UDI portal criedentials and select “Submit”.

GoogleHomeapp ss small 20.jpg


19) The ”Google Home” mobile application will import “Spokens” from the UDI Portal. Once complete, the created “Spokens” will appear under the “Device” tab of “Google Home” mobile application. The setup of the Google Home mobile application is now complete, and ready to use.

  • Note: The screen of the application may be blank white momentarily while “Spokens” are imported. Devices, scenes, and programs may be added to rooms within the “Google Home” mobile application.


GoogleHomeapp ss small 21.jpg GoogleHomeapp ss small 22.jpg

Supported Commands

  • For Devices:
    • Turn On: “Ok Google, turn on the kitchen light”
    • Turn Off: “Ok Google, turn off the kitchen light”
    • Brighten: “Ok Google, brighten the kitchen light”
    • Dim: “Ok Google, dim the kitchen light”
    • Set: “Ok Google, set the kitchen light to 50%”
    • Turn On lights: "OK Google, turn on the lights"
    • Turn On all lights: "Ok Google, turn on all the lights"
    • Turn On room lights: "Ok Google turn on the lights in the <room name>"
    • Turn On room lights: "Ok Google turn on the <room name> lights"
  • For Scenes:
    • Turn On: “Ok Google, turn on the kitchen light”
    • Turn Off: “Ok Google, turn off the kitchen light”
  • For Programs:
    • Turn On: “Ok Google, turn on the kitchen light” - runs Then
    • Turn Off: “Ok Google, turn off the kitchen light” - runs Else
  • For State Variables:
    • Turn On: “Ok Google, turn on X” - Sets the variable X to the <turn on> value (defined in the portal)
    • Turn On: “Ok Google, turn on X to Y percent” - Sets the variable X to Y
    • Turn Off: “Ok Google, turn off X” - Sets the variable X to the <turn off> value (defined in the portal)

Supported Queries/Questions

  • For Devices:
    • Status "Ok Goggle is the <name> on?"
    • Status "Ok Google is the <name> off?"

Troubleshooting

  • Once a device has been added to a room it can only be moved to another room, it cannot be “un-roomed” without “Un-Linking UDI Portal account.


  • Adding “Spokens” to the UDI Portal after linking the UDI Portal to the "Google Home" Mobile application requires “unlinking” the UDI Portal from the “Google Home” mobile application and then “relinking” the UDI Portal -- in order for “Google Home” to see the new “Spokens”. To do this, select “main menu" then "Home control" then select the ellipsis in the upper right corner. Select “Manage accounts”, select "Universal Devices" under "Linked", then select “Unlink account”. Once the account has been "unlinked", quit the application out of multitasking (iOS) or recent apps (Android). The user may now add "Spokens in the ISY Portal, then "relink" the ISY Portal and "Google home" mobile application to see the new "Spokens".


  • Google Home will automatically group devices, scenes and programs with similar names containing the same word. It makes no distinction between a program and a device at this time. Example: If the user names a device “Hue bloom 1”, names a scene “Hue lights”, and names a program “Hue Color cycle” then speaking “Turn hue on” will result in device, scene, and program being toggled in some cases. This may change as time goes on.