ISY Portal Google Home Integration
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.
3) Select “Amazon Echo/Google Home” under “Connectivity”.
4) Select “Device” from the “Spoken device list”.
5) Select the dropdown arrow to reveal devices.
6) Select a device to be added.
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.
8) When a device “Spokens” have been added, they will appear in red in the “Spoken mapping” dropdown.
9) When a “Device” has been added successfully it will appear in the “Spoken device list”.
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.
Google Home Application
NOTES:
When Adding Scenes to ISY Portal "Spoken Device List" there is an option for "Category". If this is left as Scene it will not show up in the device list on the Google Home App but will still be controllable via voice. If user would like the Scene to show up in the Google Home Device List change the "Category" for the scene in ISY Portal to "Light". To check the "Category" click on the device "Spoken" column in the Spoken Device List.
Skip to step 3 to reload new Devices, or from the Admin Tab in UD Mobile select Google Assistant Linking.
1) Download the Application “Google Home” by Google
]
2) Launch “Google Home”. Sign in. Allow All permissions. Google Home will then attempt to find devices on your network. Wait until complete or press cancel
3) SKIP THIS STEP IF THIS IS A NEW INSTALLATION OF GOOGLE HOME. If this is an existing installation of Google Home select Settings.
4) SKIP THIS STEP IF THIS IS A NEW INSTALLATION OF GOOGLE HOME. Select Add Device.
5) Select "Works with Google".
6) If this is the first time linking to Google Home click the search icon and start typing "Universal Devices", then select Universal Devices under "Add New". If account was linked in the past select Universal Devices under "Linked Services"
7) If prompted to connect or reconnect account select connect or reconnect.
8) Select continue when prompted to link isy.io account (my.isy.io (isy.io is the Universal Devices ISY Portal URL)
9) Sign into using your ISY Portal username and password.
10) After pressing Submit user should be redirected back to the Google Home App. The following screen may only show for briefly.
11) Select the back buttons until at the Google-Home Home screen.
12) Scroll down to see devices Linked to you.
Are your Scenes missing? See the notes at the top of this section.
13) Please follow these same instructions after adding new devices to ISY Portal.
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>”
- For Door Locks
- Lock: "Ok Google, lock <device>"
- Unlock: "Ok Google, unlock <device>"
- Is locked: "Ok Google, is <devices> locked?"
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.