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.

ISY 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)
  • For Thermostats:
    • Change mode: “Set <device> mode to <off|heat|cool|auto|on>”
    • Change mode: “Turn off <device>”
    • Change mode: “Turn on <device>”
    • Change temperature: “Set <device> to <temp>”
    • Change temperature: “Increase <device> by <tempDelta>”
    • Multiple thermostat commands: “What is the inside temperature”
    • Multiple thermostat commands: “Set heating to <temp>”
    • Multiple thermostat commands: “Set cooling to <temp>”
    • Multiple thermostat commands: “Set the thermostat modes to <mode>”

Supported Queries/Questions

  • For Devices:
    • Status "Ok Goggle is the <name> on?"
    • Status "Ok Google is the <name> off?"
  • For Thermostats:
    • Query thermostat: “what is <device> set to”
    • Query thermostat: “what is <device> inside temperature”
    • Query thermostat: “what is <device> humidity (If your thermostat supports it)”

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.


  • 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.


  • After adding new “Spokens” to ISY Portal, you need to send then to Google Home. In the Google Home dialog, there is a button to send the spokens to Google Home.


  • If the "Send spokens to Google Home" button do not work, you may have to unlink and relink.

If Unlink/Relink works, but it stops working after a while, read on. If the only spokens in use are scenes and/or programs, there is a known issue where the "Send spokens to Google Home" button may stop working. If you encounter this issue, please add a "dummy" device. Please chooses a common device that changes state at least daily.


  • If the Google Home integration no longer works, please use the the Google Home application to unlink and relink.