Skip to content

RABCbot/home-assistant.custom_components.alexa_gateway

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

49 Commits
 
 
 
 
 
 

Repository files navigation

custom_components/alexa_gateway

This custom component integrates Home Assistant with an Alexa SmartHome Skill. It allows using native Alexa voice commands and full access with the Alexa app.

Goals

  1. Replace the emulated_hue integration
  2. Avoid port forwarding to expose Home Assistant to the external Internet
  3. Support common entities (lights, switches, garage door, scripts and sensors)

Ingredients

  • Alexa
  • Alexa SmartHome Skill
  • Alexa Account Linking
  • AWS Lambda
  • AWS IoT GreenGrass core
  • This custom component

Services

The custom component registers two services to Home Assistant:

  • process_request: To be called from your lambda running in your local Greengrass IoT core
  • report_change: To be called from an Automation in Home-assistant to send your entity status change to the Alexa Event Gateway

Account Linking

Amazon blog post about Login with Amazon

AWS Greengrass IoT

Follow repo instructions to get Greengrass IoT running. NOTE: Instructions might be outdated.

Configuration

To enable this custom component add these lines to your Home-Assistant configuration.yaml file:

alexa_gateway:
  url: https://api.amazonalexa.com/v3/events
  auth_url: https://api.amazon.com/auth/o2/token
  client_id: !secret ALEXA_CLIENT_ID
  client_secret: !secret  ALEXA_CLIENT_SECRET

Customize

It is possible to override the Alexa interface and Alexa display values
For example, for an entity you can make it as a Doorbell event

script.doorbell:
  alexa_interface: Alexa.DoorbellEventSource
  alexa_display: DOORBELL

Supported Alexa interfaces

Alexa.ContactSensor
Alexa.MotionSensor
Alexa.TemperatureSensor
Alexa.ThermostatController
Alexa.PowerController
Alexa.LockController
Alexa.BrightnessController
Alexa.ColorController
Alexa.ColorTemperatureController
Alexa.ModeController (garage door)
Alexa.RangeController (generic counter and blinds)
Alexa.EventDetectionSensor
Alexa.DoorbellEventSource

reference: https://developer.amazon.com/en-US/docs/alexa/device-apis/list-of-interfaces.html

License

alexa_response.py Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages