Alexa usage and skill Guide

Introduction

This guide includes a description of the available voice commands and devices you can control using Alexa and BeoLiving Intelligence. To enable this feature, Alexa’s skill “BeoLiving Intelligence skill by Khimo” must be enabled through the Alexa App (refer to BeoLiving Intelligence Link to Third Party Cloud Service Guide).

This feature does not depend on the mode of the BeoLiving Intelligence (ESSENTIAL or PRO).

Terminology

  • BLI: Alias for BeoLiving Intelligence.
  • BLApp: BeoLiving App.

Discovery

The first step you should take after linking Alexa with your BLI is to discover all devices in your configuration. Automatic discovery of all supported devices is performed by saying “Alexa, discover my smart home devices” to your Alexa-enabled device. Alexa will then communicate with your BLI and get all supported devices.

Device name reference

In the discovery process, Alexa creates a name reference for each device as “(BLI device zone name) + (BLI device name)”. For example, if you have a light named “Light” included in a zone named “Kitchen”, you can say “Alexa, turn on kitchen light” to turn it on.

Commands

The following sections show the available commands for each device. Note that some commands may not be available on all devices: for example, a monochromatic dimmer will not support the set color command.

Lights/Dimmers

  • Turn on/off:
    • Alexa, turn on/off (LIGHT-NAME)
    • Description: Turns on/off the light.
  • Set brightness:
    • Alexa, dim (LIGHT-NAME) (BRIGHTNESS)%
    • Description: Sets the brightness level.
  • Relative brightness adjustment:
    • Alexa, increase/decrease (LIGHT-NAME) by (BRIGHTNESS)%
    • Description: Increases or decreases the brightness level.
  • Set color:
    • Alexa, set the (LIGHT-NAME) to (COLOR)
    • Description: Sets the light’s color.

Shades

  • Raise/lower:
    • Alexa, raise/lower (SHADES-NAME)
    • Description: Raises or lowers the shades.
  • Set level:
    • Alexa, (SHADES-NAME) to (LEVEL)%
    • Description: Sets the shades’s level.

Thermostats

  • Turn off:
    • Alexa, turn off (THERMOSTAT-NAME)
    • Description: Sets thermostat to Off mode.
  • Set thermostat setpoint:
    • Alexa, set (THERMOSTAT-NAME) to (TEMPERATURE)
    • Description: Sets the thermostat’s setpoint to a specific temperature.
    • Rules:
      • In case the thermostat has two setpoints (THERMOSTAT_2SP BLI resource type) and it’s in “Auto” mode, upper setpoint (Cool setpoint) will be set at +2 degrees of (TEMPERATURE) and lower setpoint (Heat setpoint) will be set at - 2 of (TEMPERATURE).
      • In Eco mode, thermostat setpoints cannot be set.
  • Relative temperature setpoint adjust:
    • Alexa, increase/decrease temperature of (THERMOSTAT-NAME)
    • Description: Increase/decrease the thermostat’s setpoints by a constant value.
    • Rules:
      • Same rules as “Set thermostat setpoint” apply.
  • Set thermostat mode:
    • Alexa, set (THERMOSTAT-NAME) to (MODE)
    • Description: Changes thermostat mode.
    • Rules:
      • MODE could be any of: “Heat”, “Cool”, “Off”, “Eco” and “Auto”.
  • Turn off:
    • Alexa, turn off (DEVICE-NAME)
    • Description: Sets the device into Standby mode.
  • Change channel by number:
    • Alexa, change channel to (CHANNEL-NUMBER) on (DEVICE-NAME)
    • Description: Changes channel to (CHANNEL-NUMBER) number in the current source.
  • Change channel by name:
    • Alexa, change channel to (CHANNEL-NAME) on (DEVICE-NAME)
    • Description: Changes the channel by name in current source.
    • Rules:
      • Searchs for (CHANNEL-NAME) in all Favourite Lists assigned to device sources. Current source will have priority for a match.
  • Skip channels:
    • Alexa, channel up/down on (DEVICE-NAME)
    • Description: Changes to the next or previous channel in the current source.
  • Set volume:
    • Alexa, set the volume of (DEVICE-NAME) to (VOLUME)
    • Description: Sets the volume level to (VOLUME).
    • Rules:
      • Desired volume must be between 0 and 90.
  • Relative volume adjust:
    • Alexa, turn the volume up/down on (DEVICE-NAME) by (VOLUME-DELTA)
    • Description: Increases or decreases the device’s volume by (VOLUME-DELTA).
  • Mute/Unmute:
    • Alexa, mute/unmute (DEVICE-NAME)
    • Description: Mutes or unmutes the device.
  • Render control commands:
    • Alexa, (CONTROL-COMMAND) on (DEVICE-NAME)
    • Description: Sends a renderer control command.
    • Rules: (CONTROL-COMMAND) could be any of:
      • FastForward
      • Next
      • Pause
      • Play
      • Previous
      • Rewind
      • Stop
  • Select source(input):
    • Alexa, change the input to (SOURCE-NAME) on (DEVICE-NAME)
    • Description: Selects a source on the device. In Alexa’s language, “sources” are equivalent to “inputs”. Possible sources are all enabled sources on the BLI Interfaces page (PRO mode only).
    • Notice: This stanza is too long and sometimes alexa does not understand it well, it is usually better to define a Macro (Scene) that turns on the Network Link product at the correct source and activates it using the “_Alexa , turn on MACRO “stanza.

Scenes/Macros

  • Activate/Deactivate scene:
    • Alexa, activate/deactivate (SCENE-NAME)” or “Alexa, turn on/turn off (SCENE-NAME)
    • Description: Fires or stops the macro.

How to change a discovered device name

Sometimes, Alexa’s identifier device name may not be suitable for use. Depending if it’s an uncommon or rare name, Alexa may not understand and complete the instructions, thus being necessary to edit Alexa’s device name.

The ways to edit the Alexa’s identifier device name are:

  • Change the resource name at BLI configuration (through BLApp or web interface, being in PRO mode) and re-discover all devices.
  • Edit the device using the Alexa App, for all devices that are not AV renderer BLI’s resource type. This is a known limitation of Alexa App.

Workarounds when input selection fails

Alexa understands popular source names like “YouTube” or “Android TV” most of the time, but using uncommon names may prevent Alexa to find the desired match in the source list.

When this happens, you can try one of the following approaches:

  • Change the source name using the Interfaces page at BLI web interface (only in PRO mode), and re-discover the devices.
  • Create a macro in BLI that selects the source in the device, and call “Alexa, activate (SCENE-NAME)”. To start using the macro with Alexa, call for a device discovery.