Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thehappydinoa/AshsSDK
AshsSDK - An Alexa Smart Home Skill SDK made for controlling any network controlled devices using payload V3 (Entertainment Devices)
https://github.com/thehappydinoa/AshsSDK
Last synced: about 2 months ago
JSON representation
AshsSDK - An Alexa Smart Home Skill SDK made for controlling any network controlled devices using payload V3 (Entertainment Devices)
- Host: GitHub
- URL: https://github.com/thehappydinoa/AshsSDK
- Owner: thehappydinoa
- License: mit
- Created: 2017-08-18T18:33:54.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-01-05T08:49:02.000Z (about 6 years ago)
- Last Synced: 2024-05-19T04:51:28.661Z (8 months ago)
- Language: Python
- Homepage:
- Size: 8.09 MB
- Stars: 14
- Watchers: 3
- Forks: 5
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [AshsSDK](https://thehappydinoa.github.io/alexa-smart-home-skill/)  [](https://gitter.im/alexa-smart-home-skill/alexa-smart-home-skill?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
An Alexa Smart Home Skill SDK made for controlling any network controlled devices using payload V3 (Entertainment Devices)
## Requirements
* A [AWS account](https://aws.amazon.com/)
* A [Amazon Developer account](https://developer.amazon.com)
* An Alexa-enabled device such as [Amazon Echo](https://www.amazon.com/dp/B00X4WHP5E/) or [Amazon Echo Dot](https://www.amazon.com/dp/B01DFKC2SO/)
* A Bridge running [Python 2.7](https://www.python.org/downloads/) and [Pip](/installing-pip.md) (I used a [Raspberry Pi](https://www.raspberrypi.org/products/), but another computer running linux will work too)
* I recomend using [screen](/installing-screen.md) to run python headless
## How to
1. AWS IAM Setup
### Create an [AWS Role in IAM](https://console.aws.amazon.com/iam/homet) called mqtt_handler with access to Lambda.
2. AWS IOT Device Setup
1. Lambda Virtual `device`
### Create an [AWS IOT Thing](https://console.aws.amazon.com/iotv2/home#/thinghub)
#### Download these as `lambda.cert.pem, lambda.public.key, lambda.private.key`
- Client Device
### Create an [AWS IOT Thing](https://console.aws.amazon.com/iotv2/home#/thinghub)
#### Download these as `client.cert.pem, client.public.key, client.private.key`
3. Get MQTT Server Hostname
* Go to [Settings](https://console.aws.amazon.com/iotv2/home#/settings)
* Note down the Endpoint
* It should look like: xxxxxxxxxxxxxx.iot.us-east-1.amazonaws.com
#### Note: Make sure to download your public and private keys to some place secure. You will not be able to re-download these.
3. Bridge Set Up
### Clone this repo and install dependencies
```bash
git clone https://github.com/thehappydinoa/AshsSDK
cd AshsSDK/
pip install -r client/requirements.txt
```
#### Copy `lambda.cert.pem` and `lambda.private.key` in to the folder named `lambda`
#### Copy `client.cert.pem` and `client.private.key` in to the folder named `client`
```bash
cd ..
python fileGenerator.py
```
4. Upload `mqtt-handler.zip` to lambda
### Create function
#### Click Create New Function
#### Create from Scratch
#### Skip adding a trigger until after the you create an Alexa Skill
#### Configure Function
* Name the function `Alexa-MQTT-Skill`
* the runtime to `Python 2.7`
* Set Code entry type to `Upload a .ZIP file`
* Set Handler to `mqtt-handler.lambda_handler`
* Set Role to Existing Role `mqtt_handler`
### Copy ARN
Should look like `arn:aws:lambda:us-east-1:xxxxxxxxxxx:function:Alexa-MQTT-Skill`
5. Create Alexa Skill
### Create or login to an [Amazon Developer account](https://developer.amazon.com/edw/home.html#/).
In the Alexa Developer Console Select `Alexa Skills Kit`
[Create an Alexa Skill](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/developing-an-alexa-skill-as-a-lambda-function)
* Set Skill Type to `Smart Home Skill API`
* Set Name to `Alexa-MQTT-Skill`
* Set Payload Version to `v3 (audio-visual devices)`
#### Copy the `ID:`
Should look like `amzn1.ask.skill.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx`
#### Go Back to the Lambda Dashboard
#### Add `Alexa Smart Home` as the Lambda Function Trigger
Paste in the ID
## You Now should be able to interact with your Skill
Try saying `Alexa, Turn on Device1`
## Resources
* [aws-iot-device-sdk-python](https://github.com/aws/aws-iot-device-sdk-python)
* [AQUOS-Remote-Python](https://github.com/thehappydinoa/AQUOS-Remote-Python)
* [Alexa Smart Home Skill Kit](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/overviews/understanding-the-smart-home-skill-api)
* [AWS Lambda](http://docs.aws.amazon.com/lambda/latest/dg/welcome.html)