MobiLincTake Control of Your Home

MobiLinc and Amazon Alexa


With MobiLinc, your ISY-994x series controller, and MobiLinc Connect cloud service, Alexa voice assistant is now supported!

Controlling your home has never been easier with your voice. Simply say "Alexa, turn on kitchen lights." or "Alexa, set the thermostat to 72 degrees."

NOTE: While our MobiLinc Custom skill is live, our MobiLinc Smart Home skill was submitted to Amazon for certification on January 23rd, 2017 and is pending approval. We expect approval from Amazon in February 2017. See below to get your ISY and the MobiLinc Custom skill ready for Smart Home.

Contact us to be notified as soon as MobiLinc Smart Home Skill is approved.


Features:

MobiLinc Connect supports two Alexa Skills: The MobiLinc Smart Home skill and the MobiLinc Custom skill.



The MobiLinc Smart Home skill supports the following voice features:

  • Turn on or off a device, scene, or program. "Alexa, turn on the kitchen lights."
  • Brighten or Dim a device. "Alexa, dim the living room."
  • Adjust the Thermostat. "Alexa, set the thermostat to 72 degrees."

The MobiLinc Custom skill supports the following voice features by saying "Alexa, tell/ask MobiLinc to":
  • Turn on or off a device or scene.
  • Turn on a device to x percentage or brighten/dim a device.
  • Toggle a device on/off or ask for a device status.
  • Lock or Unlock one or all doors. (Z-Wave door locks only)
  • Get thermostat temperature.
  • Get/Set the thermostat mode.
  • Get/Set thermostat set point for heat or cool.
  • Increase or Decrease the setpoint.
  • Run/Stop/Status of a program.
  • Run a Special Action.
  • Custom program responses spoken by Alexa.

For power users, the MobiLinc Smart Home skill can be linked to different Alexa devices to provide a simple voice experience for a room. For example, in the living room you could say "Alexa, turn the lights on" and have just the living room lights turn on. Then, in a different room of the house, you could also say "Alexa, turn the lights off" and have just the lights in that room turn off. See below for Advanced Setup instructions.


Who can use this?

Anyone with an active MobiLinc Connect account, Amazon Alexa device like the Echo and Echo Dot, and an ISY-994x controller.

What do I need?

The following is needed:

1. MobiLinc HD, MobiLinc Pro, or Orchestrated MobiLinc for iOS or Android.
2. Active MobiLinc Connect account and an ISY series controller running firmware 4.5.4 or later with the MobiLinc Connect portal installed and connected to your MobiLinc Connect account via the MobiLinc app.
3. Amazon Alexa device like the Echo or Echo Dot.

Setup Guide:

Please follow these steps to connect your ISY to Alexa through MobiLinc Connect:

Install MobiLinc Connect:
1. Install the MobiLinc Connect portal in your ISY-994x by opening the Admin Console from a PC/MAC and going to Help->Purchase Modules.
2. Once installed and the ISY reboots, open MobiLinc and go to Settings->Lighting Controller->Host Type and select "MobiLinc Connect".
3. Select "Create a New Account" and follow the directions.

Prepare your vocal names of your devices, scenes, and programs:
Many device and scene names aren't written in a way that's easily spoken or written as simple English text. For example, a device may be named "office.1.upstairs". This name will not work with voice recognition. To get around this please follow these steps:
1. Use the ISY's Admin Console and right-click on your device or scene and select "Notes".
2. Under the "Spoken" field enter in simple English to describe your device/scene. For example: "Upstairs Office".
3. Programs: Make sure the name of the program is written in plain speakable English. See Advanced Setup for additional configuration options.
4. After making any changes to the Spoken Notes field or changing the name of your devices, scenes, or programs, say "Alexa, tell MobiLinc to refresh devices".
5. MobiLinc will resync your changes back to MobiLinc Connect and Alexa.

Enable the MobiLinc Custom skill for Alexa (this is required to support the Smart Home skill):
1. Open the Alexa app on your iOS/Android device and search for "MobiLinc".
2. Tap "Enable Skill".
3. The Alexa app will prompt for your MobiLinc Connect email address and your MobiLinc Connect password.
4. Once verified, select which ISY on your MobiLinc Connect account you would like to connect to Alexa.
5. Once linked, say "Alexa, tell MobiLinc to refresh devices".
6. MobiLinc Connect will pull your current list of names for your devices, scenes, and programs for Alexa support.

Enable the MobiLinc Smart Home skill for Alexa:
1. Open the Alexa app on your iOS/Android device and search for "MobiLinc". Select the MobiLinc Smart Home skill.
2. Tap "Enable Skill".
3. The Alexa app will prompt for your MobiLinc Connect email address and your MobiLinc Connect password in addition to an optional
Custom Name. See Advanced Setup for additional configuration options.
4. Once verified, select which ISY on your MobiLinc Connect account you would like to connect to Alexa.
5. Once linked, say "Alexa, discover devices" or tap "Discover Devices" in the Alexa app.
6. Alexa will ask MobiLinc Connect for the current list of names for your devices, scenes, and programs for Smart Home Alexa support.

Q: How can I tell when the Refresh devices command is complete?
A: If you have any push notifications setup for your iOS devices, MobiLinc Connect will broadcast a push notification to all your connected iOS devices that use push notifications through MobiLinc Connect informing you when the sync is complete. In most cases it only takes a few seconds, but if you have 100+ items to sync between devices, scenes, programs it can take a few minutes. If you don't have push notifications setup, you can watch the front of the ISY for the blinking LEDs to stop.

Advanced Setup Guide:

For our MobiLinc power users, our Alexa support has several exciting advanced features:

Voice Programs:
By default, the MobiLinc Custom skill and the Smart Home skill will pull in all of your programs for voice control. Most program names are not voice friendly and will take up many slots in Alexa's 300 item limit for Smart Home devices. To clean this up, follow these steps:
1. Create a Program folder anywhere in your program list called "
Voice".
2. Any programs in the root "
Voice" folder will be pulled into the MobiLinc Custom and Smart Home skill for use.
3. Create a folder under "
Voice" called "MobiLinc" for use for Special Actions below.
4. Create a folder under "
Voice" called "Accounts" for use for Room Specific Alexa Support below.

Custom Responses:

Running a program with the MobiLinc Custom skill returns a not-so-friendly response saying what parts of the program were run. Often times, the program you want to run should have a custom and pleasant voice response to running that program. Now you can customize the Alexa response for the MobiLinc Custom skill!

For any program you want to have Alexa say the exact response phrase in response to running a program simply add the phrase in parenthesis after the name of the program.

For example, let's say we have a program called "Irrigation" and we want Alexa to respond with "Irrigation is on". To set this up, follow these steps:
1. Create your Irrigation program under the "Voice" folder from above and name it:
Irrigation (Irrigation is on)
2. Save your program changes.
3. Tell Alexa, "Alexa, tell MobiLinc to refresh devices".
4. After the device refresh is complete, you can say "Alexa, tell MobiLinc to run program irrigation".
5. Alexa will respond with "Irrigation is on".

Get as creative or tongue-in-cheek as you want. Surprise your friends and family with different (and unexpected) Alexa responses.

Special Actions:
We've identified a set of special actions that are common to many households that deserve a shorter and more natural voice sentence to execute. These actions are:

Going to Bed
Going to Sleep
Good Morning
Good Night
Home
Leaving
Party Time
Stop Party Time

For example, when leaving for the day, you can say "Alexa, tell MobiLinc we're leaving", or "Alexa, tell MobiLinc I'm leaving". This will instruct our MobiLinc Custom skill to look inside of your MobiLinc folder created under the Voice folder above for the "leaving" program to run the "Then" path. MobiLinc will give a default response of "Goodbye" for the leaving action or your custom response if setup as outlined under the "Custom Responses" instructions.

To support the Special Actions, create 8 programs under the Voice/MobiLinc folder with the following exact names. Any programs under the MobiLinc folder that do not match the below names will be ignored by the skill:
going to bed
going to sleep
good morning
good night
home
leaving
party time
stop party time

Specify a custom response in parenthesis for any or all of the above like:
leaving (See you later)

Phrases that trigger the Custom Actions:
"Alexa, tell MobiLinc we're/I'm going to bed."
"Alexa, tell MobiLinc we're/I'm going to sleep."
"Alexa, tell MobiLinc good morning."
"Alexa, tell MobiLinc good night."
"Alexa, tell MobiLinc we're/I'm home."
"Alexa, tell MobiLinc we're/I'm leaving."
"Alexa, tell MobiLinc it's party time."
"Alexa, tell MobiLinc to stop party time."

Room Specific Alexa Support:
This is the most exciting new feature for the MobiLinc Smart Home skill. Many MobiLinc/Alexa users have multiple Echo/dots in several rooms. What we wanted to support is walking into a room and just saying "Alexa, turn on the lights" and Alexa would know what room you are in and only turn on those lights. The same phrase said in another room with another Alexa device would only turn on those lights. Here's how to set this up.

For the setup, let's assume that you have two Echo Dots. One in the Living Room and one in the Master Bedroom.

Admin Console Setup:
1. In your
Voice folder, go to the Accounts folder created above in Voice Programs
2. Create a folder named "Master Bedroom" and another folder named "Living Room". You can name these anything, but where the Echo's are located helps to keep things organized.
3. In the
Master Bedroom folder create a program called "lights" and assign your Master Bedroom devices/scenes/programs to turn ON in the Then path and OFF in the Else path.
4. Repeat step 3 for the
Living Room folder for items in the living room.
5. After editing your programs. Click Save in the Admin Console.

Alexa App Setup:
1. Create a second Amazon account with another email address you own.
2. Remove the Master Bedroom Echo from your primary Amazon email in the Alexa App.
3. Log into the Alexa app with your second Amazon email.
4. Assign or pair the Master Bedroom Echo to your second Amazon account in the Alexa App.
5. Log back into the Alexa app with your primary Amazon account that has your Living Room echo.
6. Link the MobiLinc Custom Skill to your Primary Amazon account.
7. Tell Alexa, "Alexa tell MobiLinc to refresh devices".
8. After the refresh has finished, link to the MobiLinc Smart Home skill.
9. On the MobiLinc Connect log-in screen, enter "
Living Room" for the Optional Custom Name. This must match exactly to the "Living Room" folder created in the Admin Console Setup step.
10. Once linked, tell Alexa to "
Discover Devices" to pull in your items from step 7.
11. Say "Alexa, turn the lights on" to your Living Room Echo to turn on just the Living Room lights. This runs the "lights" program "Then" path in the
Living Room folder.
12. Log out of the Alexa app and back in as your second Amazon email with the Master Bedroom Echo.
13. While you can link to the MobiLinc Custom skill, it is not necessary.
14. Link to the MobiLinc Smart Home skill.
15. On the MobiLinc Connect log-in screen, enter "
Master Bedroom" for the Optional Custom Name. This must match exactly to the "Master Bedroom" folder created in the Admin Console Setup step.
16. Once linked, Discover Devices to pull in your items from step 7.
17. Say "Alexa, turn the lights on" to your Master Bedroom Echo to turn on just the Master Bedroom lights. This runs the "lights" program "Then" path in the
Master Bedroom folder.

Notes:
1. The example only illustrates the one phrase "Alexa, turn on the lights", but you can add any number of common programs to the
Account folders. Examples may be, "all lights", "bathroom lights", "upstairs lights", "downstairs lights", etc.
2. Programs in the sub Account folders are only added to the Smart Home account link that matches the Optional Custom Name during account linking.
3. After making changes to the Voice device, scene, or program names, tell Alexa "Alexa, tell MobiLinc to refresh devices". Once complete, tell each Alexa linked device to a separate Amazon account "Alexa, discover devices". In the example above, you would need to tell the primary account's Echo in the Living Room to discover devices as well as the Master Bedroom Echo to discover devices.

Voice Command Guide for MobiLinc Smart Home Skill:

Once MobiLinc Connect is connected and synced with the Alexa MobiLinc Smart Home skill, you can issue the following voice commands:

Devices: Example "Kitchen"
"Alexa, turn kitchen off."
"Alexa, turn kitchen on."
"Alexa, set kitchen to 50 percent."
"Alexa, dim the kitchen."
"Alexa, brighten the kitchen."

Scene: Example "Dining Room"
"Alexa, turn dining room on."
"Alexa, turn dining room off."

Thermostats: Example "Upstairs Thermostat"
"Alexa, set the temperature of the upstairs thermostat to 74 degrees."
"Alexa, increase the upstairs thermostat by 5 degrees."
"Alexa, decrease the upstairs thermostat by 5 degrees."

Programs: Example "Irrigation"
"Alexa, turn irrigation on." (Runs the Then path)
"Alexa, turn irrigation off." (Runs the Else path)

Voice Command Guide for MobiLinc Custom Skill:

Once MobiLinc Connect is connected and synced with the Alexa MobiLinc Custom skill, you can issue the following voice commands:

Devices/Scenes: Example "Office"
"Alexa, tell MobiLinc to turn my office off."
"Alexa, tell MobiLinc to turn my office on."
"Alexa, tell MobiLinc to set my office to 50 percent."
"Alexa, tell MobiLinc to toggle my office light."
"Alexa, ask MobiLinc the status of office light."

Z-Wave Door Locks: Example "Front Door"
"Alexa, tell MobiLinc to lock my front door."
"Alexa, tell MobiLinc to unlock my front door."
"Alexa, tell MobiLinc to lock all doors."
"Alexa, tell MobiLinc to unlock all doors."
"Alexa, ask MobiLinc if front door is locked."
"Alexa, ask MobiLinc if front door is unlocked."

Thermostats: Example "Upstairs"
"Alexa, ask MobiLinc what's the temperature of upstairs."
"Alexa, ask MobiLinc to get the mode for upstairs."
"Alexa, ask MobiLinc to set the mode for upstairs."
"Alexa, ask MobiLinc to get thermostat set point."
"Alexa, tell MobiLinc to set temperature."
"Alexa, tell MobiLinc to increase temperature."
"Alexa, tell MobiLinc to set upstairs heat set point to 65 degrees."
"Alexa, tell MobiLinc to set upstairs cool set point to 75 degrees."
"Alexa, tell MobiLinc to set upstairs mode to cool."

Programs: Example "Irrigation"
"Alexa, tell MobiLinc to run irrigation."
"Alexa, tell MobiLinc to stop irrigation."
"Alexa, ask MobiLinc the status of program irrigation."