Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added 3rd_party_integrations_in_esp_rainmaker article to the blog #39

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Added 3rd_party_integrations_in_esp_rainmaker article to the blog #39

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
58 changes: 58 additions & 0 deletions content/blog/3rd_party_integrations_in_esp_rainmaker/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,58 @@
---
title: 3rd Party Integrations in ESP RainMaker
date: 2020-06-30
showAuthor: false
authors:
- Piyush Shah
---
# 3rd Party Integrations in ESP RainMaker

[Piyush Shah](https://medium.com/@shahpiyushv?source=post_page-----3ea4df6afa3--------------------------------)

[Follow](https://medium.com/m/signin?actionUrl=https%3A%2F%2Fmedium.com%2F_%2Fsubscribe%2Fuser%2F57464183000e&operation=register&redirect=https%3A%2F%2Fblog.espressif.com%2F3rd-party-integrations-in-esp-rainmaker-3ea4df6afa3&user=Piyush+Shah&userId=57464183000e&source=post_page-57464183000e----3ea4df6afa3---------------------post_header-----------)

[The ESP Journal](https://blog.espressif.com/?source=post_page-----3ea4df6afa3--------------------------------)

--

![](https://miro.medium.com/v2/resize:fit:640/format:webp/1*gpf1R6rG-WZfoTCfubQIpg.jpeg)

IoT, in general, has come a long away. During the very early stage, there was browser based control and monitoring, which, though more convenient than non-IoT devices, had a very narrow market. With the advent of Smartphones, IoT devices became much more easier to use and mass adoption became a possibility. However, the real push was given by the advent of various eco-systems and Voice assistants like Siri, Alexa and Google Assistant. Controlling by just asking verbally is much more natural than opening some app in a smartphone and tapping buttons.

With this in mind, we now have added 3rd party integrations, particularly Alexa and Google Voice Assistant (GVA) support in ESP RainMaker!

# How does this work?

If you are already familiar with ESP RainMaker, you may know that it has the concepts of [devices](https://rainmaker.espressif.com/docs/spec-concepts.html#devices) and [parameters](https://rainmaker.espressif.com/docs/spec-concepts.html#parameters). The devices and parameters have an optional “type” field. We have defined our own standard types for some common smart home devices like switches, lightbulbs, fans, etc. You can find information about the standard types [here](https://rainmaker.espressif.com/docs/standard-types.html). We have now created a layer which maps these parameters to formats that are understood by Alexa and GVA. So a device type in RainMaker (like light, switch, etc.) maps to a similar device type there, and their parameters like power, brightness, hue, saturation, intensity. etc. get mapped to the corresponding capabilities/traits. If you have just the power and brightness params, you get a simple brightness controllable light. If you include hue, saturation and intensity, you get a color light in Alexa and GVA.

# Usage

The code required to implement the standard devices is very simple. Let us look at a colour light example (led_light) which is already available on [GitHub](https://github.com/espressif/esp-rainmaker/tree/master/examples/led_light). The relevant code snippet below is self explanatory.

The [switch example on GitHub](https://github.com/espressif/esp-rainmaker/tree/master/examples/switch) is also ready out of the box for Alexa/GVA.

Once you build and flash the Lightbulb/Switch example, provision your board and link to your account using the [ESP RainMaker Phone apps](https://rainmaker.espressif.com/docs/quick-links.html#phone-apps). Give the device some friendly name so that it is easy to identify.

# Enabling Alexa

- Open the Alexa app on your phone, go to Skills and Games in the menu and search for ESP RainMaker.

![](https://miro.medium.com/v2/resize:fit:640/format:webp/1*SsIwUMlN8qxwefmoB1G07A.jpeg)

- Select the skill, tap on “Enable to Use” and provide your RainMaker credentials.
- Once the account linking is successful, allow Alexa to discover your devices.
- Once the devices are successfully discovered, the setup is complete and you can start controlling them using Alexa.

# Enabling Google Voice Assistant (GVA)

- Open the Google Home app on your phone.
- Tap on “+” -> Set up Device.
- Select the “Works with Google” option meant for devices already set up.
- Search for ESP RainMaker and sign in using your RainMaker credentials.
- Once the Account linking is successful, your RainMaker devices will show up and you can start using them.

![](https://miro.medium.com/v2/resize:fit:640/format:webp/1*nNmV4ly-4simENKrfBSCGg.jpeg)

- Some users may not see the list like above, but the devices should show up in the device list in the Google Home app.

So, go ahead and start linking your RainMaker devices to your favourite voice assistants. Currently, only switch and light are supported. Let us know what you would like us to add next by dropping a message either on the [forum](https://esp32.com/viewforum.php?f=41) or [GitHub](https://github.com/espressif/esp-rainmaker/issues).