README.md

EchoPhotonBridge

How it works

It's Simple. An Alexa Skill interfaces to a Library on the Particle device which abstracts away all the calls and communication required to implement Amazon Home Automation Skills. So now you can concentrate on bringing your devices to life instead of writting Lambdas, oAuth Servers and interfaces.

What does that really mean? Simple. You link your Particle.IO account to your Amazon Alexa account, then when you make a device that includes home automation, you simply say, "Alexa, Discover Devices" and it will find your device. And this interface supports a wide range of controls, not just on and off.

Using the EchoPhotonBridge, you'll be able to use phrases like:
Alexa, Turn Photon Light On, Alexa, Make Photon Light Red,
Alexa, Lock File Cabinet, Alexa, what is the temperture of the blanket

What can it do?

The EchoPhotonBridge supports

Turn On & Off (like a Light or Fan)

Change a Device's Color (like a Light)

Set, Increase or Decrease a Percentage on a Device (like a Light Dimmer or Fan Speed)

Set, Increase or Decrease a Target Temperature (like for a Thermostat)

Ask for the Current Temperature of a Device (like how cold a room is)

Ask for the Target Temperature of a Device (like what the Thermostat is set to)

Lock a Device (like a door lock) - Alexa does not support unlocking

Ask for the Status of a Lock (locked or unlocked)

Set, Increase or Decrease a Color Temperature (like a light bulb)

What you need?

Purchase a Particle Photon when you get it, Create a Particle IO Account then add your Photon to your Account using your smart phone.

Program your Photon, in the Particle.io IDE, click on Libraries, search for EchoPhotonBridge and click on EchoPhotonBridge, then under examples, choose your what example to try. Then flash your device.

Add the Photon Smart Home Bridge Alexa Skill to your Amazon Echo. You will be asked for your Particle.IO Bridge login, so login - this will give the skill access to your devices. The bridge will scan your particle account for devices running the EchoPhotonBridge Library and interface them to Amazon.

Ask "Alexa Discover Devices" to trigger scanning for new devices and find your new Photon.

Got a Code Example?

You just define the name of the device and attach a function to call - it's easy - how easy? 5 Lines of code easy!

Need More Code?

Check out the examples!

Need Help?

The Particle IO Bridge is available free. Should you need assistance, our suggestion is to visit the Particle.IO Community Site. Should you require professional assistance at our standard hourly rate, please feel free to contact Jeremy directly using the contact form on the home page.